100% found this document useful (1 vote)
124 views

Protocolo Box Tracker

The document outlines the CanTrack protocol for communicating between tracking devices and servers. It includes: 1. The command structure for sending commands from servers to devices and receiving responses from devices. 2. The different types of data packets including login, heartbeat, GPS, and LBS data. 3. How device status and events are represented in a 4-byte status field using binary values for things like alarms, ACC status, and battery level.

Uploaded by

registro
Copyright
© © All Rights Reserved
Available Formats
Download as PDF, TXT or read online on Scribd
100% found this document useful (1 vote)
124 views

Protocolo Box Tracker

The document outlines the CanTrack protocol for communicating between tracking devices and servers. It includes: 1. The command structure for sending commands from servers to devices and receiving responses from devices. 2. The different types of data packets including login, heartbeat, GPS, and LBS data. 3. How device status and events are represented in a 4-byte status field using binary values for things like alarms, ACC status, and battery level.

Uploaded by

registro
Copyright
© © All Rights Reserved
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 12

CANTRACK PROTOCOL

SHENZHEN CANTRACK TECHNOLOGY CO.,LTD

A/3
CONFIDENTIAL

Dec. 2021

Contents
1 / 12
CANTRACK PROTOCOL

A Command structure ................................................................................ 3

1. Structure of Sending command from server ....................................... 3

2. Structure of device response to server .............................................. 3

B Data Packet Type ................................................................................... 4

1. Login data(V0): ....................................................................... 4

2. Heartbeat data(HTBT): ............................................................ 4

3. GPS data format(V1): ...............................................................4

4. V3 data(LBS data) ..................................................................5

C Status & Events for alarm: .................................................................... 6

D Server GPRS command format ............................................................... 9

E GPRS Command List ..............................................................................9

2 / 12
CANTRACK PROTOCOL

A Command structure

1. Structure of Sending command from server


*XX,YYYYYYYYYYYYYYY,CMD,HHMMSS,PARA1,PARA2,…#

* command head
XX supplier name, ASCII character
, separator
YYYYYYYYYYYYYYY 15digit IMEI number
CMD command code
HHMMSS time:h/m/s
PARA parameter
# ending character
Must use capital letter for the initial Letter of command character without any space.

2. Structure of device response to server

General information:

*XX,YYYYYYYYYYYYYYY,V1,HHMMSS,S,latitude,D,longitude,G,speed,direction,DDMM
YY,equ _status #

*HQ,865205030330012,V1,145452,A,2240.55181,N,11358.32389,E,0.00,0,100815,FFF
FFBFF#

GPS data:

*XX,YYYYYYYYYYYYYYY,V2,HHMMSS,S,latitude,D,longitude,G,speed,direction,DDMM
YY,equ_status #

*HQ,865205030330012,V2,150421,A,2240.55841,N,11358.33462,E,2.06,0,100815,FFF
FFBFF#

Confirm data:

*XX,YYYYYYYYYYYYYYY,V4,CMD,hhmmss,HHMMSS,S,latitude,D,longitude,G,speed,d
irection,DDMMYY,equ_status #

*HQ,865205030330012,V4,S2,150950,151007,A,2240.55503,N,11358.35174,E,0.85,0,1
00815, FFFFFBFF #

3 / 12
CANTRACK PROTOCOL

B Data Packet Type

1. Login data(V0):

*HQ, YYYYYYYYYYYYYYY,V0#
*HQ,135790246811220,V0#
Device upload:*HQ,135790246811220,V0#
Server response:*HQ,135790246811220,V0#

2. Heartbeat data(HTBT):

*XX,YYYYYYYYYYYYYYY, HTBT,Bat_Percent#
*HQ,135790246811220,HTBT,100#
For example:
Device upload:*HQ,135790246811220,HTBT,100#
Server response:*HQ,135790246811220,HTBT,100#

Bat_Percent means Battery level


when power on or device wake up, device won't update heartbeat data.
After connected server successfully and Got GPS signal, device will send
heartbeat data to server at every 2 minutes.

3. GPS data format(V1):

