Ei 2020 0007 Mobilogix MT2000 Protocol Over The Air 11 16 2020 V1 0

Download as pdf or txt
Download as pdf or txt
You are on page 1of 37

“T 

MESSAGE” PROTOCOL 
USER GUIDE 

Version: 1.0

Release date of: November 23, 2020


     

CONFIDENTIAL 
 

MT2000S “T MESSAGE” 

PROTOCOL OVER THE AIR 
 

Version  Release Note  Release Date  Author 


V1.0  First Release  2020.11.23  Ricardo Franco 
       
       

CONFIDENTIAL.   MT2000S “T MESSAGE”[Company]‐ PROTOCOL OVER THE AIR  2 of 37 


     

TABLE OF CONTENTS 

1  INTRODUCTION ..................................................................................................................................... 5 
2  SPECIFICATIONS .................................................................................................................................... 5 
3  LOGIN MECHANISM OF THE MT2000 ................................................................................................... 6 
3.1  COMMUNICATION MESSAGE FORMAT ........................................................................................ 6 
4  EVENT MESSAGE ................................................................................................................................... 7 
4.1  T1 – LOGIN (MT2000 TO SERVER) ................................................................................................. 7 
4.2  S1 – LOGIN (SERVER TO MT2000) ................................................................................................. 8 
4.3  T3 – TERMINAL LOCATION (MT2000 TO SERVER) ........................................................................ 8 
4.4  S3 – TERMINAL LOCATION (SERVER TO MT2000) ......................................................................... 9 
4.5  T14 – HEARTBEAT (MT2000 TO SERVER) .................................................................................... 10 
4.6  S14 – HEARTBEAT (SERVER TO MT2000) .................................................................................... 11 
4.7  T31 – SLEEP (MT2000 TO SERVER) .............................................................................................. 11 
4.8  S31 – SLEEP (SERVER TO MT2000) .............................................................................................. 12 
4.9  T21 – TRIP ON (MT2000 TO SERVER) .......................................................................................... 13 
4.10  S21 – TRIP ON (SERVER TO MT2000) .......................................................................................... 14 
4.11  T22 ‐ TRIP Off (MT2000 TO SERVER) ........................................................................................... 15 
4.12  S22 ‐ TRIP Off (SERVER TO MT2000) ........................................................................................... 16 
5  ALERT MESSAGE .................................................................................................................................. 16 
5.1  T9 – SHAKE ALERT (MT2000 TO SERVER) .................................................................................... 16 
5.2  S9 – SHAKE ALERT (SERVER TO MT2000) .................................................................................... 18 
5.3  T10 – MAIN BATTERY REMOVAL (MT2000 TO SERVER) ............................................................. 18 
5.4  S10 – MAIN BATTERY ALERT (SERVER TO MT2000) .................................................................... 19 
5.5  T11 – LOW BATTERY VOLTAGE ALERT (MT2000 TO SERVER) ..................................................... 20 
5.6  S11 – LOW BATTERY VOLTAGE ALERT (SERVER TO MT2000) ..................................................... 21 
5.7  T12 – OUTSIDE GEOFENSE ALERT (MT2000 TO SERVER) ............................................................ 22 
5.8  S12 – OUTSIDE GEOFENSE ALERT (SERVER TO MT2000) ............................................................ 23 
5.9  T13 – OVERSPEED ALERT (MT2000 TO SERVER) ......................................................................... 23 
5.10  S13 – OVERSPEED ALERT (SERVER TO MT2000) ......................................................................... 25 
5.11  T15 – TOWING ALERT (MT2000 TO SERVER) .............................................................................. 25 
5.12  S15 – TOWING ALERT (SERVER TO MT2000) .............................................................................. 26 
6  COMMANDS FOR THE MT2000 BY GPRS ............................................................................................ 27 

CONFIDENTIAL.   MT2000S “T MESSAGE”[Company]‐ PROTOCOL OVER THE AIR  3 of 37 


     
6.1  S6 – WRITE CONFIG PARAMETER (SERVER TO MT2000) ............................................................ 28 
6.2  T6 – WRITE CONFIG PARAMETER (MT2000 TO SERVER) ............................................................ 29 
6.3  S5 – READ CONFIG PARAMETER (SERVER TO MT2000) .............................................................. 29 
6.4  T5 – READ CONFIG PARAMETER (MT2000 TO SERVER) .............................................................. 31 
6.5  S4 – REQUEST TERMINAL LOCATION (SERVER TO MT2000) ....................................................... 31 
6.6  T4 – REQUEST TERMINAL LOCATION (MT2000 TO SERVER) ...................................................... 32 
6.7  S7 – REBOOT TERMINAL (SERVER TO MT2000) .......................................................................... 33 
7  COMMANDS FOR THE MT2000 BY SMS .............................................................................................. 34 
8  FIRMWARE OVER THE AIR UPDATE (FOTA) ........................................................................................ 35 
8.1  S6 – FOTA COMMAND (SERVER TO MT2000) ............................................................................. 36 
8.2  T6 – FOTA COMMAND (MT2000 TO SERVER) ............................................................................. 36 
8.3  T16 – FOTA PROCESS FINISHED (MT2000 TO SERVER) ............................................................... 37 
 

CONFIDENTIAL.   MT2000S “T MESSAGE”[Company]‐ PROTOCOL OVER THE AIR  4 of 37 


     

1 INTRODUCTION 

This document provides the communication protocol over the air, and the form of bilateral 
communication between the MT2000 device and the application server. 

Will be analyzed in this document: 

 The connection and login mechanism of the MT2000 with the application server. 
 The communication messages and events of the MT2000 and their respective return messages; 
 The configuration messages of the MT2000, and their respective return messages (to request 
the current configuration or the configuration return). 

2 SPECIFICATIONS 

The MT2000 device uses a message‐based protocol called "Protocol T message". The MT2000 device will 
always be a client on a Socket over TCP connection. 

Below are the main characteristics of the connection between the MT2000 and the application server. 

 Connection: TCP/IP (only). 
 Message encoding: ASCII plain text; 
 Type of communication: Bilateral on the same connection (always initiated by the MT2000, but 
can be closed by either side). 
 Connection duration: Persistent, keeps the connection active as long as possible (auto‐
reconnection). 

 
Open TCP socket connection 
 

  TCP connection accepted 

  exchange of “T message” 

The initial settings of the MT2000 must be done by SMS. only two items are required: APN settings 
(APN,  username and password), and the IP and Port settings for the server, the rest of the settings can 
all be done by T message. 

CONFIDENTIAL.   MT2000S “T MESSAGE”[Company]‐ PROTOCOL OVER THE AIR  5 of 37 


     

3 LOGIN MECHANISM OF THE MT2000 

After the connection is established, MT2000 will try to login by sending a message of type "T1" (login 
message), the device will be continuously trying to log in without sending any other message until the 
server accepts the login of MT2000. 

 
T1 message sending 
 

  8s Time out 

 
T1 message sending 
 
8s Time out 
 

  T1 message sending 
 
S1 message (T1 response) 
 

 
Other “T” and “S” message 
 

3.1  COMMUNICATION MESSAGE FORMAT 

All message data is carried as printable 8‐bit ASCII characters. It always starts with a “[“ called SOM 
(Start of message). Each “filed” is separated by a comma and ends with a “]” called EOM (end of 
message).  

Header  Payload  Tail 


SOM TM_STAMP  MESS_TYPE  field1  ...  field N  EOM 
[  Timestamp,  Message Type, Field 1, ..., Field N ] 
Different message types contain a different number of fields. In some cases, it is permissible to omit the 
contents of a field, however the field separators should still be present.  

Maximum message length is 1024 bytes. 

CONFIDENTIAL.   MT2000S “T MESSAGE”[Company]‐ PROTOCOL OVER THE AIR  6 of 37 


     

4 EVENT MESSAGE 

4.1  T1 – LOGIN (MT2000 TO SERVER) 

Sent by the terminal for authentication and login to the server. The Terminal will log in whenever it 
establishes a connection with the server. After a TCP connection, the MT2000 will only send other 
messages after the server accepts the login (response packet S1). 

Field  Data Field Meaning 


SOM  [    
TM_STAMP  19 char.  GPS Time stamp "YYYY‐MM‐DD HH:MM:SS" 
MESS_TYPE  T1  Type of message "Login" 
1 = Report is real time from MT2000  
REPT_TYPE  1 char.  0 = Report from buffer 
Protocol version, always starting with "V" folowed by 3 period separated 
numbers "V1.x.x". 
PRT_VER  6 char.  Note: Do note use this field to reject packet 
S/N  12 char.  Terminal serial number 

It is a number that uniquely identifies a subscription in a Global Mobile 
Communications System. In Brazil it must come in the format 
"55+DDD+Subscriber Number (9 digits). It is ery usual for operators not to 
MSISDN  null  provide this information, in which case the field will become null. 
NET_MOBI  null 
PASS  8 char.  Device access password. For future implementation. 

The international mobile subscriber identity (IMSI), is a number that uniquely 
IMSI  15 char.  identifies every user of a cellular network (associated with SIM‐CARD). 

The International Mobile Equipment Identity (IMEI) is a unique number to 
IMEI  15 char.  identify devices and modems in the GSM network (Associated with the tracker). 
EOM  ]    
Example of a T1 message. 

