Ruptela SMS Command List
Ruptela SMS Command List
1
Table of Contents
Table of Contents..............................................................................................................................................1
1. SMS Command List....................................................................................................................................... 3
1.1 1.1. SMS Commands......................................................................................................................... 6
1.1.1 1.1.1. accinfo.............................................................................................................................7
1.1.2 1.1.2. accreset...........................................................................................................................8
1.1.3 1.1.3. ahj-on/ahj-off.................................................................................................................. 9
1.1.4 1.1.4. authid............................................................................................................................11
1.1.5 1.1.5. banned.......................................................................................................................... 13
1.1.6 1.1.6. caninfo.......................................................................................................................... 14
1.1.7 1.1.7. cansinfo......................................................................................................................... 17
1.1.8 1.1.8. clear dtc........................................................................................................................ 20
1.1.9 1.1.9. clear obd....................................................................................................................... 21
1.1.10 1.1.10. connect....................................................................................................................... 22
1.1.11 1.1.11. coords......................................................................................................................... 23
1.1.12 1.1.12. delrecords................................................................................................................... 25
1.1.13 1.1.13. dfota............................................................................................................................26
1.1.14 1.1.14. dmpfconnect............................................................................................................... 29
1.1.15 1.1.15. doutreset.....................................................................................................................30
1.1.16 1.1.16. econnect..................................................................................................................... 31
1.1.17 1.1.17. enginevolt................................................................................................................... 32
1.1.18 1.1.18. forward........................................................................................................................33
1.1.19 1.1.19. get3g........................................................................................................................... 34
1.1.20 1.1.20. getapn......................................................................................................................... 36
1.1.21 1.1.21. getcfg...........................................................................................................................37
1.1.22 1.1.22. getdinmode.................................................................................................................39
1.1.23 1.1.23. getgfwver.................................................................................................................... 40
1.1.24 1.1.24. getio............................................................................................................................ 41
1.1.25 1.1.25. getioparam..................................................................................................................42
1.1.26 1.1.26. getlog/stoplog.............................................................................................................44
1.1.27 1.1.27. getnetw....................................................................................................................... 46
1.1.28 1.1.28. getsd........................................................................................................................... 47
1.1.29 1.1.29. gsminfo....................................................................................................................... 48
1.1.30 1.1.30. imei............................................................................................................................. 50
1.1.31 1.1.31. immobilizer................................................................................................................. 51
1
1.1.32 1.1.32. info.............................................................................................................................. 52
1.1.33 1.1.33. iqfinfo..........................................................................................................................56
1.1.34 1.1.34. iqfset........................................................................................................................... 57
1.1.35 1.1.35. lastchange................................................................................................................... 58
1.1.36 1.1.36. lcvselect...................................................................................................................... 59
1.1.37 1.1.37. modrev........................................................................................................................62
1.1.38 1.1.38. neconnect................................................................................................................... 63
1.1.39 1.1.39. nreset.......................................................................................................................... 64
1.1.40 1.1.40. optiver.........................................................................................................................65
1.1.41 1.1.41. reset............................................................................................................................ 66
1.1.42 1.1.42. set3g........................................................................................................................... 67
1.1.43 1.1.43. setcfg...........................................................................................................................69
1.1.44 1.1.44. setconnection..............................................................................................................71
1.1.45 1.1.45. setdinmode................................................................................................................. 73
1.1.46 1.1.46. setio............................................................................................................................ 74
1.1.47 1.1.47. setioparam.................................................................................................................. 76
1.1.48 1.1.48. setiotime..................................................................................................................... 79
1.1.49 1.1.49. setlcv........................................................................................................................... 82
1.1.50 1.1.50. setlock......................................................................................................................... 84
1.1.51 1.1.51. setnetw....................................................................................................................... 87
1.1.52 1.1.52. setvalue.......................................................................................................................89
1.1.53 1.1.53. snapshot......................................................................................................................91
1.1.54 1.1.54. ssl status......................................................................................................................93
1.1.55 1.1.55. switchip....................................................................................................................... 94
1.1.56 1.1.56. tacho........................................................................................................................... 95
1.1.57 1.1.57. tachostatus..................................................................................................................96
1.1.58 1.1.58. ussd............................................................................................................................. 97
1.1.59 1.1.59. version.........................................................................................................................99
1.1.60 1.1.60. webcoords.................................................................................................................100
1.2 1.2. SMS during Critical Processes................................................................................................ 102
1.3 1.3. Informational Messages and Alerts........................................................................................103
2
1. SMS Command List
Legal Information
Copyright © 2023 Ruptela. All rights reserved. Reproduction, transfer, distribution or storage of parts
or all of the contents in this document in any form without the prior written permission of Ruptela is
prohibited. Other products and company names mentioned in this document are trademarks or trade
names of their respective owners.
Document Application
The SMS commands can be used with all 4th and 5th generation tracking devices.
Document Changelog
Version Date Modification
2.0 2021-01-18 Updated: User manual structure and design.
2.1 2021-01-26 Updated: SMS commands lcvselect and setlcv.
Added: SMS command tachostatus.
2.2 2021-06-22
Updated: SMS command setvalue.
2.3 2021-08-12 Added: SMS commands ahj-on/ahj-off.
2.4 2021-11-05 Updated: SMS commands setvalue and info.
2.5 2021-11-26 Updated: SMS commands authid, immobilizer, info, setlock and ssl status.
2.6 2022-01-14 Added: SMS command dmpfconnect.
2.7 2022-02-18 Updated: SMS commands immobilizer, setlock and ssl status.
2.8 2022-04-04 Updated: SMS command gsminfo.
Updated: SMS commands getdinmode, getio, info, setdinmode and setvalue.
2.9 2022-05-20
Updated: Availability tables.
2.10 2022-10-03 Updated: SMS command tachostatus.
Updated: Added IMSI and ICCID parameters to the SMS command info.
2.11 2022-11-25 Updated: The SMS command immobilizer is now supported by HCV5/Pro5 Lite
devices.
2.12 2023-01-13 Updated: Fixed incorrect name of SMS command: from iqinfo to iqfinfo.
Updated: Added a reason for the response GPS is not available for the SMS
2.13 2023-01-16
command coords.
3
Updated: The SMS command setlock is now supported by HCV5 Lite/Pro5 Lite
2.14 2023-04-07
devices.
Notations
The following notations are used in this document to highlight important information:
Bold text
Used to indicate user interface elements or for emphasis.
Italic text
Used to indicate items that belong to a list and can be selected.
Note
Caution
Used to mark actions that require caution when handling the product.
Warning
Used to mark actions that may cause irreversible damage if performed incorrectly.
Tip
Availability table
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
Used to mark which devices support a given functionality. 4th generation device names are written
without the FM prefix.
BT – Bluetooth
4
CAN – Controller Area Network
FW – Firmware
GND – Ground
HW - Hardware
5
1.1 1.1. SMS Commands
The password, command and command text are separated by a space symbol. Command text
parameters are separated by a comma.
The password can contain up to 16 symbols and cannot match any SMS commands names. The
following symbols can be used:
· All digits (0-9)
· Letters A-Z (both lowercase and uppercase)
· Characters _, @, #, /, %, -
It is possible to include IDs in the SMS commands so that the server knows to which SMS command the
device responds. To do so, the Use ID in SMS commands functionality must be enabled in the
configuration. If the functionality is enabled, the ID must be included in all SMS commands, otherwise the
commands will not be processed.
The SMS command structure with the included ID: <password> <command> <command text> ID<ID
string>
Where:
The ID must be unique. If the device receives several SMS commands with the same ID, only
the first one will be processed.
6
1.1.1 1.1.1. accinfo
accinfo
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
This SMS command is used to check if the accelerometer is calibrated for the Eco-Drive and impact
detection functionalities.
Command Structure
SMS command structure: <password> accinfo
Response
Response structure: AXL state:<state> XYZo:<XYZo> Xc:<Xc> Yc:<Yc> Zc:<Zc>
XYZo, Xc, Yc, Zc – are the parameters used for accelerometer event calculations.
Response example: AXL state:11 XYZo:120 -39 -945 Xc:131 -92 -94 -7 Yc:-138 97 -96 16 Zc:953 120 -39
-945
7
1.1.2 1.1.2. accreset
accreset
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
This SMS command is used to reset the existing accelerometer (used for the Eco-Drive and impact
detection functionalities) calibration and initiate a new automatic calibration process. For calibration to be
successful, the Data Source of the Eco-Drive section in the advanced configurator should be set to
ACC, CAN+OBD, or OBD+ACC.
Command Structure
SMS command structure: <password> accreset
An additional parameter can be included in the SMS command to reset the calibration, initiate a new
automatic calibration process, and inform the user of the ongoing calibration status: <password>
accreset r
Responses
If the <password> accreset structure was used and calibration is successful: Acc reset OK
· If the conditions are correct to start calibration: Acc calibration initiated. Drive normally to
calibrate.
· If the conditions are incorrect: Configuration error.
· If the gravitational vector has been determined and acceleration events will be gathered: Up
direction found. Drive normally to finish calibration.
· The calibration process was finished successfully: Calibration successful.
8
1.1.3 1.1.3. ahj-on/ahj-off
ahj-on/ahj-off
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
The SMS command ahj-on is used to activate the Anti-hijack sequence and ahj-off is used to deactivate
it in accordance with the Anti-hijack workflow. For a more detailed description of the workflow and
mode functionality, refer to the Digital Output User Manual.
Command Structure
ahj-on SMS command structure: ahj-on <A>, <B>, <C>
Where:
<A> Activation speed, km/h
Range: 0–250
<B> Deactivation timeout, s
Range: 1–65000
<C> Reactivation timeout, s
Range: 0–65000
ahj-on SMS command structure: ahj-on *
When "*" is provided instead of the mentioned parameters, the corresponding values will be set from the
configuration.
ahj-off SMS command structure: ahj-off <A>, <B>
Where:
<A> Guaranteed unrestricted time period, s
Range: 0 - 65000 s
<B> Unconditionally initiate after the guaranteed unrestricted period expires.
Values: 0 – no, 1 – yes
Responses
If the ahj-on command is accepted: ahj-on OK.
If the ahj-off command is accepted: ahj-off OK.
9
If the ahj-on command is declined (the mode is not configured, invalid values, invalid structure):
ahj-on ERROR.
If the ahj-off command is declined (the mode is not configured, invalid values, invalid structure):
ahj-off ERROR.
10
1.1.4 1.1.4. authid
authid
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
*
This SMS command is used to add/remove IDs to/from the expanded list. Up to 4 IDs can be modified at a
time.
Command Structure
SMS command structure for adding the IDs: <password> authid add <ID1>, <ID2>, <ID3>, <ID4>
Where:
The ID length must be exactly 8 B or 16 B, as empty bytes will not be filled with zeros.
SMS command structure for deleting the IDs: <password> authid del <ID1>, <ID2>, <ID3>, <ID4>
Where:
Responses
If IDs were added successfully: add <ID1> OK <ID2> OK <ID3> OK <ID4> OK.
If IDs were deleted successfully: del <ID1> OK <ID2> OK <ID3> OK <ID4> OK.
If the device does not have enough memory for all IDs: Not enough memory.
If the ID cannot be deleted because it was not found in the ID list: Not found.
If the ID cannot be added because it was already found in the ID list: Already exists.
11
The same ID was entered in the authid command several times: Repeating IDs.
12
1.1.5 1.1.5. banned
banned
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
This SMS command is used to get information about temporarily banned operators.
Command Structure
SMS command structure: <password> banned
Response
Response structure: Already banned:<X>, Newly banned:<Y>, ops:<ZZZ>
Where:
<X> Number of times when the tracking device tried to ban operator which has
already been in the banned list.
<Y> Number of times when the tracking device added an operator in the
banned list.
13
1.1.6 1.1.6. caninfo
caninfo
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
This SMS command is used to get information about the settings of the CAN1 interface. These settings are
used to see the exact CAN1 interface setup in the configuration file (it does not necessarily reflect the
actual mode of operation).
Command Structure
SMS command structure: <password> caninfo
Response
Response structure: CAN enable: X Manufacturer Y Type Z Active A
Where:
· 0 – CAN is disabled
· 1 – CAN is enabled, FMS standard mode
· 2 – CAN is enabled, LCV mode
· 3 – CAN is enabled, OBD mode
· 4 – CAN is enabled, tachograph mode
· 1 – VAG
· 2 – Mercedes
· 3 – Citroen
· 4 – Ford
· 5 – Fiat
· 6 – Opel
· 7 – Renault
· 8 – Toyota
14
· 9 – FMS tractor
· 10 – Truck
· 11 – Hyundai
· 12 – Lexus
· 13 – Volvo
· 14 – BMW
· 15 – Nissan
· 16 – Honda
· 17 – Mitsubishi
· 18 – Subaru
· 19 – Chrysler
· 20 – Isuzu
· 21 – Ssanyong
· 22 – Mazda
· 23 – Komatsu
· 24 – Rangerover
· 25 – Claas
· 26 – SAAB
· 27 – Landrover
· 28 – Porsche
· 29 – Kia
· 30 – Jaguar
· 31 – Infiniti
· 32 – Linde
· 33 – Hitachi
· 34 – Suzuki
· 35 – Changan
· 36 – Brilliance
· 37 – Geely
· 38 – Chery
· 39 – FAW
· 40 – Lifan
· 41 – Mini
· 42 – Alfa Romeo
· 43 – Jeep
· 44 – Dacia
· 45 – Peugeot
15
· 46 – Dieci
· 0 – silent mode;
· 1 – active mode;
16
1.1.7 1.1.7. cansinfo
cansinfo
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
This SMS command is used to get information about the CAN1 and CAN2 interface settings of the tracking
device. These settings are used to see the exact dual CAN interface setup in the configuration file (it does
not necessarily reflect the actual mode of operation).
Command Structure
SMS command structure: <password> cansinfo
Response
Response structure: CAN1 enable: X Manufacturer Y Type Z Active A; CAN2 enable: X Manufacturer Y
Type Z Active A
Where:
· 0 – CAN is disabled
· 1 – CAN is enabled, FMS standard mode
· 2 – CAN is enabled, LCV mode
· 3 – CAN is enabled, OBD mode
· 4 – CAN is enabled, tachograph mode
· 1 – VAG
· 2 – Mercedes
· 3 – Citroen
· 4 – Ford
· 5 – Fiat
· 6 – Opel
· 7 – Renault
17
· 8 – Toyota
· 9 – FMS tractor
· 10 – Truck
· 11 – Hyundai
· 12 – Lexus
· 13 – Volvo
· 14 – BMW
· 15 – Nissan
· 16 – Honda
· 17 – Mitsubishi
· 18 – Subaru
· 19 – Chrysler
· 20 – Isuzu
· 21 – Ssanyong
· 22 – Mazda
· 23 – Komatsu
· 24 – Rangerover
· 25 – Claas
· 26 – SAAB
· 27 – Landrover
· 28 – Porsche
· 29 – Kia
· 30 – Jaguar
· 31 – Infiniti
· 32 – Linde
· 33 – Hitachi
· 34 – Suzuki
· 35 – Changan
· 36 – Brilliance
· 37 – Geely
· 38 – Chery
· 39 – FAW
· 40 – Lifan
· 41 – Mini
· 42 – Alfa Romeo
· 43 – Jeep
· 44 – Dacia
18
· 45 – Peugeot
· 46 – Dieci
· 0 – silent mode;
· 1 – active mode;
Response example: CAN1 enable: 2 Manufacturer 2 Type 1 Active 0; CAN2 enable: 2 Manufacturer 2 Type
1 Active 0.
19
1.1.8 1.1.8. clear dtc
clear dtc
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
This SMS command allows clearing J1939 and J1708 DTC codes from the memory of the tracking device.
Command Structure
SMS command structure: <password> clear dtc
Responses
If the command was performed successfully: DTC codes were cleared.
20
1.1.9 1.1.9. clear obd
clear obd
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
This SMS command is used to clear all OBD-related data from the device memory (not configuration).
Command Structure
SMS command structure: <password> clear obd
Response
If the command was performed successfully: OBD parameters and DTC cleared.
21
1.1.10 1.1.10. connect
connect
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
This SMS command is used to force the tracking device to connect to a server with the custom IP, port,
and protocol settings. The tracking device creates a dummy record just with the header part.
Command Structure
SMS command structure: <password> connect <IP>,<Port>,<Protocol>
Where:
<Protocol> The principle of communication. There are two available protocols: TCP
and UDP.
Command Example
SMS command example: <password> connect 192.168.0.1,7011,TCP
Responses
If the connection was successful: connection data ok.
22
1.1.11 1.1.11. coords
coords
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 HCV Tco4 LCV Eco4 Eco4 S/T Plug4
Pro4
Pro5 Lite
This SMS command is used to get the current GPS status and coordinates.
Command Structure
SMS command structure: <password> coords
Responses
Response structure: <time>, lat. <latitude>, long. <longtitude>, alt. <altitude>, sat. <satellites>, dir.
<angle>, hdop <hdop>, state <X>
Where:
Response example: 2013-04-24 07:01, lat. 46.1443183, long. 11.881766, alt. 217.5, sat. 8, dir. 198.10,
hdop 100, state 3.
23
If the device has no valid timestamp obtained from the GNSS and/or network, the response will instead
be: GPS is not available.
24
1.1.12 1.1.12. delrecords
delrecords
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
This SMS command is used to delete all records from the internal flash memory of the tracking device.
Command Structure
SMS command structure: <password> delrecords
Response
Response example: all records deleted.
25
1.1.13 1.1.13. dfota
dfota
5th Generation Devices 4th Generation Devices
Trace HCV LCV Pro5 HCV5 Tco4 Tco4 Eco Eco4 Plug4
5 5 5 HCV LCV 4 S/T
Lite
Pro4
Pro5
Lite
This SMS command is used to update the modem firmware for 3G and LTE Cat M1 devices. The firmware
file is in a diff format, so the device updates are only the differences between the new and current
firmware. Therefore, the current and target modem firmware version have to be known before the
update.
The modem firmware file must be placed in an FTP or HTTP server before the update.
26
The total SMS command length with the password, command name, and link to the file
cannot be longer than 160 symbols.
Command Structure
Command structure when updating via an FTP server:
Where:
<user_name> String type, the user name for authentication. The maximum size of the
parameter is 50 visual symbols.
<password> String type, the password for authentication. The maximum size of the
parameter is 50 visual symbols.
< server_URL > String type, the IP address or domain name of the FTP server. The
maximum size of the parameter is 50 visual symbols.
<port> Integer type, the port of the FTP server. The range is 1 – 65535.
Typical value: 21.
<file_path> String type, the file name in the FTP server. The maximum size of the
parameter is 50 visual symbols.
Where:
<http_server_URL > String type, the IP address or domain name of the HTTP server.
<http_port> Integer type, the port of the HTTP server. The range is 1 – 65535.
Typical value: 80.
<http_file_path > String type, the file name in HTTP server
Command Example
If the firmware is updated via an FTP server:
Responses
If the modem update was started successfully: Modem FW update process started. Check modem FW
version with "modrev" command later.
If the modem firmware is updated successfully: Modem FW update process successful. Current modem
version: xx.
If the modem firmware update is failed: Modem FW update process FAILED. Error code: xx
If the update was performed for a 2G modem: ERROR: DFOTA FW update NOT supported on this modem.
If the minimum link requirements are not met: ERROR: link string too short.
If something is wrong with the command syntax: ERROR: wrong command syntax.
If the update process was started previously: ERROR: DFOTA FW update process already started.
28
1.1.14 1.1.14. dmpfconnect
dmpfconnect
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
*
This SMS command is used to immediately connect the device to DMP without waiting for the configured
connection frequency. See the Device Management Platform (DMP) User Manual for more information.
Command Structure
SMS command structure: <password> dmpfconnect
Response
If the command was performed successfully: OK.
Once the response is received, the device will attempt to immediately connect to DMP. If there are any
update commands pending for that device – these commands will start executing after the device
establishes a connection with DMP.
29
1.1.15 1.1.15. doutreset
doutreset
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
Command Structure
SMS command structure: <password> doutreset
Responses
If the command was performed successfully: DOUT activation mechanism was reset.
If DOUTs are not active at the time: DOUT activation mechanism is inactive.
If the DOUT activation with conditions functionality is not configured: DOUT activation is not
configured.
30
1.1.16 1.1.16. econnect
econnect
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
This SMS command is used to force the tracking device to connect to a server with custom APN, user,
password, IP, port, and protocol settings. The tracking device creates a dummy record just with the
header part.
Command Structure
SMS command structure:
Where:
<apn> The APN name. This parameter is mandatory for most SIM cards. Consult
with your SIM card provider for more information.
<apnLogin> User name for the APN settings.
<apnPassword> Password for the APN settings.
<IP> 32-bit number, commonly known as an Internet Protocol address
(xxx.xxx.xxx.xxx).
<Port> 16-bit number, commonly known as the port number (xxxxx).
<Protocol> The principle of communication. There are two available protocols: TCP
and UDP.
Command Example
SMS command example: password econnect apn,apnlogin,apnpassword,192.168.0.1,7011,TCP
Responses
If the connection was successful: Emergency connection data ok.
31
1.1.17 1.1.17. enginevolt
enginevolt
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
This SMS command is used to automatically measure the engine power voltage upper level when the
engine is on, and the lower level, when the engine is off. With these voltage levels, the device will
automatically detect when the engine is on, and when it is off.
Command Structure
SMS command structure: <password> enginevolt
Responses
If the message structure is wrong: Unknown command.
32
1.1.18 1.1.18. forward
forward
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
This SMS command allows forwarding an SMS via the tracking device.
The total length of the whole command with text may not exceed 160 symbols.
Command Structure
SMS command structure: <password> forward <phone_number> <text>
<phone_number> must not contain 0 or + in the beginning of the number (Not +370 or 00370, but 370).
Responses
If the SMS message is forwarded: SMS-Forward OK.
33
1.1.19 1.1.19. get3g
get3g
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
This SMS command is used to get information about whether the tracking device is connected to the 3G or
GSM network or not.
Command Structure
SMS command structure: <password> get3g
Responses
Response format: <mode status> 3G mode, connected to <network> (<X>-profile)
· automatic
· disabled
· enabled
· 3G
· GSM
· 1
· 2
· 3
· 4
If the device has enabled 3G and the status is OK. For all examples, the current profile is 3: enabled 3G
mode, connected to 3G (3-profile)
If the device has enabled 3G but it is not connected to the 3G network: enabled 3G mode, connected to
GSM (3-profile)
34
If the device has disabled 3G: disabled 3G mode, connected to GSM (3-profile)
If the device has automatic selection 3G and it is working in 3G: automatic 3G mode, connected to 3G (3-
profile)
If the device has automatic selection 3G and it is working in GSM: automatic 3G mode, connected to GSM
(3-profile)
If the HW version does not support 3G: Get3G: hw does not support 3G
35
1.1.20 1.1.20. getapn
getapn
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
This SMS command is used to get the APN, username, password, IP, port, and protocol settings from the
tracking device.
Command Structure
SMS command structure: <password> getapn
Response
Response example: APN: banga User: PSW: IP1: 92.62.134.38 Port1: 9021 IP2: 195.14.173.3 Port2:
9000 TCP/UDP: 0.
If the response text is very long, it might not fit into a single message and be cropped.
36
1.1.21 1.1.21. getcfg
getcfg
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
This command is only used to get the current status of the selected parameters.
The amount of maximum simultaneously received parameters in one SMS message is limited.
Complete answer: 125 symbols. Incomplete answer: 105 symbols.
Command Structure
SMS command structure: <password> getcfg <ParamID1>,<ParamID2>,<ParamID3>…
Where:
Responses
When the parameter ID is correct: ID: XXX,value:XXX.
Parameter configuration password and SMS password is not available with this SMS: ERROR:
parameter(s) read is forbidden
37
If the SMS configuration is disabled in the configurator tool: You do not have permission to change the
settings.
If the response does not fit in the SMS message, then in the end there will be a phrase: other
values not fit.
38
1.1.22 1.1.22. getdinmode
getdinmode
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
This SMS command allows receiving information on the configuration of the specified DIN. This applies
only to configurable DINs.
Command Structure
SMS command structure: <password> getdinmode <DIN#>
Command Example
SMS command example: password getdinmode 3
Responses
If DIN is in the positive mode: DIN# - positive mode.
If DIN is not available for the tracking device: Configurable DIN functionality is not available for your HW
version.
39
1.1.23 1.1.23. getgfwver
getgfwver
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
Only Eco4
S
This SMS command is used to check if the GNSS module firmware is updated.
Command Example
SMS command example: <password> getgfwver
Responses
Response example if the GNSS module firmware has been updated to the latest version:
AXN_5.1.6_3333_19010200,0002,MC60-GNSS,1.0*00.
If the update was performed on other devices: Not applicable for this device.
40
1.1.24 1.1.24. getio
getio
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
This SMS command is used to get the values/statuses of the inputs and outputs.
Command Structure
SMS command structure: <password> getio
Response
Response structure:
DIN1=<X>,DIN2=<X>,DIN3=<X>,DIN4=<X>,DOUT1=<X>,DOUT2=<X>,DOUT3=<X>,DOUT4=<X
>,AIN1=<Y>,AIN2=<Y>,AIN3=<Y>,AIN4=<Y>
· 0 – low
· 1 – high
DIN1=0,DIN2=1,DIN3=1,DIN4=1,DOUT1=0,DOUT2=0,DOUT3=0,DOUT4=0,AIN1=24210,AIN2=2860
0,AIN3=18600,AIN4=28600
DIN1=0,DIN2=1,DIN3=1,DOUT1=0,DOUT2=0,AIN1=24210,AIN2=28600
DIN1=0,DIN2=1,DIN3=1,DIN4=1,DOUT1=0,DOUT2=0,AIN1=24210,AIN2=28600
41
1.1.25 1.1.25. getioparam
getioparam
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
This command is used to get the current status of the selected IO parameter.
Where:
Responses
Response example, if the IO parameter was enabled:
id=65,profile=2,enable=1,level=0,delta=0,average=1000,eventon=2,include=0,priority=0,switch=0,ed
ge=0
If the SMS configuration is disabled in the configurator tool: You do not have permission to change the
settings.
ERROR: more than one I/O parameter with same ID was found;
42
ERROR: wrong request syntax.
43
1.1.26 1.1.26. getlog/stoplog
getlog/stoplog
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
The getlog command is used to initiate the logging process. The stoplog command is used to stop the log
sending to a server. When the device gets the getlog command, it should open a link with the defined
server and send the log according to the defined mode. All other tracking device processes (e.g. records
sending, peripheral device communication) will keep working. Only a device restart can stop the log data
sending process.
The log will be sent as ASCII. The log starts from device type HCV/LCV/PRO, selected mode, defined time,
bootloader version, firmware version, hardware version, GSM signal level, and Voltage status: 0 – lower
than 8 Volts (bad), 1 – higher than 8 Volts (OK) and device IMEI.
Command Structure
getlog SMS command structure: <password> getlog <IP>,<Port>,<Mode>,<Time>
Where:
<Time> The time period for log sending. Defined in minutes. Range: 1-60
minutes.
Command Example
getlog SMS command example: password getlog 100.101.102.103,1111,1,15
44
Responses
If getlog SMS format is correct: getlog ok
If the logging proces is already running, the device will respond: getlog already running
When device gets the stoplog command and log sending is in progress, it should stop sending log to a
server and reply: stoplog ok
If device gets the stoplog command and the log is not running: getlog already stopped
In some cases, remote debug might have to log the data about many different events and
processes. This would force remote debug to generate large internal data streams and the
device might not be able to send it all via GPRS. This might lead to data loss.
45
1.1.27 1.1.27. getnetw
getnetw
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
This SMS command is used to get information about the cellular network type.
Command Structure
SMS command structure: <password> getnetw
Responses
Response structure: <network mode> connected to <network> <profile>
Response example if the device is set to automatic network selection and is connected to 2G in Profile 1:
automatic mode, connected to 2g (1-profile).
46
1.1.28 1.1.28. getsd
getsd
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
This SMS command is used to get information about an SD card, inserted into the tracking device.
Command Structure
SMS command structure: <password> getsd
Responses
Response structure, if the SD card is inserted and used for records: Using SD Card for Records. Size:
<sector_count x sector_size> B, H: <SDrecordHead>, T: <SDrecordTail>.
Response structure, if the SD card is inserted and used for log: Using SD Card for Log and working OK.
Size: <sector_count x sector_size> B, H: <SDrecordHead>, T: <SDrecordTail>.
Response structure, if the SD card is inserted and used for log, but some errors occurred: Using SD Card
for Log but ERROR. Size: <sector_count x sector_size> B, H: <SDrecordHead>, T: <SDrecordTail>.
Where:
47
1.1.29 1.1.29. gsminfo
gsminfo
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
This SMS command is used to get mobile network and GPRS information.
Command Structure
SMS command structure: <password> gsminfo
Response
Response structure: ST:<st>; OP <op>,lvl <lvl>,LAC <lac>, CID: <cid>, <network>; M:<m>, R <r>,
SP: <sp>; GPRS <gprs>:O <o>,C <c>, E <e>; LK: O<y>, E <x>, TMO <tmo>; RS: <rs>; P <p>
Where:
Start time. Date & time (GMT) from the last tracking device reset/power
<st>
ON.
GSM network
<lac> Location Area Code. 16 bit number thereby allowing 65536 location areas
within one GSM PLMN.
<cid> Cell ID. Generally unique number used to identify each BTS or sector of a
BTS.
<network> Current network mode. There are three possible values: GSM, 3G, and
LTE.
<i> Initialization. The number of times when the tracking device has tried to
initialize modem since the start time.
<r> The number of resets of the modem since the start time.
<sp> Status pin. The number of times when the modem was turned ON and
turned OFF unsuccessfully.
48
General Packet Radio Service. Status of GPRS. There are two possible
values:
<gprs>
0 – no GPRS
1 – attached to GPRS
<o> The number of opened GPRS sessions.
<c> The number of closed GPRS sessions.
<e> The number of GPRS errors.
Link with server (LK)
<y> The number of opened links.
<x> The number of link errors.
<tmo> The number of server response timeout.
<rs> Device last reset source.
<p> GPRS protocol version. It can have the following values:
0 – standard protocol
1 – extended protocol
Response example: ST:2013.04.20 23:26:33; OP 22210,lvl 15,LAC 20030, CID: 28289, GSM; M:I 126, R
125, SP: 0; GPRS 0:O 64,C 0, E 248; LK:O 575, E 1, TMO 126; RS: 04; P 0
49
1.1.30 1.1.30. imei
imei
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
Command Structure
SMS command structure: <password> imei
Response
Response example: IMEI: 863071016796615
50
1.1.31 1.1.31. immobilizer
immobilizer
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
*
* – not available with the initial firmware release for Trace5-2G, Trace5-LTE, and Trace5-LTM (Rev.A).
Command Structure
SMS command structure: <password> immobilizer <speed>
Where:
<speed> – describes the vehicle speed at which the progressive DOUTs must be toggled. Only number
from 1 to 250 can be sent.
Responses
If the command was performed successfully: Immobilizer OK.
51
1.1.32 1.1.32. info
info
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
This customizable SMS command with a configurable set of parameters can be used to get some specific
information from the tracking device via SMS.
Command Structure
SMS command structure: <password> info <param1>;<param2>;<param3;>[...];<paramN>
ain2 following:
ain3 · 0 – low.
ain4
din1
· 1 – high.
din2 The analogue inputs are in millivolts.
din3
Note: The response will contain only the values of requested
din4
dout1 parameters.
dout2
dout3
dout4
alt Current altitude.
apn APN name.
apnp APN password.
apnu APN username.
bat Returns battery voltage in millivolts.
bleapp BLE App version.
blebl BLE BL version.
blemac BLE MAC address.
blesd BLE SD version.
blest BLE status.
blver Bootloader version.
cid GSM Cell ID.
Current latitude and longitude, separated by a comma.
coords Note: The device will respond with GNSS data not available if there will be
no GNSS fix.
52
dir Current angle
eng Current engine state. Possible values:
· 0 – OFF
· 1 – ON
extver (For HCV5 Lite/Pro5 Lite) Extender firmware version.
extstat (For HCV5 Lite/Pro5 Lite) Extender status.
(For Trace5-2G and Trace5-LTM (Rev.A)) Currently used partition
fpart
number
fwver Firmware version.
get3g Information about the connection to the 3G or GSM network.
gmap Hyperlink to Google maps with coordinates: latitude and longitude.
gprs Status of GPRS. Possible values:
· 0 – no GPRS
· 1 – attached to GPRS
gprsc The number of closed GPRS sessions.
gprse The number of GPRS errors.
gprso The number of opened GPRS sessions.
gps Current GNSS state. Values:
· 1 – off
· 2 – on no fix
· 3 – on got fix
· 4 – not responding
· 5 – sleep
· 6 – disabled
gsmlvl GSM signal level.
hdop Current HDOP level.
hwid HW identifier.
hwver Hardware version.
iccid SIM card's ICCID.*
imei Device IMEI number.
imsi SIM card's IMSI.*
io[xxxxx] Specific IO current value.
[xxxxx] – IO ID number.
Note: Values can be retrieved only for configured IO parameters.
Note: For multi-part IO elements, firstly the IO ID should be requested.
ip1 IP1 address and port number.
ip2 IP2 address and port number.
lac Location Area Code.
lke The number of link errors.
lko The number of opened links.
lktmo The number of server response timeout.
modi The number of times when the tracking device has tried to initialize the
modem since the start time.
modr The number of modem resets since the start time.
modrev Used to get modem revision information.
53
modsp The number of times when the modem was turned ON and turned OFF
unsuccessfully.
op GSM operator number
p GPRS protocol version. Possible values:
· 0 – standard protocol;
· 1 – extended protocol.
prot Currently set protocol:
· 0 – TCP
· 1 - UDP.
pwr Returns power supply voltage in millivolts.
Denotes, whether the device is in rescue mode:
Command Examples
SMS command examples:
Responses
Response examples:
4075;213.9;11659;0x4C5455313233343536373839303132333400000000000000;54.7412916,25.2
27750.
54
2016-12-13 12:40:30;865789021340700;0;11691.
If the response is longer, then the device will send maximum 157 characters of response plus # symbol
and two digits that show, which tag was last in the reply counting from the beginning:
https://www.google.com/maps/?q=54.7413016,25.2227550;54.7413016,25.2227550;0x4C5455313233
343536373839303132333400000000000000;11659;2016-12-13 11:20:02;#05.
If some requested IO is not enabled in configuration or some tag is unknown, then the device will respond
with NA: 2016-12-13 12:41:57;865789021340700;0;NA;NA
55
1.1.33 1.1.33. iqfinfo
iqfinfo
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 HCV Tco4 LCV Eco4 Eco4 S/T Plug4
Pro4
Pro5 Lite
This SMS command is used to obtain the values of various iQFreeze parameters.
Command Structure
SMS command structure: <password> iqfinfo
Response
The response includes the following parameters:
· Refrigerator serial number;
· Trailer serial number;
· Device serial number;
· Device FW version;
· Device BT name;
· Current time and date (UTC);
· Vehicle registration number.
If an error occured, the tracking device will send the following response: Communication error
56
1.1.34 1.1.34. iqfset
iqfset
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
This SMS command is used to manage refrigerator set-point temperature values and configuration.
Command Structure
SMS command structure: <password> iqfset <setpoint>,<cycle mode>
Where:
<setpoint> has the value range from -99.9 to 99.9. A dot must be used as the delimiter symbol.
Any of the parameters can be omitted, then only the provided parameters will be changed.
Response
If an incorrect symbol or value is included in the command, or no value is included: Syntax error.
57
1.1.35 1.1.35. lastchange
lastchange
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
This SMS command is used to get information about when the last time the device configuration or
primary server IP was changed.
The date and time of the configuration change will be updated during any type of configuration
modification.
When the device is connecting to GPRS and tries to open a link (with different IP settings), the
date and time of the IP change will be updated. When the device reconnects to a server with the
same IP but a different port, the date and time of the IP change will not be updated.
The latest changes are tracked when the internal device clock is synchronized (upon GNSS
fix, synchronizing with an NTP server, or connecting to a mobile network).
Command Structure
SMS command structure: <password> lastchange
Responses
Response example: lastchange ip: 2015-11-09, 09:02; cfg: 2015-11-09, 10:02
If the device configuration and server settings were never changed: lastchange ip: no time available; cfg:
no time available
58
1.1.36 1.1.36. lcvselect
lcvselect
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
This SMS command is used to automatically select a correct LCV group and LCV subgroup combination.
The LCV Autoselect functionality reads and analyses the CANbus line data, then searches for a match
within its LCV profile database and selects the best possible configuration.
The following parameters are considered as high importance, which has greater significance during the
auto-selection process and can be included into the SMS command: Fuel, Vehicle distance, RPM, Wheel
based speed. Additionally, you can add an optional parameter to enable all possible IOs for the selected
LCV group on the active profile, after the process of LCV group selection is complete.
For the 4th generation devices, tick the Enable I/Os checkbox in the advanced configurator
before sending the SMS command.
Enough free IO slots must be available (the needed number varies, depending on the vehicle).
Activation
The LCV Autoselect functionality works only with light vehicles. Also, the Active CAN mode is
unavailable and as a result, Toyota, Truck, Tractor, Claas and Komatsu LCV groups are excluded
from the selection process.
59
The LCV Autoselect functionality does not guarantee that all supported CAN IO parameters for
the selected LCV group and subgroup will be available for a specific vehicle.
Command Structure
SMS command structure: <password> lcvselect <distance>,<RPM>,<enableIO>
Where:
The enableIO parameters can be enabled only in the active profiles. These parameters might
interfere with the IO list configuration.
Command Examples
SMS command example: password lcvselect 10200,900,1
Other examples:
If you do not want to send distance and RPM values via SMS: password lcvselect ,
If you want to send only the RPM value: password lcvselect ,RPM
If you want to send only the vehicle distance value: password lcvselect distance,
If you do not want to send distance and RPM values via SMS, but enable automatic IO selection: password
lcvselect ,,1
Responses
60
If the SMS structure is correct and the LCV autoselect process started successfully:: LCV auto selection is
in progress.
If the current tracking device configuration is incompatible with the LCV autoselect feature: Wrong CAN
configuration.
If the LCV Autoselect functionality should be restarted: LCV autoselection not started, try again.
If currently a critical process is running in the tracking device: Waiting for LCV autoselection start.
If the distance and/or RPM values received via SMS are out of the accepted range: Parameters are out of
ranges.
If the LCV autoselect task ended, but it failed to find matches in the database: No valid matches were
found.
If a group is selected, but there are not enough free IO slots to enable all the autoselect IOs: Configured
group: <Group>/<Subgroup>,can1 ch:<number>, can2 ch:<number>,ERR: Not enough I/O slots.
If the protocol v1.1 was not enabled prior to the SMS command: Configured group:
<Group>/<Subgroup>, Error: old I/O protocol is used.
61
1.1.37 1.1.37. modrev
modrev
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
Command Structure
SMS command structure: <password> modrev
Responses
Response structure: Modem revision: <info>
Response examples:
62
1.1.38 1.1.38. neconnect
neconnect
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
Only Eco4
T devices
This SMS command is used to initiate the connection to a server once, using connection settings in the
SMS command. The tracking device does not send any responses to this command.
Command Structure
SMS command structure:
Where
<APN> Access Point Name (APN) is the name of a gateway between a GPRS (or
3G, etc.) mobile network and another computer network, frequently the
public Internet.
<APNLogin> User name for the APN settings.
<APNPassword> Password for the APN settings.
<IP> 32-bit number, commonly known as an Internet Protocol address
(xxx.xxx.xxx.xxx).
<Port> 16-bit number, commonly known as the port number (xxxxx).
<Protocol> The principle of communication. There are two available protocols: TCP
and UDP.
63
1.1.39 1.1.39. nreset
nreset
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
Only Eco4
T devices
This SMS command is used to initiate the restart of the tracking device. The tracking device does not send
any responses to this command.
Command Structure
SMS command structure: <password> nreset
64
1.1.40 1.1.40. optiver
optiver
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
This SMS command is used to request the version of the OptiTemp device.
Command Structure
SMS command structure: <password> optiver
Responses
Response example: Version: TMS X2 V2.100
65
1.1.41 1.1.41. reset
reset
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
After sending this SMS command, the device will reboot, but its configuration parameters will not
be lost.
Command Structure
SMS command structure: <password> reset
Response
Response example: Resetting device.
66
1.1.42 1.1.42. set3g
set3g
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
This SMS command is used to set the tracking device to connect to the 3G or GSM network.
Command Structure
SMS command structure: <password> set3g <X>
· 0 – disabled
· 1 – enabled
· 2 – automatic
Command Example
SMS command example: password set3g 1
Responses
Response structure: 3G <modestatus> mode set <setstatus> (<Y>-profile)
· automatic
· disabled
· enabled
· OK
· FAIL
· 1
67
· 2
· 3
· 4
If the device could not enable the 3G network: 3G enabled mode set FAIL (1-profile).
If the device could not disable the 3G network: 3G disabled mode set FAIL (1-profile).
If the device changed to the automatic connection to the 3G network: 3G automatic mode set OK (1-
profile).
If the device could not change to the automatic connection to the 3G network: 3G automatic mode set
FAIL (1-profile).
If the HW version does not support the 3G network: Set3G: hw does not support 3G.
68
1.1.43 1.1.43. setcfg
setcfg
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
The setcfg command allows you to change all parameters, except timetable, passwords, Enable SMS
configuration functionality, and geozone points.
Prior to sending the SMS command, you must enable the Enable SMS configuration checkbox
in the Authorized numbers section.
Command Structure
SMS command structure: <password> setcfg <ParamID1> <Value1>, <ParamID2> <Value2>,
<ParamID3> <Value3>…
Where:
Command Example
password setcfg 100 0 — this SMS command will set the protocol to TCP.
password setcfg 111 123.000.111.222, 121 13242 — this SMS command will set IP2 to 123.000.111.222
and IP2 port number to 13242.
Responses
If parameters are set successfully: Configuration parameter(s) was set!
If the parameters were set incorrectly: Configuration parameter(s) was NOT set! Parameter No. X is
incorrect.
69
If the setup is unsuccessful and the parameters are locked: Configuration parameter(s) was NOT set!
Parameter No. X is locked.
If not every setting was provided in the SMS command: Configuration parameter(s) was NOT set! IO slot
No. 9 is not fully set.
If the device is busy: Configuration parameter(s) was NOT set! Device is busy try again later.
If SMS configuration is disabled in the configurator or the configuration has a password: You do not have
permission to change the settings.
70
1.1.44 1.1.44. setconnection
setconnection
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
This SMS command is used to permanently change the tracking device configuration settings: APN, APN
username, APN password, protocol, IP1, Port1, IP2, and Port2
Command Structure
SMS command structure: <password> setconnection
<apn>,<apnlogin>,<apnpassword>,<Protocol>,<IP1>,<Port1>,<IP2>,<Port2>
Where
<APN> Access Point Name (APN) is the name of a gateway between a GPRS (or
3G, etc.) mobile network and another computer network, frequently the
public Internet.
<APNLogin> User name for the APN settings.
<APNPassword> Password for the APN settings.
<IP1> <IP2> 32-bit number, commonly known as an Internet Protocol address
(xxx.xxx.xxx.xxx).
<Port1> <Port2> 16-bit number, commonly known as the port number (xxxxx).
<Protocol> The principle of communication. There are two available protocols: TCP
and UDP.
Command Example
SMS command example:
If one of the parameters should be preserved, then the the parameter should be filled with *old*. For
example, IP1 and port1 should be preserved (old value should remain):
If you do not require to change the IP2 and port2, then leave these parameters empty: password
setconnection apn,apnlogin,apnpass,TCP,111.111.111.111,1111
71
Responses
If the configuration is ok: Set connection data ok
72
1.1.45 1.1.45. setdinmode
setdinmode
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
This SMS command allows to set the DIN mode (Positive mode or Negative mode) for configurable DINs.
Command Structure
SMS command structure: <password> setdinmode <din#> <mode>
Where <din#> – can have the following values:
· 1 – selects DIN1;
· 2 - selects DIN2 (Trace5 only, excluding the pre-revision variants)
· 3 – selects DIN3;
· 4 – selects DIN4;
Command Example
SMS command example: password setdinmode 3 1
Responses
If DIN# was set to ground (negative) mode: DIN mode set: DIN# - ground mode;
If DIN# was set to positive mode: DIN mode set: DIN# - positive mode;
If the device does not support the configuration of DINs or the wrong DIN mode is specified, the following
responses can be received:
73
1.1.46 1.1.46. setio
setio
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
Command Structure
SMS command structure for HCV5/LCV5/Pro5 devices: <password> setio <X1>,<X2>,<X3>,<X4>
Where:
· 0 – low
· 1 – high
· 2 – do not change
Command Example
SMS command example for HCV5/LCV5/Pro5 devices: password setio 0,1,1,2.
74
Responses
If the configuration was set successfully: SETIO configuration data ok.
75
1.1.47 1.1.47. setioparam
setioparam
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
The setioparam command is only used for the IO parameters setup. You can use it, when it is not required
to modify global parameters, such as APN settings, connection settings, etc.
Command Structure
SMS command structure: <password> setioparam
id=<id>,profile=<profile>,enable=<enable>,level=<level>,delta=<delta>,average=<average>,event
on=<eventon>,include=<include>,priority=<priority>,switch=<switch>,edge=<edge>
Where:
<profile> Profile, where the parameter is enabled. The values can be the
following:
· 1 – Profile 1
· 2 – Profile 2
· 3 – Profile 3
· 4 – Profile 4
<enable> Enables or disables the parameter. The values can be the following:
· 0 – disabled
· 1 – enabled
<level> Sets a reference value.
<delta> Sets a maximum possible value deviation from the reference value.
<average> Period of averaging values in ms.
<eventon> Defines the logic of when an IO parameter is generated. The values can
be the following:
· 0 – Hysteresis
· 1 – Change
· 2 – Monitoring
76
<include> Includes the parameter value in records only when the Change or
Hysteresis condition is met. The values can be the following:
· 0 – not include data only on event
· 1 – include data only on event
<priority> Determines the importance of IO parameter value changes. The values
can be the following:
· 0 – Low
· 1 – High
<switch> Switches to another profile, if the Change or Hysteresis condition is met.
The values can be the following:
· 0 – no switch
· 1 – Profile 1
· 2 – Profile 2
· 3 – Profile 3
· 4 – Profile 4
<edge> Only applicable for the Hysteresis condition. Defines on which hysteresis
edge IO parameter has to be generated. The values can be the
following:
· 0 — On Both
· 1 — On Rising
· 2 — On Falling.
Command Example
password setioparam
id=29,profile=4,enable=1,level=12700,delta=1000,average=1000,eventon=0,include=1,priority=0,swi
tch=0,edge=0 - this SMS command enables IO parameter ID 29 (Power supply voltage) in Profile 4 with
reference level 12700 mV, delta 1000 mV, averaging 1000 ms. Event on is set to Hysteresis, the data will
be included only on event and priority is low. There is no switch to another profile and edge is set On Both.
password setioparam id=30,profile=4,enable=1 – this SMS command is the shortest possible. It enables
IO parameter ID 30 (Battery voltage) in Profile 4.
77
If the SMS command does not define new values for delta, average, eventon, include, priority, switch,
edge, then old values for these parameters will remain. If the setup is completely new, then these values
will be set to default:
0 0 1000 2 0 0 0 0
Responses
If the IO parameter was set correctly: setioparam OK slot: XX.
If the IO profile is not entered: setioparam ERROR, I/O profile field is mandatory.
If the IO profile is too long: setioparam ERROR, I/O profile field limits exceed.
If the IO enable is not entered: setioparam ERROR, I/O enable field is mandatory.
If the IO enable is too long: setioparam ERROR, I/O enable field limits exceed.
If the SMS command is too long: setioparam ERROR, I/O parameter limits exceed.
If the SMS command is not written correctly: setioparam ERROR, wrong request syntax.
If all slots are full: setioparam ERROR, no free slots for set the I/O.
If the tracking device finds more than one IO parameter with the same ID: setioparam ERROR, more than
one I/O with the same ID.
If a parameter was supposed to be disabled and it is not enabled: setioparam ERROR, parameter is
already disabled.
If the SMS configuration is disabled in the configurator tool: You do not have permission to change the
settings.
78
1.1.48 1.1.48. setiotime
setiotime
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
This SMS command allows the tracking device to switch DOUT for a temporary period. After this
command is completed, the tracking device stores the DOUT status. If several commands are sent after
each other, then an interruption will occur and the state will then be undefined.
If you will send several commands in a row too fast, the DOUT will get stuck and the tracking
device will need to be restarted. We highly recommend you to wait at least until a response is
received for the first sent command, before sending the next.
The minimum impulse resolution is 10 ms and the minimum duration is 10 ms. If the Eco-panel is
connected, the minimum resolution and duration is 50 ms.
Command Structure
SMS command structure: <password> setiotime <X1> <DOUT1_time1> <Y1> <DOUT1_time2>,<X2>
<DOUT2_time1> <Y2> <DOUT2_time2>,<X3> <DOUT3_time1> <Y3> <DOUT3_time2>,<X4>
<DOUT4_time1> <Y4> <DOUT4_time2>
Where:
<XN> DOUTN first logical state. The values can be the following:
· 0 – GND
· 1 – no GND
< DOUTN_time1> DOUTN first logical state length. The value can be up to 999 999 999
ms.
<YN> DOUTN second logical state. The values can be the following:
· 0 – GND
79
· 1 – no GND
< DOUTN_time2> DOUTN second logical state length. The value can be up to 999 999 999
ms.
SMS command structure, when there is a repetitive amount of sequences: <password> setiotime <X1>
<DOUT1_time1> <Y1> <DOUT1_time2> n=<Z>,<X2> <DOUT2_time1> <Y2> <DOUT2_time2>
n=<Z>,<X3> <DOUT3_time1> <Y3> <DOUT3_time2> n=<Z>,<X4> <DOUT4_time1> <Y4>
<DOUT4_time2> n=<Z>
Command Example
SMS command example: password setiotime 1 500 0 500,0 200 1 300,0 500 1 600,1 700 0 800
SMS command example with a repetitive amount of sequences: password setiotime 1 500 0 500 n=10,0
200 1 300 n=20,0 500 1 600 n=30,1 700 0 800 n=40
SMS command example for set DOUT3: password setiotime ,,1 500 0 500
SMS command example for set DOUT4: password setiotime ,,,1 500 0 500
Responses
If everything is ok: setiotime set OK.
If configuration SMS is incorrect, the device will respond with: setiotime syntax error in DOUTN settings:
error text.
pulse is shorter than 10ms Pulse length less than 10 milliseconds was set.
80
other reason Something else has happened.
81
1.1.49 1.1.49. setlcv
setlcv
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
This SMS command is used to set a specific LCV group, subgroup and additionally enable IOs which are
assigned to this group.
All LCV Group names and subgroup numbers are identical to those in the configurator. The only
exception is the Caterpillar subgroup, which does not have a number in the configurator. In this
case the <Group_name> would be tractor and <Sub_Group_number> - 2.
The LCV group and IOs will be set only on the currently active profile.
Command Structure
SMS command structure: <password> setlcv
<Group_Name>,<Sub_Group_number>,<CAN_interface_number>,<Silent/Active>,
<Channel_X>,<Additional_CAN_interface>
Where:
82
Default value: Silent.
<Channel_X> Set the Channel for the CAN interfaces. The Channel setting is used
when two separate physical connections must be made to receive all
parameters from a LCV group/subgroup:
· Channel1 – 1;
· Channel2 – 2
Default value: 1.
<Additional_CAN_interface> Specify whether to enable the other CAN interface:
· Not activate – 0;
· Activate – 1.
Default value: Not active.
Command Examples
SMS command examples:
password setlcv vag,17,1,0,2,1 – VAG17 subgroup will be enabled on CAN1 interface, silent mode on
CAN1 and CAN2, CAN1 will be enabled on Channel 2, CAN2 will also be enabled on Channel 1.
password setlcv VAG,17,2 – VAG17 subgroup will be enabled on CAN2 interface, all other parameters are
set to default settings.
Responses
Response example if everything is ok: Configured group: VAG17, I/O elements enabled.
If the LCV subgroup was set, but there are not enough free IO slots to enable all the IO parameters for
this subgroup: Configured group: VAG17, Error: Not enough I/O slots.
If the LCV subgroup was set, but Protocol v1.1 is not enabled, so no parameters are enabled at all:
Configure group: VAG17, Error: old I/O protocol is used.
If an incorrect group name, subgroup number, or value was provided for one of the parameters: Error:
unknown parameter.
If the device is currently in the process of LCV auto select, during which the user cannot set a LCV group
or enable IO parameters: Error: LCV auto select still in progress.
If the LCV group contains more than 80 IO parameters: Configured group: Tractor2, Error: Not enough
I/O slots.
83
1.1.50 1.1.50. setlock
setlock
5th Generation Devices 4th Generation
Devices
84
*
* – not available with initial firmware release for Trace5-2G, Trace5-LTE and Trace5-LTM (Rev.A).
Command Structure
SMS command structure: <password> setlock <lock> <ATH>
85
<ATH> can have the following values:
Command Examples
SMS command example if you want to block the engine: password setlock skip ath-on
SMS command example if you want to lock the vehicle if the doors are closed: password setlock lock ath-
skip
Responses
Response structure if the command was successful: setlock <lock>-OK <ATH>-OK
· IGN – ignition
· ODW – open door/window error
· DFD – door front driver
· DFP – door front passenger
· DRD – door rear driver
· DRP – door rear passenger
· DHT – door hatch
· the ignition is on
· the ignition state is unknown
Response examples:
86
1.1.51 1.1.51. setnetw
setnetw
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
This SMS command is used to set the required cellular network type.
Command Structure
SMS command structure: <password> setnetw <network>
· 1 – automatic mode
· 2 – 2G mode (GSM)
· 3 – 3G mode (UMTS)
· 4 – LTE mode
Responses
Response structure: setnetw <network mode> <status> mode <outcome> <profile>
87
· (1-profile) – the network mode is set in Profile 1
· (2-profile) – the network mode is set in Profile 2
· (3-profile) – the network mode is set in Profile 3
· (4-profile) – the network mode is set in Profile 4
If the HW version does not support 3G/LTE: setnetw: modem does not support 3g/lte
If the <network mode> value is out of range: setnetw error: field is out of range
If the device does not support 3G mode: setnetw: modem does not support 3g
88
1.1.52 1.1.52. setvalue
setvalue
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
* – value will be overwritten by a valid message from CAN-Bus (if available in the specific vehicle).
*** – (for Trace5-2G, Trace5-LTE and Trace5-LTM (Rev.A)) implemented partially, initially will only
support Virtual odometer (ID:65).
Command Structure
SMS command structure: <password> setvalue <ID> <value>
Where:
89
<value> Enter the IO value.
Command Example
SMS command example: password setvalue 65,0
Response
Response example: 65,0.
90
1.1.53 1.1.53. snapshot
snapshot
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
This SMS command allows taking pictures on demand via connected peripherals with cameras.
Command Structure
SMS command structure: <password> snapshot <peripheral number>
Responses
Response structure: snapshot <peripheral number> <answer>, <other peripheral number> <answer>
busy Indicates that the peripheral is busy with a previously taken picture at
the moment.
n/a Indicates that the peripheral is either not configured on the given port,
not connected or not responding.
fullsd Indicates that the memory of the SD card is full and the picture will be
discarded, as there are no pictures to be overwritten.
Response examples:
snapshot 1 ok
92
1.1.54 1.1.54. ssl status
ssl status
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
Only Eco4 T
*
devices
* – not available with the initial firmware release for Trace5-2G, Trace5-LTE, and Trace5-LTM (Rev.A).
This SMS command allows receiving information about the current SSL authentication status.
Command Structure
SMS command structure: <password> ssl status
Response
Response structure: SSL status server1 <status>,server2 <status>
93
1.1.55 1.1.55. switchip
switchip
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
This SMS command is used to change the current primary IP and port (IP1, Port1 or IP2, Port2).
This change is temporary and applies only until the device is reset. After the reset, IP and port
configuration will be restored to the previous state.
Command Structure
SMS command structure: <password> switchip <X>
Command Example
SMS command example: password switchip 1
Responses
If the connection is successful: Setting primary IP OK
94
1.1.56 1.1.56. tacho
tacho
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
Command Structure
SMS command structure: <password> tacho
Response
Response structure: TACHO status: <X>
· 0 – not available;
· 1 – everything is ok;
· 2 – tacho parameters are not configured;
95
1.1.57 1.1.57. tachostatus
tachostatus
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
This SMS command is used to get more detailed information about the tachograph status.
Command Structure
SMS command structure: <password> tachostatus
Responses
· Tacho status 1. Ready for remote tacho download. – If a successful service response and
successful routing control response are received
· Tacho status 2. Tacho parameters are not configured. – If the tachograph solution is not
enabled in the device configuration
· The device is busy with critical process. Please try again later. -– If the device is downloading a
tachograph file at the moment when the SMS command is received
Errors can be the following:
· Tacho status 0. Error (10 00) – When no response is received to service enable request
(response timeout). In this case, please check the physical connection.
· Tacho status 0. Error (31 00) – When no response is received to the routing control request
(response timeout). In this case, please try again.
· Tacho status 0. Error (10 12) OR Error (10 22) – Remote download is not activated on this port
(A or C). Please contact the tachograph workshop.
If you get other error messages, please contact our technical support.
96
1.1.58 1.1.58. ussd
ussd
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
GSM network operators are providing various services via USSD communication. Support of the USSD
commands allows users to send various USSD requests to the GSM operator over the tracking device and
receive answers. In this case the device operates in the transparent channel principle.
Operation principles
· USSD command is received through the SMS and then passed to the modem;
· USSD command is not affected or ignored by ongoing firmware, configuration updates, or
tachograph and smart card reading.
· After getting the response, the device transmits the answer to the sender of the SMS;
· A timeout of 120 seconds is used when waiting for the response from the GSM operator.
Command Structure
SMS command structure: <password> ussd *command#
Where command is a set of digits and asterisk symbols (*). The command always begins with an asterisk
symbol * and is terminated by #. Inside, the command can have several asterisk symbols.
Command Examples
Correct SMS command examples:
97
Responses
If the operator responds to the ussd command within 120 seconds: ussd response
If * or # symbols are missing or command is blank in the request message: ussd bad format
If the response is not received from the operator within 120 seconds: ussd timeout
If there is an error with the GSM network operator: ussd modem error
98
1.1.59 1.1.59. version
version
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
This SMS command is used to get the current tracking device version.
Command Structure
SMS command example: <password> version
Response
Response structure: <X>,<Y>,<Z>,<W>,<V>
Where:
<4> GSM signal level. The signal level ranges from 0 (no signal) to 31 (strong
signal).
99
1.1.60 1.1.60. webcoords
webcoords
5th Generation Devices 4th Generation Devices
Trace5 HCV5 LCV5 Pro5 HCV5 Lite Tco4 Tco4 LCV Eco4 Eco4 S/T Plug4
HCV Pro4
Pro5 Lite
This SMS command is used to get a hyperlink to Google maps with coordinates, current vehicle speed,
and ignition status.
Command Example
SMS command structure: <password> webcoords
Responses
Response structure: <time>, <hyperlink>, <speed>, <ignition>
Where:
If the GPS data is not available but was available earlier, then the device can return the last known
coordinates and the time shows when the coordinates were taken:
Where:
100
<hyperlink> Hyperlink to Google maps with coordinates: latitude and longitude.
101
1.2 1.2. SMS during Critical Processes
· Firmware update
· Configuration update
· Tacho read
· Smart Card read
· reset
· connect
· econnect
· switchip
· setconnection
· delrecords
· setcfg
· getcfg
· setioparam
· getioparam
· clear obd
· tacho
Response example: The device is busy with critical process. Please try again later.
102
1.3 1.3. Informational Messages and Alerts
If required, you can receive an SMS alert with date and time, which will notify if one of the configured
events is triggered: GPS speed, power supply voltage, autogeofence alert DIN1, DIN2, DIN3, DIN4
(ignition).
To receive such alerts, the SMS Alert Number functionality must be configured in the advanced
configurator. Follow these steps:
1. Click Options button in the Authorized numbers section to open the Numbers window.
2. In the SMS Alert Number field enter the number, where the alerts will be sent.
3. Close the Numbers window and click the Options button in the IO events section.
4. Set one of the events:
· All DINs – Event on is set to Change
· Power supply voltage – Event on is set to Hysteresis (On Both or On Falling)
· GPS speed – Event on is set to Hysteresis (On Both or OnRising)
· Autogeofence alert – Event on is set to Change
5. Tick the SMS Alert checkbox.
6. If required, enter the custom message in the Event on high and Event on low fields.
103
If the device was out of the GSM coverage, it will accumulate events that will be sent as soon as
the GSM connectivity is restored. The tracking device can store up to 16 events. If the 16 event
threshold is reached, the device will start to overwrite oldest events. A report of all events will be
sent in ONE message (as many, that can fit in 160 characters). Multiple events in one SMS
message will be delimited by a semicolon symbol ;.
2015.06.14 08:30:45-overspeed.
104