EV07 GPRS Protocol

GPRS communication protocol (ET017S)

1, GPRS data from tracker to server

Descriptions about GPRS packets from the tracker are as follows:

Tracker to server

Explanation

!1,IMEI;

tracker only send one time !1,IMEI; once it establish a connection with server. After connect successfully, it will only send GPRS data pack without IMEI number. But it will send !1,IMEI again if disconnect and later connect again to the server.

!D,date,time,lat,long,speed,direction,event Real time data, start with !D, Please see the detailed code,altitude,bat,sta1,sta2,0;

explanation of real time data on page 2.

!3,OK;

confirm the command set successfully

!3,error;

confirm the command set failure

!4,f1,f2,f3,f4,f5,f6,f7,f8,f9;

read all functions settings

!7,firmware version,CSQ;

read tracker firmware version and GSM signal strength

!5,CSQ,GPS location availability;

!5 means heartbeat, heartbeat is fixed to send every 200 seconds.

CSQ means GSM signal strength GPS location availability means the location is the last known or the current position. for example: !5,28,A; means GSM signal strength is 28 and GPS location is the current position.

1.1 Real time data description: !, , , , , , ,, , ,,, ; (Example: !D,3/7/13,6:35:30,22.645952,114.040436,0.0,225.8,1f0001,12.11,98,0,0,0; )

Parameter !

Description Indicates the GPRS data packet header from the server to

Example !

the tracker. The header type is ASCII. D

Has one byte. The type is the ASCII

D

Date

dd indicates date.

3/7/2015

mm indicates month. yy indicates year. Decimal Time

HH indicates hour.

6:35:30

MM indicates minute. SS indicates second. Decimal latitude

Unit: degree

22.756325

(-)yy.dddddd

Decimal

-23.256438

When a minus (-) exists, the tracker is in the southern hemisphere. When no minus (-) exists, the tracker is in the northern hemisphere. yy indicates the degree. dddddd indicates the decimal part. Longitudes

Unit: degree

114.752146

(-)xxx.dddddd

Decimal

-114.821453

When a minus (-) exists, the tracker is in the western hemisphere.

When no minus (-) exists, the tracker is in the eastern hemisphere. xxx indicates the degree. dddddd indicates the decimal part. Speed

Unit: km/h

60

Decimal Direction

Indicates the direction. The unit is degree. When the value is 90 0, the direction is north. The value ranges from 0 to 359. Decimal

Event code

Decimal

1f0001

For details, see section 1.2 "Event Code." Altitude

Unit: meter

12.11

Decimal Battery

Indicates the percentage of the remaining battery

90

Satellite in use

Indicates the number of GPS satellites it fixed

8

Decimal Numbers of

Indicates the number of available GPS satellites.

10

satellites

Decimal

Reserved

Not in use

0

;

the end

;

1.2 Event code

flag (4byte): This 6 letters should be converted from HEX to BIN. And there will be 24 digits which

contains only 1 and 0. The order of these digits should be from right to left and start with "0" bit (23/22/21……3/2/1/0)

Event flag (Bit)

Event 00 means no GPS signal, no GSM locating;

1 to 0

01 means GPS signal fixed, no GSM locating; 10 means GSM locating fixed, no GPS signal;

3 to 2

00 means GPS chip works. 01 means GPS chip failed.

4

N/A

5

N/A

6 7 8 9 10 11 12 14 15

1 means SOS alarm 0 means No SOS alarm 1 means over-speed alarm 0 means No over-speed alarm 1 means fall down alarm 0 means No fall down alarm 1 means GEO fence 1 alarm 0 means No GEO fence 1 alarm 1 means GEO fence 2 alarm 0 means No GEO fence 2 alarm 1 means GEO fence 3 alarm 0 means No GEO fence 3 alarm 1 means low battery alarm 0 means No battery alarm 1 means motion alarm 0 means No motion alarm 1 means movement alarm 0 means No movement alarm Value range is from 0-31

20 to 16