Header  Payload  Tail


SOM  TM_STAMP  MESS REPT_ PRT_VE S/N  MSIS NET_ PASS  IMSI  IMEI  EOM
_TYPE  TYPE  R  DN  MOBI

[  2020‐11‐13 23:00:15,  T1,  1,  1.x.x, 202000000001, ,  ,  12345678, 72400000 35936608 ] 


0000001,  0000001
 

CONFIDENTIAL.   MT2000S “T MESSAGE”[Company]‐ PROTOCOL OVER THE AIR  7 of 37 


     

4.2 S1 – LOGIN (SERVER TO MT2000) 

The server needs to authorize the login of the MT2000 for it to start reporting positions. 

Field  Data Field  Meaning 


SOM  [    
TM_STAMP  19 char.  GPS Time stamp "YYYY‐MM‐DD HH:MM:SS" 
MESS_TYPE  S1  Type of message "Login" 
0 = Login rejected  
STATUS  1 char.  1 = Login sucess 
EOM  ]    
Example of a S1 message. 

Header  Payload Tail


SOM  TM_STAMP  MESS Status  EOM
_TYPE

[  2020‐11‐13 23:00:15, S1, 1  ] 
 

4.3 T3 – TERMINAL LOCATION (MT2000 TO SERVER) 

Periodically sends (configurable by the user) the location information when a trip is taking place. It is the 
most common location message. 

Field  Data Field  Meaning 


SOM  [    
TM_STAMP  19 char. GPS Time stamp "YYYY‐MM‐DD HH:MM:SS"
MESS_TYPE  T3  Type of message "Terminal Location" 
1 = Report is real time from MT2000  
REPT_TYPE  1 char.  0 = Report from buffer 
Protocol version, always starting with "V" folowed by 3 period 
separated numbers "V1.x.x". 
PRT_VER  6 char.  Note: Do note use this field to reject packet
S/N  12 char.  Terminal serial number 

CONFIDENTIAL.   MT2000S “T MESSAGE”[Company]‐ PROTOCOL OVER THE AIR  8 of 37 


     

Terminal Status is an Ascii coded number representing a set of status 
bits as follows. 
Bit0: 0=Output Disabled, 1=Output Enabled; 
Bit1: 0=Disconected external batery, 1=Conected external batery; 
Bit2: 0=Without TRIP, 1=Under TRIP; 
Bit3: 0=Stationary (parked), 1=Moving; 
Bit4: 0=Outside geofense, 1=Inside geofense; 
Bit5: 0=ACC off, 1=ACC on; 
Bit6: 0=Undue movement, 1=Allowed movement; 
Bit7: 0=Operation Mode, 1=Standby Mode. 
TERM_STATUS  2 char. 
BAT_VOLT  String  External battery voltage. i.e. "12.30" 

Number_GPS_Sat + GSM_Signal_strength + GPS_fix. 
N0: GPS_fix 
    0=No fix, lat and long fieldsare empty; 
    1=Currente GPS fix, lat and long fieldsare currente GPS fix; 
    2=Last good fix, lat and long fieldsare last GPS fix.    
N1: GSM_Signal_strength = 0~9 
LOC_STATUS  3 char.  N2: Number_GPS_ Sat = 0~9 
LAT  String  Latitude (+/‐xx.xxxxxx) 
LONT  String  Longitude (+/‐ xx.xxxxxx) 
SPEED  String  Speed in km/h 
DIR  String  Course on the ground in degree 
EOM  ]    
Example of a T3 message 

Header  Payload 
SOM  TM_STAMP  MESS REPT_ PRT_VE S/N  TERM BAT_VO LOC_ST LAT  LONG 
_TYPE  TYPE  R  _STAT LT  ATUS 

[  2020‐11‐13 23:00:15,  T3,  1,  1.x.x, 202000000001, 23, 12.18, 731, ‐22.932220, ‐47.022446,


Payload  Tail 
SPEED  DIR  EOM 

0,  201  ] 
 

4.4 S3 – TERMINAL LOCATION (SERVER TO MT2000) 

The server needs to send ACK to the MT2000 (from message T3). It is advisable to send the ACK to 
ensure that no message is buffered unnecessarily, and in the case of the message sent is from the 
buffer, it is the condition to take that message out of the buffer and clear the memory space. The 
MT2000 also uses the ACK timestamp to adjust its internal clock when there is no GPS signal. 

CONFIDENTIAL.   MT2000S “T MESSAGE”[Company]‐ PROTOCOL OVER THE AIR  9 of 37 


     

Field  Data Field  Meaning 


SOM  [    
TM_STAMP  19 char.  GPS Time stamp "YYYY‐MM‐DD HH:MM:SS" 
MESS_TYPE  S3  Type of message "Terminal Location" ACK 
EOM  ]    
Example of a S3 message. 

Header  Tail
SOM  TM_STAMP  MESS EOM
_TYPE

[  2020‐11‐13 23:00:15, S3 ] 
 

4.5 T14 – HEARTBEAT (MT2000 TO SERVER) 

Periodically sends (configurable by the user) a package when the ignition is off (similar to a keep alive). 
This package has no location information, as the satellites are generally not yet fixed, however before 
sleeping again the terminal will send the T31 package, with all the location information. 

Field  Data Field  Meaning 


SOM  [    
TM_STAMP  19 char.  GPS Time stamp "YYYY‐MM‐DD HH:MM:SS" 
MESS_TYPE  T14  Type of message "Heartbeat" 
1 = Report is real time from MT2000  
REPT_TYPE  1 char.  0 = Report from buffer 
Protocol version, always starting with "V" folowed by 3 period 
separated numbers "V1.x.x". 
PRT_VER  6 char.  Note: Do note use this field to reject packet 
S/N  12 char.  Terminal serial number 

Terminal Status is an Ascii coded number representing a set of status 
bits as follows. 
Bit0: 0=Output Disabled, 1=Output Enabled; 
Bit1: 0=Disconected external batery, 1=Conected external batery; 
Bit2: 0=Without TRIP, 1=Under TRIP; 
Bit3: 0=Stationary (parked), 1=Moving; 
Bit4: 0=Outside geofense, 1=Inside geofense; 
Bit5: 0=ACC off, 1=ACC on; 
Bit6: 0=Undue movement, 1=Allowed movement; 
Bit7: 0=Operation Mode, 1=Standby Mode. 
TERM_STATUS  2 char. 
BAT_VOLT  String  External battery voltage. i.e. "12.30" 
EOM  ]    
 

CONFIDENTIAL.   MT2000S “T MESSAGE”[Company]‐ PROTOCOL OVER THE AIR  10 of 37 


     
Example of a T14 message 

Header  Payload  Tail 


SOM  TM_STAMP  MESS REPT_ PRT_VE S/N  TERM BAT_VOLT  EOM 
_TYPE TYPE R  _STAT

[  2020‐11‐13 23:00:15, T14, 1,  1.x.x, 202000000001, 23, 12.18  ] 


 

4.6 S14 – HEARTBEAT (SERVER TO MT2000) 

The server needs to send ACK to the MT2000 (from message T14). It is advisable to send the ACK to 
ensure that no message is buffered unnecessarily, and in the case of the message sent is from the 
buffer, it is the condition to take that message out of the buffer and clear the memory space. The 
MT2000 also uses the ACK timestamp to adjust its internal clock when there is no GPS signal. 

Field  Data Field  Meaning 


SOM  [ 
TM_STAMP  19 char.  GPS Time stamp "YYYY‐MM‐DD HH:MM:SS" 
MESS_TYPE  S14  Type of message "Heartbeat" ACK 
EOM  ]    
Example of a S14 message. 

Header  Tail
SOM  TM_STAMP  MESS EOM
_TYPE

[  2020‐11‐13 23:00:15, S14 ] 
 

4.7 T31 – SLEEP (MT2000 TO SERVER) 

Always before sleeping the device will send a message of type T31. This can occur: After a heartbeat 
message (T14), then an ignition off (T22), or any other message. The sleep message is similar to the T3 
message. 

Field  Data Field  Meaning 


