3.3 SMS Configuration

This subsection describes how to configure 2N® Lift8 via the Short Message Service (SMS). Short text messages can help you configure the Central Unit (CU) easily without using a PC. See below for their use. You need to know the phone number of the SIM card inserted in the 2N® Lift8 CU to use this function.

Warning

  • The SMS configuration function is supported only on condition that the CU is equipped with a GSM (918650E 2N® Lift8 GSM Module) or UMTS (918651E 2N® Lift8 UMTS Module) module.
  • This function is not available with the PSTN (918652E 2N® Lift8 PSTN Module) or VoIP (918653E 2N® Lift8 VoIP Module) modules!

Caution

  • Every SMS must meet the conditions listed below to be sent to 2N® Lift8 successfully. If not, the SMS will be ignored, no changes will be made.

Function Description

You can configure 2N® Lift8 with the aid of SMS messages. Send the SMS to the CU SIM card phone number. Make sure that the used parameters are correct to avoid SMS processing failure and an error reply.

Warning

Make sure that every configuration SMS includes the correct parameters!

  • Device name: L8
  • Correct command format (CNF, RESET, etc.)
  • CU service password
  • Correct parameter format (see the command parameters)
  • Space separated parameters

Note

Maximum length of command SMS

  • Modern GSM devices support long SMS, i.e. several normal SMS messages recognised as a single message. A common SMS may have up to 160 characters according to the GSM standard, which permits a total of 1120 bits, i.e. 140 bytes, per SMS. As 7-bit encoding is used by default, 20 characters are saved in every 140 bytes. Therefore, 160 characters are the maximum SMS text length. GSM 03.38 is used as the character set. If non-ASCII characters (chars with diacritics) are used, 16-bit UCS-2 encoding is applied and the SMS contains 70 characters only. Information on all fragments of long SMS are written in the UDH (User Data Header) and so the maximum fragment length is 153 characters with 7-bit encoding. On principle, long SMS may consist of up to 255 fragments, but mobile devices support 6–8 fragments in practice.
  • It implies from what is said above that the maximum message length is 918–1224 characters with 7-bit encoding depending on the device used. The UCS-2 calculation is analogous.

Basic Configuration with CNF Command

You can set all the 2N® Lift8 CU parameters via configuration SMS messages, including those requiring a string (word, IP address, etc.). Every configuration SMS message must include the following parts: L8 header for unique identification of the 2N® Lift8 CU,  a CNF command for identification of the function to be performed, i.e. configuration in this case, and a valid service password, which is 12345 by default. Now you can enter the CU setting data in the parameter=value format. The SMS syntax is as follows:

<header> <CNF> <service password> <par1>=<val1> <par2>=<val2>


A complete SMS can be as follows, for example:

L8 CNF 12345 011=734523352 941=99 012=602874321 914=105 111=5 112=1


If everything is OK, you will receive the following confirmation SMS:

L8 CNF OK

Tip

  • Commonly, the bus or GSM/UMTS module may get restarted during configuration. In this case, the configuration confirming message is not sent until re-login.

Caution

  • SMS-based configuration obeys the same rules and limitations as configuration via an application or a phone (maximum length, value range, two-digit limitation, etc.). If any of these rules is not met, 2N® Lift8 shall not set the parameters and shall send an error SMS specifying the wrong parameter.

 

Factory RESET

Use the DEF command to reset the CU factory values remotely. Once the command is received, the CU is factory reset immediately. The message syntax is as follows:

<header> <DEF> <service password>

A complete SMS can be as follows, for example: 

L8 DEF 12345

If everything is OK, you will receive the following confirmation SMS:

L8 DEF OK

RESET Command

Use the RST command to restart the CU remotely. When the command is received, the CU is restarted immediately. A confirmation SMS is sent before the CU restarts.The message syntax is as follows:

<header> <RST> <service password>


A complete SMS can be as follows, for example:

L8 RST 12345


If everything is OK, you will receive the following confirmation SMS:

L8 RST OK

Profile Changing Command

Profile configuration is customised in 2N® Lift8. Use the SET command to set a selected profile and send a confirmation SMS. The message syntax is as follows:

 <header> <SET> <service password> <profil number>

A complete SMS can be as follows, for example: 

 L8 SET 12345 4

 

If everything is OK, you will receive the following confirmation SMS:

 L8 SET OK


Error Replies

Should there be an error in the configuration SMS or command processing procedures, 2N® Lift8 transmits an error reply notifying that the command has not been executed! 

2N® Lift8 sends error replies until all the configuration SMS parameters are correct and the command can be executed.

The following errors can be specified:

L8 ERR Unknown command – An unknown command has been entered. The CNF and RESET commands are only allowed.

L8 ERR Invalid Message – The received SMS has an invalid format. The L8 header is probably missing.

L8 ERR Invalid Syntax – There is a syntactic error in the SMS. Most probably, the password/command sequence is wrong or there is a redundant text at the end.

L8 ERR Invalid Password  – The Service password is absent or invalid.

L8 ERR Invalid parameters – Some command parameters fail to match the CU parameters or the parameter value is beyond the allowed limits.

 

Note

  • The language localisation of the SMS reply is based on the voice menu recorded. 
  • Cs and en texts are available at present. Slovak uses cs, the other languages use en.