KHD KG100 User manual

WWW.KHD.HK GPRS Communication Standard Protocol
GPRS Communication Protocol
Between GPS Tracker and Server
version V2.02
KG100/KG200/KG300/KC200
Change Version Change Record Date
V1.00 Build file 2008-8-21
by George
V1.01 Add parking overtime with time 2008-10-23
By George
V1.02 Change sign in to illegal ignition and add illegal ignition
alarm
2008-10-23
By George
V1.10 Add user define alarm bit in alarm info 2008-12-16
By George
V1.20 Change fatigue drive alarm mode, add clear value for illegal
ignition alarm , add penetrate transmit data for serial 2-7
2009-3-16
By George
V1.28 Add acc status in 0x82 packet 2009-4-30
By JGShi
V1.41 Add remote update result upload A5 command. 209-7-21
By George
V2.00 Format change and add protocol for new functions in 108 2012.5-15
By liven
V2.01 Add 8E data description 2012.12-19
By Liven
V2.02 Add command 0x71, 0xA3, 0xD3,0xD4,0xD9,0xDA,
0xDB, 0xDC, Appendix1 Position Data.
2013.06-15
By Wayne

KHD GPS Tracker GPRS Communication Standard Protocol
Internal documents, forbidden copies in any form unless get company approved
2

KHD GPS Tracker GPRS Communication Standard Protocol
Internal documents, forbidden copies in any form unless get company approved
3
Content
I Command Format ......................................................................................... 5
II Command List ............................................................................................. 6
III Command Details ....................................................................................... 8
1. Login – 0xB1 ................................................................................................. 8
2. Login/Server Confirmation – 0x21 ................................................................... 8
3. One time track on demand – 0x30 ................................................................... 8
4. One time track on demand reply – 0x81 ........................................................... 9
5. Tracking by Interval (Acc_On) – 0x34 .............................................................. 9
6. Tracking by Interval (Acc_Off) – 0x70 .............................................................. 9
7. Track by Distance – 0x35 .............................................................................. 10
8. Position Data Upload (by Interval, distance) – 0x80 ........................................ 10
9. Blind Area Data re-Upload – 0x8E .................................................................. 10
10. Over speed Alarm Set – 0x3F ........................................................................ 11
11. Movement Alarm – 0xC7 ............................................................................... 11
12. Stop Engine (Remote Immobilize) – 0x39 ....................................................... 11
13. Recover Engine (Disable Immobilize) – 0x38 .................................................. 12
14. Listen in (Voice Monitoring) – 0x3E ................................................................ 12
15. Set Geo-Fencing – 0x46 ................................................................................ 12
16. Cancel Geo-Fencing – 0x47 ........................................................................... 13
17. Inquiry GEO Fencing – 0x48 .......................................................................... 13
18. Send Dispatch Info – 0x3A ............................................................................ 14
19. Delete Mileage – 0x66 .................................................................................. 14
20. Alarm Info – 0x82 ........................................................................................ 14
21. Cancel Alarm – 0x37 .................................................................................... 15
22. Set GPRS Parameters – 0xC1 ........................................................................ 15
23. Set Server IP and Port In Device – 0x69 ......................................................... 15
24. Set Reply – 0x85 .......................................................................................... 16
25. Illegal Ignition Set -0xC6 .............................................................................. 16
26. Device Factory Reset – 0xC3 ......................................................................... 17
27. Set Vehicle Idle Alarm – 0x4B ........................................................................ 17
28. Check Device Version – 0x3D ........................................................................ 17
29. Check Device Version Reply – 0x84 ................................................................ 18
30. Get Current Address – 0xA8 .......................................................................... 18
31. Get Current Address Reply – 0x72 ................................................................. 18
32. Remote Update Firmware – 0xD2 .................................................................. 19
33. Remote Update Firmware Result – 0xA5 ......................................................... 19
34. Camera Related Command – 0x28/0x65/0x26/0xAB ........................................ 20
35. Temperature alarm set – 0x71 ....................................................................... 20
36. Peripheral data info upload –0xA3 ................................................................. 20
37. Fuel level sensor Parameter Set – 0xD3 ......................................................... 21
38. Real-time tracking by Interval – 0xD4 ............................................................ 21

KHD GPS Tracker GPRS Communication Standard Protocol
Internal documents, forbidden copies in any form unless get company approved
4
39. Tracking compensation by angle – 0xD9 ......................................................... 22
40. Fatigue driving alarm set – 0xDA ................................................................... 22
41. Over Speed alarm and trig-time set – 0xDB .................................................... 23
42. Device odometer value set – 0xDC ................................................................ 24
Appendix 1 Position Data ............................................................................... 25
Appendix 2 Alarm Data .................................................................................. 28
Appendix 3 peripheral data ............................................................................ 29