* command head
XX Supplier name,ASCII character
, separator
YYYYYYYYYYYYYYY 15digit IMEI number
V1/V2/V3/V4 comamnd code
CMD to be confirmed command
hhmmss time value of confirmed command
HHMMSS Time
S data valid byte (A/V/B),
A represent valid data signal, V represent invalid data signal, B represent Beidou valid
data signal
Latitude latitude,format DDMM.MMMMM
D latitude symbol(N:north,S:south)
Longitude Longitude,format DDDMM.MMMMM
G Longitude symbol(E:East,W:west)
Speed range 000.00 ~ 999.99 byte (must be 3 digits XXX, if
speed is 60km/h, so it need reserve a “space” in front of
60 value)
Direction direction,true north is 0 degree,resolution 1 dgree,
clockwise
DDMMYY date/month/year
equ_status (refer < Status & Events for alarm >)
4 / 12
CANTRACK PROTOCOL

# ending

PS: prococol calculate method is decimal system. Calculate by knot. It require


transformation when analyze speed in your platform. So can not calculate by km/h
directly. For example: if it show 10 in your platform, the real speed is 10 knot/h,
10*1.852=18.52km/h.

4. V3 data(LBS data)

*XX,YYYYYYYYYYYYYYY,V3,HHMMSS,Base_Info,Battery_Info,Failure_Info,Cont,DDM
MYY,equ_status#
* command head
XX Supplier name,ASCII character
, separator
YYYYYYYYYYYYYYY 15digit IMEI number
CMD comamnd code
HHMMSS terminal time

Base_Info:Base station information format asbelow:

MCC,MNC,Base_Number,LAC1,Cell_ID1,RS1,dBm1, LAC2,Cell_ID2,RS2,dBm2,…
MCC country code, china is 460
MNC network code, china mobile 00, China Union 01
Base_Number Cell ID quantity, 00-99
LAC Base station area code
Cell_ID Cell ID number
RS signal strength, the data show empty if no signal
dBm receiving signal strength, the data show empty if no
signal
Battery_Info battery info, 0x0000-0x0299 hexadecimal represent
battery voltage
Failure_Info reboot info, 0-9
Cont ending of data for extend protocol “X” represent
DDMMYY
equ_status (refer<Status & Events for alarm >)
# End

*HQ,865205030330012,V3,000201,46000,07,009350,004022,132,-
88,009350,004032,140,,009350,004031,139,,009350,004023,133,,009350,004033,127,,
009350,004021,124,,010351,003942,118,,0256,0,X,010915,FFFFFBFF#

Explain:

1. the data represent receiving 7 Cell ID signal, battery voltage


0x256/0x400=598/1024=0.584*5.6V =3.27V, battery level is 3.27V/3.6V*100%=90.8%
without reboot.

2. Battery percentage nominal voltage is 3.6V, battery percentage top and button
limitation 1%-100%, if the upload voltage over than battery percentage top and button
limitation, it regards to parse the data based on battery percentage top and button
limitation.

5 / 12
CANTRACK PROTOCOL

C Status & Events for alarm:


equ_status
Vehicle status:total 4 bytes, means vehicle status and alarm status etc. Use
ASCII character represents Hexadecimal values, the following is the exact
meaning of single bit of variate each byte, bit represents adopt negative logic,
namely bit=0 is valid.
Important: Need convert to Binary format to get the Bit value; Check the
converted data as arrow from end to front.
Binary data is read from left to right, and from end to up data as arrow remark.

Bit order 1st byte 2nd byte 3rd byte 4th byte

0 1 Reserved 1 Reserved 1 Reserved 1 Reserved

1 1 1 Arm(0)/Disarm(1 Movement
Reserved Reserved 0 0
) condition alarm

2 0 0 Overs
Removal alar
SOS Alarm 0 ACC off 0 peeding
m
alarm

3 0 0: Cut fuel 0 Device


status powered by
0 Vibration alarm 1 Reserved
1: resume the backup
fuel status battery

4 0 Power cut 0 External


alarm power Low battery Fence-in
0 0
disconnected alarm alarm
status

5 1 Reserved 1 Reserved 0 Sharp Turning 0 Fatigue


driving alarm

6 1 Reserved 0 ACC ON 0 Harsh 0 Harsh


alarm acceleration braking

7 1 Reserved 0 ACC OFF Fence-out


1 Reserved 0
alarm alarm

6 / 12
CANTRACK PROTOCOL

How to parse Events & status packet “FFFF FFFF”?

7 / 12
CANTRACK PROTOCOL

8 / 12
CANTRACK PROTOCOL

D Server GPRS command format


