| Head | Message Header | Message Body | Check Code | Tail |
|---|---|---|---|---|
| Begin | JT808Header | JT808Bodies | CheckCode | End |
| 7E | - | - | - | 7E |
| Message ID | Message Body Properties | Protocol Version Number (2019 Version) | Terminal Phone Number | Message serial number | Total number of messages | Packet Sequence Number |
|---|---|---|---|---|---|---|
| MsgId | JT808HeaderMessageBodyProperty | ProtocolVersion | TerminalPhoneNo | MsgNum | PackgeCount | PackageIndex |
| Version identification(2019 version) | Subcontracting | Data Encryption | Message Body Length |
|---|---|---|---|
| VersionFlag | IsPackge | Encrypt | DataLength |
According to the corresponding message ID: MsgId
Note: the data content (excluding the head and tail identifiers) is escaped
The escape rules are as follows:
- If the character 0x7e appears in the data content, it should be replaced with the character 0x7d followed by the character 0x02;
- If the character 0x7d appears in the data content, it should be replaced with the character 0x7d followed by the character 0x01;
Reason for the inversion: Confirm the TCP message boundary of the JT808 protocol.
MsgId 0x0200: Location information report
JT808Package jT808Package = new JT808Package();
jT808Package.Header = new JT808Header
{
MsgId = Enums.JT808MsgId.位置信息汇报,
ManualMsgNum = 126,
TerminalPhoneNo = "123456789012"
};
JT808_0x0200 jT808_0x0200 = new JT808_0x0200();
jT808_0x0200.AlarmFlag = 1;
jT808_0x0200.Altitude = 40;
jT808_0x0200.GPSTime = DateTime.Parse("2018-10-15 10:10:10");
jT808_0x0200.Lat = 12222222;
jT808_0x0200.Lng = 132444444;
jT808_0x0200.Speed = 60;
jT808_0x0200.Direction = 0;
jT808_0x0200.StatusFlag = 2;
jT808_0x0200.JT808LocationAttachData = new Dictionary<byte, JT808_0x0200_BodyBase>();
jT808_0x0200.JT808LocationAttachData.Add(JT808Constants.JT808_0x0200_0x01, new JT808_0x0200_0x01
{
Mileage = 100
});
jT808_0x0200.JT808LocationAttachData.Add(JT808Constants.JT808_0x0200_0x02, new JT808_0x0200_0x02
{
Oil = 125
});
jT808Package.Bodies = jT808_0x0200;
byte[] data = JT808Serializer.Serialize(jT808Package);
var hex = data.ToHexString();
// Output Hex：
// 7E 02 00 00 26 12 34 56 78 90 12 00 7D 02 00 00 00 01 00 00 00 02 00 BA 7F 0E 07 E4 F1 1C 00 28 00 3C 00 00 18 10 15 10 10 10 01 04 00 00 00 64 02 02 00 7D 01 13 7E
1.Initial Packet：
7E 02 00 00 26 12 34 56 78 90 12 00 (7D 02) 00 00 00 01 00 00 00 02 00 BA 7F 0E 07 E4 F1 1C 00 28 00 3C 00 00 18 10 15 10 10 10 01 04 00 00 00 64 02 02 00 (7D 01) 13 7E
2.Escaping
7D 02 ->7E
7D 01 ->7D
Escaping result
7E 02 00 00 26 12 34 56 78 90 12 00 7E 00 00 00 01 00 00 00 02 00 BA 7F 0E 07 E4 F1 1C 00 28 00 3C 00 00 18 10 15 10 10 10 01 04 00 00 00 64 02 02 00 7D 13 7E
3.Unpack
7E --Header Identification
02 00 --Header->Message ID
00 26 --Header->Message Body Properties
12 34 56 78 90 12 --Header->Terminal Phone Number
00 7E --Header-> Message Serial Number
00 00 00 01 --Body->Alarm Flag
00 00 00 02 --Body->Status
00 BA 7F 0E --Body->Latitude
07 E4 F1 1C --Body->Longitude
00 28 --Body->Altitude
00 3C --Body->Spedd
00 00 --Body->Heading
18 10 15 10 10 10 --Body->GPS Timestamp
01 --Body->Additional Information->Mileage
04 --Body->Additional Information->Length
00 00 00 64 --Body->Additional Information->Data
02 --Body->Additional Information->Fuel Level
02 --Body->Additional Information->Length
00 7D --Body->Additional Information->Data
13 --Check Code
7E --Tail Identification
//1.Convert to byte array
byte[] bytes = "7E 02 00 00 26 12 34 56 78 90 12 00 7D 02 00 00 00 01 00 00 00 02 00 BA 7F 0E 07 E4 F1 1C 00 28 00 3C 00 00 18 10 15 10 10 10 01 04 00 00 00 64 02 02 00 7D 01 13 7E".ToHexBytes();
//2.Deserialize array
var jT808Package = JT808Serializer.Deserialize(bytes);
//3.Packet Header
Assert.Equal(Enums.JT808MsgId.位置信息汇报, jT808Package.Header.MsgId);
Assert.Equal(38, jT808Package.Header.MessageBodyProperty.DataLength);
Assert.Equal(126, jT808Package.Header.MsgNum);
Assert.Equal("123456789012", jT808Package.Header.TerminalPhoneNo);
Assert.False(jT808Package.Header.MessageBodyProperty.IsPackge);
Assert.Equal(0, jT808Package.Header.PackageIndex);
Assert.Equal(0, jT808Package.Header.PackgeCount);
Assert.Equal(JT808EncryptMethod.None, jT808Package.Header.MessageBodyProperty.Encrypt);
//4.Packet Body
JT808_0x0200 jT808_0x0200 = (JT808_0x0200)jT808Package.Bodies;
Assert.Equal((uint)1, jT808_0x0200.AlarmFlag);
Assert.Equal((uint)40, jT808_0x0200.Altitude);
Assert.Equal(DateTime.Parse("2018-10-15 10:10:10"), jT808_0x0200.GPSTime);
Assert.Equal(12222222, jT808_0x0200.Lat);
Assert.Equal(132444444, jT808_0x0200.Lng);
Assert.Equal(60, jT808_0x0200.Speed);
Assert.Equal(0, jT808_0x0200.Direction);
Assert.Equal((uint)2, jT808_0x0200.StatusFlag);
//4.1.Additional Information 1
Assert.Equal(100, ((JT808_0x0200_0x01)jT808_0x0200.JT808LocationAttachData[JT808Constants.JT808_0x0200_0x01]).Mileage);
//4.2.Additional Information 2
Assert.Equal(125, ((JT808_0x0200_0x02)jT808_0x0200.JT808LocationAttachData[JT808Constants.JT808_0x0200_0x02]).Oil);
// Create JT808Package package using extension method of message Id
JT808Package jT808Package = Enums.JT808MsgId.位置信息汇报.Create("123456789012",
new JT808_0x0200 {
AlarmFlag = 1,
Altitude = 40,
GPSTime = DateTime.Parse("2018-10-15 10:10:10"),
Lat = 12222222,
Lng = 132444444,
Speed = 60,
Direction = 0,
StatusFlag = 2,
JT808LocationAttachData = new Dictionary<byte, JT808LocationAttachBase>
{
{ JT808Constants.JT808_0x0200_0x01,new JT808_0x0200_0x01{Mileage = 100}},
{ JT808Constants.JT808_0x0200_0x02,new JT808_0x0200_0x02{Oil = 125}}
}
});
byte[] data = JT808Serializer.Serialize(jT808Package);
var hex = data.ToHexString();
//Output Hex：
//7E 02 00 00 26 12 34 56 78 90 12 00 01 00 00 00 01 00 00 00 02 00 BA 7F 0E 07 E4 F1 1C 00 28 00 3C 00 00 18 10 15 10 10 10 01 04 00 00 00 64 02 02 00 7D 01 6C 7E
// Initial configuration
IJT808Config DT1JT808Config = new DT1Config();
IJT808Config DT2JT808Config = new DT2Config();
// Registering a custom message external assembly
DT1JT808Config.Register(Assembly.GetExecutingAssembly());
// Skip checksum verification
DT1JT808Config.SkipCRCCode = true;
// Add custom message Id
DT1JT808Config.MsgIdFactory.SetMap<DT1Demo6>();
DT2JT808Config.MsgIdFactory.SetMap<DT2Demo6>();
// Serialization
JT808Serializer DT1JT808Serializer = new JT808Serializer(DT1JT808Config);
JT808Serializer DT2JT808Serializer = new JT808Serializer(DT2JT808Config);
| Package Name | Version | Downloads |
|---|---|---|
| Install-Package JT808 |  |
 |
