User's Manual

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 s
ession timings
in the GW
0x0005 Set DXT SR parameters Set radio channel, network ID, encryption word
and
cyclic w
akeup 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
0x0008 Set BT parameters Set BT local name and PIN
0x0009 Get Battery level Get Battery level (percentage)
0x
000
A
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
0x000
F
Set
Auto
DXT Data
Set
parameters
of Get D
ata from DXTs when
GW
2 Bytes
OpCode BitMask
Reserved
2 Bytes 1 Byte
Parameters
Variable