KHD GPS Tracker GPRS Communication Standard Protocol
Internal documents, forbidden copies in any form unless get company approved
5
I Command Format
Commands format of GPRS Packets are defined as following:
From Server to Device:
))<Command(1byte)><L(2 bytes)><ID(4bytes)><Parameter(s)><Checksum>\r
From Device to Server:
))<Command(1byte)><L(2 bytes)><ID(4bytes)><data><Checksum>\r
Note:
1. Do not input ‘<’ and ‘>’ in the command content.
2. All Muti-byte data complies with the following sequence: High byte prior to the
low byte (Big Endian).
3. The size of one location data packet is about 50 bytes.
Item Specification
)) 2bytes. It is header for all correct packets. ‘))’ is ASCII code, in
hex code it is 0x29 0x29.
Command 1 byte. It is in hex code, every packet have one and only
command word. For detail, please refer to Part II Command
List
L 2 bytes. It means the length from Length byte (not include
length byte) to packet end, include the end byte. It is in hex
code.
ID 4bytes. It is in hex code. Every device has one and only ID, It is
calculate from the device SN.
For example: Suppose the device SN is: 29800298
Divide into 4 parts: 29 80 02 98
Convert to hex: 1D 50 02 62
Add 0x80 to 2nd,3rd part: 1D D0 82 62
Then you get the device ID: 1DD08262
Parameter/data Minimum 0 byte, maxmum 200byte, see appendix 1 for data
description.
Checksum 1 bytes, it is xor checksum, for example:
if the packet is: 29 29 B1 00 07 0A 9F 95 38 0C 82 0D
0x82= 29 xor 29 xor B1 xor 00 xor 07 xor 0A xor 9F xor 95 xor
38 xor 0C
\r 1 bytes, it is end byte of package, in hex it is 0D

KHD GPS Tracker GPRS Communication Standard Protocol
Internal documents, forbidden copies in any form unless get company approved
6
II Command List
Command Page
1. Login – 0xB1............................................................................................. 8
2. Login/Server Confirmation – 0x21 .............................................................. 8
3. Track on Demand – 0x30 ........................................................................... 8
4. Track on Demand Reply – 0x81 .................................................................. 9
5. Track by Interval (motion) – 0x34 .............................................................. 9
6. Track by Interval (motionless) – 0x70 ......................................................... 9
7. Track by Distance – 0x35 ......................................................................... 10
8. Position Data Upload (by Interval, distance) – 0x80 .................................. 10
9. Blind Area Data re-Upload – 0x8E ............................................................ 10
10. Over speed Alarm Set – 0x3F ................................................................... 11
11. Movement Alarm – 0xC7 .......................................................................... 11
12. Stop Engine (Remote Immobilize) – 0x39 ................................................. 11
13. Recover Engine (Disable Immobilize) – 0x38 ............................................. 12
14. Listen in (Voice Monitoring) – 0x3E .......................................................... 12
15. Set Geo-Fencing – 0x46........................................................................... 12
16. Cancel Geo-Fencing – 0x47 ...................................................................... 13
17. Inquiry GEO Fencing – 0x48 .................................................................... 13
18. Send Dispatch Info – 0x3A ...................................................................... 14
19. Delete Mileage – 0x66 ............................................................................. 14
20. Alarm Info – 0x82 ................................................................................... 14
21. Cancel Alarm – 0x37 ............................................................................... 15
22. Set GPRS Parameters – 0xC1 ................................................................... 15
23. Set Server IP and Port In Device – 0x69 ................................................... 15
24. Set Reply – 0x85 ..................................................................................... 16
25. Illegal Ignition Set -0xC6 ......................................................................... 16
26. Device Factory Reset – 0xC3 .................................................................... 17
27. Set Vehicle Idle Alarm – 0x4B .................................................................. 17
28. Check Device Version – 0x3D ................................................................... 17
29. Check Device Version Reply – 0x84 .......................................................... 18
30. Get Current Address – 0xA8 ..................................................................... 18
31. Get Current Address Reply – 0x72 ............................................................ 18
32. Remote Update Firmware – 0xD2 ............................................................. 19
33. Remote Update Firmware Result – 0xA5 ................................................... 19

KHD GPS Tracker GPRS Communication Standard Protocol
Internal documents, forbidden copies in any form unless get company approved
7
34. Camera Related Command – 0x28/0x65/0x26/0xAB .................................. 20