SOM  [    
TM_STAMP  19 char. GPS Time stamp "YYYY‐MM‐DD HH:MM:SS"
MESS_TYPE  T31  Type of message "Terminal to sleep" 
1 = Report is real time from MT2000  
REPT_TYPE  1 char.  0 = Report from buffer 
Protocol version, always starting with "V" folowed by 3 period 
separated numbers "V1.x.x". 
PRT_VER  6 char.  Note: Do note use this field to reject packet
S/N  12 char.  Terminal serial number 

CONFIDENTIAL.   MT2000S “T MESSAGE”[Company]‐ PROTOCOL OVER THE AIR  11 of 37 


     

Terminal Status is an Ascii coded number representing a set of status 
bits as follows. 
Bit0: 0=Output Disabled, 1=Output Enabled; 
Bit1: 0=Disconected external batery, 1=Conected external batery; 
Bit2: 0=Without TRIP, 1=Under TRIP; 
Bit3: 0=Stationary (parked), 1=Moving; 
Bit4: 0=Outside geofense, 1=Inside geofense; 
Bit5: 0=ACC off, 1=ACC on; 
Bit6: 0=Undue movement, 1=Allowed movement; 
Bit7: 0=Operation Mode, 1=Standby Mode. 
TERM_STATUS  2 char. 
BAT_VOLT  String  External battery voltage. i.e. "12.30" 

Number_GPS_Sat + GSM_Signal_strength + GPS_fix. 
N0: GPS_fix 
    0=No fix, lat and long fieldsare empty; 
    1=Currente GPS fix, lat and long fieldsare currente GPS fix; 
    2=Last good fix, lat and long fieldsare last GPS fix.    
N1: GSM_Signal_strength = 0~9 
LOC_STATUS  3 char.  N2: Number_GPS_ Sat = 0~9 
LAT  String  Latitude (+/‐xx.xxxxxx) 
LONT  String  Longitude (+/‐ xx.xxxxxx) 
SPEED  String  Speed in km/h 
DIR  String  Course on the ground in degree 
EOM  ]    
Example of a T31 message 

Header  Payload 
SOM  TM_STAMP  MESS REPT_ PRT_VE S/N  TERM BAT_VO LOC_ST LAT  LONG 
_TYPE  TYPE  R  _STAT LT  ATUS 

[  2020‐11‐13 23:00:15, T31,  1,  1.x.x, 202000000001, 23, 12.18, 731, ‐22.932220, ‐47.022446,


Payload  Tail 
SPEED  DIR  EOM 

0,  201  ] 
 

4.8 S31 – SLEEP (SERVER TO MT2000) 

The server needs to send ACK to the MT2000 (from message T31). It is advisable to send the ACK to 
ensure that no message is buffered unnecessarily, and in the case of the message sent is from the 
buffer, it is the condition to take that message out of the buffer and clear the memory space. The 
MT2000 also uses the ACK timestamp to adjust its internal clock when there is no GPS signal. 

CONFIDENTIAL.   MT2000S “T MESSAGE”[Company]‐ PROTOCOL OVER THE AIR  12 of 37 


     

Field  Data Field  Meaning 


SOM  [    
TM_STAMP  19 char.  GPS Time stamp "YYYY‐MM‐DD HH:MM:SS" 
MESS_TYPE  S31  Type of message " Terminal to sleep " ACK 
EOM  ]    
Example of a S31 message. 

Header  Tail
SOM  TM_STAMP  MESS EOM
_TYPE

[  2020‐11‐13 23:00:15, S31 ] 
 

4.9 T21 – TRIP ON (MT2000 TO SERVER) 

Every time the ignition is turned on (either physical or virtual), the terminal will send a message to the 
server (similar to message T3). 

Field  Data Field  Meaning 


SOM  [    
TM_STAMP  19 char.  GPS Time stamp "YYYY‐MM‐DD HH:MM:SS" 
MESS_TYPE  T21  Type of message "Trip is on" 
1 = Report is real time from MT2000  
REPT_TYPE  1 char.  0 = Report from buffer 
Protocol version, always starting with "V" folowed by 3 period 
separated numbers "V1.x.x". 
PRT_VER  6 char.  Note: Do note use this field to reject packet 
S/N  12 char.  Terminal serial number 

Terminal Status is an Ascii coded number representing a set of status 
bits as follows. 
Bit0: 0=Output Disabled, 1=Output Enabled; 
Bit1: 0=Disconected external batery, 1=Conected external batery; 
Bit2: 0=Without TRIP, 1=Under TRIP; 
Bit3: 0=Stationary (parked), 1=Moving; 
Bit4: 0=Outside geofense, 1=Inside geofense; 
Bit5: 0=ACC off, 1=ACC on; 
Bit6: 0=Undue movement, 1=Allowed movement; 
Bit7: 0=Operation Mode, 1=Standby Mode. 
TERM_STATUS  2 char. 
BAT_VOLT  String  External battery voltage. i.e. "12.30" 

CONFIDENTIAL.   MT2000S “T MESSAGE”[Company]‐ PROTOCOL OVER THE AIR  13 of 37 


     

Number_GPS_Sat + GSM_Signal_strength + GPS_fix. 
N0: GPS_fix 
    0=No fix, lat and long fieldsare empty; 
    1=Currente GPS fix, lat and long fieldsare currente GPS fix; 
    2=Last good fix, lat and long fieldsare last GPS fix.    
N1: GSM_Signal_strength = 0~9 
LOC_STATUS  3 char.  N2: Number_GPS_ Sat = 0~9 
LAT  String  Latitude (+/‐xx.xxxxxx) 
LONT  String  Longitude (+/‐ xx.xxxxxx) 
SPEED  String  Speed in km/h 
DIR  String  Course on the ground in degree
EOM  ]    
Example of a T21 message 

Header  Payload 
SOM  TM_STAMP  MESS REPT_ PRT_VE S/N  TERM BAT_VO LOC_ST LAT  LONG 
_TYPE  TYPE  R  _STAT LT  ATUS 

[  2020‐11‐13 23:00:15, T21,  1,  1.x.x, 202000000001, 23, 12.18, 731, ‐22.932220, ‐47.022446,


Payload  Tail 
SPEED  DIR  EOM 

0,  201  ] 
 

4.10 S21 – TRIP ON (SERVER TO MT2000) 

The server needs to send ACK to the MT2000 (from message T21). It is advisable to send the ACK to 
ensure that no message is buffered unnecessarily, and in the case of the message sent is from the 
buffer, it is the condition to take that message out of the buffer and clear the memory space. The 
MT2000 also uses the ACK timestamp to adjust its internal clock when there is no GPS signal. 

Field  Data Field  Meaning 


SOM  [    
TM_STAMP  19 char.  GPS Time stamp "YYYY‐MM‐DD HH:MM:SS" 
MESS_TYPE  S21  Type of message " Trip is on" ACK 
EOM  ]    
Example of a S21 message. 

Header Tail
SOM  TM_STAMP  MESS EOM
_TYPE

[  2020‐11‐13 23:00:15, S21 ]
 

CONFIDENTIAL.   MT2000S “T MESSAGE”[Company]‐ PROTOCOL OVER THE AIR  14 of 37 


     

4.11 T22 ‐ TRIP OFF (MT2000 TO SERVER) 

Every time the ignition is turned off (either physical or virtual), the terminal will send a message to the 
server (similar to message T3). 

Field  Data Field  Meaning 


SOM  [    
TM_STAMP  19 char.  GPS Time stamp "YYYY‐MM‐DD HH:MM:SS" 
MESS_TYPE  T22  Type of message "Trip is off" 
1 = Report is real time from MT2000  
REPT_TYPE  1 char.  0 = Report from buffer 
Protocol version, always starting with "V" folowed by 3 period 
separated numbers "V1.x.x". 
PRT_VER  6 char.  Note: Do note use this field to reject packet 
S/N  12 char.  Terminal serial number 

Terminal Status is an Ascii coded number representing a set of status 
bits as follows. 
Bit0: 0=Output Disabled, 1=Output Enabled; 
Bit1: 0=Disconected external batery, 1=Conected external batery; 
Bit2: 0=Without TRIP, 1=Under TRIP; 
Bit3: 0=Stationary (parked), 1=Moving; 
Bit4: 0=Outside geofense, 1=Inside geofense; 
Bit5: 0=ACC off, 1=ACC on; 
Bit6: 0=Undue movement, 1=Allowed movement; 
Bit7: 0=Operation Mode, 1=Standby Mode. 
TERM_STATUS  2 char. 
BAT_VOLT  String  External battery voltage. i.e. "12.30" 

Number_GPS_Sat + GSM_Signal_strength + GPS_fix. 
N0: GPS_fix 
    0=No fix, lat and long fieldsare empty; 
    1=Currente GPS fix, lat and long fieldsare currente GPS fix; 
    2=Last good fix, lat and long fieldsare last GPS fix.    
N1: GSM_Signal_strength = 0~9 
LOC_STATUS  3 char.  N2: Number_GPS_ Sat = 0~9 
LAT  String  Latitude (+/‐xx.xxxxxx) 
LONT  String  Longitude (+/‐ xx.xxxxxx) 
SPEED  String  Speed in km/h
DIR  String  Course on the ground in degree 
EOM  ]    
 