it means GSM signal strength, 0 means no GSM signal, 31 means has very strong GSM signal

21 22

1 means device turned on 1 means device is charging 0 means device is not charging

2, GPRS Command List (from server to tracker)

Command

Command description

GPRS flag

123456M,time interval 

Track by time interval in PS1 mode

f1

123456S0

Disconnect GPRS connection

f1

123456A1, phone

Setting first emergency contact number (can be mobile

f2

number 

number or landline number or 911 etc.)

123456A0

Remove first emergency contact number

f2

123456B1, phone

Setting second emergency contact number (can be mobile

f3

number 

number or landline number or 911 etc.)

123456B0

Remove second emergency contact number

f3

123456C1, phone

Setting third emergency contact number (can be mobile

f4

number 

number or landline number or 911 etc.)

123456C0

Remove third emergency contact number

f4

123456L+/-time zone 

Setting the SMS time zone

f5

123456J1,driving speed 

Setting the over speed alarm function

f6

123456J0

Turning off over speed alarm

f6

123456R1,distance 

Setting the movement alarm

f7

123456R0

Turning off the movement alarm

f7

123456W1,S/M/H

Setting motion alarm

f8

123456W0

Turning off motion alarm

f8

123456AGPS1

Turning on AGPS

f9.0

123456AGPS0

Turning off AGPS

f9.0

123456P1

Turning on voice monitor

f9.1

123456P0

Turning off the voice monitor

f9.1

123456GSM1

Setting track by GSM base station(GSM tower or called LBS)

f9.2

123456GSM0

Turning off track by GSM base station

f9.2

123456LED1

Turning off LED indicator

f9.3

123456LED0

Turning on LED indicator

f9.3

123456F1

Turning on fall detection

f9.4

123456F0

Turning off fall detection

f9.4

123456SP1

Turning on smart power saving working mode

f9.5

123456SP0

Turning on living tracking mode

f9.5

123456T

Reboot device, settings will remain

f9.6

123456LOC

Real-time location query

123456G

Reading all the function settings

123456Z1,IP/domain

Setting the DNS server IP address or domain name and port

name, port  123456DS1

Turning on deep sleep working mode

123456DS0

Turning off deep sleep working mode

123456S0

disable GPRS connection

123456V

Reading the tracker firmware version, GSM signal strength

Note: 

A comma (,) is used to separate data characters. The character type is the American Standard Code for Information Interchange (ASCII).



Do not use special characters such as < and > in a command.



All multi-byte data complies with the following sequence: High bytes are prior to low bytes. The size of a GPRS data packet is about 100 bytes.

3, Command Details: Tracking by time interval GPRS Setting

123456M,time interval 

GPRS Reply

!3,ok;

Description

To set data uploading time interval in 123456SP1 or 123456SP0 mode (123456SP1 means smart power saving mode-default working mode). time interval is from 001~999 the maximum time interval is 999*10 seconds=9990 seconds

Note: 1, time interval must be 3 digitals. 2, the unit is 10 seconds the data uploading interval is 3 minutes by default when moving. When not moving, uploading interval will change to 10 minutes automatically. Example

123456M,080 After the above command set successfully, the tracker will send the following GPRS data pack to the platform every 800 seconds. !D,3/7/13,6:35:30,22.645952,114.040436,0.0,225.8,1f0001,12.11,98,0,0,0;

Disconnect GPRS connection GPRS Setting

123456S0

GPRS Reply

!3,ok;

Description

123456S0 can only disconnect the GPRS connection when device in 123456PS1 or 123456PS0 or 123456DS1 working mode. can’t

be used for working mode 4 and mode 5.

Setting first emergency contact number GPRS Setting

123456A1, phone number 

GPRS Reply

!3,ok;

Description

Phone number: a phone number can be mobile number or landline number or 911 etc.

Note: Wen alarm is generated, the tracker will send text message to phone numbers. When the SOS button is pressed, the tracker will dial phone numbers A,B,C in sequence and will stop dialing when a phone number answered the call. Example

