Introduction

1. This document mainly introduces the related functional protocols between the locator and the server, as well as their data formats and contents.

2. The protocol only applies to communication between the locator and the server. The current version corresponds to May 2017. If there is any modification in the future, adjust the documentation accordingly.

3. All communication data formats are 0x780x78+data length+protocol number+data content+0x0d0x0a, and the data length is the sum of the number of bytes occupied by the data content and the number of bytes occupied by the protocol number. A special number is not the rule, there is a corresponding description in the details of the agreement.

4. All communication data is transmitted by tcpip protocol, the server address is ______ port is ______

5. Some protocol data transmission is bidirectional, that is, the data is initiated by one party in the device or the server, and the receiving party must reply with a reply data corresponding to the protocol. Some protocols are one-way, that is, after the device or the server sends the data, the receiving party does not need to reply. Unless otherwise specified, the protocol data is one-way, that is, the party receiving the data does not need to reply to the data.6. The sample data is all hexadecimal

7. The end of the data is 0D0A. It is necessary to pay attention to the case where the data contains the 0D0A in the middle of the data. It cannot be processed with 0D0A as the data end when the data length has not yet been reached.

8. The data that must be replied is: 0x01, 0x10, 0x11, 0x13, 0x17, 0x69. The data communication will be disconnected and reconnect if don’t response these data.

9. Minimum support is required to implement location functionality: 0x01 login data packet, 0x08 heartbeat data packet, 0x10GPS online data, 0x11 GPS offline data, 0x13 status data packet, 0x17 offline WIFILBS data packet, 0x30 time synchronization, 0x69 online WIFILBS data packet, 0x57 Parameter setting packet.

Details

0x01 login

Device sent data to the server

Start bit 2byte Reserved bit 1byte Protocol number 1byte IMEI 8byte Software version number 1byte Stop bit 2byte

Eg.7878 0A 01 0123456789012345 01 0D0A

The IMEI data is BCD coded, and the IMEI data in the data packet is 0x01 0x23 0x45 0x67 0x89 0x01 0x23 0x45 , IMEI is 123456789012345

Software version number: 01 software version number

After the server receives the login data, it must reply to the device data.

Start bit 2byte packet length 1byte protocol number 1byte stop bit 2byte

If it is a legal device, it returns 0x01 protocol data. If the login fails, reply to the 0x44 protocol to prevent the device from uploading data.

Eg.7878 01 01 0D0A successfully logged in

   7878 01 44 0D0A login failed

Note: The data of this data data length of 1byte is not the same as the actual length. No practical significance. Please take data according to the data format

0x05 server sends supervisory status to the terminal

Start 2Byte, package content length 1Byte, protocol number 1Byte, status 1Byte, stop bit 2Byte

7878 02 05 xx 0D0A

01. Supervisory number dials the device number. The device automatically answers the pickup effect.

02. Supervisory number dials the device number Automatically answers the two-way call

03. Regulatory number dials the device number Bells manually answer the two-way call

0x08 heartbeat package

Device sent data to the server

Start bit 2byte packet length 1byte protocol number 1byte end bit 2byte

Eg.7878 01 08 0D0A

Used to keep the connection between the device and the server from being disconnected

0x10 GPS positioning data packet

Device sent data to the server

Start bit 2byte Packet length 1byte Protocol number 1byte Date time 6byte GPS Data length, visible satellite number 1byte GPS latitude and longitude 8byte Speed 1byte East and West latitude Status Heading 2byte Stop bit 2byte

Eg.7878 12 10 0A03170F3217 9C 026B3F3E 0C22AD65 1F 3460 0D0A

Date and time: 0A03170F3217, year, month, day, minute, second, each accounted for 1 byte, converted to 10 years, March 23, 15:50:23, year plus 2000 is 2010, time is GMT0.

GPS data length, visible satellite number: data length and visible satellite number each accounted for 0.5byte, 9C said: GPS information length is 9, the number of participating satellites is 0x0c (12)

GPS latitude and longitude: 026B3F3E, longitude and latitude each occupy 4bytes, indicating positioning data, latitude and longitude conversion method is as follows:

Convert the latitude and longitude values output by the gps module into fractions in minutes, then multiply the converted fractions by 30000 and convert the multiplied result to hexadecimal.

   For example, 22"32.7658', (22X60+32.7658)X30000=40582974, converted to hexadecimal 0x02 0x6B 0x3F 0x3E, 22X60 is convert ° to '.

GPS speed: 1 byte, indicating the running speed of GPS, the range is 0x00-0xFF km / h. In the example, 1F indicates a speed of 31 kilometers per hour.