CONFIDENTIAL.   MT2000S “T MESSAGE”[Company]‐ PROTOCOL OVER THE AIR  15 of 37 


     
Example of a T22 message 

Header  Payload 
SOM  TM_STAMP  MESS REPT_ PRT_VE S/N  TERM BAT_VO LOC_ST LAT  LONG 
_TYPE  TYPE  R  _STAT LT  ATUS 

[  2020‐11‐13 23:00:15, T22,  1,  1.x.x, 202000000001, 23, 12.18, 731, ‐22.932220, ‐47.022446,


Payload  Tail 
SPEED  DIR  EOM 

0,  201  ] 
 

4.12 S22 ‐ TRIP OFF (SERVER TO MT2000) 

The server needs to send ACK to the MT2000 (from message T22). It is advisable to send the ACK to 
ensure that no message is buffered unnecessarily, and in the case of the message sent is from the 
buffer, it is the condition to take that message out of the buffer and clear the memory space. The 
MT2000 also uses the ACK timestamp to adjust its internal clock when there is no GPS signal. 

Field  Data Field  Meaning 


SOM  [    
TM_STAMP  19 char.  GPS Time stamp "YYYY‐MM‐DD HH:MM:SS" 
MESS_TYPE  S22  Type of message " Trip is off" ACK 
EOM  ]    
Example of a S22 message. 

Header  Tail
SOM  TM_STAMP  MESS EOM
_TYPE

[  2020‐11‐13 23:00:15, S22 ]
 

5 ALERT MESSAGE 

5.1  T9 – SHAKE ALERT (MT2000 TO SERVER) 

When the ignition is off (ACC off), and the MT2000 detects vibration, it must wake up, register with the 
server and send a shake alert message. 

This message will be sent every 5 min (as long as the tracker detects the shake). 

Field  Data Field  Meaning 


SOM  [    
TM_STAMP  19 char.  GPS Time stamp "YYYY‐MM‐DD HH:MM:SS" 
MESS_TYPE  T9  Type of message "Shake alert"

CONFIDENTIAL.   MT2000S “T MESSAGE”[Company]‐ PROTOCOL OVER THE AIR  16 of 37 


     

1 = Report is real time from MT2000  
REPT_TYPE  1 char.  0 = Report from buffer 
Protocol version, always starting with "V" folowed by 3 period 
separated numbers "V1.x.x". 
PRT_VER  6 char.  Note: Do note use this field to reject packet
S/N  12 char.  Terminal serial number 

Terminal Status is an Ascii coded number representing a set of status 
bits as follows. 
Bit0: 0=Output Disabled, 1=Output Enabled; 
Bit1: 0=Disconected external batery, 1=Conected external batery; 
Bit2: 0=Without TRIP, 1=Under TRIP; 
Bit3: 0=Stationary (parked), 1=Moving; 
Bit4: 0=Outside geofense, 1=Inside geofense; 
Bit5: 0=ACC off, 1=ACC on; 
Bit6: 0=Undue movement, 1=Allowed movement; 
Bit7: 0=Operation Mode, 1=Standby Mode. 
TERM_STATUS  2 char. 
BAT_VOLT  String  External battery voltage. i.e. "12.30" 

Number_GPS_Sat + GSM_Signal_strength + GPS_fix. 
N0: GPS_fix 
    0=No fix, lat and long fieldsare empty; 
    1=Currente GPS fix, lat and long fieldsare currente GPS fix; 
    2=Last good fix, lat and long fieldsare last GPS fix.    
N1: GSM_Signal_strength = 0~9 
LOC_STATUS  3 char.  N2: Number_GPS_ Sat = 0~9 
LAT  String  Latitude (+/‐xx.xxxxxx) 
LONT  String  Longitude (+/‐ xx.xxxxxx) 
SPEED  String  Speed in km/h 
DIR  String  Course on the ground in degree 
EOM  ]    
Example of a T9 message. 

Header  Payload 
SOM  TM_STAMP  MESS REPT_ PRT_VE S/N  TERM BAT_VO LOC_ST LAT  LONG 
_TYPE  TYPE  R  _STAT LT  ATUS 

[  2020‐11‐13 23:00:15,  T9,  1,  1.x.x, 202000000001, 23, 12.18, 731, ‐22.932220, ‐47.022446,


Payload  Tail 
SPEED  DIR  EOM 

0,  201  ] 
 

CONFIDENTIAL.   MT2000S “T MESSAGE”[Company]‐ PROTOCOL OVER THE AIR  17 of 37 


     

5.2 S9 – SHAKE ALERT (SERVER TO MT2000) 

The server needs to send ACK to the MT2000 (from message T9). It is advisable to send the ACK to 
ensure that no message is buffered unnecessarily, and in the case of the message sent is from the 
buffer, it is the condition to take that message out of the buffer and clear the memory space. The 
MT2000 also uses the ACK timestamp to adjust its internal clock when there is no GPS signal. 

Field  Data Field  Meaning 


SOM  [    
TM_STAMP  19 char.  GPS Time stamp "YYYY‐MM‐DD HH:MM:SS" 
MESS_TYPE  S9  Type of message "Shake Alert" ACK 
EOM  ]    
Example of a S9 message. 

Header  Tail
SOM  TM_STAMP  MESS EOM
_TYPE

[  2020‐11‐13 23:00:15, S9 ] 
 

5.3 T10 – MAIN BATTERY REMOVAL (MT2000 TO SERVER) 

When external power is breached (power signals removed), the MT2000 will generate alert messages. 

Field  Data Field  Meaning 


SOM  [    
TM_STAMP  19 char.  GPS Time stamp "YYYY‐MM‐DD HH:MM:SS" 
MESS_TYPE  T10  Type of message "Battery removal" 
1 = Report is real time from MT2000  
REPT_TYPE  1 char.  0 = Report from buffer 
Protocol version, always starting with "V" folowed by 3 period 
separated numbers "V1.x.x". 
PRT_VER  6 char.  Note: Do note use this field to reject packet 
S/N  12 char.  Terminal serial number 

CONFIDENTIAL.   MT2000S “T MESSAGE”[Company]‐ PROTOCOL OVER THE AIR  18 of 37 


     

Terminal Status is an Ascii coded number representing a set of status 
bits as follows. 
Bit0: 0=Output Disabled, 1=Output Enabled; 
Bit1: 0=Disconected external batery, 1=Conected external batery; 
Bit2: 0=Without TRIP, 1=Under TRIP; 
Bit3: 0=Stationary (parked), 1=Moving; 
Bit4: 0=Outside geofense, 1=Inside geofense; 
Bit5: 0=ACC off, 1=ACC on; 
Bit6: 0=Undue movement, 1=Allowed movement; 
Bit7: 0=Operation Mode, 1=Standby Mode. 
TERM_STATUS  2 char. 
BAT_VOLT  String  External battery voltage. i.e. "12.30" 

Number_GPS_Sat + GSM_Signal_strength + GPS_fix. 
N0: GPS_fix 
    0=No fix, lat and long fieldsare empty; 
    1=Currente GPS fix, lat and long fieldsare currente GPS fix; 
    2=Last good fix, lat and long fieldsare last GPS fix.    
N1: GSM_Signal_strength = 0~9 
LOC_STATUS  3 char.  N2: Number_GPS_ Sat = 0~9 
LAT  String  Latitude (+/‐xx.xxxxxx) 
LONT  String  Longitude (+/‐ xx.xxxxxx) 
SPEED  String  Speed in km/h 
DIR  String  Course on the ground in degree 
EOM  ]    
Example of a T10 message. 

Header  Payload 
SOM  TM_STAMP  MESS REPT_ PRT_VE S/N  TERM BAT_VO LOC_ST LAT  LONG 
_TYPE  TYPE  R  _STAT LT  ATUS 

[  2020‐11‐13 23:00:15, T10,  1,  1.x.x, 202000000001, 23, 12.18, 731, ‐22.932220, ‐47.022446,


Payload  Tail 
SPEED  DIR  EOM 

0,  201  ] 
 

5.4 S10 – MAIN BATTERY ALERT (SERVER TO MT2000) 

The server needs to send ACK to the MT2000 (from message T10). It is advisable to send the ACK to 
ensure that no message is buffered unnecessarily, and in the case of the message sent is from the 
buffer, it is the condition to take that message out of the buffer and clear the memory space. The 
MT2000 also uses the ACK timestamp to adjust its internal clock when there is no GPS signal. 

CONFIDENTIAL.   MT2000S “T MESSAGE”[Company]‐ PROTOCOL OVER THE AIR  19 of 37 


     

Field  Data Field  Meaning 


SOM  [    
TM_STAMP  19 char.  GPS Time stamp "YYYY‐MM‐DD HH:MM:SS" 
MESS_TYPE  S10  Type of message "Battery removal" ACK 
EOM  ]    
Example of a S10 message. 

Header  Tail
SOM  TM_STAMP  MESS EOM
_TYPE