KHD GPS Tracker GPRS Communication Standard Protocol
Internal documents, forbidden copies in any form unless get company approved
8
III Command Details
1. Login – 0xB1
Command: ))<0xB1><L><ID><reserved><Checksum><\r>
Description:
After your device installed properly, device will send this packet
to server for login. It will send every 30s, like heart beat.It
must be reply, If server does not give reply (see Login
confirmation), device will keep send this packet without any
other packet; after get reply, other commands start work.
Example: 29 29 B1 00 07 0A 9F 95 38 0C 82 0D
Note:
In example, the ID is 0A9F9538, change to device SN, it is
10312156. In <reserved> part 0x0C, we keep it as future use;
do not have certain meaning now.
2. Login/Server Confirmation – 0x21
Command: ))<0x21><L><receive package check sum><receive package
command><reserved><Checksum><\r>
Description: This command is send from server to device, to confirm some
information, like login, some important alarm, and so on.
Example: 29 29 21 00 05 82 B1 06 11 0D
Note:
The example is the confirmation for packet 29 29 B1 00 07 0A
9F 95 38 0C 82 0D, <receive package check sum> is 0x82,
<receive package command> is 0xB1, <reserved> part is
0x06.
3. One time track on demand – 0x30
Command: ))<0x30><L><ID><Checksum><\r>
Description:
This command will get current location data when you send,
and device only upload location data once. About the device
reply, See Reply.
Example: 29 29 30 00 06 0A 9F 95 38 0E 0D
Note: This command used when you want track manually, you can
send this command from software platform to device.

KHD GPS Tracker GPRS Communication Standard Protocol
Internal documents, forbidden copies in any form unless get company approved
9
4. One time track on demand reply – 0x81
Command: ))<0x81><L><ID><Position data><Checksum><\r>
Description:
Reply packet for track on demand command; send current
position, speed, and status data to server. From device to server.
About <Position data> description , please see Appendix 1
Positon data
Example: 29298100280A9F95380812281601310223943011403725000003
30FF0000007FFC0F00001E000000000034290D
Note: The data between <ID> and <Checksum> is Position data.
5. Tracking by Interval (Acc_On) – 0x34
Command: ))<0x34><L><ID>< Parameter ><Checksum><\r>
Description:
This is command for setting device upload by time interval
when ACC on. Our device default upload interval is 30s, you
can change or set it with this command, the content of
<parameter> part is interval, and unit is second, in hex code.
After receive this command, device will give Set Reply. And
the packet send by interval to server see Position Data
Upload.
Example: 29 29 34 00 08 0A 9F 95 38 00 1E 1A 0D
Note: In this example, the interval is 001E, In decimal it is 30, so this
command will set the device upload with interval 30s.
6. Tracking by Interval (Acc_Off) – 0x70
Command: ))<0x70><L><ID>< Parameter ><Checksum><\r>
Description:
This is command for setting device upload by time interval
when ACC off. Our device default upload interval is 30s, you
can change or set it with this command, the content of
<parameter> part is interval, and unit is second, in hex code.
After receive this command, device will give Set Reply. And
the packet send by interval to server see Position Data
Upload.
Example: 29 29 70 00 08 0A 9F 95 38 00 1E 5E 0D
Note: In this example, the interval is 001E, In decimal it is 30, so this
command will set the device upload with interval 30s.

KHD GPS Tracker GPRS Communication Standard Protocol
Internal documents, forbidden copies in any form unless get company approved 10
7. Track by Distance – 0x35
Command: ))<0x35><L><ID>< Parameter ><Checksum><\r>
Description:
This command set device upload when moving a certain
distance. In default device have close this function, use this
command to change the upload rule to distance interval. The
content of <parameter> part is distance interval; the unit of it
is meter, in hex code. After receive this command device will
send Set Reply, And the packet send by interval to server see
Position Data Upload.
Example: 29 29 35 00 08 0A 9F 95 38 00 64 61 0D
Note: In this example, the interval is 0064, in decimal it is 100, the
device will upload with interval 100m.
8. Position Data Upload (by Interval, distance) – 0x80
Command: ))<0x80><L><ID><data><Checksum><\r>
Description:
This packet is send from device to server, send by interval set
to device. In default, our device will send this packet every 30s
after login. About the <data> description, please see
Appendix 1 Positon data.
Example:
29 29 80 00 28 0A 81 85 0A 12 03 10 09 57 50 00 52 81 37 00
61 19 08 00 00 02 32 F8 48 FF BB FF FF 00 00 00 1E 00 00 00
00 00 00 ED 0D
Note: The data between <ID> and <Checksum> is Position data.
9. Blind Area Data re-Upload – 0x8E
Command: ))<0x8E><L><ID><data><Checksum><\r>
Description:
This packet is send from device to server, send by interval set
to device. In default, our device will send this packet every 30s
after login. About the <data> description, please see
Appendix 1 Positon data.
Example:
29 29 8E 00 28 0F 80 81 5A 12 12 18 20 31 16 02 23 18 46 11
40 22 70 00 72 02 62 FB 00 07 7C 7F BF 56 00 00 1E 3C 32 00
00 00 00 85 0D
Note: The data between <ID> and <Checksum> is Position data.