1 Star 0 Fork 13

KelleyLiu / JT808-1

forked from chris_coder / JT808-1 
加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README
MIT

JT808协议

MIT LicenceFOSSA StatusBuild Status

前提条件

  1. 掌握进制转换:二进制转十六进制;
  2. 掌握BCD编码、Hex编码;
  3. 掌握各种位移、异或;
  4. 掌握常用反射;
  5. 掌握快速ctrl+c、ctrl+v;
  6. 掌握以上装逼技能,就可以开始搬砖了。

JT808数据结构解析

数据包[JT808Package]

头标识 数据头 数据体 校验码 尾标识
Begin JT808Header JT808Bodies CheckCode End
7E - - - 7E

数据头[JT808Header]

消息ID 消息体属性 终端手机号 消息流水号
MsgId JT808HeaderMessageBodyProperty TerminalPhoneNo MsgNum

数据头-消息体属性[JT808HeaderMessageBodyProperty]

是否分包 加密标识 消息体长度 消息总包数 包序号
IsPackge Encrypt DataLength PackgeCount PackageIndex

消息体属性[JT808Bodies]

根据对应消息ID:MsgId

注意:数据内容(除去头和尾标识)进行转义判断

转义规则如下:

  1. 若数据内容中有出现字符 0x7e 的,需替换为字符 0x7d 紧跟字符 0x02;
  2. 若数据内容中有出现字符 0x7d 的,需替换为字符 0x7d 紧跟字符 0x01;

反转义的原因:确认JT808协议的TCP消息边界。

举个栗子1

1.组包:

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, JT808_0x0200_BodyBase>();

jT808_0x0200.JT808LocationAttachData.Add(JT808_0x0200_BodyBase.AttachId0x01, new JT808_0x0200_0x01
{
    Mileage = 100
});