[  2020‐11‐13 23:00:15, S10 ] 
 

5.5 T11 – LOW BATTERY VOLTAGE ALERT (MT2000 TO SERVER) 

When the main (external) battery has a voltage below the threshold (configured by the user in the LBV 
register). After this message, the MT2000 disconnects from the main battery in order not to exhaust the 
vehicle's battery. 

Field  Data Field  Meaning 


SOM  [    
TM_STAMP  19 char.  GPS Time stamp "YYYY‐MM‐DD HH:MM:SS" 
MESS_TYPE  T11  Type of message "Low Main Battery" 
1 = Report is real time from MT2000  
REPT_TYPE  1 char.  0 = Report from buffer 
Protocol version, always starting with "V" folowed by 3 period 
separated numbers "V1.x.x". 
PRT_VER  6 char.  Note: Do note use this field to reject packet 
S/N  12 char.  Terminal serial number 

Terminal Status is an Ascii coded number representing a set of status 
bits as follows. 
Bit0: 0=Output Disabled, 1=Output Enabled; 
Bit1: 0=Disconected external batery, 1=Conected external batery; 
Bit2: 0=Without TRIP, 1=Under TRIP; 
Bit3: 0=Stationary (parked), 1=Moving; 
Bit4: 0=Outside geofense, 1=Inside geofense; 
Bit5: 0=ACC off, 1=ACC on; 
Bit6: 0=Undue movement, 1=Allowed movement; 
Bit7: 0=Operation Mode, 1=Standby Mode. 
TERM_STATUS  2 char. 
BAT_VOLT  String  External battery voltage. i.e. "12.30" 

CONFIDENTIAL.   MT2000S “T MESSAGE”[Company]‐ PROTOCOL OVER THE AIR  20 of 37 


     

Number_GPS_Sat + GSM_Signal_strength + GPS_fix. 
N0: GPS_fix 
    0=No fix, lat and long fieldsare empty; 
    1=Currente GPS fix, lat and long fieldsare currente GPS fix; 
    2=Last good fix, lat and long fieldsare last GPS fix.    
N1: GSM_Signal_strength = 0~9 
LOC_STATUS  3 char.  N2: Number_GPS_ Sat = 0~9 
LAT  String  Latitude (+/‐xx.xxxxxx) 
LONT  String  Longitude (+/‐ xx.xxxxxx) 
SPEED  String  Speed in km/h 
DIR  String  Course on the ground in degree
EOM  ]    
Example of a T11 message. 

Header  Payload 
SOM  TM_STAMP  MESS REPT_ PRT_VE S/N  TERM BAT_VO LOC_ST LAT  LONG 
_TYPE  TYPE  R  _STAT LT  ATUS 

[  2020‐11‐13 23:00:15, T11,  1,  1.x.x, 202000000001, 23, 12.18, 731, ‐22.932220, ‐47.022446,


Payload  Tail 
SPEED  DIR  EOM 

0,  201  ] 
 

5.6 S11 – LOW BATTERY VOLTAGE ALERT (SERVER TO MT2000) 

The server needs to send ACK to the MT2000 (from message T11). It is advisable to send the ACK to 
ensure that no message is buffered unnecessarily, and in the case of the message sent is from the 
buffer, it is the condition to take that message out of the buffer and clear the memory space. The 
MT2000 also uses the ACK timestamp to adjust its internal clock when there is no GPS signal. 

Field  Data Field  Meaning 


SOM  [    
TM_STAMP  19 char.  GPS Time stamp "YYYY‐MM‐DD HH:MM:SS" 
MESS_TYPE  S11  Type of message "Low Main Battery" ACK 
EOM  ]    
Example of a S11 message. 

Header Tail
SOM  TM_STAMP  MESS EOM
_TYPE

[  2020‐11‐13 23:00:15, S11 ]
 

CONFIDENTIAL.   MT2000S “T MESSAGE”[Company]‐ PROTOCOL OVER THE AIR  21 of 37 


     

5.7 T12 – OUTSIDE GEOFENSE ALERT (MT2000 TO SERVER) 

When the MT2000 leaves the electronic fence area, the device sends an alert message. 

Field  Data Field  Meaning 


SOM  [    
TM_STAMP  19 char.  GPS Time stamp "YYYY‐MM‐DD HH:MM:SS" 
MESS_TYPE  T12  Type of message "Geofense outside" 
1 = Report is real time from MT2000  
REPT_TYPE  1 char.  0 = Report from buffer 
Protocol version, always starting with "V" folowed by 3 period 
separated numbers "V1.x.x". 
PRT_VER  6 char.  Note: Do note use this field to reject packet 
S/N  12 char.  Terminal serial number 

Terminal Status is an Ascii coded number representing a set of status 
bits as follows. 
Bit0: 0=Output Disabled, 1=Output Enabled; 
Bit1: 0=Disconected external batery, 1=Conected external batery; 
Bit2: 0=Without TRIP, 1=Under TRIP; 
Bit3: 0=Stationary (parked), 1=Moving; 
Bit4: 0=Outside geofense, 1=Inside geofense; 
Bit5: 0=ACC off, 1=ACC on; 
Bit6: 0=Undue movement, 1=Allowed movement; 
Bit7: 0=Operation Mode, 1=Standby Mode. 
TERM_STATUS  2 char. 
BAT_VOLT  String  External battery voltage. i.e. "12.30" 

Number_GPS_Sat + GSM_Signal_strength + GPS_fix. 
N0: GPS_fix 
    0=No fix, lat and long fieldsare empty; 
    1=Currente GPS fix, lat and long fieldsare currente GPS fix; 
    2=Last good fix, lat and long fieldsare last GPS fix.    
N1: GSM_Signal_strength = 0~9 
LOC_STATUS  3 char.  N2: Number_GPS_ Sat = 0~9 
LAT  String  Latitude (+/‐xx.xxxxxx)
LONT  String  Longitude (+/‐ xx.xxxxxx) 
SPEED  String  Speed in km/h 
DIR  String  Course on the ground in degree
EOM  ]    
 

CONFIDENTIAL.   MT2000S “T MESSAGE”[Company]‐ PROTOCOL OVER THE AIR  22 of 37 


     
Example of a T12 message. 

Header  Payload 
SOM  TM_STAMP  MESS REPT_ PRT_VE S/N  TERM BAT_VO LOC_ST LAT  LONG 
_TYPE  TYPE  R  _STAT LT  ATUS 

[  2020‐11‐13 23:00:15, T12,  1,  1.x.x, 202000000001, 23, 12.18, 731, ‐22.932220, ‐47.022446,


Payload  Tail 
SPEED  DIR  EOM 

0,  201  ] 
 

5.8 S12 – OUTSIDE GEOFENSE ALERT (SERVER TO MT2000) 

The server needs to send ACK to the MT2000 (from message T12). It is advisable to send the ACK to 
ensure that no message is buffered unnecessarily, and in the case of the message sent is from the 
buffer, it is the condition to take that message out of the buffer and clear the memory space. The 
MT2000 also uses the ACK timestamp to adjust its internal clock when there is no GPS signal. 

Field  Data Field  Meaning 


SOM  [    
TM_STAMP  19 char.  GPS Time stamp "YYYY‐MM‐DD HH:MM:SS" 
MESS_TYPE  S12  Type of message "Geofense outside" ACK 
EOM  ]    
Example of a S12 message. 

Header  Tail
SOM  TM_STAMP  MESS EOM
_TYPE

[  2020‐11‐13 23:00:15, S12 ]
 

5.9 T13 – OVERSPEED ALERT (MT2000 TO SERVER) 

When the MT2000 detects a speed above the threshold (defined by the user in the SPD register), the 
device sends an alert message. 

Field  Data Field  Meaning 


SOM  [    
TM_STAMP  19 char.  GPS Time stamp "YYYY‐MM‐DD HH:MM:SS" 
MESS_TYPE  T13  Type of message "Overspeed" 
1 = Report is real time from MT2000  
REPT_TYPE  1 char.  0 = Report from buffer 

CONFIDENTIAL.   MT2000S “T MESSAGE”[Company]‐ PROTOCOL OVER THE AIR  23 of 37 


     

Protocol version, always starting with "V" folowed by 3 period 
separated numbers "V1.x.x". 
PRT_VER  6 char.  Note: Do note use this field to reject packet 
S/N  12 char. Terminal serial number

Terminal Status is an Ascii coded number representing a set of status 
bits as follows. 
Bit0: 0=Output Disabled, 1=Output Enabled; 
Bit1: 0=Disconected external batery, 1=Conected external batery; 
Bit2: 0=Without TRIP, 1=Under TRIP; 
Bit3: 0=Stationary (parked), 1=Moving; 
Bit4: 0=Outside geofense, 1=Inside geofense; 
Bit5: 0=ACC off, 1=ACC on; 
Bit6: 0=Undue movement, 1=Allowed movement; 
Bit7: 0=Operation Mode, 1=Standby Mode. 
TERM_STATUS  2 char. 
BAT_VOLT  String  External battery voltage. i.e. "12.30" 

Number_GPS_Sat + GSM_Signal_strength + GPS_fix. 
N0: GPS_fix 
    0=No fix, lat and long fieldsare empty; 
    1=Currente GPS fix, lat and long fieldsare currente GPS fix; 
    2=Last good fix, lat and long fieldsare last GPS fix.    
N1: GSM_Signal_strength = 0~9 
LOC_STATUS  3 char.  N2: Number_GPS_ Sat = 0~9 
LAT  String  Latitude (+/‐xx.xxxxxx) 
LONT  String  Longitude (+/‐ xx.xxxxxx) 
SPEED  String  Speed in km/h 
DIR  String  Course on the ground in degree 
EOM  ]    
 

