JTT809协议解析梳理.md · l745230/JTT809

[//]:#目录
[TOC]

# 前言
## 修订记录
| 编号 | 版本号 | 更新内容 | 更新人 | 发布日期 
| :-: | :-: | :-: | :-: | :-: 
| 1 | V1.0 | 新建 | 林冰清 | 2023-05-06

## 概述
[《道路运输车辆卫星定位系统 平台数据交换》](https://jtst.mot.gov.cn/hb/search/stdHBDetailed?id=a71bf1e0e866c7207daf0bc436642be8)(标准号:JT/T 809-2019),这个标准是中国交通运输行业标准之一，规定了车载终端监控平台与上级监管部门之间的数据传输格式，和各种监管业务流程.

[《福建省平台JTT809、JTT1078扩展协议》](https://gitee.com/linbq-b7/jtt809-b7/blob/master/doc/%E5%8D%8F%E8%AE%AE%E7%9B%B8%E5%85%B3/%E7%A6%8F%E5%BB%BA%E7%9C%81%E5%B9%B3%E5%8F%B0JTT809%E3%80%81JTT1078%E6%89%A9%E5%B1%95%E8%A1%A5%E5%85%85%E8%AF%B4%E6%98%8E.docx)为适应福建省平台监管需要，对部分消息进行了扩展,在JTT809-2019协议基础上扩展了字段.

省厅监管平台为上级平台. 车联网应用平台为下级平台.

## 阅读对象
[《车联网应用平台》](https://vaas.fjssj.com:38080/)开发人员、网关开发人员

| 缩略语 | 说明 
| - | -
| CCITT | 国际电报电话咨询委员会 
| CRC | 循环冗余校验 
| CRC16-CCITT | CCITT标准的CRC-16检验码 
| UTC | 协调世界时,时间比北京时晚八小时 
| TCP | 传输控制协议 
| IP | 互联网协议地址

# 福建省平台JTT809、JTT1078扩展协议
为适应福建省平台监管需要，对部分消息进行了扩展,具体扩展见附录-福建省平台JTT809、JTT1078扩展补充说明.docx

## JTT809
1. 车辆静态信息
2. 查岗功能
3. 车辆定位信息
4. 报警督办功能

## JTT1078
1. 实时音视频请求及应答
2. 远程录像回放请求及应答

# JTT809-2019协议
## 通信方式
上级平台与下级平台之间采用双链路通信方式,具体要求如下:
* 上、下级平台间通信方式应采用 TCP 协议长连接方式。
* 上级平台应提供服务的 IP 地址、端口号以及用户名、密码等信息,供下级平台接入。
* 下级平台向上级平台发起建立主链路连接请求,主链路成功建立后，上级平台应向下级平台发起从链路连接请求。
* 若主、从链路均连接正常,则下级平台应通过主链路向上级平台发送数据,上级平台应通过从链路向下级平台发送数据。
* 若主、从链路中其中一条链路中断时,所有的数据均应通过另外一条链路进行数据传输,断开的链路恢复时,应按照约定继续从两条链路进行数据传输。
* 通信链路应通过其中的 TCP 客户端方发送链路保持数据包检测链路连接状态,实现链路的可
靠连接。

## 安全认证

上级平台应对下级平台的接入请求进行安全验证,确保建立可靠、可信的通信链路。下级平台可不对上级平台的接入请求进行安全验证。
上级平台对下级平台安全验证流程遵循以下规定:
* 上级平台应为下级平台分配相应的接入码、接入用户名、密码以及数据加解密相关参数。
* 下级平台与上级平台连接时,发送“登录请求”消息,上级平台收到下级平台连接请求后,应首先验证请求的 IP 地址,若请求的 地址与约定接人的IP 地址不一致,则返回验证失败结果:其次，上级平台应对下级平台的接入码、用户名以及密码进行验证,根据验证的结果向下级平台返回相应的结果值。
* 上、下级平台间的数据传输可采用加密模式传输,实现对传输数据的即时加密,具体加密算法按照 8.2.7.3 中的规定。

## 消息处理
平台间的消息处理和重传机制应遵循以下规定:
* 发送方在发送消息时,按照子业务数据类型分别对所发送的消息按发送顺序编号。程序开始运行时编号等于零,发送第一个消息数据时开始计数,到最大数 4 294 967 295 后归零.
* 若平台间链路中断,则链路登录成功后,平台须发送链路断开之前所有子业务数据类型对应的消息序列号。发送方在收到消息序列号后,对发送消息进行编号时,续编链路中断之前的消息序列号。消息序列号通知消息见 8.3.2。
* 接收方在接收消息时,按照子业务数据类型分别对收到的消息按序列号进行统计,若发现消息序列号有缺失,则立即发送消息补传请求。消息补传请求消息见 8.3.4.1.4 和8.3.4.2.4.发送方收到消息补传请求后,根据请求的消息序列号及子业务类型,重传相应的消息。在填入重传的消息序列号时,使用该消息的原始消息序列号。
* 接收方在发送消息补传请求后,若等待补传消息超时,则重新发送消息补传请求,每次重传后的应答超时时间按照式下图计算,其中应答时间和重传次数由发送方和接收方自行约定。
![](https://gitee.com/linbq-b7/jtt809-b7/raw/master/doc/%E5%8D%8F%E8%AE%AE%E7%9B%B8%E5%85%B3/%E8%B6%85%E6%97%B6%E9%87%8D%E8%AF%95.jpg)

## 消息应答
协议中除明确说明无需应答的消息外,其余消息均应按照一请求一应答的消息来使用。如在约定的重传时间内未收到应答消息,请求方将视为超时,此后收到的对应应答消息视为无效。

## 消息协议对照表
> 业务数据类型标识
* 上级平台向下级平台发送的请求消息,一般应以“DOWN_”开头,以后缀“_REO”结尾:下级平台向上级平台发送的请求消息,一般以“UP_”开头,以后缀“_REO”结尾。
* 当上下级平台之间有应答消息时,应答消息可继续沿用对应的请求消息开头标识符,通过后缀“RSP”来标识结尾

> 子业务类型标识
* 对应于业务数据类型下的子业务,其标识头应继续遵循原有归属业务数据类型的标识头。示例:业务数据类型 UP_EXG_MSG 下的子业务类型标识头,均以“UP_EXG_MSG”开始。
* 子业务类型名称标识的主从链路方向应遵循原有归属业务数据类型的主从链路方向

### 链路管理类
| 链路 | 消息ID | 子业务 | 业务/子业务数据类型名称 | 业务/子业务数据类型标识
| :---: | :--: | :-: | --------------------------- | -
| 主链路 | 0x1001 | - | 主链路登录请求消息            | UP_CONNECT_REO
| 主链路 | 0x1002 | _ | 主链路登录应答消息            | UP_CONNECT_RSP
| 主链路 | 0x1003 | _ | 主链路注销请求消息            | UP_DISCONNECT_REO
| 从链路 | 0x1004 | _ | 主链路注销应答消息            | UP_DISCONNECT_RSP
| 主链路 | 0x1005 | _ | 主链路连接保持请求消息         | UP_LINKTEST_REO
| 从链路 | 0x1006 | _ | 主链路连接保持应答消息         | UP_LINKTEST_RSP
| 从链路 | 0x1007 | _ | 主链路断开通知消息            | UP_DISCONNECT_INFORM
| 主链路 | 0x1008 | _ | 下级平台主动关闭链路通知消息     | UP_CLOSELINK_INFORM
| 从链路 | 0x9001 | _ | 从链路连接请求消息            | DOWN_CONNECT_REO 
| 从链路 | 0x9002 | _ | 从链路连接应答消息            | DOWN_CONNECT_RSP 
| 从链路 | 0x9003 | _ | 从链路注销请求消息            | DOWN_DISCONNECT_REO 
| 主链路 | 0x9004 | _ | 从链路注销应答消息            | DOWN_DISCONNECT_RSP 
| 从链路 | 0x9005 | _ | 从链路连接保持请求消息         | DOWN_LINKTEST_REO 
| 主链路 | 0x9006 | _ | 从链路连接保持应答消息         | DOWN_LINKTEST_RSP 
| 主链路 | 0x9007 | _ | 从链路断开通知消息            | DOWN_DISCONNECT_INFORM
| 从链路 | 0x9008 | _ | 上级平台主动关闭链路通知消息     | DOWN_CLOSELINK_INFORM

### 信息统计类
| 链路 | 消息ID | 子业务 | 业务/子业务数据类型名称 | 业务/子业务数据类型标识
| :---: | :--: | :-: | ----------------------------------------- | -
| 主链路 | 0x9101 | - | 发送车辆定位信息数量通知消息                 | UP_MANAGE_TOTAL_RECVBACK_MSG
| 从链路 | 0x9102 | - | 平台链路连接情况与车辆定位消息传输情况上报请求消息 | DOWN_MANAGE_MSG_REO
| 主链路 | 0x1102 | - | 平台链路连接情况与车辆定位消息传输情况上报应答消息 | UP_MANAGE_MSG_RSP
| 从链路 | 0x9103 | - | 下发平台间消息序列号通知消息                 | DOWN_MANAGE_MSG_SN_INFORM
| 主链路 | 0x1103 | - | 上传平台间消息序列号通知消息                 | UP_MANAGE_MSG_SN_INFORM

### 车辆动态信息交换类
| 链路 | 消息ID | 子业务 | 业务/子业务数据类型名称 | 业务/子业务数据类型标识
| :---: | :--: | :-: | ----------------------------------------- | -
| 主链路 | 0x1200 | - | 主链路动态信息交换消息                     | UP_EXG_MSG
| 主链路 | 0x1201 | √ | 上传车辆注册信息                          | UP_EXG_MSG_REGISTER
| 主链路 | 0x1202 | √ | 实时上传车辆定位信息                       | UP_EXG_MSG_REAL_LOCATION
| 主链路 | 0x1203 | √ | 车辆定位信息自动补报                       | UP_EXG_MSG_HISTORY_LOCATION
| 主链路 | 0x1205 | √ | 启动车辆定位信息交换应答                    | UP_EXG_MSG_RETURN_STARTUP_ACK
| 主链路 | 0x1206 | √ | 结束车辆定位信息交换应警                    | UP_EXG_MSG_RETURN_END_ACK
| 主链路 | 0x1207 | √ | 申请交换指定车辆定位信息请求                 | UP_EXG_MSG_APPLY_FOR_MONITOR_STARTUP
| 主链路 | 0x1208 | √ | 取消交换指定车辆定位信息请求                 | UP_EXG_MSG_APPLY_FOR_MONITOR_END
| 主链路 | 0x1209 | √ | 补发车辆定位信息请求                       | UP_EXG_MSG_APPLY_HISGNSSDATA_REO
| 主链路 | 0x120A | √ | 上报车辆驾驶员身份识别信息应答                | UP_EXG_MSG_REPORT_DRIVER_INFO_ACK
| 主链路 | 0x120B | √ | 上报车辆电子运单应答                       | UP_EXG_MSG_TAKE_EWAYBILL_ACK
| 主链路 | 0x120C | √ | 主动上报驾驶员身份信息                      | UP_EXG_MSG_REPORT_DRIVER_INFO
| 主链路 | 0x120D | √ | 主动上报车辆电了运单信息                    | UP_EXG_MSG_REPORT_EWAYBILL_INFO
| 主链路 | 0x120E | √ | 主动上报车辆行驶路线信息                    | UP_EXG_MSG_DRVLINE_INFO
| 从链路 | 0x9200 | - | 从链路动态信息交换消息                     | DOWN_EXG_MSG
| 从链路 | 0x9201 | √ | 车辆注册信息应答消息                       | DOWN_EXG_MSG_REGISTER_ACK
| 从链路 | 0x9202 | √ | 交换车辆定位信息                          | DOWN_EXG_MSG_CAR_LOCATION
| 从链路 | 0x9203 | √ | 车辆定位信息交换补发                       | DOWN_EXG_MSG_HISTORY_ARCOSSAREA
| 从链路 | 0x9204 | √ | 交换车辆静态信息                          | DOWN_EXG_MSG_CAR_INFO
| 从链路 | 0x9205 | √ | 启动车辆定位信息交换请求                    | DOWN_EXG_MSG_RETURN_STARTUP
| 从链路 | 0x9206 | √ | 结束车辆定位信息交换请求                    | DOWN_EXG_MSG_RETURN_END
| 从链路 | 0x9207 | √ | 申请交换指定车辆定位信息应答                 | DOWN_EXG_MSG_APPLY_FOR_MONITOR_STARTUP_ACK
| 从链路 | 0x9208 | √ | 取消交换指定车辆定位信息应答                 | DOWN_EXG_MSG_APPLY_FOR_MONITOR_END_ACK
| 从链路 | 0x9209 | √ | 补发车辆定位信息应答                       | DOWN_EXG_MSG_APPLY_HISGNSSDATA_ACK
| 从链路 | 0x920A | √ | 上报车辆驾驶员身份信息请求                   | DOWN_EXG_MSG_REPORT_DRIVER_INFO
| 从链路 | 0x920B | √ | 上报车辆电子运单请求                       | DOWN_EXG_MSG_TAKE_EWAYBILL_REO
| 从链路 | 0x920C | √ | 上报车辆行驶路线请求                       | DOWN_BASE_MSG_DRVLINE_REO
| 从链路 | 0x920D | √ | 车辆行驶线路请求应答                       | DOWN_BASE_MSG_DRVLINE_ACK

### 平台间信息交互类
| 链路 | 消息ID | 子业务 | 业务/子业务数据类型名称 | 业务/子业务数据类型标识
| :---: | :--: | :-: | ----------------------------------------- | -
| 主链路 | 0x1300 | - | 主链路平台间信息交互消息                    | UP_PLATFORM_MSG
| 主链路 | 0x1301 | √ | 平台查岗应答                             | UP_PLATFORM_MSG_POST_OUERY_ACK
| 主链路 | 0x1302 | √ | 下发平台间报文应繁                        | UP_PLATFORM_MSG_INFO_ACK
| 主链路 | 0x1303 | √ | 上传平台间消息补传请求                     | UP_PLATFORM_MSG_RETRAN_REO
| 从链路 | 0x9300 | - | 主链路平台间信息交互消息                    | DOWN_PLATFORM_MSG
| 从链路 | 0x9301 | √ | 平台查岗请求                             | DOWN_PLATFORM_MSG_POST_OUERY_REO
| 从链路 | 0x9302 | √ | 下发平台间报文请求                        | DOWN_PLATFORM_MSG_INFO_REO
| 从链路 | 0x9302 | √ | 下发平台间消息补传请求                     | DOWN_PLATFORM_MSG_RETRAN_REO

### 车辆报警信息交互类
| 链路 | 消息ID | 子业务 | 业务/子业务数据类型名称 | 业务/子业务数据类型标识
| :---: | :--: | :-: | ----------------------------------------- | -
| 主链路 | 0x1400 | - | 主链路报警信息交互消息                      | UP_WARN_MSG
| 主链路 | 0x1401 | √ | 报警督办应答                             | UP_WARN_MSG_URGE_TODO_ACK
| 主链路 | 0x1402 | √ | 上报报警信息                             | UP_WARN_MSG_ADPT_INFO
| 主链路 | 0x1411 | √ | 上报报警督办应答消息                       | UP_WARN_MSG_URGE_TODO_ACK_INFO
| 主链路 | 0x1412 | √ | 主动上报报警处理结果信息消息                 | UP_WARN_MSG_ADPT_TODO_INFO
| 主链路 | 0x1413 | √ | 上报报警督办请求消息                       | UP_WARN_MSG_URGE_TODO_REO_INFO
| 主链路 | 0x1403 | √ | 上报报警预警消息                          | UP_WARN_MSG_INFORM_TIPS
| 从链路 | 0x9400 | - | 从链路报警信息交互消息                      | DOWN_WARN_MSG
| 从链路 | 0x9401 | √ | 报警督办请求                             | DOWN_WARN_MSG_URGE_TODO_REO
| 从链路 | 0x9402 | √ | 下发报警预警信息                          | DOWN_WARN_MSG_INFORM_TIPS
| 从链路 | 0x9403 | √ | 实时交换报警信息                          | DOWN_WARN_MSG_EXG_INFORM

### 车辆监管类
| 链路 | 消息ID | 子业务 | 业务/子业务数据类型名称 | 业务/子业务数据类型标识
| :---: | :--: | :-: | ----------------------------------------- | -
| 主链路 | 0x1500 | - | 主链路车辆监管消息                        | UP_CTRL_MSG
| 主链路 | 0x1501 | √ | 车辆单向监听应答                          | UP_CTRL_MSG_MONITOR_VEHICLE_ACK
| 主链路 | 0x1502 | √ | 车辆拍照应答                             | UP_CTRL_MSG_TAKE_PHOTO_ACK
| 主链路 | 0x1503 | √ | 下发车辆报文应答                          | UP_CTRL_MSG_TEXT_INFO_ACK
| 主链路 | 0x1504 | √ | 上报车辆行驶记录应答                       | UP_CTRL_MSG_TAKE_TRAVEL_ACK
| 主链路 | 0x1505 | √ | 车辆应急接人监管平台应答                    | UP_CTRL_MSG_EMERGENCY_MONITORING_ACK
| 从链路 | 0x9500 | - | 从链路车辆监管消息                        | DOWN_CTRL_MSG
| 从链路 | 0x9501 | √ | 车辆单向监听请求                          | DOWN_CTRL_MSG_MONITOR_VEHICLE_REO
| 从链路 | 0x9502 | √ | 车辆拍照请求                             | DOWN_CTRL_MSG_TAKE_PHOTO_REO
| 从链路 | 0x9503 | √ | 下发车辆报文请求                          | DOWN_CTRL_MSG_TEXT_REO
| 从链路 | 0x9504 | √ | 上报车辆行驶记录请求                       | DOWN_CTRL_MSG_TAKE_TRAVEL_REO
| 从链路 | 0x9505 | √ | 车辆应急接入监管平台请求                    | DOWN_CTRL_MSG_EMERCENCY_MONITORING_REO

### 车辆静态信息交换类
| 链路 | 消息ID | 子业务 | 业务/子业务数据类型名称 | 业务/子业务数据类型标识
| :---: | :--: | :-: | ----------------------------------------- | -
| 主链路 | 0x1600 | - | 主链路静态信息交换消息                     | UP_BASE_MSG
| 主链路 | 0x1601 | √ | 补报车辆静态信息应答                       | UP_BASE_MSG_VEHICLE_ADDED_ACK
| 主链路 | 0x1602 | √ | 补报车辆行驶路线信息应答                    | UP_BASE_MSG_DRVLINE_ADDED_REO
| 从链路 | 0x9600 | - | 从链路静态信息交换消息                     | DOWN_BASE_MSG
| 从链路 | 0x9601 | √ | 补报车辆静态信息请求                       | DOWN_BASE_MSG_VEHICLE_ADDED

## 主业务流程说明
***809-2019主业务流程图见附录,以下为套入车联网平台与省厅监管平台后的梳理***

### 链路登录
```mermaid
sequenceDiagram
participant 车联网
participant 省厅

车联网->>省厅: 0x1001(主链路登录请求消息)
省厅->>车联网: 0x1002(主链路登录应答消息)
省厅-->>车联网: 0x9001(从链路连接请求消息)
车联网-->>省厅: 0x9002(从链路连接应答消息)
```

### 消息序列号通知
```mermaid
sequenceDiagram
participant 车联网
participant 省厅

车联网->>省厅: 0x1103(上传平台间消息序列号通知消息)
省厅-->>车联网: 0x9103(下发平台间消息序列号通知消息)
```

### 连接情况与车辆定位消息
```mermaid
sequenceDiagram
participant 车联网
participant 省厅

省厅-->>车联网: 0x9102(平台链路连接情况与车辆定位消息传输情况上报请求消息)
车联网->>省厅: 0x1102(平台链路连接情况与车辆定位消息传输情况上报应答消息)
```

### 主链路保持
```mermaid
sequenceDiagram
participant 车联网
participant 省厅

车联网->>省厅: 0x1005(主链路连接保持请求消息)
省厅-->>车联网: 0x1006(主链路连接保持应答消息)
```

### 从链路保持
```mermaid
sequenceDiagram
participant 车联网
participant 省厅

省厅-->>车联网: 0x9005(从链路连接保持请求消息)
车联网->>省厅: 0x9006(从链路连接保持应答消息)
```

### 主链路注销
```mermaid
sequenceDiagram
participant 车联网
participant 省厅

车联网->>省厅: 0x1003(主链路注销请求消息)
省厅-->>车联网: 0x1004(主链路注销应答消息)
省厅-->>车联网: 0x1007(主链路断开通知消息)
```

### 从链路注销
```mermaid
sequenceDiagram
participant 车联网
participant 省厅

省厅-->>车联网: 0x9003(从链路注销请求消息)
车联网->>省厅: 0x9004(从链路注销应答消息)
车联网->>省厅: 0x9007(从链路断开通知消息)
```

### 从链路异常
```mermaid
sequenceDiagram
participant 车联网
participant 省厅

车联网->>省厅: 0x1008(下级平台主动关闭链路通知消息)
```
或
```mermaid
sequenceDiagram
participant 车联网
participant 省厅

省厅->>车联网: 0x1008(下级平台主动关闭链路通知消息)
```

### 主链路异常
```mermaid
sequenceDiagram
participant 车联网
participant 省厅

省厅-->>车联网: 0x9008(上级平台主动关闭链路通知消息)
```
或
```mermaid
sequenceDiagram
participant 车联网
participant 省厅

车联网-->>省厅: 0x9008(上级平台主动关闭链路通知消息)
```

### 数据结构
| 头标识 | 数据头 | 数据体 | CRC校验码 | 尾标识 
| :---: | :---: | :---: | :------: | :---: 
| Head Flag | Message Header | Message Body | CRC Code | End Flag 
|  0x5b  | - | - | - | 0x5d

#### 头标识
头标识为字符0x5b

* 报文序列号占用4 个字节,为发送信息的序列号,按照消息的子业务数据类型分别编号,用于接收方检测是否有信息的丢失。上级平台和下级平台按自己发送数据包的个数计数.互不影响。程序开始运行时等于零发送第一帧数据时开始计数,到最大数 4 294 967 295 后自动归零。
* 报文加密标识位,用来区分报文是否进行加密。如果标识为1,则说明对后续相应业条的数据体采用ENCRYPTKEY 对应的密钥进行加密处理。如果标识为 0.则说明不进行加密处理。
* 采用UTC 时间表示,长度为8 个字节。如2010-1-10 9.7:54 的UTC 值为1263 085674,其在协议中表示为
0x000000004B49286A.

#### 数据体
##### 数据格式
***不同的业务数据类型,对应不同的数据格式.***

###### 示例 1.链路管理业务类-主链路登录请求消息
>主链路登录请求消息
链路类型:主链路。
消息方向:下级平台往上级平台。
业务数据类型标识:UP CONNECT REO。
描述:下级平台向上级平台发送用户名和密码等登录信息
下级平台登录请求消息数据体

| 字段名 | 字节数 | 类型 | 描述及要求
| - | - | - | -
| USERID | 4 | uint32_t | 用户名       
| PASSWORD | 8 | Octet String | 密码
| MSG_GNSSCENTERID | 32 | uint32_t | 下级平台接人码，上级平台给下级平台分配的唯一标识号
| DOWN_LINK_IP | 32 | Octet String | 下级平台提供对应的从链路服务端 IP 地址
| DOWN_LINK_PORT | 2 | uintl6_t | 下级平台提供对应的从链路服务端口号

###### 示例 2.链路管理业务类-主链路登录应答消息
>主链路登录应答消息
链路类型:主链路。
消息方向:上级平台往下级平台。
业务数据类型标识UP_CONNECT RSP
描述:上级平台对下级平台登录请求信息进行安全验证后,返回相应的验证结果。
主链路登录应签消息数据体

| 字段名 | 字节数 | 类型 | 描述及要求
| - | - | - | -
| RESULT | 1 | BYTE | 验证结果,定义如下:  0x00:成功  0x01:IP 地址不正确 0x02:接人码不正确 0x03:用户没有注册 0x04:密码错误 0x05:资源紧张,稍后再连接(已经占用) OxFF:其他
| VERIFY_CODE | 4 | uint32_t | 校验码

###### 示例 3.车辆动态信息交换业务类-上传车辆注册信息消息
> 主链路车辆动态信息交换业务
链路类型:主链路。
消息方向:下级平台往上级平台。
业务数据类型标识:UP EXG MSG
描述:下级平台向上级平台发送车辆动态信息交换业务数据包。
主链路车辆动态信息交换业务数据体

| 字段名 | 字节数 | 类型 | 描述及要求
| - | - | - | -
| PLATFORM_ID | 11 | BYTES | 平台唯一编码,由平台所在地行政区划代码和平台编号组成
| PRODUCER_ID | 11 | BYTES | 车载终端厂商唯一编码,由车载终端厂商所在地行政区划代码和制造商 ID 组成
| TERMINAL_MODEL_TYPE | 30 | BYTES | 车载终端型号,不足 30 位时后补 0x00
| IMEI_ID | 15 | Octet String | 车载终端通讯模块 IMEI 码
| TERMINAL_ID | 30 | BYTES | 车载终端编号,大写字母和数字组成,不足 15 位时后补 0x00
| TERMINAL_SIMCODE | 13 | Octet String |  车载终端 SIM 卡电话号码。号码不足 13 位,则在前补充数字 0

##### 数据加密
> 根据报文加密标志位：ENCRYPT_FLAG, 1 表示报文加密

###### 加密要求
数据加密要求具体如下:
* 加密只针对报文的数据体部分进行。密钥通过网络进行传输,不同的报文可采用不同的密钥进行加密。
* 在数据包发送之前,应将数据包内容与伪随机序列按字节进行异或运算。
* 加密算法如下.用N 模伪随机序列发生器立生伪随机字节序列。将待传输的数据与伪随机码按字节进行异或运算。
* 不同的上下级平台之间,加密的算法是一致的,但是针对 M1、IA1、IC1 的不同。数据应先经过加密而后解密。

###### 秘钥格式
| 字段 | 类型 | 描述及要求
| - | - | -
| ENCRYPT_KEY | uint32_t | 数据加密的密钥.长度为 4 个字节

###### 加密算法
加密解密为同一算法,见附录.

#### CRC校验码
从数据头到校验码前的 CRC16-CCITT 的校验值,应遵循大端排序方式的规定。CRC16-CCITT 码生成多项式为x^16+x^12+x^5+1,简记式 1021。

数据 CRC 校验码格式规定见表:

| 字段 | 字节数 | 类型 | 描述及要求 
| - | - | - | - 
| CRC CODE | 2 | uintl6_t | 数据 CRC 校验码

#### 尾标识
头标识为字符0x5d

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

转义规则如下:

1. 若数据内容中有出现字符 0x5b 的，需替换为字符 0x5a 紧跟字符 0x01;
2. 若数据内容中有出现字符 0x5a 的，需替换为字符 0x5a 紧跟字符 0x02;
3. 若数据内容中有出现字符 0x5d 的，需替换为字符 0x5e 紧跟字符 0x01;
4. 若数据内容中有出现字符 0x5e 的，需替换为字符 0x5e 紧跟字符 0x02.

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

### 示例
``` 
5B 00 00 00 C9 00 00 06 82 17 00 01 34 15 F4 01 00 00 00 00 00 27 0F 00 00 00 00 5E 02 A5 07 B8 D4 C1 41 31 32 33 34 35 00 00 00 00 00 00 00 00 00 00 00 00 00 02 17 01 00 00 00 8B 01 02 03 04 05 06 07 08 09 10 11 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 E7 D3 5D
```

``` json
{
  "[5B]起始标识": 91,
  "消息头": {
    "[000000C9]数据长度": 201,
    "[00000682]报文序列号": 1666,
    "[1700]业务类型标识": "5888",
    "[013415F4]下级平台接入码": 20190708,
    "[010000]协议版本号标识": "1.0.0",
    "[0]报文加密标识位": "None",
    "[0000270F]数据加密的密匙": 9999,
    "[000000005EA507B8]发送消息时的系统UTC时间": "2020-04-26T12:02:00"
  },
  "消息体": {
    "[D4C141313233343500000000000000000000000000]车牌号": "粤A12345",
    "[02]车牌颜色": "黄色",
    "[1701]子业务类型标识": "5889",
    "[0000008B]后续数据长度": 139,
    "子业务类型": {
      "[0102030405060708091011]企业视频监控平台唯一编码": "\u0001\u0002\u0003\u0004\u0005\u0006\u0007\b\t\u0010\u0011",
      "[00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000]归属地区政府平台使用的时效口令": "",
      "[00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000]跨域地区政府平台使用的时效口令": ""
    }
  },
  "[E7D3]校验码": 59347,
  "[5D]结束标识": 93
}
```

# 车联网业务[todo]
| 模块   | 功能   | 描述               |
|------|------|------------------|
| 省厅服务 | 上传省厅 | 车辆静态数据录入、审核、取消审核，并上报省厅 |
| 省厅服务 | 上级查岗 | 省厅给运营商发送查岗信息：如验证码、问题等，运营商回复并上报省厅                 |
| 省厅服务 | 报警督办 | 省厅针对需要处理的报警给运营商发送办理提醒，运营商处理并回复省厅                 |
| 省厅服务 | 报警处理 | 将报警处理结果上报省厅                 |

# 附录
## 相关协议
1. [JTT808-2019.pdf](https://gitee.com/linbq-b7/jtt809-b7/blob/master/doc/%E5%8D%8F%E8%AE%AE%E7%9B%B8%E5%85%B3/JTT808-2019.pdf)
2. [JTT809-2019.pdf](https://gitee.com/linbq-b7/jtt809-b7/blob/master/doc/%E5%8D%8F%E8%AE%AE%E7%9B%B8%E5%85%B3/JTT809-2019.pdf)
3. [JTT1078-2016.pdf](https://gitee.com/linbq-b7/jtt809-b7/blob/master/doc/%E5%8D%8F%E8%AE%AE%E7%9B%B8%E5%85%B3/JTT1078-2016.pdf)
4. [福建省平台JTT809、JTT1078扩展补充说明.docx](https://gitee.com/linbq-b7/jtt809-b7/blob/master/doc/%E5%8D%8F%E8%AE%AE%E7%9B%B8%E5%85%B3/%E7%A6%8F%E5%BB%BA%E7%9C%81%E5%B9%B3%E5%8F%B0JTT809%E3%80%81JTT1078%E6%89%A9%E5%B1%95%E8%A1%A5%E5%85%85%E8%AF%B4%E6%98%8E.docx)

## 轨迹考核规则
1. [全国平台考核管理办法课件.pptx](https://gitee.com/linbq-b7/jtt809-b7/blob/master/doc/%E8%BD%A8%E8%BF%B9%E8%80%83%E6%A0%B8/%E5%85%A8%E5%9B%BD%E5%B9%B3%E5%8F%B0%E8%80%83%E6%A0%B8%E7%AE%A1%E7%90%86%E5%8A%9E%E6%B3%95%E8%AF%BE%E4%BB%B6.pptx)
2. [809省厅2023年新考核规则.docx](https://gitee.com/linbq-b7/jtt809-b7/blob/master/doc/%E8%BD%A8%E8%BF%B9%E8%80%83%E6%A0%B8/809%E7%9C%81%E5%8E%852023%E5%B9%B4%E6%96%B0%E8%80%83%E6%A0%B8%E8%A7%84%E5%88%99.docx)

## 省厅对接步骤 
1. [省联网联控系统接入必备说明.docx](https://gitee.com/linbq-b7/jtt809-b7/blob/master/doc/%E7%9C%81%E5%8E%85%E5%AF%B9%E6%8E%A5/%E7%9C%81%E8%81%94%E7%BD%91%E8%81%94%E6%8E%A7%E7%B3%BB%E7%BB%9F%E6%8E%A5%E5%85%A5%E5%BF%85%E5%A4%87%E8%AF%B4%E6%98%8E.docx)
2. [福建省道路运输车辆卫星定位系统接口说明文档.docx](https://gitee.com/linbq-b7/jtt809-b7/blob/master/doc/%E7%9C%81%E5%8E%85%E5%AF%B9%E6%8E%A5/%E7%A6%8F%E5%BB%BA%E7%9C%81%E9%81%93%E8%B7%AF%E8%BF%90%E8%BE%93%E8%BD%A6%E8%BE%86%E5%8D%AB%E6%98%9F%E5%AE%9A%E4%BD%8D%E7%B3%BB%E7%BB%9F%E6%8E%A5%E5%8F%A3%E8%AF%B4%E6%98%8E%E6%96%87%E6%A1%A3.docx)
3. [JT809检测工具使用说明.docx](https://gitee.com/linbq-b7/jtt809-b7/blob/master/doc/%E7%9C%81%E5%8E%85%E5%AF%B9%E6%8E%A5/JT809%E6%A3%80%E6%B5%8B%E5%B7%A5%E5%85%B7%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E.docx)
4. [CheckTools809-2019.rar](https://gitee.com/linbq-b7/jtt809-b7/blob/master/doc/%E7%9C%81%E5%8E%85%E5%AF%B9%E6%8E%A5/CheckTools809-2019.rar)
5. [jttools在线协议解析](https://jttools.smallchi.cn/)

## 开源项目参考
1. [C#-https://github.com/SmallChi](https://github.com/SmallChi)
2. [Go-https://github.com/lai323/jt809server](https://github.com/lai323/jt809server)

## 其他
1. [CRC-8和CRC-16算法](https://zhuanlan.zhihu.com/p/114049042?utm_source=wechat_timeline)
2. 809主业务流程![](https://gitee.com/linbq-b7/jtt809-b7/raw/master/doc/%E5%8D%8F%E8%AE%AE%E7%9B%B8%E5%85%B3/809%E4%B8%BB%E4%B8%9A%E5%8A%A1%E6%B5%81%E7%A8%8B%E5%9B%BE.jpg)
3. 加密算法![](https://gitee.com/linbq-b7/jtt809-b7/raw/master/doc/%E5%8D%8F%E8%AE%AE%E7%9B%B8%E5%85%B3/%E5%8A%A0%E5%AF%86%E7%AE%97%E6%B3%95.jpg)
4. [TCP消息边界](https://baijiahao.baidu.com/s?id=1692571196492629298&wfr=spider&for=pc)

l745230/JTT809

简介

发行版

贡献者

近期动态

l745230/JTT809 .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

l745230/JTT809