Product Description

4.3.3 Command and Response messages
Command and Response messages format is shown in the Figure 42.
Figure 42
The OpCode is the code of the Command sent by the Host or the Response sent by the Gateway. The
field BitMask explains which parameters are active in the Parameters field. Note that all the
parameters are always present in the packet, so a specific Command/Response has always the same
size. If a parameter is not active, the respective value will be not modified. If a parameter is mandatory
and an invalid BitMask field has been set, command will be not executed. Default values will be
loaded by Reset command.
The field Reserved is ignored, and its value shall be set to 0xFF.
The field Parameters holds the parameters of the command. It has a specific format for every
command depending on the OpCode. Every parameter could be optional (O) or mandatory (M), if it is
optional and the parameters is not enabled the Gateway will use a default value.
Every response has a Status field. All the parameters of responses are mandatory.
Every command has a 10 minutes timeout. When timeout expires and command is not executed yet,
error response will be received.
During execution of any command (after ACK message has been received and before response is
received), only Get Status and Reboot commands can be executed; other commands or bytes on
control interface are not considered.
Table 4.2 shows the list of commands and responses.
OP Code Command/Response Name Description
0x0001 Set date/time Set RTC time
0x0002 Get date/time Get RTC time
0x0003 Get serial number Get gateway serial number
0x0004 Set GW SR parameters Set radio channel, network ID, encryption word
and wakeup session timings in the GW
0x0005 Set DXT SR parameters Set radio channel, network ID, encryption word
and cyclic wakeup timings in a DXT
0x0006 Set gateway mode Choose control interface (BT/USB/UART/GSM)
0x0007 Set GSM parameters Set APN, DNS and SIM PIN
0x000
8
Set BT parameters
Set BT
local name and
PIN
0x0009 Get Battery level Get Battery level (percentage)
0x000A Get hw/sw version Get hardware/software version
0x000B Get GSM parameters Get GSM parameters
0x000C Get GW SR parameters Get SR parameters from the GW
0x000D
Get DXT SR parameters
Get SR parameters from a DXT
0x000E Scan for DXT Scan for active DXTs
0x000F Set Auto DXT Data Set parameters of Get Data from DXTs when GW
2 Bytes
OpCode BitMask
Reserved
2 Bytes 1 Byte
Parameters
Variable