Example of a T13 message. 

Header  Payload 
SOM  TM_STAMP  MESS REPT_ PRT_VE S/N  TERM BAT_VO LOC_ST LAT  LONG 
_TYPE  TYPE  R  _STAT LT  ATUS 

[  2020‐11‐13 23:00:15, T13,  1,  1.x.x, 202000000001, 23, 12.18, 731, ‐22.932220, ‐47.022446,


Payload  Tail 
SPEED  DIR  EOM 

0,  201  ] 
 

CONFIDENTIAL.   MT2000S “T MESSAGE”[Company]‐ PROTOCOL OVER THE AIR  24 of 37 


     

5.10 S13 – OVERSPEED ALERT (SERVER TO MT2000) 

The server needs to send ACK to the MT2000 (from message T13). It is advisable to send the ACK to 
ensure that no message is buffered unnecessarily, and in the case of the message sent is from the 
buffer, it is the condition to take that message out of the buffer and clear the memory space. The 
MT2000 also uses the ACK timestamp to adjust its internal clock when there is no GPS signal. 

Field  Data Field  Meaning 


SOM  [    
TM_STAMP  19 char.  GPS Time stamp "YYYY‐MM‐DD HH:MM:SS" 
MESS_TYPE  S13  Type of message "Overspeed" ACK 
EOM  ]    
Example of a S13 message. 

Header  Tail
SOM  TM_STAMP  MESS EOM
_TYPE

[  2020‐11‐13 23:00:15, S13 ] 
 

5.11 T15 – TOWING ALERT (MT2000 TO SERVER) 

When the MT2000 moves 100 meters from the place of origin with the ignition off. It sends a T15 
message every 5 min three times. 

Field  Data Field  Meaning 


SOM  [    
TM_STAMP  19 char.  GPS Time stamp "YYYY‐MM‐DD HH:MM:SS" 
MESS_TYPE  T15  Type of message "Towing"
1 = Report is real time from MT2000  
REPT_TYPE  1 char.  0 = Report from buffer 
Protocol version, always starting with "V" folowed by 3 period 
separated numbers "V1.x.x". 
PRT_VER  6 char.  Note: Do note use this field to reject packet 
S/N  12 char. Terminal serial number

CONFIDENTIAL.   MT2000S “T MESSAGE”[Company]‐ PROTOCOL OVER THE AIR  25 of 37 


     

Terminal Status is an Ascii coded number representing a set of status 
bits as follows. 
Bit0: 0=Output Disabled, 1=Output Enabled; 
Bit1: 0=Disconected external batery, 1=Conected external batery; 
Bit2: 0=Without TRIP, 1=Under TRIP; 
Bit3: 0=Stationary (parked), 1=Moving; 
Bit4: 0=Outside geofense, 1=Inside geofense; 
Bit5: 0=ACC off, 1=ACC on; 
Bit6: 0=Undue movement, 1=Allowed movement; 
Bit7: 0=Operation Mode, 1=Standby Mode. 
TERM_STATUS  2 char. 
BAT_VOLT  String  External battery voltage. i.e. "12.30" 

Number_GPS_Sat + GSM_Signal_strength + GPS_fix. 
N0: GPS_fix 
    0=No fix, lat and long fieldsare empty; 
    1=Currente GPS fix, lat and long fieldsare currente GPS fix; 
    2=Last good fix, lat and long fieldsare last GPS fix.    
N1: GSM_Signal_strength = 0~9 
LOC_STATUS  3 char.  N2: Number_GPS_ Sat = 0~9 
LAT  String  Latitude (+/‐xx.xxxxxx) 
LONT  String  Longitude (+/‐ xx.xxxxxx) 
SPEED  String  Speed in km/h 
DIR  String  Course on the ground in degree 
EOM  ]    
 

Example of a T15 message. 

Header  Payload 
SOM  TM_STAMP  MESS REPT_ PRT_VE S/N  TERM BAT_VO LOC_ST LAT  LONG 
_TYPE  TYPE  R  _STAT LT  ATUS 

[  2020‐11‐13 23:00:15, T15,  1,  1.x.x, 202000000001, 23, 12.18, 731, ‐22.932220, ‐47.022446,


Payload  Tail 
SPEED  DIR  EOM 

0,  201  ] 
 

5.12 S15 – TOWING ALERT (SERVER TO MT2000) 

The server needs to send ACK to the MT2000 (from message T15). It is advisable to send the ACK to 
ensure that no message is buffered unnecessarily, and in the case of the message sent is from the 
buffer, it is the condition to take that message out of the buffer and clear the memory space. The 
MT2000 also uses the ACK timestamp to adjust its internal clock when there is no GPS signal. 

CONFIDENTIAL.   MT2000S “T MESSAGE”[Company]‐ PROTOCOL OVER THE AIR  26 of 37 


     

Field  Data Field  Meaning 


SOM  [    
TM_STAMP  19 char.  GPS Time stamp "YYYY‐MM‐DD HH:MM:SS" 
MESS_TYPE  S15  Type of message "Towing" ACK 
EOM  ]    
Example of a S15 message. 

Header  Tail
SOM  TM_STAMP  MESS EOM
_TYPE

[  2020‐11‐13 23:00:15, S15 ] 
 

6 COMMANDS FOR THE MT2000 BY GPRS 

The application server can send several commands to the MT2000 tracker. We suggest that you make a 
management of the commands and mechanism for sending because we must remember: 

 One command must be sent at a time (the same MT2000 unit can only receive another 
command after the first one has been executed); 
 MT2000 is always a client, that is, only MT2000 can open a connection to the server. If the user 
needs to send a command and the MT2000 is a sleep or disconnected, the server must queue 
that command and send it at the first opportunity to connect the MT2000. 

 
Sending commands 
 
Pull command on the queue 
 

  Sending commands 

 
Pull command on the queue 
 
Tx message sending 
 

  Sx message response 

 
Push command off the queue 
 

CONFIDENTIAL.   MT2000S “T MESSAGE”[Company]‐ PROTOCOL OVER THE AIR  27 of 37 


     

6.1  S6 – WRITE CONFIG PARAMETER (SERVER TO MT2000) 

The configuration commands always have the same structure and the parameters are described in the 
following table. 

Field  Data Field  Meaning 


SOM  [    
TM_STAMP  19 char.  GPS Time stamp "YYYY‐MM‐DD HH:MM:SS" 
MESS_TYPE  S6  Type of message "Write config" 
PARAM_VAL  String  “Parameter” = “Value” 
EOM  ]    
 

Example of a S6 message 

Header  Payload  Tail 


SOM  TM_STAMP  MESS PARAM_VAL  EOM 
_TYPE

[  2020‐11‐13 23:00:15, S6, FREQ=60  ] 


 

Parameter  Value  Meaning 


APN=apn_name:user:pass 
APN  APN=apn_name   configure the GSM internet access point 
URL=dns_name:TCP_port  Configure the application server address. TCP 
URL  URL=ip_address:TCP_port protocol only. DNS or IPV4 addresses can be used. 
Communication time with ignition on.  
Range: 0‐65,535 (in seconds). 
FREQ  FREQ=time_in_seconds   T = “0” does not send data in real time. 
Communication time with ignition off.  
HEARTBEAT  HEARTBEAT=time_in_minutes  Range: 1‐60,000 (in minutes). 
Time to go to sleep after the ignition is turned off. 
SLEEPT  SLEEPT=time_in_seconds  Range: 0‐3,600 (in seconds) 
Energy saving mode: 
Deep sleep: Does not receive SMS, does not 
SLEEP_MODE=0(deep sleep)  receive GPRS. 
SLEEP_MODE=1(regular sleep)  Regular sleep: Receive SMS, Do not receive GPRS. 
SLEEP_MODE  SLEEP_MODE=2(always on)  Always On: Receive SMS, Receive GPRS. 
Ignition detection, physical or virtual. In the case 
IGNITION_DETECTION=0(by wire)   of virtual ignition, it is necessary to configure the 
IGNITION_DETECTION  IGNITION_DETECTION=1(by voltage) "ENGINEV" parameter. 
Threshold voltage to determine ignition on or off. 
Must be used for virtual ignition (note 
ENGINEV  ENGINEV=12600(in milivolts)  IGNITION_DETECTION parameter) 
STI=0(disabled)  Output 1 activation control. Usually used for 
STI  STI=1(enabled)  blocking. 

