MeiTrack MVT340, MVT100, MVT380 User Manual

MEITRACK MVT100/MVT340/MVT380 GPRS Protocol
MEITRACK MVT100/MVT340/MVT380
GPRS Protocol
Applicable Model: MVT100/MVT340/MVT380
File Name
MEITRACK MVT100/MVT340/MVT380
GPRS Protocol
Created By
Kyle Lv
Project
MVT100/MVT340/MVT380
Creation Date
Update Date
2017-01-20
Subproject
GPRS Protocol
Total Pages
23
Version
V1.0
Confidential
Internal Documentation
Change History
Copyright © 2017 Meitrack Group All rights reserved. - 2 -
Contents
1 Command Format ..........................................................................................................................................................................- 5 -
1.1 GPRS Command Format .....................................................................................................................................................- 5 -
1.2 Tracker Command Format ..................................................................................................................................................- 5 -
1.3 Event Code ..........................................................................................................................................................................- 8 -
2 Command List ................................................................................................................................................................................- 9 -
3 Command Details ........................................................................................................................................................................- 10 -
3.1 Real-Time Location Query – A10 ......................................................................................................................................- 10 -
3.2 Setting a Heartbeat Packet Reporting Interval – A11 ........................................................................................................- 10 -
3.3 Tracking by Time Interval – A12 ........................................................................................................................................- 10 -
3.4 Setting the Cornering Report Function – A13 ...................................................................................................................- 11 -
3.5 Tracking by Distance – A14 ...............................................................................................................................................- 11 -
3.6 Setting the Parking Scheduled Tracking Function – A15 ...................................................................................................- 12 -
3.7 Enabling the Parking Scheduled Tracking Function – A16 .................................................................................................- 12 -
3.8 Setting GPRS Parameters – A21 ........................................................................................................................................- 12 -
3.9 Setting the DNS Server IP Address – A22 ..........................................................................................................................- 13 -
3.10 Setting the Standby GPRS Server – A23 ..........................................................................................................................- 13 -
3.11 Reading All Authorized Phone Numbers – A70 ...............................................................................................................- 14 -
3.12 Setting Authorized Phone Numbers – A71 .....................................................................................................................- 14 -
3.13 Setting Listen-in Phone Numbers – A72 .........................................................................................................................- 14 -
3.14 Setting the Smart Sleep Mode – A73 ..............................................................................................................................- 15 -
3.15 Automatic Event Report – AAA .......................................................................................................................................- 15 -
3.16 Deleting a GPRS Event in the Buffer – AFF ......................................................................................................................- 15 -
3.17 Setting a Geo-Fence – B05 ..............................................................................................................................................- 16 -
3.18 Deleting a Geo-Fence – B06 ............................................................................................................................................- 16 -
3.19 Setting the Speeding Alarm Function – B07 ...................................................................................................................- 17 -
3.20 Setting the Towing Alarm Function – B08 .......................................................................................................................- 17 -
3.21 Setting the Anti-Theft Function – B21 ............................................................................................................................- 17 -
3.22 Turning off the LED Indicator – B31 ................................................................................................................................- 18 -
3.23 Setting a Log Interval – B34 ............................................................................................................................................- 18 -
3.24 Setting the SMS Time Zone – B35 ...................................................................................................................................- 18 -
3.25 Setting the GPRS Time Zone – B36 .................................................................................................................................- 19 -
3.26 Checking the Engine First to Determine Tracker Running Status – B60 .........................................................................- 19 -
3.27 Setting SMS Event Characters – B91 ...............................................................................................................................- 19 -
3.28 Setting Event Authorization – B99 ..................................................................................................................................- 20 -
3.29 Controlling Output Status – C01 .....................................................................................................................................- 20 -
3.30 Notifying the Tracker of Sending an SMS – C02 ..............................................................................................................- 21 -
3.31 Setting a GPRS Event Transmission Mode – C03 .............................................................................................................- 21 -
3.32 Reading Device's Firmware Version and SN – E91 ..........................................................................................................- 22 -
3.33 Restarting the GSM Module – F01 ..................................................................................................................................- 22 -
3.34 Restarting the GPS Module – F02 ...................................................................................................................................- 22 -
3.35 Setting the Mileage and Run Time – F08 ........................................................................................................................- 22 -
3.36 Deleting SMS/GPRS Cache Data – F09 ............................................................................................................................- 23 -
Copyright © 2017 Meitrack Group All rights reserved. - 3 -
3.37 Restoring Initial Settings – F11 ........................................................................................................................................- 23 -
Copyright © 2017 Meitrack Group All rights reserved. - 4 -
Parameter
Description
Example
@@
Indicates the GPRS data packet header sent from the server to the
tracker. The header type is ASCII. (Hexadecimal is represented as
0x40.)
@@
$$
Indicates the GPRS data packet header sent from the tracker to the
server. The header type is ASCII. (Hexadecimal is represented as
0x24.)
$$
Data identifier
Contains 1 byte. The type is the ASCII, and its value ranges from
0x41 to 0x7A.
Q
Data length
Indicates the length of characters from the first comma (,) to \r\n.
Decimal.
Example: $$<Data identifier><Data length>,<IMEI>,<Command
type>,<Command><* Checksum>\r\n
25
IMEI
Indicates the tracker IMEI number. The number type is ASCII. It has
15 digits generally.
353358017784062
Command type
Hexadecimal
For details, see chapter 2 and chapter 3.
AAA
Event code
Decimal
For details, see section 1.3 "Event Code."
1
Latitude
(-)yy.dddddd
Unit: degree
Decimal
When a minus (-) exists, the tracker is in the southern hemisphere.
22.756325 (indicates
22.756325°N)
-23.256438 (indicates
1 Command Format
1.1 GPRS Command Format
GPRS command sent from the server to the tracker:
@@<Data identifier><Data length>,<IMEI>,<Command type>,<Command><*Checksum>\r\n
GPRS command sent from the tracker to the server:
$$<Data identifier><Data length>,<IMEI>,<Command type>,<Command><*Checksum>\r\n
1.2 Tracker Command Format
$$<Data identifier><Data length>,<IMEI>,<Command type>,<Event code>,<(-)Latitude>,<(-)Longitude>,<Date and
time>,<Positioning status>,<Number of satellites>,<GSM signal strength>,<Speed>,<Direction>,<Horizontal dilution of precision
(HDOP)>,<Altitude>,<Mileage>,<Run time>,<Base station info>,<I/O port status>,<Analog input value>,<Geo-fence
number><*Checksum>\r\n
Note:
A comma (,) is used to separate data characters. The character type is the American Standard Code for Information
Interchange (ASCII). (Hexadecimal is represented as 0x2C.)
Symbols "<" and ">" will not be present in actual data, only for documentation purpose only. All multi-byte data complies with the following rule: High bytes are prior to low bytes. The size of a GPRS data packet is about 160 bytes.
Descriptions about GPRS packets from the tracker are as follows:
Copyright © 2017 Meitrack Group All rights reserved. - 5 -
When no minus (-) exists, the tracker is in the northern hemisphere.
yy indicates the degree.
dddddd indicates the decimal part.
23.256438°S)
Longitude
(-)xxx.dddddd
Unit: degree
Decimal
When a minus (-) exists, the tracker is in the western hemisphere.
When no minus (-) exists, the tracker is in the eastern hemisphere.
xxx indicates the degree.
dddddd indicates the decimal part.
114.752146 (indicates
114.752146°E)
-114.821453 (indicates
114.821453°W)
Date and time
yymmddHHMMSS
yy indicates year.
mm indicates month.
dd indicates day.
HH indicates hour.
MM indicates minute.
SS indicates second.
Decimal
091221102631
Indicates 21 December
2009, 10:26:31 am.
Positioning status
Indicates the GPS signal status.
A = Valid
V = Invalid
A
The GPS is valid.
Number of satellites
Indicates the number of received GPS satellites.
Decimal
5
Five GPS satellites are
received.
GSM signal strength
Value: 0–31
Decimal
12
The signal strength is 12.
Speed
Unit: km/h
Decimal
58
The speed is 58 km/h.
Direction
Indicates the driving direction. The unit is degree. When the value is
0, the direction is north. The value ranges from 0 to 359.
Decimal
45: indicates that the
location is at northeast.
90: indicates that the
location is at east.
HDOP
The value ranges from 0.5 to 99.9. The smaller the value is, the
more the accuracy is.
Decimal
When the accuracy value is 0, the signal is invalid.
0.5–1: Perfect
2–3: Wonderful
4–6: Good
7–8: Medium
9–20: Below average
21–99.9: Poor
5
The HDOP is 5.
Altitude
Unit: meter
Decimal
118
Mileage
Unit: meter
564870
Copyright © 2017 Meitrack Group All rights reserved. - 6 -
Decimal
Indicates the total mileage. The maximum value is 4294967295. If
the value exceeds the maximum value, it will be automatically
cleared.
Run time
Unit: second
Decimal
Indicates the total time. The maximum value is 4294967295. If the
value exceeds the maximum value, it will be automatically cleared.
2546321
Base station info
The base station information includes:
MCC|MNC|LAC|CI
The MCC and MNC are decimal, while the LAC and CI are
hexadecimal.
Note: Base station information in an SMS is empty.
460|0|E166|A08B
I/O port status
Hexadecimal
Status values of eight input ports and eight output ports:
Bit0 to Bit7 corresponds to status of output ports 1 to 8.
Bit8 to Bit15 corresponds to status of input ports 1 to 8.
0421 (hexadecimal) =
0000 0100 0010 0001
Analog input value
Separated by "|".
Hexadecimal
AD1|AD2|AD3|Battery analog|External power analog
Note: Analog input values in an SMS report are empty.
Voltage formula of analog AD (AD1, AD2, and AD3):
MVT340/MVT380: (AD x 6)/1024
MVT100: (AD x 3.3 x 2)/4096
Voltage formula of battery analog (AD4):
MVT340/MVT380: (AD4 x 3 x 2)/1024
MVT100: (AD4 x 3.3 x 2)/4096
Voltage formula of external power supply (AD5):
MVT340/MVT380: (AD5 x 3 x 16)/1024
MVT100: (AD5 x 3.3 x 16)/4096
123|456|235|1456|222
(Hexadecimal)
Geo-fence number
32-bit unsigned
Only available by GPRS event code 20 or 21.
02 00 00 00 (indicates
geo-fence 2)
*
Separates commands from checksums.
1 byte and ASCII (Hexadecimal is represented as 0x2A)
*
Checksum
2 bytes. The parameter indicates the sum of all data (excluding the
checksum and ending mark). It is a hexadecimal character.
Example: $$<Data identifier><Data length>,<IMEI>,<Command
type>,<Command><*Checksum>\r\n
BE
\r\n
2 bytes. The parameter is an ending character. The type is ASCII.
(Hexadecimal value: 0x0d 0x0a)
\r\n
Copyright © 2017 Meitrack Group All rights reserved. - 7 -
Loading...
+ 16 hidden pages