GPS Tracker Communication - Protocol V1 (1) .51
GPS Tracker Communication - Protocol V1 (1) .51
1. Summarize
This tracker connects to platform server with TCP. The way for
connection is that device connects to the platform server forwardly. After
connecting to the platform server, tracker will feedback a enrolling
message. The enrolling message contains the devices ID. If the device
received the answer from the platform server, it will stop to sending
enrolling message but send continuous feedback message. The
continuous feedback message not contains the device ID. The platform
server binds the device by connection. One connection represents a
device ID. When the connection cuts off, the device will connect the
platform server automatically and send out a device enrolling message.
Beside, the device will send out a hand-shaking message intervals of time.
The hand-shaking message contains Device ID. After receiving the
handshaking answer message from the platform server, the device waits
for sending the handshaking message in next period.
Remark:V1.8 agreement, the 12 serial numbers in the packet sent
by deivce is: 0 + 11 digits device number,so that the platform needn't bind
the device according to the connection ,the platform process will be more
simple if bind the device according to every packet device number .
V1.5
2008/11/4
V1.6
2008/11/29
V1.7
2008/12/22
V1.8
2008/12/29
V1.9
2009/2/12
2. Message Instrument
2.1 Data Type definition
Data Type
CHAR
C_STRING
N_STRING
H_STRING
HEX_STRING
BIN
BYTE
Instruction
Single ASCII code character
Contain ASCII character string. When fix digits, fill in
Binary system of bank0x20Hon right for lacking digit to
fix a long time except for special instruction.
Contain the digit character string of 0.9. When fix digits,
fill in ASCII code 0(Ox30H) on left for lacking digit
except for special instruction.
Contain the digit character string of O. F. When fix digits,
fill in ASCII code 0(Ox30H) on left for lacking digit
except for special instruction.
Hexadecimal system character string. Such as 1, use 31
for indication. When fix digits, fill in ASCII code 0
(Ox30H) on left for lacking digit except for special
instruction.
Binary system data
8 digits without symbol integer,0..255
following:
Head
1 byte
Message Body
Trail
N byte (N1K)
1byte
Each Full data frame must contain: Head symbol, Serial Numbe()r/ Time,
Command word, Message body, Trail symbol
Second
types of
Message
03
A
(Down
Message)
Rema
rk
00
01
Command description
Message
serial NO.
04
05
07
11
12
15
17
Devic
e
param
eter
messa
ge
00
01
Common Message
Attemper Message
02
03
04
Navigation Message
00
04
Isochronous
for
continues Vehicl
feedback configuring 3.1.3
e
Isometry for continues feedback positio
configuring
ning
Response for terminal location Messa
information
ge
Set ACC open sending data Answ
er
transmiting intervals 3.1.12
Set ACC open sending data messa
ge
transmiting intervals 3.1.13
Answer Alarm Message 3.1.4
Answer Message for getting Answ
er
customer successfully (Taxi)
signal
Control the restarted message of
the device 3.1.11
Contr
Circuit control signal 3.1.9
ol
Oil control signal 3.1.10
signal
One key configuring command
Read one key configuring
Answer currency up explaining
result message
Alarm configuring message
Device Function configuring Expan
ding
command
Device
mode
configured messa
ge
command
Intialized device command
05
01
00
01
01
R
03
05
06
01
07
00
00
01
02
03
00
01
02
B
(Up
Message)
03
O
P
Gener
al
comm
unicati
on
messa
ge
Alarm
messa
ge
Devic
02
03
04
05
12
00
01
R
02
03
05
06
04
05
06
08
S
09
20
21
23
00
00
00
01
02
e
status
messa
ge
2.3.3 Device ID
Length15 bytes (Fixed); Type: C_STRING.
FunctionThis field for fixing the device. Only when the device sends the device
login message and handshake message, it will send the device ID, and other message
will not send device ID. The platform fixs device by device ID. The usual format for
device ID is 0000 + telephone number. The reference format
is : 000013612345678
V1.8 agreement, the 12 serial numbers in the packet sent by deivce is: 0
+ 11 digits device number,The platform answer 12 serial numbers canbe
arbitrary number, the device do no processing
3. Command Message
3.1.Down Messageplatform server sending
3.1.1 Answer handshake signal message
Message
Field
Beginning
identifier
Running
NO./Time
Command
word
Message
body
Message
content
Message
Value
(
Type
Length
(Character)
CHAR
C_STRING
12
AP01
C_STRING
Message
content
HSO
C_STRING
CHAR
Ending
)
identifier
For example
Instruction
(040331141830AP01HSO )
Figures the sending message
Response
No need response
Instruction This message is available to all device
Message
Value
(
Type
Length
(Character)
CHAR
C_STRING
12
AP05
C_STRING
Message
content
C_STRING
non
CHAR
Ending
)
identifier
For example
040331141830AP05
Instruction
Message
Value
(
Type
CHAR
Length
(Character)
1
C_STRING
12
C_STRING
C_STRING
identifier
Running
NO./Time
Command
AR00
word
Message
Body
Instruction
AR00XXXXYYZZ
AR00Fixed key words
XXXXInterval for each message of continues feedback. hexUnit
Second, 4 characters in all, H_STRING. The max is 0xFFFF
secondsWhen XXXX0,the device stops continues feedback.
YYZZThe total time for feedback, 16 advance system. Unit
YYHourZZMinute. 4 characters in allH_STRINGThe max
is 0xFFFFie:255 hours 255 minutes. When YYZZ0, according
to the time intervals, continues feedback.
When both XXXX and YYZZ are not 0it figure that feedback
according to the time intervals, when it up to the total time, it
automaticly stop to feedback
)
CHAR
1
Message
Content
Ending
identifier
For example
(040331141830AR0000140024)
Figures the sending message time is 2008-8-30-14:18:30. Down fixed time to set
continues feedback. Feedback GPS data every 20 (16*1 + 4) seconds and feedback
36 (16 * 2 + 4) minutes in all.
Response
Device response BS08
Sending
mode
Instruction
Message
Value
(
AS01
Type
CHAR
Length
(Character)
1
C_STRING
12
C_STRING
Instruction
C_STRING
1
AS01X
XThe type of alarm for BO01X up alarm message.1character,16
advance system, ASCII character
7
Ending
identifier
For example:
(040331141830AS012)
Figures the sending message time is 2008-8-30-14 :18:30, answer the up vehicle rob
police
Response
No need response
Instruction This message is available to all device
Message
Value
(
Type
Length
(Character)
CHAR
C_STRING
12
AP00
C_STRING
Message
content
C_STRING
Ending
)
CHAR
identifier
For example:
040331141830AP00
Down one time calling message.
Response
Device response BP04
Instruction
Message
Value
(
Type
Length
(Character)
CHAR
identifier
8
Instruction
C_STRING
12
AP12
C_STRING
Message
content
C_STRING
Running
NO./Time
Command
word
Message
Body
H050L030
Message
Content
Ending
CHAR
identifier
For example
(080830141830AP12 H050L030 )
Setting the up limit speed is50km/h,low limit is 30km/h.When up limit is 000,it
figures cancel alarm up limit, and When down limit is 000,it figures cancel alarm
down limit. Less 3 digits of the speed, full 0 on left. Alarm refer to 3.2.4
Response
BP12
Instruction This message is available to all device
Message
Value
(
Type
CHAR
Length
(Character)
1
C_STRING
12
AV00
C_STRING
Message
content
C_STRING
Instruction
identifier
Running
NO./Time
Command
word
Message
Body
Message
Content
Ending
CHAR
identifier
9
For example
(080830141830AV00 0 )
Figures the sending message time is 2008-8-30-14:18:30, closed the
circuit.
Respons BV00
e
Instructi This message is available to all device
on
3.1.10 Oil control single
Message
Message
Type
Length
Instruction
Field
Value
(Character)
Beginning
(
CHAR
1
identifier
Running
C_STRING
12
NO./Time
Command
AV01
C_STRING
4
word
Message body Message
C_STRING
content
Message
1or0,1figures opening oil0figures closing oil
content
Ending
)
CHAR
1
identifer
For example
(080830141830AV01 0 )
figures the sending message time is 2008-8-30-14 :18:30,closed the oil
Responds BV01
Instruction This message is available to all device
Type
Length
(Character)
CHAR
C_STRING
12
C_STRING
C_STRING
10
Instruction
Message
content
no
Ending
)
CHAR
1
identifier
For example
(080830141830AT00)
Figures the sending message time is 2008-8-30-14 :18:30,the device restart.
Response
BT00
Instruction This message is available to all device
Message
Value
(
Type
Length
(Character)
CHAR
C_STRING
12
11
Instruction
NO./Time
AR06
C_STRING
Command
word
C_STRING
Message body Message
content
Message
AR06XXXX
content
AR06Fixed keywords
XXXXThe time for sending data intervals for the ACC Open,
Hex. UnitSecond
)
Ending
identifier
For example
(080830141830AR06003C)
CHAR
Figures the sending message time is 2008-8-30-14 :18:30,it sends back intervals 20
seconds when the ACC is closing.
Response
BR06
Instruction This message is available to all device
Type
Length
(Character)
CHAR
C_STRING
12
C_STRING
Instruction
C_STRING
Minlatitude,
Maxlatitude,
G,
Minlongitude,
AX05Fixed Keywords
N0 or 10, figures cancel Geo-fence, 1figures sets
Geo-fence.
If for cancelling the Geo-fence, the back data cannot be sent out.
DStandard for latitude, N, north latitude; S: south latitude.
Minlatitude: lower limit for latitude, Format: DDFF.FFF, DD
latitudes degree (00 ~ 90), FF.FFFlatitudes cent
12
Message
Value
(
AR03
Type
Length (byte)
CHAR
C_STRING
12
C_STRING
BYTE
13
Instruction
Message
content
)
Ending
identifier
For example
Required message:
CHAR
Sending content is "ShenA87J58 the position is: Guangdong province Shenzhen bus
station south around2.5 kilometers ,near Saige technical park 2008-11-29-:14:18,if
the required longitude and latitude is "0",which can return "terminal has no position"
Response
no
Message
Field
Beginning
identifier
Running
NO./Time
Command
word
Message
Value
(
AP15
Type
Length (byte)
CHAR
C_STRING
12
C_STRING
Instruction
BYTE
AP15+NNNN
NNNN:The dialed telephone number for the device ,length is not
fixed.
)
CHAR
1
For example
080830141830AP1513632782450
It will dial the number 1513632782450,after the terminal answer
Response
BS20
Message
Value
(
Type
Length (byte)
CHAR
C_STRING
12
15
Instruction
Command
word
AP03
C_STRING
C_STRING
Message
content
AAABBBCCCDDDEEEEE
AAA,BBB,CCC,DDD is IP address ,which all are
EEEEE is IP port ,which is five digits
Ending
identifier
CHAR
three digits
For example
081129141830AP0322101807911000123
Set up the terminal IP address for 221.18.79.110 port for123
Response
BP02
Message
Value
(
AP04
Type
Length (byte)
CHAR
C_STRING
12
C_STRING
Instruction
C_STRING
Message
content
Ending
identifier
CHAR
16
For example
081129141830AP04CMNET
Set up the terminal APN is CMNET
Response
BP03
Message
Value
(
AP07
Type
Length (byte)
CHAR
C_STRING
12
C_STRING
C_STRING
Message
content
Ending
identifier
CHAR
For example
081129141830AP07
Response
BP01
17
Instruction
Message
Value
(
AV02
Type
Length (byte)
CHAR
C_STRING
12
C_STRING
Instruction
C_STRING
Message
content
Ending
identifier
CHAR
For example
081129141830AV02
Response
BS21
Field value
Type
Length
Field
Beginning
(byte)
(
CHAR
C_STRING
12
identifier
Running /time
18
Instruction
Command
BP00
C_STRING
Device ID
C_STRING
15
C_STRING
word
Device ID
Message body
Message
0000136123456780HSO
content
Ending
CHAR
identifier
Example
040331141830BP00000013612345678HSO
Up data handshaking message, 000013612345678is devices ID
Response
Message
Field
Beginning
Type
Length
Value
(
(Character)
CHAR
C_STRING
12
identifier
Running
NO./Time
Command word BP05
Terminal ID
Device ID
C_STRING
C_STRING
15
Message body
C_STRING
60
Message
content
Ending
CHAR
identifier
Example
19
Instruction
(01363278450BP05000013632782450080524A2232.9806N11404.9355E000.110124
1323.8700000000L000450AB)
Cent
Response
Message
Field
Beginning
Type
Length
Value
(
Instruction
(Character)
CHAR
C_STRING
12
C_STRING
C_STRING
identifier
Running
NO./Time
Command word
BS08
Message Body
Message Content
BS08XXXXYYZZ
BS08Fix key words
XXXXinterval of time every each return newsUnitsecond
total of 4 bytesH_STRINGup to 65535 secondsXXXX
0, stop to return message
YYZZtotal return timeUnitYYHourZZMinuteTotal
of 4 byteshexadecimalup to FFFFmeans 255 hours and 255
minutesWhen YYZZ0,then ceaselessly return according to
the interval of time
When XXXX and YYZZ unequal tothen means ceaselessly
return by time intervalstop return until reach the total time
Ending identifier
Example
CHAR
040331141830BS0800050014
20
Showing the time for send message at 14:18:30 March 31,2004return GPS data
every 5 secondstotal of 20 minutes
Response No need to response
Instruction
Message
Field
Beginning
Type
Length
Value
(
Instruction
(Character)
CHAR
C_STRING
12
C_STRING
C_STRING
61
identifier
Running
NO./Time
Command
BO01
word
Message
Body
Message
BO01X+GPS data
Content
BO01Fixed keywords
XSpecific alarm information code1 byteHexadecimal
Alarm information
0Vehicle power off
21
4Lowerspeed Alert
5Overspeed Alert
)
Ending
CHAR
identifier
Example
(080331061830B0019061830A2934.0133N10627.2544E040.0080331309.6200000
000L00070AD)
Showing the time for send message at 14:18:30,March 31,2008add 8 hours is china
time. Alarm message and vehicle robberyGPS data acquisition time is March
31,2008 Universal time is 6:18:30 A shows the data available 29
degrees,34.0133 minutes north latitude 106 degrees 27.2544 minutes east
longitudespeed is 040.0 km/hthe angle is 309.62 degrees, from due northL
means the sum of distance, unit is metermileage statistic
Response Centre response AS01
Instruction
Message
Field
Beginning
Type
Length
Value
(
(Character)
CHAR
C_STRING
12
C_STRING
C_STRING
Random
length
identifier
Running
NO./Time
Command
BP04
word
Message
Body
Message
BP04GPS data
22
Instruction
Content
Ending
CHAR
identifier
Example
(013632782450BP04080525A2934.0133N
10627.2544E000.0141830309.6200000000200300C6
Showing the time for send message at 22:18:30,on May 25.Upterminal newscenter
response by one roll callGPS data acquisition time is May25,2008
Universal time is 14:18:30A shows the data available29 degrees,34.0133
minutes north latitude106 degrees 27.2544 minutes east longitudespeed is
0km/hthe angle is 309.62 degrees, from due north.
Response
No
Message Value
Type
Field
Beginning
Length
CHAR
(Character)
1
C_STRING
12
C_STRING
C_STRING
Random
length
CHAR
identifier
Running
NO./Time
Command
BR00
word
Message body
Message body
BR00GPS data
Message
content
Ending
23
Instruction
identifier
Example
(013632782450BR00080612A2232.9828N11404.9297E000.0022828000.00000000
00L000230ED)00L000230AA)
Response
No
Instruction
Message
Field
Beginning
Type
Length
Value
(
(Character)
CHAR
C_STRING
12
C_STRING
C_STRING
Random
length
identifier
Running
NO./Time
Command
BR02
word
Device ID
CHAR
content
Ending
identifier
Example
Response No
24
Instruction
Instruction
Message
Field
Beginning
Type
Length
Value
(
Instruction
(Character)
CHAR
C_STRING
12
BP12
C_STRING
Message
Content
C_STRING
identifier
Running
NO./Time
Command
word
Message
body
Message
H0501L030
content
Ending
CHAR
identifier
Example
(013632782450BP12H050L030 )
Instruction
Message
Field
Beginning
identifier
Serial
Type
Length
Value
(
(Character)
CHAR
C_STRING
12
25
Instruction
number/Time
Command
Word
Message
Body
Message
Content
Close
Identifier
Example
BV00
C_STRING
Message
C_STRING
Content
1or0,1 means circuit has been opened0 means circuit has
been closed
)
CHAR
Response No
Instruction This message is available to all device
Message
Field
Beginning
Type
Length
Value
(
Instruction
(Character)
CHAR
C_STRING
12
C_STRING
identifier
Running
NO./Time
Command
BV01
word
Message
C_STRING
content
Message body 1or0,1means oil has been opened0means oil has been
closed
Device ID
Message
CHAR
content
Ending
identifier
Example
26
Response No
Instruction This message is available to all device
Message
Field
Beginning
Type
Length
Value
(
Instruction
(Character)
CHAR
C_STRING
12
BT00
C_STRING
Message
Content
C_STRING
identifier
Running
NO./Time
Command
word
Message
Body
Message
no
Content
Ending
CHAR
identifier
Example
Response No
Instruction This message is available to all device
Message
Field
Beginning
Type
Length
Value
(
(Character)
CHAR
C_STRING
12
identifier
Running
NO./Time
27
Instruction
Command
BR05
C_STRING
Message
Content
C_STRING
word
Message
Body
Message
no
Content
Ending
CHAR
identifier
Example
Response No
Instruction This message is available to all device
Message
Field
Beginning
Length
Value
(
(Character)
CHAR
C_STRING
12
BR06
C_STRING
Message
Content
C_STRING
identifier
Running
NO./Time
Command
word
Message
Body
Message
no
Content
Ending
CHAR
identifier
Example
28
Instruction
Response No
Instruction This message is available to all device
Message
Field
Beginning
Type
Length
Value
(
Instruction
(Character)
CHAR
C_STRING
12
C_STRING
Message
Content
C_STRING
identifier
Running
NO./Time
Command
word
Message
Body
Message
Content
Ending
N
Command
N0 or 1,0figures answer the cancelling Geo-fence. 1 figures
answer setting Geo-fence.
)
CHAR
1
identifier
Example
Response No
Instruction This message is available to all device
29
3.2.15 Obtain
terminal location
Message
Message
Field
Beginning
Type
Length
Value
(
Instruction
(Character)
CHAR
C_STRING
12
BR03
C_STRING
Message
Content
C_STRING
identifier
Running
NO./Time
Command
word
Message
Body
Message
BR03+GPS data
Content
Ending
CHAR
identifier
Example
(013632782450BR03080525A2934.0133N
10627.2544E000.0141830309.6200000000L200300C6)
Response AR03
Instruction This message is available to all device
Message
Field
Beginning
Type
Length
Value
(
(Character)
CHAR
identifier
30
Instruction
C_STRING
12
BS20
C_STRING
Message
Content
C_STRING
CHAR
Running
NO./Time
Command
word
Message
Body
Message
Content
Ending
identifier
Example
(013632782450BS20)
Response no
Instruction This message is available to all device
Message
Field
Beginning
Type
Length
Value
(
(Character)
CHAR
C_STRING
12
BP02
C_STRING
Message
Content
C_STRING
identifier
Running
NO./Time
Command
word
Message
Body
Message
Content
31
Instruction
Ending
CHAR
identifier
Example
(013632782450BP02)
Response no
Instruction This message is available to all device
3.2.18
Message
Message
Field
Beginning
Type
Length
Value
(
(Character)
CHAR
C_STRING
12
BP03
C_STRING
Message
Content
C_STRING
CHAR
identifier
Running
NO./Time
Command
word
Message
Body
Message
Content
Ending
identifier
Example
(013632782450BP03)
Response NO
Instruction This message is available to all device
32
Instruction
3.2.19
Message
Message
Field
Beginning
Type
Length
Value
(
Instruction
(Character)
CHAR
C_STRING
12
BP01
C_STRING
Message
Content
C_STRING
identifier
Running
NO./Time
Command
word
Message
Body
Unfixed length string, the platform only display the string directly
Message
Content
Ending
CHAR
identifier
Example
(013632782450BP01GPS518,DEC,22,2008)
Response NO
Instruction This message is available to all device
3.2.20
Message
Message
Field
Beginning
Type
Length
Value
(
(Character)
CHAR
C_STRING
12
C_STRING
identifier
Running
NO./Time
Command
BP21
33
Instruction
word
Message
Body
Message
Content
C_STRING
CHAR
Message
Content
Ending
identifier
Example
(013632782450BS21)
Response NO
Instruction This message is available to all device
4. Appendix
Message
Message
Type
Length
Field
Time
Value
YYMMDD
N_STRING
(Character)
6
The
availability of
GPS data
CHAR
Latitude
N_STRING
CHAR
N_STRING
10
Latitude
indicator
Longitude
N or S
34
Instruction
Two bytes for each
year/month/day
A or V. A means
the availability of GPS
dataV means the
invalidation of GPS data.
The unit is degree for he
front two bytes from
090the unit is cent
for later seven bytes
N
means
north
latitude S means
south latitude
The unit is degree for he
front three bytes, from
Longitude
indicator
Speed
Time
E or W
CHAR
HHMMSS
N_STRING
N_STRING
5
6
N_STRING
Orientation
IO State
Milepost
Mile data
0 or 1
N_STRING
CHAR
H_STRING
1
8
35