North and South latitude, east and west, state, heading: occupy 2 bytes, the heading indicates the running direction of GPS, 0-360, unit degree, and north is 0. The first six bits of the first byte of the 8-bit binary represent the state, and the last two bits and the eight bits of the second byte represent the heading. As shown below

0 South latitude 1 North latitude 0 East longitude 1 West longitude 0 GPS not positioned 1 GPS positioning

In the example, the state heading is 3460, which is converted to binary 0011 0100 0110 0000, indicating that the GPS is in the positioning state, east longitude, north latitude, and the heading is 96°.

The server must reply:

Start bit 2byte Reserved byte 1byte Protocol number 1byte Date time 6byte stop bit 2byte

Eg.7878 00 10 0A03170F3217 0D0A package length string is 00

Note: The data of this data data length of 1byte is not the same as the actual length. No practical significance. Please take the data reply data length byte 00 according to the data format. 0D0A is more likely to appear in the time data, and it needs to be judged according to the length of the data to avoid truncation errors.

0x11 offline GPS positioning data package

Same as 0x10 format

Eg.7878 12 11 0A03170F3217 9C 026B3F3E 0C22AD65 1F 3460 0D0A

The server must reply:

Start bit 2byte reserved byte 1byte protocol number 1byte date time 6byte stop bit 2byte

Eg.7878 00 11 0A03170F3217 0D0A package length string is 00

Note: The data of this data data length of 1byte is not the same as the actual length. No practical significance. Please take the data in the data format. Reply data length byte 00. 0D0A is more likely to appear in the time data, and it needs to be judged according to the length of the data to avoid truncation errors.

V1.2 has made changes to the positioning data. 0x10 0x11 works.

GPS increase altitude alarm

7878 15 10120B05030D2498038077200BE2078F003400 XXXX FX 0D0A

 2Byte XXXX = hex (elevation)

1Byte FX alert

0000 0001 = vibration

0000 0010 = speeding

0000 0100 = wifi attendance

0000 1000 = leave wifi attendance

0001 0000 = low power alarm

The same location, wifi / lbs are added FX

The server sends a startup speed setting to the terminal.

7878 02 86 XX 0D0A

0x13 status package

Device sent data to the server

Start bit 2byte Reserved byte 1byte Protocol number 1byte Battery power 1byte Software version 1byte Time zone 1byte Status packet upload interval 1byte End bit 2byte

Eg.7878 06 13 55 23 08 03 0D0A

55 indicates that the battery power is still 85%, 23 indicates that the software version number is 35 08 indicates that it is East 8 (just an integer), and 03 indicates that the status packet upload interval is 3 minutes.

Increased signal strength

Start bit 2byte Packet length 1byte Protocol number 1byte Battery power 1byte Software version 1byte Time zone 1byte Status packet upload interval 1byte Device signal strength 1byte End bit 2byte

Eg.7878 07 13 55 23 08 03 64 0D0A

0x55 indicates that the battery level is 85. 0x64 indicates device signal strength 100

Server reply

Reply content is the same as sending status package

Set the status packet upload interval

Start bit 2byte packet length 1byte protocol number 1byte state packet upload interval 1byte end bit 2byte

This data is sent to the device by the server to set the upload interval of the status packet.

Eg.7878 02 13 03 0D0A

03 is to upload the upload interval of the status package for 3 minutes, the unit is minute.

Set the heartbeat packet upload interval

Start bit 2byte packet length 1byte protocol number 1byte heartbeat packet upload interval 2byte end bit 2byte

This data is sent to the device by the server to set the upload interval of the status packet.

Eg.7878 03 13 012C 0D0A

012C uploads the heartbeat packet upload interval to 300 seconds, in seconds. The heartbeat packet upload interval ranges from 20 to 600 seconds.

Note: The data of this data data length of 1byte is not the same as the actual length. No practical significance. Please take the data in the data format.

---------------------------------------------------------------------------------------------------------------------------------

The status pack adds the function of plug-in reminder

Status pack latest 0A13 contains temperature and temperature increase after xx

00 is not plugged in, 01 is plugged in

7878 0913 424008196400041F0D0A

7878 0A13 424008196400041F 00 0D0A No USB charging

7878 0A13 424008196400041F 01 0D0A Plug in usb to charge

Status pack adds heart rate reminder

7878 0B13 424008196400041F00 XX 0D0A XX = 16 heart rate

-------------------------------------------------- -------------------------------------------------- -----------------------------

Equipment Send health data (This function is for GPS health care bracelet only, don’t support regular GPS trackers)

7878 0E13 424008196400 yyyy XX EEEfffff 0D0A

