Coban Gprs Protocol
Coban Gprs Protocol
2014-12-12
V0.1 2012-11-20
2. HEARTBEAT-PACKETS .............................................................................................................. 1
V0.1 2012-11-20 拟制
V0.2 2013-02-5 添加调度屏和广告屏协议
V0.1 2012-11-20
2. Heartbeat-packets
To make sure the device real time online, the device send timed heartbeat-packet. Interval time is
one minute.
Send Response
Keywor Keywor
Function explanation Function explanation
d d
100 Single track 001
101 Auto track continuously 001
Cancel Auto continuous track
102 Cancel Auto continuous track 102
successfully
103 Track upon distance interval 001
104 Cancel alarm 104 Cancel alarm successfully
105 Set movement alarm 105 Set movement alarm
Cancel movement alarm
106 Cancel movement alarm 106
successfully
第 1 页 共 15 页
V0.1 2012-11-20
Data load
116 116 Data load successfully
118 Set less GPRS Traffic 118 Set less GPRS Traffic successfully
Close less GPRS Traffic
119 Cancel less GPRS Traffic 119
Successfully
Automatic update positions of Automatic update positions of
120 120
vehicle turns vehicle turns successfully
Set multi-area management
121 Set multi-area management 121
successfully
122 Set IP , Port for Address Function 122 Set IP , Port for Address Function
123 Set shock alarm 123 Set shock alarm successfully
124 Cancel shock alarm 124 Cancel shock alarm successfully
125 Remote start successfully
125 Remote start 525 ACC off
526 No appointment
126 Set OBDII data sending way 126 Set successfully
Activate speed limit mode
150 Activate speed limit mode 150
successfully
Deactivate speed limit mode
151 Deactivate speed limit mode 151
successfully
第 2 页 共 15 页
V0.1 2012-11-20
第 3 页 共 15 页
V0.1 2012-11-20
Content specification
Content after the first comma is: keywords
Content after the second comma is: year, month, day, hour, second
Content after the third comma is: the number of sim card in the tracker
Content after the fourth comma is: whether the signal of GPS is ok.
F means gps data is valid, L means no gps signal. In the old version, it is 5 comma
when L, the following field is null. It stand for LBS in the new version, LAC is
instead of latitude, Cellid is instead of longitude.
imei:359586015829802,help me,000000000,13554900601,L,,,22820,,10320,,,,;
Content after the fifth comma is: hour, minute, second of zero time zone
Content after the sixth comma is: Be corresponding to the content after the fourth
comma, A=F,V=L;
Content after the seventh comma is: Latitude
Content after the eighth comma is: N is north latitude, S is south latitude
Content after the ninth comma is: Longitude
第 4 页 共 15 页
V0.1 2012-11-20
Content after the tenth comma is: E is east longitude, W is west longitude
Content after the eleventh comma is: speed
Content after the twelfth comma is: 1 stand for address request, non-1 stand for
direction ( Direction will be sure with a decimal point )
Content after the thirteenth comma is: altitude
Content after the fourteenth comma is: The current state of the vehicle ACC; 1 is on,
0 is off
Content after the fifteenth comma is: The current state of the vehicle door; 1 is open
the door, 0 is close the door
Content after the sixteenth comma is: the remaining Oil percentage in the fuel tank 1
Content after the seventeenth comma is: the remaining oil percentage in the fuel tank
2
Content after the eighteenth comma is: The current temperature sensor indicated
End with a semicolon after the nineteenth comma.
di di di di
Ac ag ag ag ag
W
cu Th no no no no
at
mu In A Dr rot En ba sti sti sti sti
Po er
la st ve ivi tle gi tte c c c c
S w te
keywo ti an ra ng pe ne ry tr tr tr tr
Time pe er m
rds ve t ge ti rc sp vo ou ou ou ou
ed lo pe
mi fu Fu m en ee lta bl bl bl bl
ad ra
le el el e ta d ge e e e e
tu
ag ge co co co co
re
e de de de de
1 2 3 4
,08092319
,OBD ,
29
Pr Le L Pr r Pr Le Pr Ri
ri
es ft e es i es ft es gh Ri
Nu gh le
de s fr f s g s re s t gh
mb t ft
vi of on t of h of ar of re t
er Fr re
keywo ce Le t F ri t Le te ri ar re
Time of on ar
rds st ft te r gh f ft mp gh te ar
wh t st
at fr mp o t r re er t mp st
ee st at
e on er n fr o ar at re er at
ls at e
t at t on n ti ur ar at e
e
ti ur s t t re e ti ur
第 5 页 共 15 页
V0.1 2012-11-20
re e t ti t re e
a re e
t m
e p
e
r
a
t
u
r
e
,TPM ,08092319
,
S 29
第 6 页 共 15 页
V0.1 2012-11-20
5.1.1.Single Locating
server device
**,imei:359586018966098,100
device server
imei:353451044508750,001,0809231929,,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
server device
**,imei:359586018966098,101,10s
Tracker report location information to the server by time intervals, this time intervals can vary
from 10 S, or 15S or 30 minutes.
imei:353451044508750,001,0809231929,,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
server device
**,imei:359586018966098,103,0200m
After set track upon time interval , set track upon distance interval, tracker will track upon
time and distance interval: when device movement reaches the limited settings and reaches
reporting interval, device will report location information.
Some products on the 001 field has been expanded, including the current oil data, while others
include the current temperature .
Location information (after"001", distinct by space, the first one is the current amount of oil,
the second is the current temperature):
Only including the current oil data,
imei:359586015829802,001 10.00,0809231429,,F,062947.294,A,2234.4026,N,11354.3277,E,0.00,360.00;
Meanwhile, including the current oil data and temperature .
imei:359586015829802,001 0.1% +28.0,0809231429,,F,062947.294,A,2234.4026,N,11354.3277,E,0.00,360.00;
newest version Location information extend as follow format
第 7 页 共 15 页
V0.1 2012-11-20
imei:353451044508750,001,0809231929,13554900601,F,055403.000,A,2233.1870,N,11354.306
7,E,0.00,30.1,65.43,1,0,10.5%,0.0%,+28.0;
GPS105, oil 2 fields define to the current definition of the cumulative mileage.
Contents is long integer number string.
imei:353451044508750,001,0809231929,13554900601,F,055403.000,A,2233.1870,N,11354.306
7,E,0.00,30.1,65.43,1,0,10.5%,101,+28.0;
Indicates that travel 101 kilometers.
Receive the message sent by the server, device give an answer . means settings is successful
or not
Server Device
**,imei:359586018966098,102
Device server
imei:353451044508750,102,0809231929, ,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
Server Device
**,imei:359586018966098,104
Device server
imei:353451044508750,104,0809231929, ,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
After sending a command to cancel the alarm, all alarm settings will be cancel, not effect.
Server Device
**,imei:359586018966098,105,65535
Device Server
imei:353451044508750,105,0809231929, ,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
tracker will alarm when goes out of 200M,after set Movement alarm
第 8 页 共 15 页
V0.1 2012-11-20
Server device
**,imei:359586018966098,106
device server
imei:353451044508750,106,0809231929, ,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
Server device
**,imei:359586018966098,107,080
device server
imei:353451044508750,107,0809231929, ,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
Server device
**,imei:359586018966098,108,-5
device server
imei:353451044508750,108,0809231929, ,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
In the time zone command -5 means time zone ,in -5 zone ,if time zone is positive 8 ,omit digital
8
Server device
**,imei:359586018966098,109
If cut off oil and power successfully, the device will reply:
imei:353451044508750,109,0809231929, ,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
When Vehicle speed is below 20 km / h ,it will execute cutting off oil and power and reply:
imei:353451044508750,509,0809231929, ,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
Server device
**,imei:359586018966098,110
device server
imei:353451044508750,110,0809231929, ,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
第 9 页 共 15 页
V0.1 2012-11-20
5.2.9.Arm
Server device
**,imei:359586018966098,111
When set Arm successfully,device reply:
imei:353451044508750,111,0809231929, ,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
When set Arm fail,pls turn off ACC,device reply:
imei:353451044508750,511,0809231929, ,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
After Armed,ACC,door,shock alerts will be effective
5.2.10. Disarm
Server device
**,imei:359586018966098,112
device server
imei:353451044508750,112,0809231929, ,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
Server device
**,imei:359586018966098,113
device server
imei:353451044508750,113,0809231929, ,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
Server device
**,imei:359586018966098,114,22.553276,113.903516;20.553276,114.903516
device Server
imei:353451044508750,114,0809231929, ,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
There are two latitude and longitude, The first latitude & longitude is coordinate of the top
left corner of the Geo-fence, while the second latitude & longitude is the coordinate of the
bottom right corner, note that there are positive and negative distinguish, positive can
omit + ,negative need add -
Server device
**,imei:359586018966098,115
第 10 页 共 15 页
V0.1 2012-11-20
device Server
imei:353451044508750,115,0809231929, ,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
Server device
**,imei:359586018966098,116,20110418
load the tracking data of 18th April 2011 to monitoring platform.device Server
imei:353451044508750,116,0809231929, ,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
Server Device
**,imei:359586018966098,117
Device Server
imei:353451044508750,117,0809231929, ,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
Server Device
**,imei:359586018966098,118
Device Server
imei:353451044508750,118,0809231929, ,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
Server Device
**,imei:359586018966098,119
Device Server
imei:353451044508750,119,0809231929, ,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
Server Device
**,imei:359586018966098,120,030
Device Server
imei:353451044508750,120,0809231929, ,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
第 11 页 共 15 页
V0.1 2012-11-20
First , click multi-area management menu , take a point on map , pull a circle and record
the radius . Name the area . Default name is area01-05 , at most 5 areas are supported .
Save the area name , lat/long of point , Radius and send them to tracker . Then tracker
will send one alert when going into the area , send another alert when getting out of
area .
Server Device
**,imei:359586018966098,121,22.353648,113.543678 area01,800m
121,22.353648 , 113.543678 are latitude , longitude of the point on map area01 is the
name of area . 800M is radius . Radius can be 800KM too .
Device Server
imei:353451044508750,121,0809231929, ,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
Server Device
**,imei:359586018966098,122,192.168.1.1,9000
Device Server
imei:353451044508750,122,0809231929, ,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
Server Device
**,imei:359586018966098,150
Device Server
imei:353451044508750,150,0809231929, ,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
Server Device
**,imei:359586018966098,151
Device Server
imei:353451044508750,151,0809231929, ,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
Server Device
**,imei:359586018966098,152,080
第 12 页 共 15 页
V0.1 2012-11-20
Device Server
imei:353451044508750,152,0809231929, ,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
Tracker send alerts to server . Server will analyze , but not respond .
5.3.1.SOS alert
5.3.3.Movement alarm
imei:353451044508750,move,0809231929, ,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
imei:353451044508750,speed,0809231929, ,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
imei:353451044508750,stockade,0809231929, ,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
5.3.6.Door alarm
第 13 页 共 15 页
V0.1 2012-11-20
5.3.8.ACC alarm
5.3.9.Accident alarm
imei:353451044508750,T:+28.0,0809231929, ,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
“T:”means Temperature senor alarm, “+28.0” mean current Temperature.
imei:353451044508750,DTC,0809231929,,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,30.1,,1,0,10.5%,P0021,;
When the keyword is DTC, the place where oil 2 means diagnostic trouble code.
第 14 页 共 15 页
V0.1 2012-11-20
imei:353451044508750,service,0809231929,,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,3.3,,1,0,10.5%,+15,+500;
When the key word is service ,the place where oil 2 means expiration time of
maintenance ,and the place where temperature means remain maintenance mileage.“+15”means
there is 15 days before expiration time ,if “-15” means it has exceed expiration time 15 days.
“+500”means there is remain maintenance mileage 500km,and “-500”means it has exceed
maintenance mileage 500km.
Server Device
**,imei:359586018966098,125
Device Server
1、Startup
imei:353451044508750,125,0809231929, ,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
2、Turn off the engine
imei:353451044508750,525,0809231929, ,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
3、Appointment
imei:353451044508750,526,0809231929, ,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
When Device enter or get out of the preset Multi-area, and it will send information to server
automatically
Enter the first area:
imei:353451044508750,area01 in,0809231929, ,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
get out of the first area:
imei:353451044508750,area01 out,0809231929, ,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
第 15 页 共 15 页
V0.1 2012-11-20
The content after the 11th comma become 1,it means the device request Absolute
street address; If the device have no GPS signal, the detail will be LBS.
imei:353451044508750,001,0809231929, 13554900601,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,1;
after receive latitude and longitude, it will show Chinese if the device is in China, and
English in foreign countries. The Chinese reply by server will be as below:
address1, 广东省深圳市南山区南头关二路 113-115 号,lat:22.111111 long:113.234564,T:11/08/09 17:22,
Speed:01
Then the software of device need recognize “address1” and translate the Chinese into
hexadecimal, send it out, the part in English send out directly, that means, if this content with
Chinese, it need send 2 SMS message, one translate the Chinese into hexadecimal, the other
SMS message is the part in English sent out directly.
When the device is in foreign countries, the information from server in English will be
received as below:
address2, zhongguo guangdong shenzhen nanshan nantou guankou ,lat:22.111111 long:113.234564,T:11/08/09
17:22,Speed:01
Then the device need adjudge "address2" remark, and forward directly to users' phone
Note: Send “address+password” to device to get the Absolute street address, if the device in SMS
mode, it will switch to GPRS mode
第 16 页 共 15 页
V0.1 2012-11-20
3、Data re-transmission
When data is wrong ,server will request to re- transmit. When data is not received completely, or
transfer is not finished over 30s,server will remove and request to re- transmit. If transmission is
still not successfully finished for 3times,then server will cancel this action. That means each
photo can be re-transmitted for 2 times at most, totally 3 times transmission plus the first one.
That will be cancelled after 3 times.
During Photo transmission, other alarms will not be triggered and photos will not be sent.
photo re-transmission without photo re-taken
**,imei:359586018966098,161
Photo transmission start,XX means photo data amount
imei:359586018966098,vtxx,0809231429,13554900601,F,062947.294,A,2234.4026,N,11354.3277,E,0.00,360.00;
Transmit data package, imei:359586018966098 is before each data package,VR,01,02,03 is photo queue in each data
package
imei:359586018966098,vr,data package…………………………………………………
5.9.Scheduling screen
5.9.1. announcement
Server Device
**,imei:359586018966098,170,gong gao, 2012 12/25 tian yao xia yue
The words in blue is the content shown in scheduling screen
Device Server
imei:353451044508750,170,0809231929, ,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
第 17 页 共 15 页
V0.1 2012-11-20
process:
Center issue a dispatch Order
171---Center sends answer race request with Order No. and details to each vehicle
Vehicle hands in answer race Order with Order NO. Press Button Ok on the device
175--- Vehicle hands in answer race Order with order NO. only.
After judged, center sends“ successful answer”response to the first vehicle, also failure
answer to other vehicles
172--- center sends“ successful answer”response to the first vehicle with Phone call
dispatch order No and details
173---Center sends failure answer to other vehicles with Order No. only
After received successful answer from center, vehicle cancel the order with Order No. to
center Press button“Down”, to cancel order due to special reasons
176---vehicle cancel order to center with Order No and reasons
Vehicle response center about carrying passengers successfully with Order No. Press
Button Up, meaning Order finished
177--- Vehicle response center about carrying passengers successfully with Order
No.
Server Device
1) 、171--- Center sends answer race request with Phone call dispatch
Order No. and details
**,imei:359586018966098,171,1301220909091,xin an 1 lu jie ke.
Order No and details are ascall code. The longest Order details is 235byte; The call phone
dispatch order No is 13Byte,which is unique and consist of 12 digital date number and 1
self-composed digital. E.g.: 1301220909091
2) 、172--- center sends“answer successfully”response to the certain vehicle with Phone call
dispatch order No and details
第 18 页 共 15 页
V0.1 2012-11-20
**,imei:359586018966098,174,1301220909091
Server Device
1)、171---vehicles send responses to center with Order No. meaning message received
imei:353451044508750,171,1301220909091,0809231929, ,F,055403.000,A,2233.1870,N,11354.
3067,E,0.00,,;
2)、175---Vehicle hands in answer race Order to Center with Order No. Press button Ok on
the device
imei:353451044508750,175,1301220909091,0809231929, ,F,055403.000,A,2233.1870,N,11354.
3067,E,0.00,,;
3)、after receive answer successfully from center
176--- vehicle cancel order to center with Order No and reasons; Press button“Down”,
to cancel order due to special reasons
imei:353451044508750,176,1301220909091,0809231929, ,F,055403.000,A,2233.1870,N,11354.
3067,E,0.00,,;
177--- Vehicle response center about carrying passengers successfully with Order No.
Press Button Up, meaning Order finished
imei:353451044508750,177,1301220909091,0809231929, ,F,055403.000,A,2233.1870,N,11354.
3067,E,0.00,,;
5.10.1.Add ads
Server Device
**,imei:359586018966098,180,03,Welcome to COBAN
Red number is message group code number, range from 03-99. Ads max capacity is 200 Byte;If
code number has exist,then the details will be covered. Words in blue are details shown on Led
screen
Device Server
imei:353451044508750,180,0809231929, ,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
5.10.2.Delete ads
Server Device
**,imei:359586018966098,181
Device Server
imei:353451044508750,181,0809231929, ,F,055403.000,A,2233.1870,N,11354.3067,E,0.00,,;
第 19 页 共 15 页
V0.1 2012-11-20
5.11.RFID
Example:
imei:353451044508750,rfid,0809231929,0083E869,F,055403.000,A,2233.1870,N,11354.3067,
E,0.00,30.1,65.43,1,0,10.5%,0.0%,28;
Content description:
Key word:rfid
The number 0083E869 will be replaced by the ID of the RFID Tag
L
S e R
L
t f i
e
a t g
Ri f
t r h
Ri gh St t
u e t
gh t at r St
s a r
t fr us e at Righ
Left o r e
ke fr on of a us t
Numbers front Left front f t a
yw ti sta on t ri r of rear Status of
of tyres temperatur l e r
or me tus t te gh p le temp right rear
tyress pressu e e m p
ds pr mp t r ft erat
re f p r
es er fr e re ure
t e e
su at on s ar
f r s
re ur t s
r a s
e u
o t u
r
n u r
e
t r e
e
,
08
, 09
tp 23 , , , , , , , , , , , , , ,
ms 19
29
01
Message example
第 20 页 共 15 页
V0.1 2012-11-20
imei:353451044508750,TPMS,080923192901,0,4,245.50,65,00111111,245.50,65,00111111,255.
50,60,00111111,255.50,60,00111111;
Content explain:
Time: year,month,day,hour,minute,second;
Status: Communication status between tracker and tyres pressue. 0 inicates normal,
1indicates failure
Numbere of tyress: 4 is the default, for future expansion;
Left front tyres pressure: Floating point numbers strings, unit: Kpa
Left front tyres temperature: integer, decimal string, units: degrees Celsius;
Left front tyre State: eight-bit string, 0 indicates normal, 1 indicates failure.
8 7 6 5 4 3 2 1
0 0 1 High 1 higher 1 lower 1 1 1
temperature pressure pressure Sensor Low Air
Reserve Reserve
>75℃ >3.4Bar <1.8Bar failure battery leakage
Index:
$GPRMC,<1>,<2>,<3>,<4>,<5>,<6>,<7>,<8>,<9>,<10>,<11><CR><LF>
1 UTC of position fix,forma: hhmmss.sss
2 Data status (A=Valid data, V=invalid data)
3 Latitude format: ddmm.mmmm
4 North (N) or South (S)
5 Longitude
6 East(E) or West(W)
7 Speed over ground 0.0 to 1851.8 knots
8 Track made good in degrees True, 000.0 to 359.9 degree, True course
9 UT date format: ddmmyy
10 Magnetic variation degrees 000.0 to180.
11 Degree
12 Checksum
第 21 页 共 15 页
V0.1 2012-11-20
第 22 页 共 15 页