Integration Guide

SATELLINE-M3-TR3
and TR4
Integration Guide, Version 1.6
12
3 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 e.g. the
frequency or addresses. It is also possible to ask the radio transceiver module to show current
settings which are in use.
3.1 SL Commands
An SL command is a continuous string of characters, which is separated from other data by pauses
which are equal or greater than time defined by Pause length parameter (default=3 characters)
in the set-up. No extra characters are allowed at the end of an SL command.
Serial interface settings are the same as in data transfer. SL command is properly recognised also
in the case when the command string is terminated by <CR> (=ASCII character no. 13, Carriage
Return, 0x0d) or <CR><LF> (<LF> = ASCII char. no. 10, Line Feed, 0x0a). 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 transceiver 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, pages 26.
3.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 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.3.15 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: