JT808 — nugetz

pkg

Koike/JT808v2.7.7

.NET 7.0.NET 8.0.NET 9.0.NET 10.0

JT/T808 protocol,JT808 protocol, GB808 protocol(support 2011, 2013, 2019 version).JT/T808协议、JT808协议、GB808协议(支持2011、2013、2019版本)。

github.com ↗

License

View license

Deps

Install Size

—

Vulns

✓ 0

Published

Jan 11, 2026

Get Started

$ dotnet add package JT808

Readme

JT/T808 协议

<p> <span>中文</span> | <a href="README.en.md">English</a> </p>

前提条件

掌握进制转换：二进制转十六进制；
掌握 BCD 编码、Hex 编码；
掌握各种位移、异或；
掌握常用反射；
掌握 JObject 的用法；
掌握快速 ctrl+c、ctrl+v；
掌握 Span<T>的基本用法
掌握以上装逼技能，就可以开始搬砖了。

JT808 数据结构解析

数据包[JT808Package]

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

数据头[JT808Header]

消息 ID	消息体属性	协议版本号(2019 版本)	终端手机号	消息流水号	消息总包数(依赖是否分包)	包序号(依赖是否分包)
MsgId	JT808HeaderMessageBodyProperty	ProtocolVersion	TerminalPhoneNo	MsgNum	PackgeCount	PackageIndex


JT808Package jT808Package = new JT808Package();