| Install-Package JT808.Protocol.Extensions.JT1078 |  |
 |
| Install-Package JT808.Protocol.Extensions.JTActiveSafety |  |
 |
BenchmarkDotNet=v0.12.0, OS=Windows 10.0.18363
Intel Core i7-8700K CPU 3.70GHz (Coffee Lake), 1 CPU, 12 logical and 6 physical cores
.NET Core SDK=3.1.100
[Host] : .NET Core 3.1.0 (CoreCLR 4.700.19.56402, CoreFX 4.700.19.56404), X64 RyuJIT
Job-DSNYYA : .NET Core 3.1.0 (CoreCLR 4.700.19.56402, CoreFX 4.700.19.56404), X64 RyuJIT
Platform=AnyCpu Server=False Toolchain=.NET Core 3.1
| Method | Categories | N | Mean | Error | StdDev | Gen 0 | Gen 1 | Gen 2 | Allocated |
|---|---|---|---|---|---|---|---|---|---|
| 0x0200_All_AttachId_Serialize | 0x0200Serializer | 100 | 262.46 us | 3.178 us | 2.654 us | 31.7383 | - | - | 196.09 KB |
| 0x0200_All_AttachId_Deserialize | 0x0200Serializer | 100 | 812.97 us | 3.537 us | 2.953 us | 80.0781 | - | - | 493.75 KB |
| 0x0200_All_AttachId_Serialize | 0x0200Serializer | 10000 | 26,537.30 us | 382.221 us | 319.172 us | 3187.5000 | - | - | 19609.38 KB |
| 0x0200_All_AttachId_Deserialize | 0x0200Serializer | 10000 | 82,939.55 us | 1,133.599 us | 1,060.370 us | 8000.0000 | - | - | 49376.19 KB |
| 0x0200_All_AttachId_Serialize | 0x0200Serializer | 100000 | 261,695.51 us | 5,005.517 us | 5,355.847 us | 32000.0000 | - | - | 196093.75 KB |
| 0x0200_All_AttachId_Deserialize | 0x0200Serializer | 100000 | 824,904.93 us | 16,325.230 us | 15,270.630 us | 80000.0000 | - | - | 493750 KB |
| 0x0100Serialize | 0x0100Serializer | 100 | 78.05 us | 0.984 us | 0.920 us | 10.6201 | - | - | 65.63 KB |
| 0x0100Deserialize | 0x0100Serializer | 100 | 81.54 us | 1.618 us | 1.798 us | 15.6250 | - | - | 96.09 KB |
| 0x0100Serialize | 0x0100Serializer | 10000 | 8,007.65 us | 97.177 us | 86.145 us | 1062.5000 | - | - | 6562.5 KB |
| 0x0100Deserialize | 0x0100Serializer | 10000 | 8,028.20 us | 123.340 us | 115.372 us | 1562.5000 | - | - | 9609.44 KB |
| 0x0100Serialize | 0x0100Serializer | 100000 | 80,765.75 us | 1,016.904 us | 901.459 us | 10571.4286 | - | - | 65625.28 KB |
| 0x0100Deserialize | 0x0100Serializer | 100000 | 80,955.97 us | 958.045 us | 849.282 us | 15571.4286 | - | - | 96093.87 KB |
| ID | Message ID | Status Execution | Status Test | Message Body | 2019 release |
|---|---|---|---|---|---|
| 1 | 0x0001 | √ | √ | Terminal universal response | |
| 2 | 0x8001 | √ | √ | Platform universal response | |
| 3 | 0x0002 | √ | √ | Terminal heartbeat | |
| 4 | 0x8003 | √ | √ | Subcontracting Request | |
| 5 | 0x0100 | √ | √ | Terminal registration | modified |
| 6 | 0x8100 | √ | √ | Terminal registration response | |
| 7 | 0x0003 | √ | √ | Terminal logout | |
| 8 | 0x0102 | √ | √ | Terminal authentication | modified |
| 9 | 0x8103 | √ | √ | Setting terminal parameters | modified and add |
| 10 | 0x8104 | √ | √ | Query terminal parameters | |
| 11 | 0x0104 | √ | √ | Query terminal parameter response | |
| 12 | 0x8105 | √ | √ | Terminal control | |
| 13 | 0x8106 | √ | √ | Querying specified terminal parameters | |
| 14 | 0x8107 | √ | Msg Body is empty | Query terminal properties | |
| 15 | 0x0107 | √ | √ | Query terminal attribute response | |
| 16 | 0x8108 | √ | √ | Issue terminal upgrade package | |
| 17 | 0x0108 | √ | √ | Terminal upgrade result notification | |
| 18 | 0x0200 | √ | √ | Location Information Report | Add additional information |
| 19 | 0x8201 | √ | √ | Location information query | |
| 20 | 0x0201 | √ | √ | Location information query response | |
| 21 | 0x8202 | √ | √ | Temporary position tracking control | |
| 22 | 0x8203 | √ | √ | Manually acknowledge alarm messages | |
| 23 | 0x8300 | √ | √ | Text message delivery | modified |
| 24 | 0x8301 | √ | √ | Event settings | deleted |
| 25 | 0x0301 | √ | √ | Incident report | deleted |
| 26 | 0x8302 | √ | √ | Questions issued | deleted |
| 27 | 0x0302 | √ | √ | Question Answer | deleted |
| 28 | 0x8303 | √ | √ | Information on demand menu settings | deleted |
| 29 | 0x0303 | √ | √ | Information On Demand / Cancel | deleted |
| 30 | 0x8304 | √ | √ | Information service | deleted |
| 31 | 0x8400 | √ | √ | Call back | |
| 32 | 0x8401 | √ | √ | Set up phone book | |
| 33 | 0x8500 | √ | √ | Vehicle control | modified |
| 34 | 0x0500 | √ | √ | Vehicle control response | |
| 35 | 0x8600 | √ | √ | Set circular area | modified |
| 36 | 0x8601 | √ | √ | Delete circular area | |
| 37 | 0x8602 | √ | √ | Set rectangular area | modified |
| 38 | 0x8603 | √ | √ | Delete rectangular area | |
| 39 | 0x8604 | √ | √ | Set polygon area | modified |
| 40 | 0x8605 | √ | √ | Delete polygon area | |
| 41 | 0x8606 | √ | √ | Set route | modified |
| 42 | 0x8607 | √ | √ | Delete route | |
| 43 | 0x8700 | x | x | Tachograph data acquisition commands | Todo: To be developed |
| 44 | 0x0700 | x | x | Tachograph data upload | Todo: To be developed |
| 45 | 0x8701 | x | x | Drive recorder parameter download command | Todo: To be developed |
| 46 | 0x0701 | √ | √ | Electronic waybill report | |
| 47 | 0x0702 | √ | √ | Collection and reporting of driver identity information | modified |
| 48 | 0x8702 | √ | Msg Body is empty | Request to report driver identity information | |
| 49 | 0x0704 | √ | √ | Batch upload of positioning data | modified |
| 50 | 0x0705 | √ | √ | CAN bus data upload | modified |
| 51 | 0x0800 | √ | √ | Multimedia event information upload | |
| 52 | 0x0801 | √ | √ | Multimedia data upload | modified |
| 53 | 0x8800 | √ | √ | Multimedia data upload response | |
| 54 | 0x8801 | √ | √ | Camera Instant Command | modified |
| 55 | 0x0805 | √ | √ | Camera captures command immediately | modified |
| 56 | 0x8802 | √ | √ | Stored multimedia data retrieval | |
| 57 | 0x0802 | √ | √ | Store multimedia data retrieval response | |
| 58 | 0x8803 | √ | √ | Store multimedia data upload | |
| 59 | 0x8804 | √ | √ | Recording start command | |
| 60 | 0x8805 | √ | √ | Single storage multimedia data retrieval upload command | modified |
| 61 | 0x8900 | √ | √ | Data downlink transparent transmission | modified |
| 62 | 0x0900 | √ | √ | Data uplink transparent transmission | modified |
| 63 | 0x0901 | √ | √ | Data compression report | |
| 64 | 0x8A00 | √ | √ | Platform RSA Public Key | |
| 65 | 0x0A00 | √ | √ | Terminal RSA Public Key | |
| 66 | 0x8F00~0x8FFF | Keep | Keep | Platform downlink message retention | |
| 67 | 0x0F00~0x0FFF | Keep | Keep | Terminal uplink message retention | |
| 68 | 0x0004 | √ | √ | Query server time request | added |
| 69 | 0x8004 | √ | √ | Query server time response | added |
| 70 | 0x0005 | √ | √ | Terminal Sub-transmission Subcontracting Request | added |
| 71 | 0x8204 | √ | √ | Link detection | added |
| 72 | 0x8608 | √ | √ | Query area or line data | added |
| 73 | 0x0608 | √ | √ | Query area or line data response | added |
| 74 | 0xE000~0xEFFF | Keep | Keep | Vendor-defined upstream message | added |
| 75 | 0xF000~0xFFFF | Keep | Keep | Vendor-defined downstream message | added |