CONFIDENTIAL.   MT2000S “T MESSAGE”[Company]‐ PROTOCOL OVER THE AIR  28 of 37 


     
Maximum speed limit (when exceeded generates 
SPD  SPD=60(in Km/h)  T13 alert) 
 Minimum battery voltage (When exceeded, it 
LBV  LBV=11500(in milivolts)  generates a T11 alert) 
Violation of geofense (when violating the 
GF1  GF1=lat:long:radius_in_meter  perimeter of the fence, it generates a T12 alert). 
Bounce time to consider movement (must be 
MOVECNT  MOVECNT=2(in seconds)  calibrated together with MOVETH parameter) 
G‐force threshold to consider movement 
MOVETH  MOVETH=20(in g‐force)  (generates T9 alert, when ignition is off) 
Defines Buffer priority: 
High Priority: Send buffered messages whenever 
the device logs on to the server (after T1 
message); 
SEND_PRIORITY=0(high priority)  Low Priority: Send a buffered message before 
SEND_PRIORITY  SEND_PRIORITY=1(low priority)  going to sleep (after T31 message).   
 

6.2 T6 – WRITE CONFIG PARAMETER (MT2000 TO SERVER) 

MT2000 sends an ACK to the server to know if the command was received and to process successfully or 
not. The server does not need to send a new ACK to the tracker. 

Field  Data Field  Meaning 


SOM  [    
TM_STAMP  19 char.  GPS Time stamp "YYYY‐MM‐DD HH:MM:SS" 
MESS_TYPE  T6  Type of message "Write config" 
PARAM_VAL  String  “Parameter” = “ACK” 
EOM  ]    
 ACK = 1: Command received and accepted successfully; 
 ACK = 0: Command received and was not accepted (failed). 

Example of a T6 message. 

Header  Payload  Tail 


SOM  TM_STAMP  MESS PARAM_VAL  EOM 
_TYPE

[  2020‐11‐13 23:00:15, T6, FREQ=1 ] 


 

6.3 S5 – READ CONFIG PARAMETER (SERVER TO MT2000) 

The S5 command reads the parameters configured in the MT2000 (the configuration can be done by the 
S6 command). 

CONFIDENTIAL.   MT2000S “T MESSAGE”[Company]‐ PROTOCOL OVER THE AIR  29 of 37 


     

Field  Data Field  Meaning 


SOM  [    
TM_STAMP  19 char.  GPS Time stamp "YYYY‐MM‐DD HH:MM:SS" 
MESS_TYPE  S5  Type of message "Read config" 
PARAM  String  “Parameter” 
EOM  ]    
 

Example of a S5 message 

Header  Payload  Tail


SOM  TM_STAMP  MESS PARAM  EOM
_TYPE

[  2020‐11‐13 23:00:15, S5, FREQ  ] 


See below the table of parameters that can be read. 

Parameter  Meaning 
APN   GSM internet access point 
Application server address. TCP protocol only. DNS or IPV4 addresses can 
URL  be used. 
Communication time with ignition on.  
Range: 0‐65,535 (in seconds). 
FREQ   T = “0” does not send data in real time. 
Communication time with ignition off.  
HEARTBEAT  Range: 1‐60,000 (in minutes). 
Time to go to sleep after the ignition is turned off. 
SLEEPT  Range: 0‐3,600 (in seconds) 
Energy saving mode: 
Deep sleep: Does not receive SMS, does not receive GPRS. 
Regular sleep: Receive SMS, Do not receive GPRS. 
SLEEP_MODE  Always On: Receive SMS, Receive GPRS. 
Ignition detection, physical or virtual. In the case of virtual ignition, it is 
IGNITION_DETECTION  necessary to configure the "ENGINEV" parameter. 
Threshold voltage to determine ignition on or off. Must be used for virtual 
ENGINEV  ignition (note IGNITION_DETECTION parameter) 
STI  Output 1 activation control. Usually used for blocking. 
SPD  Maximum speed limit (when exceeded generates T13 alert) 
LBV   Minimum battery voltage (When exceeded, it generates a T11 alert) 
Violation of geofense (when violating the perimeter of the fence, it 
GF1  generates a T12 alert). 
Bounce time to consider movement (must be calibrated together with 
MOVECNT  MOVETH parameter) 
G‐force threshold to consider movement (generates T9 alert, when 
MOVETH  ignition is off) 
SEND_PRIORITY  Defines Buffer priority:   

CONFIDENTIAL.   MT2000S “T MESSAGE”[Company]‐ PROTOCOL OVER THE AIR  30 of 37 


     
High Priority: Send buffered messages whenever the device logs on to the 
server (after T1 message); 
Low Priority: Send a buffered message before going to sleep (after T31 
message). 
 

6.4 T5 – READ CONFIG PARAMETER (MT2000 TO SERVER) 

MT2000 sends the response to the server to know the configured parameter. The server does not need 
to send a new ACK to the tracker. 

Field  Data Field  Meaning 


SOM  [    
TM_STAMP  19 char.  GPS Time stamp "YYYY‐MM‐DD HH:MM:SS" 
MESS_TYPE  T5  Type of message "Write config" 
Parameter: The same parameter used in the message tables for S5 
and S6; 
Value: The value is delivered in the same way as it was configured 
PARAM_VAL  “Parameter” = “Value”  in S6 (same format, type of field and range). 
EOM  ]    
 

Example of a T5 message. 

Header  Payload Tail 


SOM  TM_STAMP  MESS PARAM_VAL  EOM 
_TYPE

[  2020‐11‐13 23:00:15, T5, FREQ=60  ] 


 

6.5 S4 – REQUEST TERMINAL LOCATION (SERVER TO MT2000) 

This command request the location of the MT2000 immediately. It can be used to request a single 
location, or to request multiple locations with a time interval between them, different from the FREQ 
time. 

Note: MT2000 needs to be awake and connected to the GPRS network. 

Note 2: If the device is sleeping in sleep mode 1 or 2, (that is, connected to the GSM network, but not 
connected to the GPRS network) the MT2000 may be asked for a location by SMS. 

Field  Data Field  Meaning 


SOM  [    
TM_STAMP  19 char.  GPS Time stamp "YYYY‐MM‐DD HH:MM:SS" 
MESS_TYPE  S4  Type of message "Request Location" 

CONFIDENTIAL.   MT2000S “T MESSAGE”[Company]‐ PROTOCOL OVER THE AIR  31 of 37 


     
Time (in seconds) of sending between each packet (number of 
PERIOD  String  packets defined by the COUNT field). 
COUNT  String  Number of packages to be sent (every PERIOD time) 
EOM  ]    
 

Example of a S4 message (one time sending example) 

Header  Payload  Tail


SOM  TM_STAMP  MESS PERIOD COUNT EOM
_TYPE

[  2020‐11‐13 23:00:15, S4, 0,  1  ] 


 

6.6 T4 – REQUEST TERMINAL LOCATION (MT2000 TO SERVER) 

Periodically sends (configurable by the user) the location information when a trip is taking place. It is the 
most common location message. 

Field  Data Field  Meaning 


SOM  [    
TM_STAMP  19 char.  GPS Time stamp "YYYY‐MM‐DD HH:MM:SS" 
MESS_TYPE  T4  Type of message "Request Terminal Location" 
1 = Report is real time from MT2000  
REPT_TYPE  1 char.  0 = Report from buffer
Protocol version, always starting with "V" folowed by 3 period 
separated numbers "V1.x.x". 
PRT_VER  6 char.  Note: Do note use this field to reject packet 
S/N  12 char.  Terminal serial number 

Terminal Status is an Ascii coded number representing a set of status 
bits as follows. 
Bit0: 0=Output Disabled, 1=Output Enabled; 
Bit1: 0=Disconected external batery, 1=Conected external batery; 
Bit2: 0=Without TRIP, 1=Under TRIP; 
Bit3: 0=Stationary (parked), 1=Moving; 
Bit4: 0=Outside geofense, 1=Inside geofense; 
Bit5: 0=ACC off, 1=ACC on; 
Bit6: 0=Undue movement, 1=Allowed movement; 
Bit7: 0=Operation Mode, 1=Standby Mode. 
TERM_STATUS  2 char. 
BAT_VOLT  String  External battery voltage. i.e. "12.30" 

CONFIDENTIAL.   MT2000S “T MESSAGE”[Company]‐ PROTOCOL OVER THE AIR  32 of 37 


     

Number_GPS_Sat + GSM_Signal_strength + GPS_fix. 
N0: GPS_fix 
    0=No fix, lat and long fieldsare empty; 
    1=Currente GPS fix, lat and long fieldsare currente GPS fix; 
    2=Last good fix, lat and long fieldsare last GPS fix.    
N1: GSM_Signal_strength = 0~9 
LOC_STATUS  3 char.  N2: Number_GPS_ Sat = 0~9 
LAT  String  Latitude (+/‐xx.xxxxxx) 
LONT  String  Longitude (+/‐ xx.xxxxxx) 
SPEED  String  Speed in km/h 
DIR  String  Course on the ground in degree
EOM  ]    
 