jT808_0x0200.JT808LocationAttachData.Add(JT808_0x0200_BodyBase.AttachId0x02, new JT808_0x0200_0x02
{
    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

2.手动解包:

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                  --尾标识

3.程序解包:

//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, ((JT808_0x0200_0x01)jT808_0x0200.JT808LocationAttachData[JT808_0x0200_BodyBase.AttachId0x01]).Mileage);
//4.2.附加信息2
Assert.Equal(125, ((JT808_0x0200_0x02)jT808_0x0200.JT808LocationAttachData[JT808_0x0200_BodyBase.AttachId0x02]).Oil);

举个栗子2

// 使用消息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>
        {
            { JT808_0x0200_BodyBase.AttachId0x01,new JT808_0x0200_0x01{Mileage = 100}},
            { JT808_0x0200_BodyBase.AttachId0x02,new JT808_0x0200_0x02{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

举个栗子3

// 全局配置
JT808GlobalConfig.Instance
    //注册自定义消息
    .Register(Assembly.GetCallingAssembly())
    //.SplitPackageStrategy(//todo 实现ISplitPackageStrategy分包策略)
    //.SetCompress(//todo 实现IJT808ICompress压缩算法)
    //.SetMsgIdFactory(//todo 实现IJT808MsgIdFactory消息工厂)
    //.SetMsgSNDistributed(//todo 实现IMsgSNDistributed消息流水号)
    // 跳过校验码验证
    .SetSkipCRCCode(true);

举个栗子4

遇到的问题-多设备多协议的自定义位置附加信息

场景: 一个设备厂商对应多个设备类型,不同设备类型可能存在相同的自定义位置附加信息Id,导致自定义附加信息Id冲突,无法解析。

解决方式:

1.凡是解析自定义附加信息Id协议的,先进行分割存储,然后在根据外部的设备类型进行统一处理;

2.可以根据设备类型做个工厂,解耦对公共序列化器的依赖。

可以参考DemoTest的Demo5

要是哪位大佬还有其他的解决方式,请您告知我下,谢谢您了。

举个栗子5

遇到的问题-多媒体数据上传进行分包处理

场景: 设备在上传多媒体数据的时候,由于数据比较多,一次上传不了,所以采用分包方式处理。

解决方式:

  1. 第一包数据上来采用平常的方式去解析数据;

  2. 当N包数据上来,采用统一分包消息体去接收数据,最后在合并成一条。

普及知识点:一般行业分包是按256的整数倍,太多不行,太少也不行,必须刚刚好。

可以参考DemoTest的Demo6

NuGet安装

Package Name Version Downloads
Install-Package JT808 JT808 JT808
Install-Package JT808.Extensions.DependencyInjection JT808 JT808

使用BenchmarkDotNet性能测试报告(只是玩玩,不能当真)


BenchmarkDotNet=v0.11.5, OS=Windows 10.0.17763.379 (1809/October2018Update/Redstone5)
Intel Core i7-8700K CPU 3.70GHz (Coffee Lake), 1 CPU, 12 logical and 6 physical cores
  [Host]     : .NET Framework 4.7.2 (CLR 4.0.30319.42000), 64bit RyuJIT-v4.7.3362.0
  Job-FVMQGI : .NET Framework 4.7.2 (CLR 4.0.30319.42000), 64bit RyuJIT-v4.7.3362.0
  Job-LGLQDK : .NET Core 2.2.5 (CoreCLR 4.6.27617.05, CoreFX 4.6.27618.01), 64bit RyuJIT

Platform=AnyCpu  Runtime=Clr  Server=False  
Method Toolchain N Mean Error StdDev Median Gen 0 Gen 1 Gen 2 Allocated
0x0200_All_AttachId_Serialize Default 100 4,331.7 us 84.946 us 161.619 us 4,295.7 us 101.5625 - - 655.89 KB
0x0200_All_AttachId_Deserialize Default 100 4,133.2 us 87.806 us 196.391 us 4,065.1 us 101.5625 - - 663.33 KB
0x0100Serialize Default 100 361.6 us 6.881 us 7.648 us 360.1 us 18.5547 - - 114.84 KB
0x0100Deserialize Default 100 399.4 us 7.947 us 15.499 us 397.5 us 22.4609 - - 140.63 KB
0x0200_All_AttachId_Serialize .NET Core 2.2 100 4,240.1 us 83.707 us 135.172 us 4,203.3 us 93.7500 - - 605.08 KB
0x0200_All_AttachId_Deserialize .NET Core 2.2 100 3,868.6 us 77.279 us 113.274 us 3,891.3 us 85.9375 - - 550.78 KB
0x0100Serialize .NET Core 2.2 100 310.4 us 6.167 us 5.467 us 311.4 us 17.0898 - - 107.03 KB
0x0100Deserialize .NET Core 2.2 100 329.8 us 6.520 us 12.246 us 328.1 us 22.4609 - - 140.63 KB
0x0200_All_AttachId_Serialize Default 10000 428,119.1 us 9,411.072 us 12,881.981 us 423,238.6 us 10000.0000 - - 65593.7 KB
0x0200_All_AttachId_Deserialize Default 10000 409,079.6 us 7,931.335 us 11,118.624 us 409,885.0 us 10000.0000 - - 66329.09 KB
0x0100Serialize Default 10000 37,024.9 us 727.285 us 945.675 us 36,811.1 us 1857.1429 - - 11484.71 KB
0x0100Deserialize Default 10000 38,524.5 us 839.922 us 824.916 us 38,353.1 us 2230.7692 - - 14062.93 KB
0x0200_All_AttachId_Serialize .NET Core 2.2 10000 446,606.3 us 10,629.572 us 31,006.961 us 446,063.0 us 9000.0000 - - 60507.81 KB
0x0200_All_AttachId_Deserialize .NET Core 2.2 10000 379,327.4 us 8,042.055 us 18,152.258 us 374,608.7 us 8000.0000 - - 55078.13 KB
0x0100Serialize .NET Core 2.2 10000 30,793.0 us 608.857 us 812.807 us 30,802.4 us 1687.5000 - - 10703.13 KB
0x0100Deserialize .NET Core 2.2 10000 32,971.0 us 760.703 us 1,352.149 us 32,730.2 us 2285.7143 - - 14062.5 KB
0x0200_All_AttachId_Serialize Default 100000 4,274,178.9 us 65,289.797 us 54,519.938 us 4,295,670.5 us 106000.0000 - - 655870.67 KB
0x0200_All_AttachId_Deserialize Default 100000 4,256,477.1 us 84,148.131 us 153,869.616 us 4,235,210.3 us 107000.0000 - - 663287.3 KB
0x0100Serialize Default 100000 361,104.4 us 8,867.774 us 13,272.867 us 359,748.7 us 18000.0000 - - 114849.33 KB
0x0100Deserialize Default 100000 380,141.7 us 7,084.695 us 10,384.654 us 377,054.2 us 22000.0000 - - 140633.58 KB
0x0200_All_AttachId_Serialize .NET Core 2.2 100000 3,874,808.0 us 49,014.358 us 40,929.209 us 3,876,230.0 us 98000.0000 - - 605078.13 KB
0x0200_All_AttachId_Deserialize .NET Core 2.2 100000 3,525,556.9 us 46,550.128 us 43,543.019 us 3,523,294.3 us 89000.0000 - - 550781.25 KB
0x0100Serialize .NET Core 2.2 100000 287,180.5 us 4,525.188 us 3,778.737 us 286,796.0 us 17000.0000 - - 107031.25 KB
0x0100Deserialize .NET Core 2.2 100000 321,008.7 us 6,416.113 us 18,096.761 us 322,410.5 us 22000.0000 - - 140625 KB

JT808终端通讯协议消息对照表

序号 消息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 保留 保留 终端上行消息保留
MIT License Copyright (c) 2018 SmallChi(Koike) Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

简介

JT808协议、GB808协议、道路运输车辆卫星定位系统-北斗兼容车载终端通讯协议 展开 收起
C#
MIT
取消

发行版

暂无发行版

贡献者

全部

近期动态

加载更多
不能加载更多了
C#
1
https://gitee.com/kelleyliu/JT808-1.git
git@gitee.com:kelleyliu/JT808-1.git
kelleyliu
JT808-1
JT808-1
master

搜索帮助