Rules and nuances that must be observed when sending commands are described in this guide.
Name | Channel | Example | |
---|---|---|---|
Command | Response | ||
SYSTEM COMMANDS | |||
Model and Version Request | all | *?V |
*#V:S-2651:01.00.72:13.05.20:RU |
IMEI Request | all | *?S |
*#S:866123456789123 |
ICCID Request | all | *?ICCID |
*#S 897010123456789123 |
USSD Request | all | *?USSD *100# |
*#USSD 1200.20р. |
GNSS Version Request | all | *?VGPS |
*#VGPS S-2435,01.01.20,30.04.20,B05V01SIM868 |
Reboot Device | all | *!DEV_RESET |
*@DEV_RESET |
Synchronization with the Server | all | *!SYNC 1 |
see command description |
Re-Upload Telemetry | all | *!REP_FL 1,09.04.18/13:00:59,10.04.18/03:00:00 |
*@REP_FL OK |
Re-Upload from SD | all | *!REP_SD 1,02.06.20,03.06.20 |
*@REP_SD OK |
Time Adjustment | all | *!SETTIME +300 |
*@SETTIME OK |
Counters Adjustment | all | *!SETP 4:234.7 |
*@SETP OK |
DIAGNOSTICS | |||
Status Request | SMS | *?A |
M:111 message |
Request/Send Status via SMS | SMS | *?ES |
M:114 message |
Internet USB BT |
*?ES +71112223344 |
see command description | |
Location request | SMS | *?POS |
see command description |
LBS Request | SMS | *?LBS |
M:112 message |
Parameter Value Request | all | *?DATA 21,22 |
*#DATA 21:0026,22:0010 |
Send Data to Interface | all | *!UC RS485,3101066С |
*@UC RS485,3E01060AE803A00F69 |
REMOTE CONTROL | |||
Connection to the Configurator (RCS) | all | *!CNCT_RCS rcs.navtelecom.ru,8100,43644176 |
see command description |
Firmware Update (RFU) | all | *!CNCT_RFU 89.208.152.55,9100,LAST |
see command description |
Connection to DRC Server | all | *!CNCT_DRC |
*@CNCT_DRC OK |
Output Control | all | *!SETOUT 1Y,2N |
*@SETOUT OK,1Y,2N |
Activate/Deactivate One Output | Internet USB BT |
*!1Y |
see command description |
Sound Indication | all | *!BEEP 20,3,100,1000 |
*@BEEP OK |
Disable Input | Internet USB BT |
*!OFF2 |
see command description |
Enable Input | Internet USB BT |
*!ON2 |
see command description |
SIM Card Change | all | *!CHNGSIM |
*@CHNGSIM 1->2 |
In response, device sends information about the model, firmware version and release date.
*?V
*#V:S-2651:01.00.72:13.05.20:RU
Format | |
*#V:<n>:<v1>.<v2>.<v3>:<d>.<m>.<y>:<loc> |
|
Parameter | Description |
<n> |
device model (6 characters) |
<v1>.<v2>.<v3> |
firmware version (2 characters each) |
<d>.<m>.<y> |
day, month and year respectively firmware version (2 characters each) |
<loc> |
firmware language version (2 characters) |
In response, device sends a unique device identification number (IMEI).
*?S
*#S:866123456789123
Format | |
*#S:<i> |
|
Parameter | Description |
<i> |
IMEI (device identification number) |
In response, device sends the ICCID number of the SIM card installed in the device.
*?ICCID
*#ICCID 897010123456789123
Format | |
*#ICCID<s><id> |
|
Parameter | Description |
<s> |
parameter separator, space |
<id> |
ICCID (SIM card identification number) |
Device forwards request received in the USSD command to the cellular operator and then sends back received response to the user. This command allows you to check the SIM card balance.
*?USSD *100#
Format | |
*?USSD<s><code> |
|
Parameter | Description |
<s> |
parameter separator, space |
<code> |
USSD request code string |
*#USSD 1200.20р.
Format | |
*#USSD<s><string> |
|
Parameter | Description |
<s> |
parameter separator, space |
<string> |
cellular operator response string |
In response, device sends the version number of the navigation receiver.
*?VGPS
*#VGPS S-2435,01.01.20,30.04.20,B05V01SIM868
Format | |
*#VGPS<s><n>,<v1>.<v2>.<v3>,<d>.<m>.<y>,<gps_ver> |
|
Parameter | Description |
<s> |
parameter separator, space |
<n> |
device model (6 characters) |
<v1>.<v2>.<v3> |
indexes of the device firmware version (2 characters each) |
<d>.<m>.<y> |
day, month, and year of the device firmware version (2 characters each) |
<gps_ver> |
model and version of the navigation receiver |
Command leads to device program restart.
*!DEV_RESET
*@DEV_RESET
(Reset device memory)
This command stops sending old telemetry from the device's internal memory to the server. However, telemetry messages are not deleted from memory. If necessary, they can be uploaded to the server with the command to re-upload telemetry from the internal memory (Re-upload telemetry).
*!SYNC 1
Format | |
*!SYNC<s><index> |
|
Parameter | Description |
<s> |
parameter separator, space |
<index> |
server index specified in the device settings (starting from 1 digit) |
Format | |
M:111 Message (description) | |
Event codes (full list) | |
5393 |
Synchronization with the server #1 |
5394 |
Synchronization with the server #2 |
5395 |
Synchronization with the server #3 |
Format | |
Standard telemetry message *@C (description in communication protocol) |
|
Event codes (full list) | |
5393 |
Synchronization with the server #1 |
5394 |
Synchronization with the server #2 |
5395 |
Synchronization with the server #3 |
On command, device starts sending telemetry from the internal memory of the device for the period specified in the command.
*!REP_FL 1,09.04.18/13:00:59,10.04.18/03:00:00
*!REP_FL 1,09.04.18,10.04.18
Format | |
*!REP_FL<s><srvindex>,<leftdate>/<lefttime>,<rightdate>/<rightdate> |
|
Parameter | Description |
<s> |
parameter separator, space |
/ |
date and time field separator |
<srvindex> |
server index to repeat in text format:0 – to all servers;1 ..3 – server index. |
<leftdate> |
date of the left border of the requested telemetry interval in text format (in UTC): DD.MM.YY . |
<lefttime> |
(optional) time of the left border of the requested telemetry interval in text format (in UTC): HH:MM:SS .Missing parameter, equates to the 00:00:00 value. |
<rightdate> |
date of the right border of the requested telemetry interval in text format (in UTC): DD.MM.YY . |
<righttime> |
(optional) time of the right border of the requested telemetry interval in text format (in UTC): HH:MM:SS .Missing parameter, equates to the 23:59:59 value. |
*@REP_FL OK
Format | |
*@REP_FL<s><result> |
|
*Parameter | Description |
<s> |
parameter separator, space |
<result> |
Command processing result (ASCII):OK - command executed;FAIL - command execution error. |
On command, device starts sending telemetry from the SD card installed in the device for the period specified in the command. Data is uploaded daily.
Requesting data upload it is important to specify a date with one day more than the requested period. For example, to upload telemetry for the day 02.06.2020, you need to specify in the command the start date of the period (left border) 02.06.20, and the end date of the period (right border) 03.06.20.
*!REP_SD 1,02.06.20,03.06.20
Format | |
*!REP_SD<s><srvindex>,<leftdate>,<rightdate> |
|
Parameter | Description |
<s> |
parameter separator, space |
<srvindex> |
server index to repeat in text format:0 – to all servers;1 ..3 – server indes. |
<leftdate> |
date of the left border of the requested telemetry interval in text format (in UTC): DD.MM.YY . |
<rightdate> |
date of the right border of the requested telemetry interval in text format (in UTC): DD.MM.YY . |
*@REP_SD OK
Format | |
*@REP_SD<s><result> |
|
Parameter | Description |
<s> |
parameter separator, space |
<result> |
Command processing result (ASCII):OK - command executed;FAIL - command execution error. |
Command allows changing the time in the device by an offset of the specified number of seconds.
*!SETTIME +300
Format | |
*!SETTIME<s><offset> |
|
Parameter | Description |
<s> |
parameter separator, space |
<offset> |
signed offset in seconds in text format. For example: +60 or -30. |
*@SETTIME OK
Format | |
*@SETTIME<s><ans> |
|
Parameter | Description |
<s> |
parameter separator, space |
<ans> |
response:OK - time is synchronized;FAIL - synchronization error. |
Command allows changing the current value of the counters of engine hours, mileage, counter inputs, etc.
*!SETP 1:0
*!SETP 4:234.7
Format | |
*!SETP<s><param>:<value> |
|
Parameter | Description |
<s> |
parameter separator, space |
<param> |
changeable parameter:1 - engine hours;4 - mileage;5 - impulse counter 1;6 - impulse counter 2;7 - impulse counter 3;8 - impulse counter 4;9 - impulse counter 5;10 - impulse counter 6;13 - total fuel consumption (CAN);14 - total mileage (CAN);15 - total engine operating time (CAN). |
<value> |
Value to be set, range depends on the selected parameter: - If param=4 or param=14 , then it is a fractional positive number (fractional part is marked with a DOT, for example: 0.0 or 999999.9).- Otherwise, it is an integer from 0 to 4294967295. |
*@SETP OK
Format | |
*@SETP<s><ans> |
|
Parameter | Description |
<s> |
parameter separator, space |
<ans> |
response:OK - value setting done;FAIL - value setting error. |
In response to a request, device sends a message with current time information, event, minimal information about the state of the inputs and outputs of the device and navigation information.
*?A
Format | |
M:111 message (desciption) | |
Event Codes (full list) | |
40962 |
Request for the object current state |
Format | |
Standard telemetry message *@C (description in Communication Protocol) |
|
Event Codes (full list) | |
40962 |
Request for the object current state |
(Request SIM card number)
In response to a request, device sends a message with information about model, firmware version of the device, IMEI number, time and date in the device at the time the response was sent, and a hyperlink to the Google Maps service with the current location of the object.
If you send a request via SMS, then the answer will be sent via SMS to the sender's number.
*?ES
Format | |
M:114 message (description) |
If you send a request via Internet/USB/BT, device will confirm receipt of the command via Internet/USB/BT and then will send an SMS M:114 message to the phone number specified in the command (thus, SMS recipient gets the phone number of the device).
*?ES +71112223344
Format | |
*?ES<sp><c> |
|
Parameter | Description |
<s> |
parameter separator, space |
<c> |
phone number in international format to which it is required to send an SMS response. |
*#ES +71112223344
Format | |
*#ES<sp><c> |
|
Parameter | Description |
<s> |
parameter separator, space |
<c> |
phone number in international format to which it is required to send an SMS response. |
Format | |
M:114 message (description) |
SMS request for the current location as a hyperlink to the Google Maps service.
Command is not available for Internet, Bluetooth, USB channels.
*?POS
19.46.00 (+3) 17/08/2019 GPS_TIMER http://maps.google.ru/maps?&hl=ru=+55.796593,+37.717445&ie=UTF8&output=html&zoom=0&p=OO
Format | |
<hour>.<min>.<sec><s>(+<p>)<s><d>/<m>/<y><s><event><s><gmap> |
|
Parameter | Description |
<s> |
parameter separator, space |
<hour>.<min>.<sec> |
current time in the device |
(+<p>) |
time zone in the device |
<d>/<m>/<y> |
day, month and year in the device |
<event> |
alias of the last event in the device (full list) |
<gmap> |
hyperlink to the Google Maps service with the latest reliable device coordinates |
In response, device sends information about the nearest base stations of the cellular operator, if it is registered in the network.
Command is not available for Internet, Bluetooth, USB channels.
This information can be used to determine the approximate location of the device through the LBS service.
*?LBS
Format | |
M:112 message (description) |
Request allows getting the current value of one or more telemetry parameters.
The parameter number in the request is:
*?DATA 21,22
Format | |
*?DATA<s><id1>,<id2>, ... ,<idN> |
|
Parameter | Description |
<s> |
parameter separator, space |
<idX> |
FLEX protocol field identifier, represented as a decimal number (ASCII) |
*#DATA 21:0026,22:0010
Format | |
*#DATA<s><id1>:<data1>,<id2>:<data2>,...,<idN>:<dataN> |
|
Parameter | Description |
<s> |
parameter separator, space |
<idX> |
FLEX protocol field identifier, represented as a decimal number (ASCII) |
<dataX> |
parameter value is represented in one of two forms:
|
If the given FLEX field contains multiple parameters, they are returned as one data block. In this case, the least-significant parameter in order will be placed on the right, and the most-significant on the left.
For example, field #77 request (LBS data):
*?DATA 77
Response:
*#DATA 77:62D649E3B6006300FA6C0300007ABDB7006300FA6C0300007ABECA006300FA6C0300007AC2
Parsing:
Time=62D649E3
C3_Rx=B6; C3_MNC=0063; C3_MCC=00FA, C3_LAC=6C03; C3_CID=00007ABD
C2_Rx=B7; C2_MNC=0063; C2_MCC=00FA, C2_LAC=6C03; C2_CID=00007ABE
C1_Rx=CA; C1_MNC=0063; C1_MCC=00FA, C1_LAC=6C03; C1_CID=00007AC2
Command allows sending arbitrary data for an external sensor via the RS-232 or RS-485 interface. Format and contents of the package for the sensor connected to the interface must be obtained from the sensor manufacturer.
After sending data, device “listens” to the interface for 500 ms and returns a response from the sensor. If no response has been received within 500 ms, the response field will contain an empty string.
*!UC RS485,3101066C
Format | |
*!UC<s><i>,<msg> |
|
Parameter | Description |
<s> |
parameter separator, space |
<i> |
interface:RS485 - RS-485 interface;RS232 - RS-232 interface. |
<msg> |
data packet to send in hexadecimal (ASCII) |
*@UC RS485,3E01060AE803A00F69
*@UC RS485,
Format | |
*@UC<s><i>,<ans> |
|
Parameter | Description |
<s> |
parameter separator, space |
<i> |
interface:RS485 - RS-485 interface;RS232 - RS-232 interface. |
<ans> |
received response in hexadecimal form (ASCII) (if there was no answer - empty string) |
Command for remote connection of the device with the Configurator via the RCS server.
Detailed description of the connection procedure is given in the guide Remote Connection via RCS Service.
*!CNCT_RCS rcs.navtelecom.ru,8100,43644176
*!CNCT_RCS 89.208.152.55,8100,43644176,internet.mts.ru,mts,mts
Format | |
*!CNCT_RCS<s><ip>,<port>,<commID>,<apn>,<login>,<password> |
|
Parameter | Description |
<s> |
parameter separator, space |
<ip> |
DNS or IP address of the RCS server |
<port> |
Port of the RCS server |
<commID> |
session identifier for connecting to the Configurator (unique for each connection) |
<apn> |
(optional) Access point name of mobile operator |
<login> |
(optional) Login of mobile operator |
<password> |
(optional) Password of mobile operator |
If parameters
<apn>
,<login>
,<password>
are not specified in the command, device will contact the service using the operator parameters from its own settings, or it will automatically determine it based on network registration data.
Device responds only in case of error.
If the command is successfully processed, there is no SMS response from the device. Confirmation is the successful connection of the device with the Configurator.
Format | |
<ip>:<port> not responding |
|
Parameter | Description |
<ip> |
DNS or IP address of the RCS server specified in the command |
<port> |
Port of the RCS server specified in the command |
Format | |
Standard telemetry message *@C (description in Communication Protocol) |
|
Event Codes (full list) | |
41484 |
Command to connect to server for communication with the configurator |
When the command is received, device connects to the remote firmware update (RFU) service and downloads the latest release firmware, or the firmware with the version specified in the command. If the connection fails during download, firmware in the device will not be updated. After several unsuccessful attempts to download the firmware, device stops the update procedure, the device will continue to work on the old version.
It is recommended to check the firmware version in the device using the
*?V
command no earlier than 30 minutes after sending the update command.
*!CNCT_RFU 89.208.152.55,9100,LAST
*!CNCT_RFU 89.208.152.55,9100,02.01.02
*!CNCT_RFU 89.208.152.55,9100,LAST,internet.mts.ru,mts,mts
Format | |
*!CNCT_RFU<s><ip>,<port>,<firmware>,<apn>,<login>,<password> |
|
Parameter | Description |
<s> |
parameter separator, space |
<ip> |
DNS or IP address of the RFU server |
<port> |
Port of the RFU server |
<firmware> |
Requested firmware version, for example: 02.01.00 .If the latest version is required, LAST keyword is used. |
<apn> |
(optional) Access point name of mobile operator |
<login> |
(optional) Login of mobile operator |
<password> |
(optional) Password of mobile operator |
If parameters
<apn>
,<login>
,<password>
are not specified in the command, device will contact the service using the operator parameters from its own settings, or it will automatically determine it based on network registration data.
Below are possible responses to the command:
Start connect to <ip>: <port> |
|
Parameter | Description |
<ip> |
DNS or IP address of the RFU server specified in the command |
<port> |
Port of the RFU server specified in the command |
Firmware OK |
Firmware <string> error <error code> |
|
Parameter | Description |
<string> |
String with firmware version |
<error code> |
Code or description of the detected error |
<ip>:<port> not responding |
|
Parameter | Description |
<ip> |
DNS or IP address of the RFU server specified in the command |
<port> |
Port of the RFU server specified in the command |
Format | |
Standard telemetry message *@C (description in Communication Protocol) |
|
Event Codes (full list) | |
41483 |
Command to connect to server to change the firmware (start downloading the firmware) |
41480 |
Command to record the program with reboot (RFU) (updating the firmware) |
Command for out-of-order connection of the device to the DRC service. In the command, you can specify the time during which the device should be connected to the DRC.
*!CNCT_DRC
*!CNCT_DRC 300
Format | |
*!CNCT_DRC<s><time>,<ip>,<port>,<cmd> |
|
Parameter | Description |
<s> |
parameter separator, space |
<time> |
(optional) Time in seconds. If the parameter is set, then device will connect to the DRC and keep the connection for the specified time. |
<ip> |
(optional) IP address of the DRC server |
<port> |
(optional) Port of the DRC server |
<cmd> |
(optional) Command to send to DRC service |
*@CNCT_DRC OK
Format | |
*@CNCT_DRC<s><ans> |
|
Parameter | Description |
<s> |
parameter separator, space |
<ans> |
Response:OK - Command accepted;FAIL - Error, command will not be executed. |
Device output control command allows activating/deactivating one or more outputs at the same time.
*!SETOUT 1Y,2N
*!SETOUT 1Y,2N,4Y
Format | |
*!SETOUT<s><num><new_state>,<num><new_state>... |
|
Parameter | Description |
<s> |
parameter separator, space |
<num> |
Number of the output whose state needs to be changed. Numbering starts from 1. |
<new_state> |
Output state to be set:Y - activate;N - deactivate. |
Command allows setting the state of several outputs at the same time. State of outputs whose numbers are not specified in the command does not change.
*@SETOUT OK,1Y,2N
Format | |
*@SETOUT<s><result>,<num><cur_state>,<num><cur_state>... |
|
Parameter | Description |
<s> |
parameter separator, space |
<result> |
Command processing result:OK - command executed;FAIL - command execution error. |
<num> |
Number of the output. Numbering starts from 1. |
<cur_state> |
Current state of the output:Y - activated;N - deactivated. |
As a result of command execution, one output specified in the command will be activated or deactivated.
Command is not available for SMS.
*!1Y
Format | |
*!<num><new_state> |
|
Parameter | Description |
<s> |
parameter separator, space |
<num> |
Number of the output whose state needs to be changed. Numbering starts from 1. |
<new_state> |
Output state to be set:Y - activate;N - deactivate. |
Format | |
Standard telemetry message *@C (description in Communication Protocol) |
|
Event Codes (full list) | |
41232 |
O1 output activation |
41234 |
O1 output deactivation |
41248 |
O2 output activation |
41250 |
O2 output deactivation |
41264 |
O3 output activation |
41266 |
O3 output deactivation |
41280 |
O4 output activation |
41282 |
O4 output deactivation |
This command allows controlling the buzzer without built-in generator, connected to the output O1. When the command is received, buzzer will emit sounds of the specified tone and duration.
Command can only be executed if:
- OutputO1
is configured as Buzzer.
- "Buzzer with built-in generator" checkbox must be unticked!
*!BEEP 20,3,100,1000
Format | |
*!BEEP<s><count>,<group>,<interval>,<freq> |
|
Parameter | Description |
<s> |
parameter separator, space |
<count> |
Number of pulses in each group of pulses. If the value is >=32 the indication is continuous. |
<group> |
Number of groups in sound indication. |
<interval> |
Duration of the sound of the group in 1/128 of a second (1 = 8ms). |
<freq> |
Frequency of sound indication of each impulse (Hz). |
*@BEEP OK
Format | |
*@BEEP<s><result> |
|
Parameter | Description |
<s> |
parameter separator, space |
<result> |
Command processing result:OK - command executed;FAIL - command execution error. |
Command allows disabling an input so that no events are generated when it is triggered.
Action of the command is terminated after the command to enable this input or after the device is rebooted.
Command is not available for SMS.
*!OFF 2
Format | |
*!OFF<s><index> |
|
Parameter | Description |
<s> |
parameter separator, space |
<index> |
Index of disabled input (from 1 to 9). |
Format | |
Standard telemetry message *@C (description in Communication Protocol) |
|
Event Codes (full list) | |
45057 |
Blocking input No. 1 by command |
45058 |
Blocking input No. 2 by command |
45059 |
Blocking input No. 3 by command |
45060 |
Blocking input No. 4 by command |
45061 |
Blocking input No. 5 by command |
45062 |
Blocking input No. 6 by command |
45063 |
Blocking input No. 7 by command |
45064 |
Blocking input No. 8 by command |
45065 |
Blocking input No. 9 by command (accelerometer, SHx sensors) |
Command enableds an input if it was previously disabled by the command.
Command is not available for SMS.
*!ON 2
Format | |
*!ON<s><index> |
|
Parameter | Description |
<s> |
parameter separator, space |
<index> |
Index of enabled input (from 1 to 9). |
Format | |
Standard telemetry message *@C (description in Communication Protocol) |
|
Event Codes (full list) | |
45073 |
Unblocking input No. 1 by command |
45074 |
Unblocking input No. 2 by command |
45075 |
Unblocking input No. 3 by command |
45076 |
Unblocking input No. 4 by command |
45077 |
Unblocking input No. 5 by command |
45078 |
Unblocking input No. 6 by command |
45079 |
Unblocking input No. 7 by command |
45080 |
Unblocking input No. 8 by command |
45081 |
Unblocking input No. 9 by command (accelerometer) |
(switching SIM card)
Command allows forcefull changing (switching) of the active SIM card for devices with 2 SIM cards.
*!CHNGSIM
*@CHNGSIM 1->2
Format | |
*@CHNGSIM<s><x>-><y> |
|
Parameter | Description |
<s> |
parameter separator, space |
-> |
Separating characters |
<x> |
Current active SIM card:1 – SIM 1 (External),2 – SIM 2 (Internal). |
<y> |
SIM card to be switched to:1 – SIM 1 (External),2 – SIM 2 (Internal). |