GPS Tracker TK103 Protocol
GPS Tracker TK103 Protocol
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, the tracker will feedback a enrolling
message. The enrolling message contains the device’s 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 one 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.
Each Full data frame must contain: Head symbol, Serial Number/ Time, Command
word, Message body, Trail symbol
Symbol digit figures the beginning and ending of the message frame. 0x28H
(character “(” ) as beginning symbol,and 0x29H (character “)” ) as ending symbol.
1
Function:Define the type of operated message for data frame transmitting, and
figures the function of data. The definition is as following,
Table 2 Message Definition
Main first Second Message Command description Remark
types of types of serial NO.
#
Message Message
00 One time calling message
3.1.5
01 Response handshake signal
message 3.1.1
03 Read device parameter
P configuring message
04 Read device operated status
A message
(Down 05 Device login response Device
Message) message 3.1.2 parameter
07 Center No. configuring message
message
11 Cell phone NO. configuring
message
12 Setting vehicle high and low
limit speed 3.1.8
15 Monitor Command
17 Read device cell phone
configuring
00 Common Message
General
01 Attemper Message
communica
Answer of calling
Q 02 tion
message(Taxi)
message
03 Calling Message(Taxi)
04 Navigation Message
00 Isochronous for continues
feedback configuring 3.1.3
Vehicle
01 Isometry for continues
positioning
feedback configuring
R Message
05 Set ACC open sending data
Answer
transmiting intervals 3.1.12
message
06 Set ACC open sending data
transmiting intervals 3.1.13
01 Answer Alarm Message
3.1.4
S 07 Answer Message for getting Answer
customer successfully signal
(Taxi)
2
00 Control the restarted
T
message of the device 3.1.11
00 Circuit control signal 3.1.9
Control
01 Oil control signal 3.1.10
signal
V 02 One key configuring
command
03 Read one key configuring
00 Answer currency up
explaining result message
01 Alarm configuring message
02 Device Function configuring
command Expanding
X
03 Device mode configured message
command
04 Intialized device command
05 Setting Geo-fence Message
3.1.14
B 01 Alarm message 3.2.4 Alarm
O
(Up message
Message) 00 Handshake signal message
3.2.1
02 Answer device parameter Device
configured message status
03 Answer device operated message
status message
04 Answer calling message
P
3.2.5
05 Anser device login response
message 3.2.2
12 Answer vehicle high and low
speed limit 3.2.8
Message for getting
07
customer successfully (Taxi)
00 Isochronous for continues
feedback message 3.2.6
01 Isometry continous feedback
R message
02 Continues feedback ending Vehicle
messsage3.2.7 positioning
05 Answer the Setting ACC message
open sending data
transmiting intervals 3.2.12
06 Answer the Setting ACC
open sending data
transmiting intervals 3.2.13
3
04 Answer attempered Message
05 Answer reading called
configuring number
06 Answer calle configuring
number
08 Answer setting isochronous
feedback message 3.2.3 Answer
S
09 Answer setting Isometry message
feedback message
20 Answer response calling
message (Taxi)
21 Answer calling
message(Taxi)
23 Answer navigation message
T 00 Answer the restarted
message of the device 3.2.11
U 00 Answer the Setting
Geo-fence Message 3.2.14
V 00 Answer circuit control 3.2.9 Answer
01 Answer oil control 3.2.10 control sign
02 Answer enquiring of one key
setting
Reserved the non- definition message for expanding message in future
The words in red is the functions the device had.
2.3.3 Device ID
Length:15 bytes (Fixed); Type: C_STRING.
Function:This 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”
4
3. Command Message
3.1.Down Message(platform server sending)
3.1.1 Answer handshake signal message
Ending ) CHAR 1
identifier
For example:
(013612345678AP01HSO )
Down response handshake signal message, “13612345678” is tracker ID.
Response No need response
Instruction: This message is available to all device
Ending ) CHAR 1
identifier
For example
5
(013612345678AP05)
“13612345678” is tracker ID.
Instruction: This message is available to all device
identifier
Running C_STRING 12
NO./Time
Command AR00 C_STRING 4
word
Message C_STRING 8
Body
Message AR00XXXXYYZZ
AR00:Fixed key words
Content XXXX:Interval for each message of continues feedback. hex。Unit:
Second, 4 characters in all, H_STRING. The max is 0xFFFF
seconds。When XXXX=0,the device stops continues feedback.
YYZZ:The total time for feedback, 16 advance system. Unit:
YY:Hour、ZZ:Minute. 4 characters in all,H_STRING,The max
is 0xFFFF,ie:255 hours 255 minutes. When YYZZ=0, according
to the time intervals, continues feedback.
When both XXXX and YYZZ are not 0,it figure that feedback
according to the time intervals, when it up to the total time, it
automaticly stop to feedback
Ending ) CHAR 1
identifier
For example:
(013612345678AR0000140024)
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. “13612345678” is tracker
ID.
Response Device response BS08
Sending Short Message, GPRS
mode
6
Instruction This message is available to ecolomic device and navigation device.
In the mode of SMS to continues feedback, if set time interval is less
than the Min time interval (Set by the device manufacturer),it will
continues feedback according to the Min time interval, otherwise
continues feedback according to the set time. The data mode is the
same as the SMS mode.
7
body content
Message
body
Ending ) CHAR 1
identifier
For example:
(013612345678AP00)
Closed the oil.“13612345678” is tracker ID.
Response Device response BP04
Instruction: This message is available to all device
identifier
Running C_STRING 12
NO./Time
Command AP12 C_STRING 4
word
Message Message C_STRING
content
Body
Message H050L030
Content
Ending ) CHAR 1
identifier
For example:
(013612345678AP12 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。
“13612345678” is tracker ID.
Response BP12
Instruction: This message is available to all device
8
3.1.9 Circuit control signal
identifier
Running C_STRING 12
NO./Time
Command AV00 C_STRING 4
word
Message Message C_STRING
content
Body
Message “1”or“0”, “1”figures opening circuit,“0”figures closing circuit.
Content
Ending ) CHAR 1
identifier
For example:
(013612345678AV00 0 )
Closed the circuit, “13612345678” is tracker ID.
Response BV00
Instruction: This message is available to all device
Ending ) CHAR 1
identifer
9
For example:
(013612345678AV01 0 )
Closed the oil。“13612345678” is tracker ID.
Responds: BV00
Instruction: This message is available to all device
Ending ) CHAR 1
identifier
For example
(013612345678AT00)
The device restart. “13612345678” is tracker ID.
Response BT00
Instruction: This message is available to all device
10
Message AR05XXXX
content AR05:Fixed keywords
XXXX:The time for sending data intervals for the ACC Open, hex.
Unit:Second
Ending ) CHAR 1
identifier
For example
(013612345678AR050014)
It sends back intervals 20 seconds when the ACC is opening. “13612345678” is
tracker ID.
Response BR05
Instruction: This message is available to all device
Ending ) CHAR 1
identifier
For example
(013612345678AR06003C)
It sends back intervals 20 seconds when the ACC is closing. “13612345678” is
tracker ID.
Response BR06
Instruction: This message is available to all device
11
3.1.14 Setting Geo-fence Message
Ending ) CHAR 1
identifier
For example
(013612345678AX051, N,2245.318,2246.452,E,11233.232,11355.175)
Set Geo-fence., lower limit for latitude is 22 degree 45.318 cent,upper limit for
12
latitude is 22 degree 46.452 cent; lower limit for longitude is 112 degree 33.232
cent,upper limit for longitude is 113 degree 55.175 cent.“13612345678” is tracker
ID.
Response BU00
Instruction: This message is available to all device
13
3.2.2 Login message
identifier
Running C_STRING 12
NO./Time
Command BP05 C_STRING 4
word
Device ID Terminal ID C_STRING 15
Ending ) CHAR 1
identifier
Example:
(013612345678BP05000013612345678080524A2232.9806N11404.9355E000.1101
241323.8700000000L000450AC)
identifier
Running C_STRING 12
NO./Time
Command word BS08 C_STRING 4
14
Message Body C_STRING 8
identifier
15
Running C_STRING 12
NO./Time
Command BO01 C_STRING 4
word
Message C_STRING 61
Body
Message BO01X+GPS data
Content BO01:Fixed keywords
X:Specific alarm information code,1 byte,Hexadecimal。
Alarm information:
0:Vehicle power off 1:Accident 2:Vehicle robbery(SOS
help)
3:Vehicle anti-theft and alarming 4:Lowerspeed Alert
5:Overspeed Alert 6:Alarm when out of Geo-fence
Ending ) CHAR 1
identifier
Example:
(013612345678BO019061830A2934.0133
N10627.2544E040.0080331309.6200000000L000770AD)
Alarm message and vehicle robbery。GPS 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 longitude,speed is 040.0 km/h,
the angle is 309.62 degrees, from due north。”L” means the sum of distance, unit is
meter,mileage statistic。
Response: Centre response AS01
Instruction This message applies to all terminals。Send the information up to 10
times every30 seconds,No longer to send the information after
receive the platform response。
16
3.2.5 Answer Calling Message
identifier
Running C_STRING 12
NO./Time
Command BP04 C_STRING 4
word
Message C_STRING Random
length
Body
Message BP04+GPS data
Content BP04:fix Command Word。
Ending ) CHAR 1
identifier
Example
(013612345678BP04080525A2934.0133N
10627.2544E000.0141830309.6200000000L00000023)
Up terminal news(center response by one roll call),GPS data acquisition time is
May25,2008,Universal time is 14:18:30,”A” shows the data available,29
degrees,34.0133 minutes north latitude,106 degrees 27.2544 minutes east
longitude,speed is 0km/h,the angle is 309.62 degrees, from due north.。
Response No
Instruction: This message is available to all device
17
identifier
Running C_STRING 12
NO./Time
Command BR00 C_STRING 4
word
Message body C_STRING
Message ) CHAR 1
content
Ending
identifier
Example
(013612345678BR00080612A2232.9828N11404.9297E000.0022828000.00000000
00L000230AA)
Response No
Instruction This message applies to economically terminals and
navigational terminals。Continuously return total time and
distance,or receive the message of stop continuously
return message from the center., then send the ending
message to center。
identifier
Running C_STRING 12
NO./Time
Command BR02 C_STRING 4
18
word
Device ID C_STRING Random
length
Message body BR02 + GPS data
Message ) CHAR 1
content
Ending
identifier
Example:
Response: No
Instruction This message applies to economically terminals and navigational
terminals。Continuously return total time and distance,or receive the
message of stop continuously return message from the center., then
send the ending message to center
19
content
Ending
identifier
Example:
(013612345678BP12 H0501L030 )
Response: No
Instruction: This message is available to all device
20
C_STRING 12
Running
NO./Time
BV01 C_STRING 4
Command
word
Message C_STRING
Device ID
content
Message body “1”or“0”,“1”means oil has been opened,“0”means oil has been
closed。
) CHAR 1
Message
content
Ending
identifier
Example:
Response: No
Instruction: This message is available to all device
identifier
Running C_STRING 12
NO./Time
Command BT00 C_STRING 4
word
Message Message C_STRING
Content
Body
Message no
Content
Ending ) CHAR 1
21
identifier
Example:
Response: No
Instruction: This message is available to all device
identifier
Running C_STRING 12
NO./Time
Command BR05 C_STRING 4
word
Message Message C_STRING
Content
Body
Message no
Content
Ending ) CHAR 1
identifier
Example:
Response: No
Instruction: This message is available to all device
22
identifier
Running C_STRING 12
NO./Time
Command BR06 C_STRING 4
word
Message Message C_STRING
Content
Body
Message no
Content
Ending ) CHAR 1
identifier
Example:
Response: No
Instruction: This message is available to all device
identifier
Running C_STRING 12
NO./Time
Command BU00 C_STRING 4
word
Message Message C_STRING
Content
Body
Message BU00N
BU00:Command
Content N:0 or 1, “0”figures answer the cancelling Geo-fence. “1” figures
answer setting Geo-fence.
Ending ) CHAR 1
23
identifier
Example:
Response: No
Instruction: This message is available to all device
24
4. Appendix
25
"1" means ACC on.
Other reservations
Milepost CHAR 1 “L” mean Mileage
Mile data H_STRING 8 Mile data,Unit: Meter
The total mileage. The
max is 0xFFFFFFFF
26