Ei 2020 0007 Mobilogix MT2000 Protocol Over The Air 11 16 2020 V1 0
Ei 2020 0007 Mobilogix MT2000 Protocol Over The Air 11 16 2020 V1 0
Ei 2020 0007 Mobilogix MT2000 Protocol Over The Air 11 16 2020 V1 0
MESSAGE” PROTOCOL
USER GUIDE
Version: 1.0
CONFIDENTIAL
MT2000S “T MESSAGE”
PROTOCOL OVER THE AIR
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
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.
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).
Maximum message length is 1024 bytes.
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).
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.
4.2 S1 – LOGIN (SERVER TO MT2000)
The server needs to authorize the login of the MT2000 for it to start reporting positions.
[ 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.
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
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.
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.
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 ]
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.
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.
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
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.
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).
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 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
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.
Header Tail
SOM TM_STAMP MESS EOM
_TYPE
[ 2020‐11‐13 23:00:15, S21 ]
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).
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 ]
Header Payload
SOM TM_STAMP MESS REPT_ PRT_VE S/N TERM BAT_VO LOC_ST LAT LONG
_TYPE TYPE R _STAT LT ATUS
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.
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).
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
0, 201 ]
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.
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.
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
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.
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.
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 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
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.
Header Tail
SOM TM_STAMP MESS EOM
_TYPE
[ 2020‐11‐13 23:00:15, S11 ]
5.7 T12 – OUTSIDE GEOFENSE ALERT (MT2000 TO SERVER)
When the MT2000 leaves the electronic fence area, the device sends an alert message.
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 ]
Header Payload
SOM TM_STAMP MESS REPT_ PRT_VE S/N TERM BAT_VO LOC_ST LAT LONG
_TYPE TYPE R _STAT LT ATUS
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.
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.
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
0, 201 ]
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.
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.
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
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.
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
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.
Example of a S6 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.
Example of a T6 message.
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).
Example of a S5 message
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:
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.
Example of a T5 message.
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.
Example of a S4 message (one time sending example)
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.
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 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
0, 201 ]
6.7 S7 – REBOOT TERMINAL (SERVER TO MT2000)
This command forces the terminal to reboot.
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
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.
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
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.
Example of a S6 message
8.2 T6 – FOTA COMMAND (MT2000 TO SERVER)
MT2000 ACK command for the application server. This ACK indicates the start of the FOTA process.
Example of a T6 message
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.
Example of a T16 message