![MIT Licence](https://camo.githubusercontent.com/8d21c5736f88861db16f98cc10dfd6be971d1551374db3394465d8e4c4aad098/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6d6173686170652f6170697374617475732e737667)
![FOSSA Status](https://camo.githubusercontent.com/e429187feba085e2672c4a32b8905f8eea9a73581e320cae5591fd4bff06badc/68747470733a2f2f6170702e666f7373612e696f2f6170692f70726f6a656374732f6769742532426769746875622e636f6d253246536d616c6c4368692532464a543830382e7376673f747970653d736869656c64)
- 掌握进制转换:二进制转十六进制;
- 掌握BCD编码、Hex编码;
- 掌握各种位移、异或;
- 掌握常用反射;
- 掌握快速ctrl+c、ctrl+v;
- 掌握以上装逼技能,就可以开始搬砖了。
头标识 |
数据头 |
数据体 |
校验码 |
尾标识 |
Begin |
JT808Header |
JT808Bodies |
CheckCode |
End |
7E |
- |
- |
- |
7E |
数据头[JT808Header]
消息ID |
消息体属性 |
终端手机号 |
消息流水号 |
MsgId |
JT808HeaderMessageBodyProperty |
TerminalPhoneNo |
MsgNum |
数据头-消息体属性[JT808HeaderMessageBodyProperty]
是否分包 |
加密标识 |
消息体长度 |
消息总包数 |
包序号 |
IsPackge |
Encrypt |
DataLength |
PackgeCount |
PackageIndex |
根据对应消息ID:MsgId
注意:数据内容(除去头和尾标识)进行转义判断
转义规则如下:
- 若数据内容中有出现字符 0x7e 的,需替换为字符 0x7d 紧跟字符 0x02;
- 若数据内容中有出现字符 0x7d 的,需替换为字符 0x7d 紧跟字符 0x01;
反转义的原因:确认JT808协议的TCP消息边界。
MsgId 0x0200:位置信息汇报
JT808Package jT808Package = new JT808Package();
jT808Package.Header = new JT808Header
{
MsgId = Enums.JT808MsgId.位置信息汇报,
MsgNum = 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, JT808LocationAttachBase>();
jT808_0x0200.JT808LocationAttachData.Add(JT808LocationAttachBase.AttachId0x01, new JT808LocationAttachImpl0x01
{
Mileage = 100
});
jT808_0x0200.JT808LocationAttachData.Add(JT808LocationAttachBase.AttachId0x02, new JT808LocationAttachImpl0x02
{
Oil = 125
});
jT808Package.Bodies = jT808_0x0200;
byte[] data = JT808Serializer.Serialize(jT808Package);
var hex = data.ToHexString();
// 输出结果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.原包:
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.进行反转义
7D 02 ->7E
7D 01 ->7D
反转义后
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.拆解
7E --头标识
02 00 --数据头->消息ID
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 --消息体->GPS时间
01 --消息体->附加信息->里程
04 --消息体->附加信息->长度
00 00 00 64 --消息体->附加信息->数据
02 --消息体->附加信息->油量
02 --消息体->附加信息->长度
00 7D --消息体->附加信息->数据
13 --检验码
7E --尾标识
//1.转成byte数组
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.将数组反序列化
var jT808Package = JT808Serializer.Deserialize<JT808Package>(bytes);
//3.数据包头
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.MessageBodyProperty.PackageIndex);
Assert.Equal(0, jT808Package.Header.MessageBodyProperty.PackgeCount);
Assert.Equal(JT808EncryptMethod.None, jT808Package.Header.MessageBodyProperty.Encrypt);
//4.数据包体
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.附加信息1
Assert.Equal(100, ((JT808LocationAttachImpl0x01)jT808_0x0200.JT808LocationAttachData[JT808LocationAttachBase.AttachId0x01]).Mileage);
//4.2.附加信息2
Assert.Equal(125, ((JT808LocationAttachImpl0x02)jT808_0x0200.JT808LocationAttachData[JT808LocationAttachBase.AttachId0x02]).Oil);
// 使用消息Id的扩展方法创建JT808Package包
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>
{
{ JT808LocationAttachBase.AttachId0x01,new JT808LocationAttachImpl0x01{Mileage = 100}},
{ JT808LocationAttachBase.AttachId0x02,new JT808LocationAttachImpl0x02{Oil = 125}}
}
});
byte[] data = JT808Serializer.Serialize(jT808Package);
var hex = data.ToHexString();
//输出结果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
// 全局配置
JT808GlobalConfig.Instance
// 注册自定义位置附加信息
.Register_0x0200_Attach<JT808LocationAttachImpl0x06>(0x06)
//.SetMsgSNDistributed(//todo 实现IMsgSNDistributed消息流水号)
// 注册自定义数据上行透传信息
//.Register_0x0900_Ext<>(//todo 继承自JT808_0x0900_BodyBase类)
// 注册自定义数据下行透传信息
//.Register_0x8900_Ext<>(//todo 继承自JT808_0x8900_BodyBase类)
// 跳过校验码验证
.SetSkipCRCCode(true);
Package Name |
Version |
Downloads |
Install-Package JT808 |
![JT808](https://camo.githubusercontent.com/48d519f576ad09449a3c8881235f64c2b2f776b6a14fd8e492c8466a1ef00a98/68747470733a2f2f696d672e736869656c64732e696f2f6e756765742f762f4a543830382e737667) |
![JT808](https://camo.githubusercontent.com/8571626e35123b3127c6dc280ebcd359ed44da729520e9387207e2e99bd81757/68747470733a2f2f696d672e736869656c64732e696f2f6e756765742f64742f4a543830382e737667) |
使用BenchmarkDotNet性能测试报告(只是玩玩,不能当真)
BenchmarkDotNet=v0.11.0, OS=Windows 10.0.17134.285 (1803/April2018Update/Redstone4)
Intel Core i7-8700K CPU 3.70GHz (Coffee Lake), 1 CPU, 12 logical and 6 physical cores
.NET Core SDK=2.1.403
[Host] : .NET Core 2.1.5 (CoreCLR 4.6.26919.02, CoreFX 4.6.26919.02), 64bit RyuJIT
Job-RUQNRZ : .NET Framework 4.7.2 (CLR 4.0.30319.42000), 64bit RyuJIT-v4.7.3163.0
Job-LKSCJQ : .NET Core 2.1.5 (CoreCLR 4.6.26919.02, CoreFX 4.6.26919.02), 64bit RyuJIT
Platform=AnyCpu Server=False
Method |
Runtime |
Toolchain |
N |
Mean |
Error |
StdDev |
Gen 0 |
Gen 1 |
Allocated |
0x0200Serialize |
Clr |
Default |
100 |
3.335 ms |
0.0548 ms |
0.0513 ms |
82.0313 |
- |
507.82 KB |
0x0200Deserialize |
Clr |
Default |
100 |
2.991 ms |
0.0184 ms |
0.0154 ms |
82.0313 |
- |
520.32 KB |
0x0200Serialize |
Core |
.NET Core 2.1 |
100 |
2.694 ms |
0.0149 ms |
0.0139 ms |
74.2188 |
- |
456.25 KB |
0x0200Deserialize |
Core |
.NET Core 2.1 |
100 |
2.494 ms |
0.0467 ms |
0.0437 ms |
74.2188 |
- |
461.72 KB |
0x0200Serialize |
Clr |
Default |
10000 |
340.080 ms |
6.6767 ms |
10.3949 ms |
8000.0000 |
- |
50784.42 KB |
0x0200Deserialize |
Clr |
Default |
10000 |
300.888 ms |
2.1836 ms |
1.9357 ms |
8000.0000 |
- |
52032.62 KB |
0x0200Serialize |
Core |
.NET Core 2.1 |
10000 |
261.578 ms |
2.1118 ms |
1.7634 ms |
7000.0000 |
- |
45625 KB |
0x0200Deserialize |
Core |
.NET Core 2.1 |
10000 |
249.057 ms |
4.8000 ms |
4.4899 ms |
7333.3333 |
- |
46171.88 KB |
0x0200Serialize |
Clr |
Default |
100000 |
3,302.609 ms |
12.7088 ms |
11.2660 ms |
82000.0000 |
- |
507821.17 KB |
0x0200Deserialize |
Clr |
Default |
100000 |
3,040.852 ms |
65.1235 ms |
82.3604 ms |
84000.0000 |
- |
520318.04 KB |
0x0200Serialize |
Core |
.NET Core 2.1 |
100000 |
2,725.767 ms |
16.9146 ms |
15.8219 ms |
74000.0000 |
- |
456250 KB |
0x0200Deserialize |
Core |
.NET Core 2.1 |
100000 |
2,607.481 ms |
52.9243 ms |
103.2248 ms |
75000.0000 |
- |
461718.75 KB |
0x0200Serialize |
Clr |
Default |
1000000 |
34,065.032 ms |
670.7606 ms |
848.2973 ms |
826000.0000 |
3000.0000 |
5078164.22 KB |
0x0200Deserialize |
Clr |
Default |
1000000 |
30,162.112 ms |
123.7327 ms |
115.7396 ms |
846000.0000 |
3000.0000 |
5203172.61 KB |
0x0200Serialize |
Core |
.NET Core 2.1 |
1000000 |
27,196.163 ms |
102.3533 ms |
95.7414 ms |
742000.0000 |
2000.0000 |
4562500 KB |
0x0200Deserialize |
Core |
.NET Core 2.1 |
1000000 |
25,050.882 ms |
105.5313 ms |
98.7141 ms |
751000.0000 |
2000.0000 |
4617187.5 KB |
序号 |
消息ID |
完成情况 |
测试情况 |
消息体名称 |
1 |
0x0001 |
√ |
√ |
终端通用应答 |
2 |
0x8001 |
√ |
√ |
平台通用应答 |
3 |
0x0002 |
√ |
√ |
终端心跳 |
4 |
0x8003 |
√ |
√ |
补传分包请求 |
5 |
0x0100 |
√ |
√ |
终端注册 |
6 |
0x8100 |
√ |
√ |
终端注册应答 |
7 |
0x0003 |
√ |
√ |
终端注销 |
8 |
0x0102 |
√ |
√ |
终端鉴权 |
9 |
0x8103 |
√ |
√ |
设置终端参数 |
10 |
0x8104 |
√ |
√ |
查询终端参数 |
11 |
0x0104 |
√ |
√ |
查询终端参数应答 |
12 |
0x8105 |
√ |
√ |
终端控制 |
13 |
0x8106 |
√ |
√ |
查询指定终端参数 |
14 |
0x8107 |
√ |
消息体为空 |
查询终端属性 |
15 |
0x0107 |
√ |
√ |
查询终端属性应答 |
16 |
0x8108 |
√ |
√ |
下发终端升级包 |
17 |
0x0108 |
√ |
√ |
终端升级结果通知 |
18 |
0x0200 |
√ |
√ |
位置信息汇报 |
19 |
0x8201 |
√ |
√ |
位置信息查询 |
20 |
0x0201 |
√ |
√ |
位置信息查询应答 |
21 |
0x8202 |
√ |
√ |
临时位置跟踪控制 |
22 |
0x8203 |
√ |
√ |
人工确认报警消息 |
23 |
0x8300 |
√ |
√ |
文本信息下发 |
24 |
0x8301 |
√ |
√ |
事件设置 |
25 |
0x0301 |
√ |
√ |
事件报告 |
26 |
0x8302 |
√ |
√ |
提问下发 |
27 |
0x0302 |
√ |
√ |
提问应答 |
28 |
0x8303 |
√ |
√ |
信息点播菜单设置 |
29 |
0x0303 |
√ |
√ |
信息点播/取消 |
30 |
0x8304 |
√ |
√ |
信息服务 |
31 |
0x8400 |
√ |
√ |
电话回拨 |
32 |
0x8401 |
√ |
√ |
设置电话本 |
33 |
0x8500 |
√ |
√ |
车辆控制 |
34 |
0x0500 |
√ |
√ |
车辆控制应答 |
35 |
0x8600 |
√ |
√ |
设置圆形区域 |
36 |
0x8601 |
√ |
√ |
删除圆形区域 |
37 |
0x8602 |
√ |
√ |
设置矩形区域 |
38 |
0x8603 |
√ |
√ |
删除矩形区域 |
39 |
0x8604 |
√ |
√ |
设置多边形区域 |
40 |
0x8605 |
√ |
√ |
删除多边形区域 |
41 |
0x8606 |
√ |
√ |
设置路线 |
42 |
0x8607 |
√ |
√ |
删除路线 |
43 |
0x8700 |
x |
下个版本 |
行驶记录仪数据采集命令 |
44 |
0x0700 |
x |
下个版本 |
行驶记录仪数据上传 |
45 |
0x8701 |
x |
下个版本 |
行驶记录仪参数下传命令 |
46 |
0x0701 |
√ |
√ |
电子运单上报 |
47 |
0x0702 |
√ |
√ |
驾驶员身份信息采集上报 |
48 |
0x8702 |
√ |
消息体为空 |
上报驾驶员身份信息请求 |
49 |
0x0704 |
√ |
√ |
定位数据批量上传 |
50 |
0x0705 |
√ |
√ |
CAN 总线数据上传 |
51 |
0x0800 |
√ |
√ |
多媒体事件信息上传 |
52 |
0x0801 |
√ |
√ |
多媒体数据上传 |
53 |
0x8800 |
√ |
√ |
多媒体数据上传应答 |
54 |
0x8801 |
√ |
√ |
摄像头立即拍摄命令 |
55 |
0x0805 |
√ |
√ |
摄像头立即拍摄命令应答 |
56 |
0x8802 |
√ |
√ |
存储多媒体数据检索 |
57 |
0x0802 |
√ |
√ |
存储多媒体数据检索应答 |
58 |
0x8803 |
√ |
√ |
存储多媒体数据上传 |
59 |
0x8804 |
√ |
√ |
录音开始命令 |
60 |
0x8805 |
√ |
√ |
单条存储多媒体数据检索上传命令 |
61 |
0x8900 |
√ |
√ |
数据下行透传 |
62 |
0x0900 |
√ |
√ |
数据上行透传 |
63 |
0x0901 |
√ |
√ |
数据压缩上报 |
64 |
0x8A00 |
√ |
√ |
平台 RSA 公钥 |
65 |
0x0A00 |
√ |
√ |
终端 RSA 公钥 |
66 |
0x8F00~0x8FFF |
保留 |
保留 |
平台下行消息保留 |
67 |
0x0F00~0x0FFF |
保留 |
保留 |
终端上行消息保留 |