SATELLINE-M3-TR8
SATELLINE-M3-TR9
Integration Guide, Version 1.7
30
7
CHANGING PARAMETERS USING SL COMMANDS
The controlling terminal device can change the configuration settings of the module. This is
accomplished with the help of SL commands. SL commands can be used to change the device
settings e.g. the frequency, addresses etc. SL commands can also be used to request setting values
from the module to the controlling terminal.
7.1
SL Commands
An SL command is a continuous string of characters, which is used to control the device and its
settings for example from the terminal screen (similar to AT commands).
Serial interface settings are the same as in data transfer, however, if SERV pin is set to LOW, baud
rate is fixed 38400, 8, N, 1. SL command is properly recognised also in the case when the
command string is terminated by <CR> (<CR> = Carriage Return, ASCII character no. 13,
Carriage Return, 0x0d in hex) or <CR><LF> (<LF>= Line Feed, ASCII char. no. 10, Line Feed,
0x0a in hex). No extra characters are allowed at the end of an SL command.
SL command is separated from other data by pauses which are equal or greater than time defined
by Pause Length-parameter (default = 3 characters) in the settings. If multiple SL commands are
sent to the module, the next command can be given after receiving the response ("OK" or "ERROR")
of the proceeding command. In addition, it is recommended to implement a timeout to the
terminal software for recovering the case when no response is received from the radio module.
The module will acknowledge all commands by returning an "OK" (command carried out or
accepted) or the requested value, or an "ERROR" (command not carried out or interpreted as
erroneous) message.
The SL commands are listed in appendix B.
7.2
SL Command Mode
The SL commands have always been enabled in the previous products like M3-R3. When the SL
commands are enabled there are possibilities that the user data may start with the characters “SL”
which is handled as the SL command. This has caused the firmware to go to the continuous SL
command search mode and any data has not been sent or even an “ERROR” acknowledgment
has been received. To avoid this kind of behavior the user can disable the SL commands. The SL
commands can be disabled or enabled using the “
SL Command mode
” parameter. The user can
do this via the
SATEL Configuration Manager,
version v1.5.1 or newer.
By default the
SL Command mode
is set to ON. If the
SL Command mode
is set to OFF then the
SL commands can be enabled or disabled using the following procedures:
To enable the SL Commands:
Send three “+” characters via serial port so that there is at least three bytes delay
between each character. The response is “OK”, when successfully set.