Example of a T4 message 

Header  Payload 
SOM  TM_STAMP  MESS REPT_ PRT_VE S/N  TERM BAT_VO LOC_ST LAT  LONG 
_TYPE  TYPE  R  _STAT LT  ATUS 

[  2020‐11‐13 23:00:15,  T4,  1,  1.x.x, 202000000001, 23, 12.18, 731, ‐22.932220, ‐47.022446,


Payload  Tail 
SPEED  DIR  EOM 

0,  201  ] 
 

6.7 S7 – REBOOT TERMINAL (SERVER TO MT2000) 

This command forces the terminal to reboot. 

Field  Data Field  Meaning 


SOM  [    
TM_STAMP  19 char.  GPS Time stamp "YYYY‐MM‐DD HH:MM:SS" 
MESS_TYPE  S7  Type of message "Reboot terminal" 
EOM  ]    
 

Example of a S7 message (one time sending example) 

Header Tail
SOM  TM_STAMP  MESS EOM
_TYPE

[  2020‐11‐13 23:00:15, S7 ]
Note: This command has no ACK 

CONFIDENTIAL.   MT2000S “T MESSAGE”[Company]‐ PROTOCOL OVER THE AIR  33 of 37 


     

7 COMMANDS FOR THE MT2000 BY SMS 

Some MT2000 commands can be sent via SMS. This alternative is very useful when a device is not 
connected to the GPRS service, or in the initial setup of the devices. 

Parameter  Meaning  SMS command  SMS response 


APN   GSM internet access point  SET APN=apn:user_apn:pass_apn   
Application server address. TCP  SET URL=dns_name_srv:tcp_port   
protocol only. DNS or IPV4  SET URL=ipv4_address:tcp_port 
URL  addresses can be used. 
Communication time with ignition  SET T3 FREQ=time_in_seconds   
on.  
Range: 0‐65,535 (in seconds). 
 T = “0” does not send data in real 
FREQ  time. 
Output 1 activation control. Usually  SET RELAY=state   
STI  used for blocking.  
REBOOT  Rebooting the device  REBOOT   
GET  asks for immediate information  GET LOCATION   
LOCATION  from MT2000 
Energy saving mode:  SET SLEEP_MODE=number_mode   
0: Deep sleep ‐ Does not receive 
SMS, does not receive GPRS. 
1: Regular sleep ‐ Receive SMS, Do 
not receive GPRS. 
SET SLEEP  2: Always On ‐ Receive SMS, 
MODE  Receive GPRS. 
Get mode of energy saving:  GET SLEEP_MODE   
0: Deep sleep ‐ Does not receive 
SMS, does not receive GPRS. 
1: Regular sleep ‐ Receive SMS, Do 
not receive GPRS. 
GET SLEEP  2: Always On ‐ Receive SMS, 
MODE  Receive GPRS. 
Ignition detection, “0” for physical  SET IGNITION_DETECTION=mode   
or “1” for virtual. In the case of 
SET  virtual ignition, it is necessary to 
IGNITION_D configure the "SET ENGINEV" 
ETECTION  parameter. 
Get mode of Ignition detection, “0”  GET IGNITION_DETECTION   
for physical or “1” for virtual. In the 
GET  case of virtual ignition, it is 
IGNITION_D necessary to configure the "SET 
ETECTION  ENGINEV" parameter. 
Threshold voltage to determine  SET ENGINEV=value_in_milivolts   
ignition on or off. Must be used for 
SET  virtual ignition (note 
ENGINEV  IGNITION_DETECTION parameter) 

CONFIDENTIAL.   MT2000S “T MESSAGE”[Company]‐ PROTOCOL OVER THE AIR  34 of 37 


     
Get Threshold voltage to determine 
ignition on or off. Must be used for 
GET  virtual ignition (note 
ENGINEV  IGNITION_DETECTION parameter)  GET ENGINEV   
Defines Buffer priority:  SET SEND_PRIORITY=mode   
0: High Priority ‐ Send buffered 
messages whenever the device logs 
on to the server (after T1 message); 
SET  1: Low Priority ‐ Send a buffered 
SEND_PRIO message before going to sleep 
RITY  (after T31 message). 
Get defines of Buffer priority:  GET SEND_PRIORITY   
0: High Priority ‐ Send buffered 
messages whenever the device logs 
on to the server (after T1 message); 
GET  1: Low Priority ‐ Send a buffered 
SEND_PRIO message before going to sleep 
RITY  (after T31 message). 
 Wake up MT2000 and get a  WAKE_UP   
WAKE UP  location. 
 

8 FIRMWARE OVER THE AIR UPDATE (FOTA) 

The MT2000 terminal, is prepared to make updates "Over the air". The update is done through HTTP 
protocol, and can be done directly on mobilogix servers using simple commands via GPRS. 

That is, the device takes the firmware from another server, but remains connected to the main 
application server. This makes the over the air update process simpler to be integrated by the platform. 

  Application  FW 
server server
  Sending FOTA update commands (S6) 

 
Sending ACK (T6) 
 

  Get the FW on external Server (address and port of the S6 command) 

 
Sending ACK (T16) 
 
Rebooting 
 

  Login process (T1), with the new FW 

CONFIDENTIAL.   MT2000S “T MESSAGE”[Company]‐ PROTOCOL OVER THE AIR  35 of 37 


     

8.1 S6 – FOTA COMMAND (SERVER TO MT2000) 

The configuration commands always have the same structure and the parameters are described in the 
following table. 

Field  Data Field  Meaning 


SOM  [    
TM_STAMP  19 char.  GPS Time stamp "YYYY‐MM‐DD HH:MM:SS" 
MESS_TYPE  S6  Type of message "Write config" 
PARAM_VAL  String  YCSJ=http://name_of_server:tcp_port/app_Vx_x_x.bin 
EOM  ]    
 

Example of a S6 message 

Header  Payload  Tail 


SOM  TM_STAMP  MESS PARAM_VAL  EOM 
_TYPE 

[  2020‐11‐13 23:00:15,  S6,  YCSJ=http://fusioniot.uk:9080/app_V1_2_3.bin  ] 


 

8.2 T6 – FOTA COMMAND (MT2000 TO SERVER) 

MT2000 ACK command for the application server. This ACK indicates the start of the FOTA process. 

Field  Data Field  Meaning 


SOM  [    
TM_STAMP  19 char.  GPS Time stamp "YYYY‐MM‐DD HH:MM:SS" 
MESS_TYPE  T6  Type of message "Write config" 
PARAM  YCSJ  Parameter to start firmware update 
ACK from FOTA process: 
1: All is OK, and the FOTA process started successfully; 
0: Something is wrong, FOTA Server did not response, or the file was 
VAL  String  not found. 
EOM  ]    
 

Example of a T6 message 

Header  Payload  Tail


SOM  TM_STAMP  MESS PARAM  VAL  EOM
_TYPE

[  2020‐11‐13 23:00:15, T6, YCSJ,  1  ] 


 

CONFIDENTIAL.   MT2000S “T MESSAGE”[Company]‐ PROTOCOL OVER THE AIR  36 of 37 


     

8.3 T16 – FOTA PROCESS FINISHED (MT2000 TO SERVER) 

MT2000 ACK command for the application server. This ACK indicates the end of the FOTA process. 

Field  Data Field  Meaning 


SOM  [    
TM_STAMP  19 char.  GPS Time stamp "YYYY‐MM‐DD HH:MM:SS" 
MESS_TYPE  T16  Type of message "FOTA process finished" 
1 = Report is real time from MT2000  
REPT_TYPE  1 char.  0 = Report from buffer 
Protocol version, always starting with "V" folowed by 3 period 
separated numbers "V1.x.x". 
PRT_VER  6 char.  Note: Do note use this field to reject packet 
S/N  12 char.  Terminal serial number 
ACK from FOTA process: 
1: All is OK, and the FOTA process is successfully; 
STATUS  String  0: Something is wrong. 
EOM  ]    
 

Example of a T16 message 

Header  Payload  Tail 


SOM  TM_STAMP  MESS REPT_ PRT_VE S/N  STATUS  EOM 
_TYPE TYPE R 

[  2020‐11‐13 23:00:15, T16, 1, 1.x.x, 202000000001, 1 ] 


 

CONFIDENTIAL.   MT2000S “T MESSAGE”[Company]‐ PROTOCOL OVER THE AIR  37 of 37 

You might also like