Command Format:
*XX, YYYYYYYYYYYYYYY,CMD,HHMMSS,command#
“command” refers to command list ( see Part E command list below)

For example:
Send: *HQ,865205039927404,CMD,130305,stop654321#
Reply: stop engine succeed

Send: *HQ,865205039927404,CMD,130305,stop654321#
Reply: resume engine succeed

E GPRS Command List


(Note all GPRS command password default 654321)

Command format Function

apn654321 APN APNname APNpassword Set APN

adminip654321 www.gps2828.com 7018 Set IP Port

password654321 888888 Change password

smslink654321 google link

fix020s060m***n654321 Set upload interval,moving at 20s, stopping at 60mins

ANGLE654321 30 Set angle change upload interval 30 degree

acc654321 ACC ON OFF alarm

noacc654321 Cancel ACC ON OFF alarm

acc654321 1 Activate ACC ON alarm via speaker sound

acc654321 0 Cancel ACC ON alarm via speaker sound

quickstop654321 Set fast cut fuel mode

noquickstop654321 Set delayed cut fuel when speed less than 20km/h(default)

stop654321 Cut fuel to stop car

9 / 12
CANTRACK PROTOCOL

resume654321 resume fuel

arm654321 Set arm mode when ACC OFF

disarm654321 Cancel arm mode

silent654321 Silent mode(speaker not sound but send SMS alarm)

lowbattery654321 on Activate Low battery alarm(default)

lowbattery654321 off Cancel Low battery alarm

extpower654321 on Activate device removal alarm(default)

extpower654321 off Cancel device removal alarm

move654321 0200 movement alarm(200meters)

nomove654321 Cancel movement alarm

vibrate654321 1 Activate vibrate alarm

vibrate654321 0 Cancel vibrate alarm(default)

sensitivity654321 1 Set vibrate level 1

sensitivity654321 2 Set vibrate level 2

sensitivity654321 3 Set vibrate level 3

sleep654321 on GSM/GPS sleep when vehicle parking

sleep654321 off Cancel sleep mode(default)

suppress654321 Activate GPS drifting during parking

nosuppress654321 Cancel GPS drifting

check654321 Check device parameters

IPAPN654321 IP APN Checking

time zone654321 -5 Set timezone west timezone 5

reset654321 Reset device

KC654321 0 Cancel alarm

KC654321 1 GPRS alarm (default)

KC654321 2 GPRS+SMS alarm

10 / 12
CANTRACK PROTOCOL

KC654321 3 GPRS+SMS+call alarm

admin654321 15018500598 Set admin number

noadmin654321 15018500598 Delete admin number

authnum654321 Check admin number

foward654321 10086 SIM Card Balance Enquiry: eg, set operator number 10086

balance654321 10086 ye SIM Card Balance Enquiry: eg, set operator code ye

X:0, driving status judge via ACC or Vibration(default)


drv654321 X
X: 1, driving status judge via ACC

Device will stop connect server enter deeply sleep after stop 5
Less gprs654321 on mins or ACC off; when driving or ACC on again will wake up
device.

Less gprs654321 off Default

Harsh Acceleration

X: 0 or 1 (cancel or activate).

accthr654321 X X: unit:km/h, value range 25-100,default 40.

Alarm triggered by speed difference within 5s.

Send APP alarm 1 time, send SMS alarm 1 time within 10mins.

Harsh Braking

X: 0 or 1 (cancel or activate).

brakethr654321 X X: unit:km/h, value range 25-100,default 40km/h.

Alarm triggered by speed difference within 5s.

Send APP alarm 1 time, send SMS alarm 1 time within 10mins.

Harsh Turning

X: 0 or 1 (cancel or activate).

turnthr654321 X X: unit:degree, value range 25-100,default 50 degree.

Alarm triggered by degree difference within 5s.

Send APP alarm 1 time, send SMS alarm 1 time within 10mins.

Fatigue Driving alarm

fatigue654321 X X: 0 or 1 (cancel or activate)

X: unit:degree, value range 25-100,default 50 degree.

11 / 12
CANTRACK PROTOCOL

Alarm triggered by continuously driving 4 hours.

Send APP alarm 1 time, send SMS alarm 1 time within 10mins.

Ver654321 Check version

OTA654321 100.245.15.11 8989 OTA Firmware

begin654321 Back to factory settings

12 / 12

You might also like