123456A1,+86123456789 123456A1,0086123456789

Remove first emergency contact number GPRS Setting

123456A0

GPRS Reply

!3,ok;

Description

after send above command, the contact number A will be removed and become empty.

Setting second emergency contact number GPRS Setting

123456B1, phone number 

GPRS Reply

!3,ok;

Description

Phone number: a phone number can be mobile number or landline number or 911 etc. Note: Wen alarm is generated, the tracker will send text message to phone numbers. When the SOS button is pressed, the tracker will dial phone numbers A,B,C in sequence and will stop dialing when a phone number answered the call.

Example

123456B1,+86123456789 123456B1,0086123456789

Remove second emergency contact number GPRS Setting

123456B0

GPRS Reply

!3,ok;

Description

after send above command, the contact number b will be removed and become empty.

Setting third emergency contact number GPRS Setting

123456C1, phone number 

GPRS Reply

!3,ok;

Description

Phone number: a phone number can be mobile number or landline number or 911 etc. Note: Wen alarm is generated, the tracker will send text message to phone numbers. When the SOS button is pressed, the tracker will dial phone numbers A,B,C in sequence and will stop dialing when a phone number answered the call.

Example

123456C1,+86123456789 123456C1,0086123456789

Remove third emergency contact number GPRS Setting

123456C0

GPRS Reply

!3,ok;

Description

after send above command, the contact number be will be removed and become empty.

Setting the SMS time zone GPRS Setting

123456L+/-time zone 

GPRS Reply

!3,ok;

Description

The default time zone of the tracker is GMT 0, to change to your local SMS report time zone, you should run this command. time zone is from -12 to +12 must be two digitals.

Example

123456L+08 after this command set successfully, the tracker SMS time zone is changed to UTC+08 123456L-05 after this command set successfully, the tracker SMS time zone is changed to UTC-05

Setting the over speed alarm function GPRS Setting

123456J1,driving speed 

GPRS Reply

!3,ok;

Description

Value range: 001~250

Must be 3 digitals the unit is km/h when the driving speed reach the preset value, a over speed alarm will be generated. Example

123456J1,090 After this command set successfully, if tracker driving speed reaches 90km/h, it will send a GPRS data pack about over speed alarm to the server.

Turning off over speed alarm GPRS Setting

123456J0

GPRS Reply

!3,ok;

Description

after this command set successfully, over speed alarm function is disabled. default is 123456J0

Setting the movement alarm GPRS Setting

123456R1,distance 

GPRS Reply

!3,ok;

Description

Value range: 01~99 Must be 2 digitals the unit is 0.1km/h when the distance reach the preset value, a movement alarm will be generated.

Example

123456R1,50

After this command set successfully, if tracker moves beyond 5km/h, it will send a GPRS data pack about movement alarm to the server.

Turning off movement alarm GPRS Setting

123456R0

GPRS Reply

!3,ok;

Description

after this command set successfully, movement alarm function is disabled. default is 123456R0

Setting motion alarm GPRS Setting

123W1,xxS/M/H 

GPRS Reply

!3,ok;

Description

Value range: 01~99 Must be 2 digitals S means Seconds, M means minutes, H means Hours when the device reach the preset value, a motion alarm will be generated.

Example

123456W1,50S After this command set successfully, if tracker detect motion every 50 seconds, it will send a GPRS data pack about motion alarm to the server.

Turning off motion alarm

GPRS Setting

123456W0

GPRS Reply

!3,ok;

Description

after this command set successfully, motion alarm function is disabled. default is 123456W0

Turning on AGPS GPRS Setting

123456AGPS1

GPRS Reply

!3,ok;

Description

after this command set successfully, AGPS function is enabled.

Turning off AGPS GPRS Setting

123456AGPS0

GPRS Reply

!3,ok;

Description

after this command set successfully, AGPS function is disabled. default is 123456AGPS0

Turning on voice monitor function (Listen in) GPRS Setting

123456P1

GPRS Reply

!3,ok;

Description