jT808Package.Header = new JT808Header
{
    MsgId = (ushort)JT808.Protocol.Enums.JT808MsgId._0x0200,
    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.BasicLocationAttachData = new Dictionary<byte, JT808_0x0200_BodyBase>();

jT808_0x0200.BasicLocationAttachData.Add(JT808Constants.JT808_0x0200_0x01, new JT808_0x0200_0x01
{
    Mileage = 100
});

jT808_0x0200.BasicLocationAttachData.Add(JT808Constants.JT808_0x0200_0x02, 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

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(bytes);

//3.数据包头
Assert.Equal(Enums.JT808MsgId._0x0200, 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.数据包体
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.BasicLocationAttachData[JT808Constants.JT808_0x0200_0x01]).Mileage);
//4.2.附加信息2
Assert.Equal(125, ((JT808_0x0200_0x02)jT808_0x0200.BasicLocationAttachData[JT808Constants.JT808_0x0200_0x02]).Oil);

// 使用消息Id的扩展方法创建JT808Package包
JT808Package jT808Package = Enums.JT808MsgId._0x0200.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,
        BasicLocationAttachData = 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();
//输出结果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

// 初始化配置
IJT808Config DT1JT808Config = new DT1Config();
IJT808Config DT2JT808Config = new DT2Config();
// 注册自定义消息外部程序集
DT1JT808Config.Register(Assembly.GetExecutingAssembly());
// 跳过校验和验证
DT1JT808Config.SkipCRCCode = true;
// 根据不同的设备终端号，添加自定义消息Id
DT1JT808Config.MsgIdFactory.SetMap<DT1Demo6>();
DT1JT808Config.FormatterFactory.SetMap<DT1Demo6>();
DT2JT808Config.MsgIdFactory.SetMap<DT2Demo6>();
DT2JT808Config.FormatterFactory.SetMap<DT2Demo6>();
// 初始化序列化实例
JT808Serializer DT1JT808Serializer = new JT808Serializer(DT1JT808Config);
JT808Serializer DT2JT808Serializer = new JT808Serializer(DT2JT808Config);

附加信息类说明	附加 ID 字节数	附加长度字节数	备注
JT808_0x0200_CustomBodyBase	1 BYTE	1 BYTE	标准
JT808_0x0200_CustomBodyBase2	2 BYTE	1 BYTE	自定义
JT808_0x0200_CustomBodyBase3	2 BYTE	2 BYTE	自定义
JT808_0x0200_CustomBodyBase4	1 BYTE	4 BYTE	自定义

Package Name	Version	Preview Version	Downloads	Remark
Install-Package JT808				JT808
Install-Package JT808.Protocol.Extensions.JT1078				JT1078 扩展 JT808
Install-Package JT808.Protocol.Extensions.SuBiao				主动安全（苏标）扩展 JT808
Install-Package JT808.Protocol.Extensions.YueBiao				主动安全（粤标）扩展 JT808
Install-Package JT808.Protocol.Extensions.GPS51				GPS51 扩展JT808


BenchmarkDotNet v0.15.8, Windows 11 (10.0.26200.6584/25H2/2025Update/HudsonValley2)
Intel Core i7-8700K CPU 3.70GHz (Coffee Lake), 1 CPU, 12 logical and 6 physical cores
.NET SDK 10.0.100
  [Host]     : .NET 10.0.0 (10.0.0, 10.0.25.52411), X64 RyuJIT x86-64-v3
  Job-SRTPUO : .NET 10.0.0 (10.0.0, 10.0.25.52411), X64 RyuJIT x86-64-v3

Platform=AnyCpu  Server=False  Toolchain=.NET 10.0

Method	Categories	N	Mean	Error	StdDev	Gen0	Gen1	Allocated
0x0100Serialize	0x0100Serializer	100	48.21 μs	0.573 μs	0.478 μs	10.8032	-	66.41 KB
0x0100Deserialize	0x0100Serializer	100	47.91 μs	0.517 μs	0.458 μs	15.8081	-	96.88 KB
0x0100Serialize	0x0100Serializer	10000	4,973.36 μs	45.377 μs	42.446 μs	1078.1250	-	6640.63 KB
0x0100Deserialize	0x0100Serializer	10000	4,942.77 μs	30.663 μs	28.682 μs	1578.1250	-	9687.5 KB
0x0100Serialize	0x0100Serializer	100000	49,646.55 μs	206.313 μs	172.280 μs	10818.1818	-	66406.25 KB
0x0100Deserialize	0x0100Serializer	100000	47,817.85 μs	667.017 μs	591.293 μs	15727.2727	-	96875 KB

0x0200_All_AttachId_Serialize	0x0200Serializer	100	105.50 μs	0.566 μs	0.529 μs	29.4189	0.1221	180.47 KB
0x0200_All_AttachId_Deserialize	0x0200Serializer	100	106.14 μs	0.910 μs	0.851 μs	38.2080	0.2441	234.38 KB
0x0200_All_AttachId_Serialize	0x0200Serializer	10000	10,165.89 μs	65.478 μs	61.248 μs	2937.5000	-	18046.88 KB
0x0200_All_AttachId_Deserialize	0x0200Serializer	10000	10,313.97 μs	55.698 μs	46.510 μs	3812.5000	15.6250	23437.5 KB
0x0200_All_AttachId_Serialize	0x0200Serializer	100000	100,048.62 μs	667.978 μs	592.145 μs	29400.0000	-	180468.75 KB
0x0200_All_AttachId_Deserialize	0x0200Serializer	100000	102,196.63 μs	391.460 μs	326.887 μs	38200.0000	200.0000	234375 KB

序号	消息 ID	完成情况	测试情况	消息体名称	2019 版本	2011 版本
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	√	√	行驶记录仪数据采集命令		被修改
44	0x0700	√	√	行驶记录仪数据上传
45	0x8701	√	√	行驶记录仪参数下传命令		被修改
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	保留	保留	终端上行消息保留
68	0x0004	√	√	查询服务器时间请求	新增
69	0x8004	√	√	查询服务器时间应答	新增
70	0x0005	√	√	终端补传分包请求	新增
71	0x8204	√	√	链路检测	新增
72	0x8608	√	√	查询区域或线路数据	新增
73	0x0608	√	√	查询区域或线路数据应答	新增
74	0xE000~0xEFFF	保留	保留	厂商自定义上行消息	新增
75	0xF000~0xFFFF	保留	保留	厂商自定义下行消息	新增

序号	消息 ID	完成情况	测试情况	消息体名称
1	0x0200_0x14	√	√	视频相关报警
2	0x0200_0x15	√	√	视频信号丢失报警状态
3	0x0200_0x16	√	√	视频信号遮挡报警状态
4	0x0200_0x17	√	√	存储器故障报警状态
5	0x0200_0x18	√	√	异常驾驶行为报警详细描述
6	0x8103_0x0075	√	√	音视频参数设置
7	0x8103_0x0076	√	√	音视频通道列表设置
8	0x8103_0x0077	√	√	单独视频通道参数设置
9	0x8103_0x0079	√	√	特殊报警录像参数设置
10	0x8103_0x007A	√	√	视频相关报警屏蔽字
11	0x8103_0x007B	√	√	图像分析报警参数设置
12	0x8103_0x007C	√	√	终端休眠模式唤醒设置
13	0x1003	√	√	终端上传音视频属性
14	0x1005	√	√	终端上传乘客流量
15	0x1205	√	√	终端上传音视频资源列表
16	0x1206	√	√	文件上传完成通知
17	0x9003	√	√	查询终端音视频属性
18	0x9101	√	√	实时音视频传输请求
19	0x9102	√	√	音视频实时传输控制
20	0x9105	√	√	实时音视频传输状态通知
21	0x9201	√	√	平台下发远程录像回放请求
22	0x9202	√	√	平台下发远程录像回放控制
23	0x9205	√	√	查询资源列表
24	0x9206	√	√	文件上传指令
25	0x9207	√	√	文件上传控制
26	0x9301	√	√	云台旋转
27	0x9302	√	√	云台调整焦距控制
28	0x9303	√	√	云台调整光圈控制
29	0x9304	√	√	云台雨刷控制
30	0x9305	√	√	红外补光控制
31	0x9306	√	√	云台变倍控制

DI:
IServiceCollection serviceDescriptors1 = new ServiceCollection();
serviceDescriptors1.AddJT808Configure()
                   .AddJT1078Configure();
全局注册：
JT808Serializer.Instance.Register(JT808_JT1078_Constants.GetCurrentAssembly());

序号	消息 ID	完成情况	测试情况	消息体名称
1	0x1210	√	√	报警附件信息消息
2	0x1211	√	√	文件信息上传
3	0x1212	√	√	文件上传完成消息
4	0x9208	√	√	报警附件上传指令
5	0x9212	√	√	文件上传完成消息应答
6	0x0200_0x64	√	√	高级驾驶辅助系统报警信息
7	0x0200_0x65	√	√	驾驶员状态监测系统报警信息
8	0x0200_0x66	√	√	胎压监测系统报警信息
9	0x0200_0x67	√	√	盲区监测系统报警信息
10	0x8103_0xF364	√	√	高级驾驶辅助系统参数
11	0x8103_0xF365	√	√	驾驶员状态监测系统参数
12	0x8103_0xF366	√	√	胎压监测系统参数
13	0x8103_0xF367	√	√	盲区监测系统参数
14	0x0900	√	√	上传基本信息
15	0x0900_0xF7	√	√	外设工作状态
16	0x0900_0xF8	√	√	外设系统信息
17	0x8900	√	√	查询基本信息
18	0x8900_0xF7	√	√	外设工作状态
19	0x8900_0xF8	√	√	外设系统信息

DI:
IServiceCollection serviceDescriptors1 = new ServiceCollection();
serviceDescriptors1.AddJT808Configure()
                   .AddSuBiaoConfigure();

全局注册:
JT808Serializer.Instance.Register(JT808_SuBiao_Constants.GetCurrentAssembly());

序号	消息 ID	完成情况	测试情况	消息体名称
1	0x1210	√	√	报警附件信息消息
2	0x1211	√	√	文件信息上传
3	0x1212	√	√	文件上传完成消息
4	0x9208	√	√	报警附件上传指令
5	0x9212	√	√	文件上传完成消息应答
6	0x1FC4	√	√	终端升级进度上报
7	0x0200_0x64	√	√	高级驾驶辅助系统报警信息
8	0x0200_0x65	√	√	驾驶员状态监测系统报警信息
9	0x0200_0x66	√	√	胎压监测系统报警信息
10	0x0200_0x67	√	√	盲区监测系统报警信息
11	0x8103_0xF364	√	√	高级驾驶辅助系统参数
12	0x8103_0xF365	√	√	驾驶员状态监测系统参数
13	0x8103_0xF366	√	√	胎压监测系统参数
14	0x8103_0xF367	√	√	盲区监测系统参数
15	0x8103_0xF370	√	√	智能视频协议版本信息
16	0x0900	√	√	上传基本信息
17	0x0900_0xF7	√	√	外设工作状态
18	0x0900_0xF8	√	√	外设系统信息
19	0x8900	√	√	查询基本信息
20	0x8900_0xF7	√	√	外设工作状态
21	0x8900_0xF8	√	√	外设系统信息

DI:
IServiceCollection serviceDescriptors1 = new ServiceCollection();
serviceDescriptors1.AddJT808Configure()
                   .AddYueBiaoConfigure();

全局注册:
JT808Serializer.Instance.Register(JT808_YueBiao_Constants.GetCurrentAssembly());

Koike/JT808v2.7.7

Get Started

Readme

JT/T808 协议

前提条件

JT808 数据结构解析

数据包[JT808Package]

数据头[JT808Header]

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

消息体属性[JT808Bodies]

举个栗子 1

1.组包：

2.手动解包：

3.程序解包：

举个栗子 2

举个栗子 3

举个栗子 4

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

举个栗子 5

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

举个栗子 6

遇到的问题-多设备多协议的消息 ID 冲突

举个栗子 7

举个栗子 8

举个栗子 9

举个栗子 10

举个栗子 11

举个栗子 12

举个栗子 13

举个栗子 14

举个栗子 15

举个栗子 16

举个栗子 17

举个栗子 18

实验功能

自动合并分包

NuGet 安装

使用 BenchmarkDotNet 性能测试报告（只是玩玩，不能当真）

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

JT1078 扩展 JT808 议消息对照表

使用方法

主动安全（苏标）扩展 JT808 协议消息对照表

使用方法

主动安全（粤标）扩展 JT808 协议消息对照表

使用方法