yyyy = temperature; XX = hex heart rate; fffff = number of hex steps, the device automatically clears 0 in the local morning EEE = Hex timing minutes, 0 manual

Server requests to refresh health data

7878 03 54 0EEE 0D0A

E = as above

The device responds with the same content

Total number of steps per day

Start bit 2byte Data length 1byte Protocol number 1byte Date 4byte Total number of steps 3byte End bit 2byte

eg

7878 08 54 20200716 000000 0d0a

08 1byte data length

54 1byte pedometer protocol number

20200716 4byte The date of the total number of steps

000000 3byte Total number of steps counted on the day

The server replies with the same data after receiving it

7878 08 54 20200716 000000 0d0a

If this data is not received. The total number of steps for the day will be the highest number of steps uploaded regularly for that day.

0x14 device sleep instruction

Device sent data to the server

Start bit 2byte packet length 1byte protocol number 1byte end bit 2byte

Eg.7878 01 14 0D0A

Send this command, indicating that the device is disconnected from the server and goes to sleep.

0x15 factory reset

Bidirectional command

After receiving the SMS reply to the factory setting, the device sends an instruction to the server.

Start bit 2byte packet length 1byte protocol number 1byte end bit 2byte

Eg.7878 01 15 0D0A

Server sent to device

Start bit 2byte packet length 1byte protocol number 1byte end bit 2byte

Eg.7878 01 15 0D0A

The device is restored to factory settings after receiving the command for 30 seconds.

0x16 total number of whitelists

Server sent data to device

Start bit 2byte packet length 1byte protocol number 1byte white list number 1byte end bit 2byte

Eg.7878 02 16 03 0D0A

Number of whitelists: 03, 3 numbers

After receiving this command, the device requests a whitelist synchronization 0x58 protocol.

0x18 4G LBS WIFI data (compatible with 2G LBS wifi data)

Start bit 2byte WIFI quantity 1byte Protocol number 1byte Date and time 6byte WIFI data variable length fixed format LBS data variable length fixed format alarm information 1byte stop bit 2byte

eg. 7878 03 18 160413031849 1475905BD30E25 001E10BBF7635D 14759006E62656 04 01CC00 000028660090DF425F 000028660090DF576C 000028660094875667 00002866009CA15667 00 0D0A

The third digit of this protocol is not the length of the data packet, but the number of WIFI hotspots. The first set of WIFI/LBS data is 03, which means that there are 3 WIFI hotspots, and the last one is LBSlbs data. If there is no WIFI hotspot, this data is 00.

Date and time: 160413031849, this data is different from the 0x10 protocol, this is BCD encoded, and the date is April 13, 2016, 3:18:49.

WIFI data

The minimum number of WIFI hotspots is 3 and the maximum number is 8. If the device searches for more than 8 hotspots, only the 8 hotspots with the best signal will be selected. 1475905BD30E25 The first 6byte is bssid, and the back 1byte is rssi, then the bssid of the first WIFI hotspot is 0x14:0x75:0x90:0x5B:0xD3:0x0E, and rssi is 0x25.

Number of LBS: 05 is the number of base stations, the minimum number of base stations is 2

MCCMNC: mcc2byte, mnc1byte 01CC00 is 46000

Base station data: lac4byte cellid 4byte, rssi1byte, 00002866 0090DF42 5F In the example, lac is 10342, cellid is 9494338, rssi is -95 (rssi value is negative, and the protocol upload is ABS value)

0x30 update time

bidirectional command

Device sends to server request time synchronization

Start bit 2byte packet length 1byte protocol number 1byte end bit 2byte

Eg.7878 01 30 0D0A

After the server receives it, it needs to return GMT time.

Start bit 2byte packet length 1byte protocol number 1byte date time 6byte end bit 2byte

Eg.7878 07 30 07E00705053718 0D0A

The time is hexadecimal, and 07E00705053718 is converted to 5:55:24 on July 5, 2016.

0x33 prohibits LBS positioning

The server sends data(command) to the device to prohibit the upload of LBS data.

Start 2Byte, packet length 1Byte, protocol number 1Byte, state 1Byte, stop bit 2Byte

7878 02 33 01 0D0A 01 = On ; 00 = Off

0x46 GPS timing period setting

Server send data(command) to device

Start bit 2byte Packet length 1byte Protocol number 1byte Switch 1byte Start time End time End bit 2byte

Eg.7878 05 46 01 1130 1230 0D0A

01 open, 00 is off, time is BCD code, 1130 is 11:30, from this time, turn off GPS to 12:30 to open

Can set a time period to turn off GPS