after this command set successfully, voice monitor function is enabled.

Turning off voice monitor function (Listen in)

GPRS Setting

123456P0

GPRS Reply

!3,ok;

Description

after this command set successfully, voice monitor function is enabled. default is 12345P0

Turning on cell locate function (Track by GSM base station, also called LBS) GPRS Setting

123456GSM1

GPRS Reply

!3,ok;

Description

after this command set successfully, device will search the location via GSM tower when GPS satellite is not able to available.(we do not suggest to use this function)

Turning off cell locate function GPRS Setting

123456GSM0

GPRS Reply

!3,ok;

Description

after this command set successfully, cell location function is disabled. default is 123456GSM0

Turning on LED indicators GPRS Setting

123456LED0

GPRS Reply

!3,ok;

Description

after this command set successfully, LED are on to indicates the status of GSM and GPS signal. Default is 123456LED0

Turning off LED indicators GPRS Setting

123456LED1

GPRS Reply

!3,ok;

Description

after this command set successfully, LEDs are off.

Turning on fall alarm function GPRS Setting

123456F1

GPRS Reply

!3,ok;

Description

after this command set successfully, fall detection is enabled.

Turning off fall alarm function GPRS Setting

123456F0

GPRS Reply

!3,ok;

Description

after this command set successfully, fall detection is disabled. Default is 123456F0

Turning on smart power saving mode function GPRS Setting

123456SP1

GPRS Reply

!3,ok;

Description

after this command set successfully, smart power saving mode is enabled. in this working mode, GPS chip is off when there is no movement or no phone usage/alarm/SMS. Battery life is not wasted when the device isn't moving. GSM/GPRS chip is always working to receives calls, SMS and transmits location. The GPS chip is activated by motion, incoming calls and SMS. Default is 123456SP1

Turning on live tracking mode GPRS Setting

123456SP0

GPRS Reply

!3,ok;

Description

after this command set successfully, living tracking mode is enabled. in the working mode, GSM/GPRS and GPS chips are always working.

Real-time location query GPRS Setting

123456LOC

GPRS Reply

!3,ok;

Description

after this command set successfully, device will reply the current location if available, if no up to date location with 2 minutes, it will reply the last known location, for example: !D,3/7/13,6:35:30,22.645952,114.040436,0.0,225.8,1f0001,12.11,98,0,0,0; 

Device reboot GPRS Setting

123456T

GPRS Reply

No Reply

Description

after this command set successfully, device will reboot, function settings are still remain after reboot.

Reading all the function settings GPRS Setting

123456G

GPRS Reply

!4,f1,f2,f3,f4,f5,f6,f7,f8,f9; 

Description

after this command set successfully, device will reply all the functions status and setting parameters.

Example

!4,180,15899795842,18620310172,008675528073450,8.0,90,0,0S,49;

Please refer to the page 4, GPRS flag. 49 is a Decimal number, must convert it to Binary and you will get 110001 1 indicates function on while 0 indicates function off.

Setting the DNS server IP address or domain name and port GPRS Setting

123456Z1,IP/domain name,port 

GPRS Reply

!3,ok;

Example

123456Z1,103.21.211.11,5050 123456Z1,www.smart-tracking.com,5050

Turning on deep sleep working mode GPRS Setting

123456DS1

GPRS Reply

!3,ok;

Description

after this command set successfully, both GSM/GPRS and GPS chip are going to sleep, device can be activated by motion.

Turning off deep sleep working mode GPRS Setting

123456DS0

GPRS Reply

!3,ok;

Description

after this command set successfully, deep sleeping mode is disabled.

Disconnect GPRS connection GPRS Setting

123456S0

GPRS Reply

!3,ok;

Description

after this command set successfully, GPRS connection is disabled.

Reading the tracker firmware version, GSM signal strength GPRS Setting

123456V

GPRS Reply

!7,firmware version,CSQ 

Description

read the tracker firmware version and GSM signal strength CSQ Value range: 00~31

Example

!7,07S.8601.1605,31