(VT08F) - V10Protrack Protocol - 20210527
(VT08F) - V10Protrack Protocol - 20210527
Communication Protocol
(VT08F)
V1.0
Directory
2. Protocol Packet...................................................................................................................... 5
3 Appendix............................................................................................................................... 20
1. Protocol Packet Format
Length
Format Description
(Byte)
The serial number of the first GPRS data (including status packet and
Information
2 data packet such as GPS, LBS) sent after booting is 1, and the serial
Serial Number
number of data sent later at each time will be automatically added.
a) Login packet is the information packet connecting the terminal and platform. It can send terminal
information to platform.
b) If a GPRS connection is established successfully, the terminal will send a first login message packet to
the server within five seconds, if the terminal receives a data packet responded by the server, the
connection is considered to be a normal connection; if not, the terminal will send login packet again.
c) If no packet returned by server within 5 seconds, then the response of login packet is timeout.
Length Description
Start Bit 2 0x78 0x78
Length = Protocol Number + Information Content +
Packet Length 1
Information Serial Number + Error Check
Protocol Number 1 0x01
Information Model
Content Identification 2 Distinguish model of terminal by identification code.
Code
Timezone & See the following chart for details of time zone
2
Language language mark.
Example: 78 11 01 07 52 53 36 90 02 42 70 00 32 05 12 79 0D 0A
2.1.3 Timezone & Language
15
14
13
12
11
One and a 10
half bits Timezone value expands 100times
bit15 bit4 9
8
7
6
5
4
2 No definition
Lower half
bit4- bit0
1 Language Select Bit Chinese
Here, to save 4 bytes, calculation result left shifted 4 bits and combined eastern time, western time and language
bit.
Length Description
Example:78 78 05 01 00 05 9F F8 0D 0A
b) If a GPRS connection is established successfully, the terminal will send a first login message packet to the server
and, within five seconds, if the terminal receives a data packet responded by the server, the connection is considered
to be a normal connection; if not, the terminal will send login packet again.
c) If no packet returned by server within 5 seconds, then the response of heartbeat packet is timeout.
Terminal
Information 1 See the following diagram for details
Content
Language
Extended 2 Latter bit 0x01 Chinese 0x02 English
Port Status
Example:78 78 0A 13 40 04 04 00 01 00 0F DC EE 0D 0A
One byte is consumed defining for various status information of the mobile phone.
Example :78 78 05 13 01 00 E1 A0 0D 0A
b) Upload locating data based on rule after successfully connected and positioned.
Length Description
Start Bit 2 0x78 0x78
Length = Protocol Number + Information Content +
Packet Length 1
Information Serial Number + Error Check
Protocol Number 1 0x31(UTC)
Bit7 0
Bit6 0
0:GPS real-time
Bit5
1:differential positioning
1:GPS having been positioning
Bit4
0:not positioned
Byte1
0:East Longitude
Bit3
1:West Longitude
0:South Latitude,
Bit2
1:North Latitude
Bit1
Bit0
Bit7
Bit6 Course
Byte2 Bit5
Bit4
Bit3
Bit2
Bit1
Bit0
Example: the value is 0x15 0x4C, the corresponding binary is 00010101 01001100,
Bit Description
BYTE_1 Bit7 0
BYTE_1 Bit6 0
BYTE_1 Bit1 0
BYTE_1 Bit0 1
BYTE_2 Bit7 0
BYTE_2 Bit6 1
BYTE_2 Bit5 0
Course 332°(0101001100 in Binary, or 332 in decimal)
BYTE_2 Bit4 0
BYTE_2 Bit3 1
BYTE_2 Bit2 1
BYTE_2 Bit1 0
BYTE_2 Bit0 0
Length Description
Start Bit 2 0x78 0x78
Length = Protocol Number + Information Content +
Packet Length 1
Information Serial Number+ Error Check
Protocol Number 1 0x34
1F 40 18 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 FF 00 02 00 05 B1 4B 0D 0A
b) Server response and parse longitude and latitude into address and re-upload to terminal after receiving the alarm
content.
Length Description
Year(1byte)Month(1byte)Day(1byte)Hour(1byte)Min(1byte)
Date Time 6
Second(1byte)(converted to a decimal)(Date Time)
LBS length 1 LBS length in total (LBS length +MCC +MNC +Cell ID)
MCC 2 Mobile Country Code(MCC) (converted to a decimal)
MNC 2 Mobile Network Code(MNC)(converted to a decimal)
LAC 2 Location Area Code (LAC) (converted to a decimal)
Cell ID 4 Cell Tower ID(Cell ID)(converted to a decimal)
Terminal
1 See the following diagram
Information
0x00: no signal;
0x01: extremely weak signal;
GSM Signal
1 0x02: weak signal;
Strength
0x03: good signal;
0x04: strong signal.
Alarm
2 See the following diagram
Language
Example:78 78 25 26 0F 0C 1D 03 0B 26 C9 02 7A C8 18 0C 46 58 60 00 04 00 09 01 CC 00 28 7D 00 1F 71 80 04 04
13 02 00 0C 47 2A 0D 0A
0x00:normal
0x01:SOS
0x02:Power cut alarm
0x03: Vibration alarm
0x04:Enter fence alarm
0x05:Exit fence alarm
0x06 Over speed alarm
Byte 1
0x09 Moving alarm
0x0A Enter GPS dead zone alarm
0x0BExit GPS dead zone alarm
0x0C Power on alarm
0x0D GPS First fix notice
0x0E Low battery alarm
0x13 Remove alarm
0x01Chinese
Byte2
0x02 English
Length Description
Information Serial Serial number of data sent later at each time will be automatically
2
Number added 1
Length Description
Start Bit 2 0x78 0x78
Length = Protocol Number + Information Content + Information
Length of data bit 1
Serial Number + Error Check
Protocol Number 1 0x80
Length of
1 Server flag bit + command content length + language
Command
Information Leave for server identification. Terminal receives the original
Server Flag Bit 4
Content data in Binary in response packet
Command Character string replied in ASCII coding. Command content is
M
Content compatible with SMS command.
Serial number of data sent later at each time will be
Information Serial Number 2
Automatically added 1.
Length Description
Example:79 79 00 9D 21 00 00 00 00 01 42 61 74 74 65 72 79 3A 34 2E 31 36 56 2C 4E 4F 52 4D
41 4C 3B 20 47 50 52 53 3A 4C 69 6E 6B 20 55 70 3B 20 47 53 4D 20 53 69 67 6E 61 6C 20 4C 65 76 65 6C 3A 53 74
72 6F 6E 67 3B 20 47 50 53 3A 53 65 61 72 63 68 69 6E 67 20 73 61 74 65 6C 6C 69 74 65 2C 20 53 56 53 20 55 73
65 64 20 69 6E 20 66 69 78 3A 30 28 30 29 2C 20 47 50 53 20 53 69 67 6E 61 6C 20 4C 65 76 65 6C 3A 3B 20 41 43
43 3A 4F 46 46 3B 20 44 65 66 65 6E 73 65 3A 4F 46 46 00 2E 26 DF 0D 0A
Wifi packet
Length
Description
(Byte)
Protocol
1 0x33
Number
Year(1byte)Month(1byte)Day(1byte)Hour(1byte)Min(1byte)
Date
6 Second(1byte)(converted to decimal)(Date Time)
Time
Timezone is UTC+0(Fixed)
NLAC
Same as LAC
1 2
Information
Content
NCI1 4 Same as CI
NRSSI
Same as RSSI
1 1
NLAC
Same as LAC
5 2
NCI5 4 Same as CI
NRSSI
Same as RSSI
5 1
WIFI
Wifi signal strength
strength 1 1
WIFI MAC5
6
WIFI
Strength 5 1
No need to reply.
3 Appendix
Code fragment of the CRC-ITU lookup table algorithm implemented based on C language
staticconstU16crctab16[]=
{
0X0000,0X1189,0X2312,0X329B,0X4624,0X57AD,0X6536,0X74BF,
0X8C48,0X9DC1,0XAF5A,0XBED3,0XCA6C,0XDBE5,0XE97E,0XF8F7,
0X1081,0X0108,0X3393,0X221A,0X56A5,0X472C,0X75B7,0X643E,
0X9CC9,0X8D40,0XBFDB,0XAE52,0XDAED,0XCB64,0XF9FF,0XE876,
0X2102,0X308B,0X0210,0X1399,0X6726,0X76AF,0X4434,0X55BD,
0XAD4A,0XBCC3,0X8E58,0X9FD1,0XEB6E,0XFAE7,0XC87C,0XD9F5,
0X3183,0X200A,0X1291,0X0318,0X77A7,0X662E,0X54B5,0X453C,
0XBDCB,0XAC42,0X9ED9,0X8F50,0XFBEF,0XEA66,0XD8FD,0XC974,
0X4204,0X538D,0X6116,0X709F,0X0420,0X15A9,0X2732,0X36BB,
0XCE4C,0XDFC5,0XED5E,0XFCD7,0X8868,0X99E1,0XAB7A,0XBAF3,
0X5285,0X430C,0X7197,0X601E,0X14A1,0X0528,0X37B3,0X263A,
0XDECD,0XCF44,0XFDDF,0XEC56,0X98E9,0X8960,0XBBFB,0XAA72,
0X6306,0X728F,0X4014,0X519D,0X2522,0X34AB,0X0630,0X17B9,
0XEF4E,0XFEC7,0XCC5C,0XDDD5,0XA96A,0XB8E3,0X8A78,0X9BF1,
0X7387,0X620E,0X5095,0X411C,0X35A3,0X242A,0X16B1,0X0738,
0XFFCF,0XEE46,0XDCDD,0XCD54,0XB9EB,0XA862,0X9AF9,0X8B70,
0X8408,0X9581,0XA71A,0XB693,0XC22C,0XD3A5,0XE13E,0XF0B7,
0X0840,0X19C9,0X2B52,0X3ADB,0X4E64,0X5FED,0X6D76,0X7CFF,
0X9489,0X8500,0XB79B,0XA612,0XD2AD,0XC324,0XF1BF,0XE036,
0X18C1,0X0948,0X3BD3,0X2A5A,0X5EE5,0X4F6C,0X7DF7,0X6C7E,
0XA50A,0XB483,0X8618,0X9791,0XE32E,0XF2A7,0XC03C,0XD1B5,
0X2942,0X38CB,0X0A50,0X1BD9,0X6F66,0X7EEF,0X4C74,0X5DFD,
0XB58B,0XA402,0X9699,0X8710,0XF3AF,0XE226,0XD0BD,0XC134,
0X39C3,0X284A,0X1AD1,0X0B58,0X7FE7,0X6E6E,0X5CF5,0X4D7C,
0XC60C,0XD785,0XE51E,0XF497,0X8028,0X91A1,0XA33A,0XB2B3,
0X4A44,0X5BCD,0X6956,0X78DF,0X0C60,0X1DE9,0X2F72,0X3EFB,
0XD68D,0XC704,0XF59F,0XE416,0X90A9,0X8120,0XB3BB,0XA232,
0X5AC5,0X4B4C,0X79D7,0X685E,0X1CE1,0X0D68,0X3FF3,0X2E7A,
0XE70E,0XF687,0XC41C,0XD595,0XA12A,0XB0A3,0X8238,0X93B1,
0X6B46,0X7ACF,0X4854,0X59DD,0X2D62,0X3CEB,0X0E70,0X1FF9,
0XF78F,0XE606,0XD49D,0XC514,0XB1AB,0XA022,0X92B9,0X8330,
0X7BC7,0X6A4E,0X58D5,0X495C,0X3DE3,0X2C6A,0X1EF1,0X0F78,
};
//calculate the 16-bit CRC of data with predetermined length.
U16GetCrc16(constU8*pData,intnLength)
{
U16fcs=0xffff;//initialization
while(nLength>0){fcs=(fcs>>8)^crctab16[(fcs^*pData)&0xff];
nLength--;
pData++;
}
return~fcs;//negated
}