3.4 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, RST, 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 the 2N® Lift8 CU parameters via configuration SMS messages, including those requiring a string (word, IP address, etc.). The CNF command cannot be used for setting parameters 810, 890, 898 and 899. Use the SMS commands below to set parameters 890 (reset) and 899 (factory reset).
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
Enter an empty value to delete the parameter values. The SMS for deletion of parameters 011 and 012 is as follows:
L8 CNF 12345 011= 012=
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 localization 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.