# JT/T 808 网关数据交换格式

该文档定义了 **emqx_jt808** 和 **EMQX** 之间数据交换的格式。

## 协议版本支持

本网关支持 JT/T 808-2013 和 JT/T 808-2019 两个版本的协议。网关通过消息头中的版本标识位自动识别协议版本：
- **2013 版本**: 消息头属性 bit14 = 0，终端手机号为 BCD[6]（12 位），消息头长度 12/16 字节
- **2019 版本**: 消息头属性 bit14 = 1，终端手机号为 BCD[10]（20 位），消息头长度 17/21 字节

在 JSON 数据交换中，2019 版本的消息会在 `header` 中包含 `proto_ver` 字段标识协议版本。

## 约定

- Payload 采用 JSON 格式进行组装
- JSON Key 采用全小写格式命名

## JSON 结构示例

### 终端到服务器
```json
{
  "header" : {
    "msg_id" : 1,
    "encrypt": 0,
    "len": VAL,
    "phone": 13900000000,
    "msg_sn": 0
  },
  "body": {
    "seq": 1,
    "id": 1,
    "result": 0
  }
}
```

### 服务器到终端
```json
{
  "header": {
    "msg_id": 32769,
    "encrypt": 0,
    "phone": 13900000000,
    "msg_sn": 0
  },
  "body": {
    "seq": 1,
    "id": 1,
    "result": 0
  }
}
```

## 数据类型对照表
| JT808 Defined Type | In JSON Type | Comment    |
|:------------------:|:------------:|:----------:|
| BYTE               | integer      | in decimal |
| WORD               | integer      | in decimal |
| DWORD              | integer      | in decimal |
| BYTE(n)            | string       |            |
| BCD(n)             | string       |            |
| STRING             | string       |            |

## 字段对照表

### 消息头字段对照表

#### JT/T 808-2013 消息头

| Field        | JSON Key name | Value Type | Value Type in JSON |
|:------------:|:-------------:|:----------:|:------------------:|
| 消息 ID      | msg_id        | word       | integer            |
| 数据加密方式 | encrypt       | word       | integer            |
| 终端手机号   | phone         | bcd(6)     | string             |
| 消息流水号   | msg_sn        | word       | integer            |

| Optional Field | JSON Key name | Value Type | Value Type in JSON |
|:--------------:|:-------------:|:----------:|:------------------:|
| 消息总包数     | frag_total    | word       | integer            |
| 消息包序号     | frag_sn       | word       | integer            |

#### JT/T 808-2019 消息头

| Field        | JSON Key name | Value Type | Value Type in JSON |
|:------------:|:-------------:|:----------:|:------------------:|
| 消息 ID      | msg_id        | word       | integer            |
| 数据加密方式 | encrypt       | word       | integer            |
| 协议版本号   | proto_ver     | byte       | integer            |
| 终端手机号   | phone         | bcd(10)    | string             |
| 消息流水号   | msg_sn        | word       | integer            |

| Optional Field | JSON Key name | Value Type | Value Type in JSON |
|:--------------:|:-------------:|:----------:|:------------------:|
| 消息总包数     | frag_total    | word       | integer            |
| 消息包序号     | frag_sn       | word       | integer            |

**注意**：

- `proto_ver` 字段仅在 2019 版本协议中出现，当前协议版本号为 1。
- 存在 `frag_total` 与 `frag_sn` 时表示消息体为长消息，进行分包处理。

### 消息体字段对照表

#### 终端通用应答 `"msg_id": 1` 0x0001

| Field      | JSON Key name | Value Type | Value Type in JSON |
|:----------:|:-------------:|:----------:|:------------------:|
| 应答流水号 | seq           | word       | integer            |
| 应答 ID    | id            | word       | integer            |
| 结果       | result        | byte       | integer            |


#### 平台通用应答 `"msg_id": 32769` 0x8001

| Field      | JSON Key name | Value Type | Value Type in JSON |
|:----------:|:-------------:|:----------:|:------------------:|
| 应答流水号 | seq           | word       | integer            |
| 应答 ID    | id            | word       | integer            |
| 结果       | result        | byte       | integer            |


#### 终端心跳 `"msg_id": 2` 0x0002

空 JSON


#### 服务器补传分包请求 `"msg_id": 32771` 0x8003

##### JT/T 808-2013

|     Field      | JSON Key name |   Value Type   | Value Type in JSON |
| :------------: | :-----------: | :------------: | :----------------: |
|   重传包总数   |    length     |      byte      |      integer       |
| 重传包 ID 列表 |      ids      | byte(2*length) |  list of integer   |
| 原始消息流水号 |      seq      |      word      |      integer       |

##### JT/T 808-2019

| Field          | JSON Key name | Value Type     | Value Type in JSON |
|:--------------:|:-------------:|:--------------:|:------------------:|
| 原始消息流水号 | seq           | word           | integer            |
| 重传包总数     | length        | word           | integer            |
| 重传包 ID 列表 | ids           | byte(2*length) | list of integer    |

**注意**：2019 版本将重传包总数由 BYTE 改为 WORD。


#### 查询服务器时间应答 `"msg_id": 32772` 0x8004 (2019 新增)

| Field | JSON Key name | Value Type | Value Type in JSON |
|:-----:|:-------------:|:----------:|:------------------:|
| 年    | year          | word       | integer            |
| 月    | month         | byte       | integer            |
| 日    | day           | byte       | integer            |
| 时    | hour          | byte       | integer            |
| 分    | minute        | byte       | integer            |
| 秒    | second        | byte       | integer            |


#### 终端注册 `"msg_id": 256` 0x0100

##### JT/T 808-2013

| Field     | JSON Key name  | Value Type | Value Type in JSON |
|:---------:|:--------------:|:----------:|:------------------:|
| 省域 ID   | province       | word       | integer            |
| 市县域 ID | city           | word       | integer            |
| 制造商 ID | manufacture    | byte(5)    | string             |
| 终端型号  | model          | byte(20)   | string             |
| 终端 ID   | dev_id         | byte(7)    | string             |
| 车牌颜色  | color          | byte       | integer            |
| 车辆标识  | license_number | string     | string             |

##### JT/T 808-2019

| Field     | JSON Key name  | Value Type | Value Type in JSON |
|:---------:|:--------------:|:----------:|:------------------:|
| 省域 ID   | province       | word       | integer            |
| 市县域 ID | city           | word       | integer            |
| 制造商 ID | manufacture    | byte(11)   | string             |
| 终端型号  | model          | byte(30)   | string             |
| 终端 ID   | dev_id         | byte(30)   | string             |
| 车牌颜色  | color          | byte       | integer            |
| 车辆标识  | license_number | string     | string             |

**注意**：2019 版本扩展了制造商 ID（5 -> 11）、终端型号（20 -> 30）、终端 ID（7 -> 30）字段长度。


#### 终端注册应答 `"msg_id": 33024` 0x8100

| Field      | JSON Key name | Value Type | Value Type in JSON |
|:----------:|:-------------:|:----------:|:------------------:|
| 应答流水号 | seq           | word       | integer            |
| 结果       | result        | byte       | integer            |

只有成功后才有此字段：

| Optional Field | JSON Key name | Value Type | Value Type in JSON |
|:--------------:|---------------|------------|--------------------|
| 鉴权码         | auth_code     | string     | string             |


#### 终端注销 `"msg_id": 3` 0x0003

空 JSON


#### 查询服务器时间请求 `"msg_id": 4` 0x0004 (2019 新增)

空 JSON


#### 终端补传分包请求 `"msg_id": 5` 0x0005 (2019 新增)

| Field          | JSON Key name | Value Type     | Value Type in JSON |
|:--------------:|:-------------:|:--------------:|:------------------:|
| 原始消息流水号 | seq           | word           | integer            |
| 重传包总数     | length        | word           | integer            |
| 重传包 ID 列表 | ids           | byte(2*length) | list of integer    |


#### 终端鉴权 `"msg_id": 258` 0x0102

##### JT/T 808-2013

| Field  | JSON Key name | Value Type | Value Type in JSON |
|:------:|:-------------:|:----------:|:------------------:|
| 鉴权码 | code          | string     | string             |

##### JT/T 808-2019

| Field        | JSON Key name    | Value Type | Value Type in JSON |
|:------------:|:----------------:|:----------:|:------------------:|
| 鉴权码长度   | code_len         | byte       | integer            |
| 鉴权码       | code             | string     | string             |
| 终端 IMEI    | imei             | byte(15)   | string             |
| 软件版本号长度| sw_version_len  | byte       | integer            |
| 软件版本号   | sw_version       | string     | string             |

**注意**：2019 版本新增鉴权码长度、终端 IMEI、软件版本号等字段。


#### 设置终端参数 `"msg_id": 33027` 0x8103

| Field      | JSON Key name | Value Type | Value Type in JSON                                     |
|:----------:|:-------------:|:----------:|:------------------------------------------------------:|
| 参数总数   | length        | byte       | integer                                                |
| 参数项列表 | params        | list       | list of id and value. `[{"id":ID, "value": VAL}, ...]` |
| 参数项     | id            | dword      | integer                                                |
| 参数值     | value         | 见下表     | 见下表                                                 |

参数 ID 说明见协议规定。

##### 参数值类型对照表

参数值的 JSON 类型根据参数 ID 对应的数据类型决定:

| 参数 ID 范围    | 数据类型 | Value Type in JSON     | 说明                                    |
|-----------------|----------|------------------------|-----------------------------------------|
| BYTE 类型参数   | byte     | integer                | 如 0x0084, 0x0090~0x0095                |
| WORD 类型参数   | word     | integer                | 如 0x0031, 0x0081~0x0082                |
| DWORD 类型参数  | dword    | integer                | 如 0x0001~0x0007, 0x0018~0x001C         |
| STRING 类型参数 | string   | string                 | 如 0x0010~0x0017, 0x0040~0x0049, 0x0083 |
| 0x0110~0x01FF   | byte[8]  | string(base64 encoded) | CAN 总线 ID 单独采集设置参数            |
| 其他未知参数    | byte[n]  | string(base64 encoded) | 保留参数或厂商自定义参数                |

示例:
```json
{
  "header": { "msg_id": 33027, ... },
  "body": {
    "length": 3,
    "params": [
      {"id": 1, "value": 60},
      {"id": 16, "value": "cmnet"},
      {"id": 272, "value": "AQIDBAUG"}
    ]
  }
}
```


#### 查询终端参数 `"msg_id": 33028` 0x8104

空 JSON


#### 查询指定终端参数 `"msg_id": 33030` 0x8106

| Field        | JSON Key name | Value Type     | Value Type in JSON               |
|:------------:|:-------------:|:--------------:|:--------------------------------:|
| 参数总数     | length        | byte           | integer                          |
| 参数 ID 列表 | ids           | byte(2*length) | list of id. `[1, 2, 3, 4, ...]` |

参数 ID 列表中元素为 integer。


#### 查询终端应答参数 `"msg_id": 260` 0x0104

| Field        | JSON Key name | Value Type | Value Type in JSON                                     |
|:------------:|:-------------:|:----------:|:------------------------------------------------------:|
| 应答流水号   | seq           | word       | integer                                                |
| 应答参数个数 | length        | byte       | integer                                                |
| 参数项列表   | params        | list       | list of id and value. `[{"id":ID, "value": VAL}, ...]` |
| 参数项       | id            | dword      | integer                                                |
| 参数值       | value         | --         | 见 [0x8103 消息参数值类型对照表](#参数值类型对照表)    |


#### 终端控制 `"msg_id": 33029 ` 0x8105

| Field    | JSON Key name | Value Type | Value Type in JSON |
|:--------:|:-------------:|:----------:|:------------------:|
| 命令字   | command       | byte       | integer            |
| 命令参数 | param         | string     | string             |


#### 查询终端属性 `"msg_id": 33031` 0x8107

空 JSON


#### 查询终端属性应答 `"msg_id": 263` 0x0107

##### JT/T 808-2013

| Field             | JSON Key name    | Value Type | Value Type in JSON |
|:-----------------:|:----------------:|:----------:|:------------------:|
| 终端类型          | type             | word       | integer            |
| 制造商 ID         | manufacture      | byte(5)    | string             |
| 终端型号          | model            | byte(20)   | string             |
| 终端 ID           | id               | byte(7)    | string             |
| 终端 SIM 卡 ICCID | iccid            | byte(10)   | string             |
| 终端硬件版本号    | hardware_version | string     | string             |
| 终端硬件固件号    | firmware_version | string     | string             |
| GNSS 模块属性     | gnss_prop        | byte       | integer            |
| 通信模块属性      | comm_prop        | byte       | integer            |

##### JT/T 808-2019

| Field             | JSON Key name    | Value Type | Value Type in JSON |
|:-----------------:|:----------------:|:----------:|:------------------:|
| 终端类型          | type             | word       | integer            |
| 制造商 ID         | manufacture      | byte(11)   | string             |
| 终端型号          | model            | byte(30)   | string             |
| 终端 ID           | id               | byte(30)   | string             |
| 终端 SIM 卡 ICCID | iccid            | byte(10)   | string             |
| 终端硬件版本号    | hardware_version | string     | string             |
| 终端硬件固件号    | firmware_version | string     | string             |
| GNSS 模块属性     | gnss_prop        | byte       | integer            |
| 通信模块属性      | comm_prop        | byte       | integer            |

**注意**：

- 2019 版本扩展了制造商 ID（5 -> 11）、终端型号（20 -> 30）、终端 ID（7 -> 30）字段长度
- 终端类型新增 bit8（支持/连接挂车）
- 终端硬件版本号长度、终端固件版本号长度，将被用于二进制报文解析，不向上暴露


#### 下发终端升级包 `"msg_id": 33032` 0x8108

| Field          | JSON Key name | Value Type | Value Type in JSON     |
|:--------------:|:-------------:|:----------:|:----------------------:|
| 升级类型       | type          | byte       | integer                |
| 制造商 ID      | manufacturer  | byte(5)    | string                 |
| 版本号长度     | ver_len       | byte       | integer                |
| 版本号         | version       | string     | string                 |
| 升级数据包长度 | fw_len        | dword      | integer                |
| 升级数据包     | firmware      | binary     | string(base64 encoded) |


#### 终端升级结果通知 `"msg_id": 264` 0x0108

| Field    | JSON Key name | Value Type | Value Type in JSON |
|:--------:|:-------------:|:----------:|:------------------:|
| 升级类型 | type          | byte       | integer            |
| 升级结果 | result        | byte       | integer            |


#### 位置信息汇报 `"msg_id": 512` 0x0200

| Field                | JSON Key name | Value Type | Value Type in JSON |
|:--------------------:|:-------------:|:----------:|:------------------:|
| 报警标志             | alarm         | dword      | integer            |
| 状态                 | status        | dword      | integer            |
| 纬度                 | latitude      | dword      | integer            |
| 经度                 | longitude     | dword      | integer            |
| 高程                 | altitude      | word       | integer            |
| 速度                 | speed         | word       | integer            |
| 方向                 | direction     | word       | integer            |
| 时间                 | time          | bcd(6)     | string             |

| Optional Field     | JSON Key name | Value Type | Value Type in JSON |
|:------------------:|:-------------:|:----------:|:------------------:|
| 位置附加信息项列表 | extra         | -          | map                |

##### JT/T 808-2019 变更

- **报警标志新增**: bit15（违规行驶报警）、bit16（胎压预警）、bit17（右转盲区异常报警）
- **报警标志变更**: bit29（碰撞预警 -> 碰撞侧翻报警）、bit31（非法开门报警 -> 保留）
- **状态位新增**: bit6（紧急刹车系统采集的前撞预警）、bit7（车道偏移预警）、bit22（车辆处于行驶状态）
- **附加信息新增**: 0x05（胎压）、0x06（车厢温度）

<!-- TODO: refine alarm more details -->

- 位置附加信息项列表, 在 `extra` 中

|       Field (附加信息描述)        |  JSON Key name  | Value Type |   Value Type in JSON   |
| :-------------------------------: | :-------------: | :--------: | :--------------------: |
|               里程                |     mileage     |   dword    |        integer         |
|               油量                |   fuel_meter    |    word    |        integer         |
|      行驶记录功能获取的速度       |      speed      |    word    |        integer         |
|     需要人工确认报警事件的 ID     |    alarm_id     |    word    |        integer         |
|         胎压 (2019 新增)          |  tire_pressure  |     -      | string(base64 encoded) |
|       车厢温度 (2019 新增)        |  carriage_temp  |    word    |        integer         |
|    超速报警附加信息(长度1或5)     | overspeed_alarm |     -      |          map           |
|     进出区域/路线报警附加信息     |  in_out_alarm   |     -      |          map           |
| 路段行驶时间不足/过长报警附加信息 | path_time_alarm |     -      |          map           |
|        扩展车辆信号状态位         |  见状态位附表   |     -      |           -            |
|             IO 状态位             |    io_status    |     -      |          map           |
|              模拟量               |     analog      |     -      |          map           |
|       无线通信网络信号强度        |      rssi       |    byte    |        integer         |
|          GNSS 定位卫星数          |  gnss_sat_num   |    byte    |        integer         |
|        后续自定义信息长度         |     custome     |     -      | string(base64 encoded) |

- 超速报警附加信息(长度1或5), 置于 map `overspeed_alarm` 内

| Field    | JSON Key name | Value Type | Value Type in JSON |
|:--------:|:-------------:|:----------:|:------------------:|
| 位置类型 | type          | byte       | integer            |

| Optional Field | JSON Key name | Value Type | Value Type in JSON |
|:--------------:|:-------------:|:----------:|:------------------:|
| 区域或路段 ID  | id            | dword      | integer            |


- 进出区域/路线报警附加信息, 置于 map `in_out_alarm` 内

| Field         | JSON Key name | Value Type | Value Type in JSON |
|:-------------:|:-------------:|:----------:|:------------------:|
| 位置类型      | type          | byte       | integer            |
| 区域或路段 ID | id            | dword      | integer            |
| 方向          | direction     | byte       | integer            |

- 路段行驶时间不足/过长报警附加信息, 置于 map `path_time_alarm` 内

| Field        | JSON Key name | Value Type | Value Type in JSON |
|:------------:|:-------------:|:----------:|:------------------:|
| 路段 ID      | id            | dword      | integer            |
| 路段行驶时间 | time          | word       | integer            |
| 结果         | result        | byte       | integer            |

- IO 状态位, 置于 map `io_status` 内

| Field        | JSON Key name | Value Type | Value Type in JSON |
|:------------:|:-------------:|:----------:|:------------------:|
| 深度休眠状态 | deep_sleep    | 1 bit      | integer            |
| 休眠状态     | sleep         | 1 bit      | integer            |

- 模拟量, 置于 map  `analog` 内

| Field    | JSON Key name | Value Type | Value Type in JSON |
|:--------:|:-------------:|:----------:|:------------------:|
| 模拟量 0 | ad0           | 16 bits    | integer            |
| 模拟量 1 | ad1           | 16 bits    | integer            |

- 扩展车辆信号状态位, 置于 map `extra` 内

| Field        | JSON Key name   | Value Type | Value Type in JSON                         |
|:------------:|:---------------:|:----------:|:------------------------------------------:|
| 信号         | signal          | - 2 bits   | map, `{"low_beam": VAL, "high_beam": VAL}` |
| 右转向灯信号 | right_turn      | 1 bit      | integer                                    |
| 左转向灯信号 | left_turn       | 1 bit      | integer                                    |
| 制动信号     | brake           | 1 bit      | integer                                    |
| 倒档信号     | reverse         | 1 bit      | integer                                    |
| 雾灯信号     | fog             | 1 bit      | integer                                    |
| 示廓灯       | side_marker     | 1 bit      | integer                                    |
| 喇叭状态     | horn            | 1 bit      | integer                                    |
| 空调状态     | air_conditioner | 1 bit      | integer                                    |
| 空档信号     | neutral         | 1 bit      | integer                                    |
| 缓速器工作   | retarder        | 1 bit      | integer                                    |
| ABS 工作     | abs             | 1 bit      | integer                                    |
| 加热器工作   | heater          | 1 bit      | integer                                    |
| 离合器状态   | cluth           | 1 bit      | integer                                    |

- 信号状态, 置于 map `signal` 内

| Field      | JSON Key name | Value Type | Value Type in JSON |
|:----------:|:-------------:|:----------:|:------------------:|
| 近光灯信号 | low_beam      | 1 bit      | integer            |
| 远光灯信号 | high_beam     | 1 bit      | integer            |

示例如下：
```json
{
  "header" : {
    "msg_id" : 1,
    "encrypt": 0,
    "len": VAL,
    "phone": 13900000000,
    "msg_sn": 0
  },
  "body": {
    "alarm": VAL,
    "status": VAL,
    "latitude": VAL,
    "longitude": VAL,
    "altitude": VAL,
    "speed": VAL,
    "direction": VAL,
    "time": VAL,
    "extra": {
      "mileage": VAL,
      "fuel_unit": VAL,
      "speed": VAL,
      "alarm_id": VAL,
      "overspeed_alarm": {
        "type": VAL,
        "id": VAL
      },
      "in_out_alarm": {
        "type": VAL,
        "id": VAL,
        "direction": VAL
      },
      "path_time_alarm": {
        "id": VAL,
        "time": VAL,
        "result": VAL
      },
      "signal": {
        "low_beam": VAL,
        "high_beam": VAL
      },
      "right_turn": VAL,
      "left_turn": VAL,
      "break": VAL,
      "reverse": VAL,
      "fog": VAL,
      "side_marker": VAL,
      "horn": VAL,
      "air_conditioner": VAL,
      "neutral": VAL,
      "retarder": VAL,
      "abs": VAL,
      "heater": VAL,
      "cluth": VAL,
      "io_status": {
        "deep_sleep": VAL,
        "sleep": VAL
      },
      "analog": {
        "ad0": VAL,
        "ad1": VAL
      }
    }
  }
}
```


#### 位置信息查询 `"msg_id": 33281` 0x8201

空 JSON


#### 位置信息查询应答 `"msg_id": 513` 0x0201

| Field        | JSON Key name | Value Type | Value Type in JSON |
|:------------:|:-------------:|:----------:|:------------------:|
| 应答流水号   | seq           | word       | integer            |
| 位置信息汇报 | params        | -          | map                |


#### 临时位置跟踪控制 `"msg_id": 33282` 0x8202

| Field          | JSON Key name | Value Type | Value Type in JSON |
|:--------------:|:-------------:|:----------:|:------------------:|
| 时间间隔       | period        | word       | integer            |
| 跟踪位置有效期 | expiry        | dword      | integer            |


#### 人工确认报警消息 `"msg_id": 33283` 0x8203

| Field            | JSON Key name | Value Type | Value Type in JSON |
|:----------------:|:-------------:|:----------:|:------------------:|
| 报警消息流水号   | seq           | word       | integer            |
| 人工确认报警类型 | type          | dword      | integer            |


#### 服务器向终端发起链路检测请求 `"msg_id": 33284` 0x8204 (2019 新增)

空 JSON


#### 文本信息下发 `"msg_id": 33536` 0x8300

##### JT/T 808-2013

| Field    | JSON Key name | Value Type | Value Type in JSON |
|:--------:|:-------------:|:----------:|:------------------:|
| 标志     | flag          | byte       | integer            |
| 文本信息 | text          | string     | string             |

##### JT/T 808-2019

| Field    | JSON Key name | Value Type | Value Type in JSON |
|:--------:|:-------------:|:----------:|:------------------:|
| 标志     | flag          | byte       | integer            |
| 文本类型 | text_type     | byte       | integer            |
| 文本信息 | text          | string     | string             |

**注意**： 2019 版本新增文本类型字段，标志位 bit0-1 含义变更。


#### 事件设置 `"msg_id": 33537` 0x8301

| Field        | JSON Key name | Value Type | Value Type in JSON                                                |
|:------------:|:-------------:|:----------:|:-----------------------------------------------------------------:|
| 设置类型     | type          | byte       | integer                                                           |
| 设置总数     | length        | byte       | integer                                                           |
| 事件项列表   | events        | list       | list of event. `[{"id": ID, "length": LEN, "content": CON}, ...]` |
| 事件 ID      | id            | byte       | integer                                                           |
| 事件内容长度 | length        | byte       | integer                                                           |
| 事件内容     | content       | string     | string                                                            |


#### 事件报告 `"msg_id": 769` 0x0301

| Field   | JSON Key name | Value Type | Value Type in JSON |
|:-------:|:-------------:|------------|:------------------:|
| 事件 ID | id            | byte       | integer            |


#### 提问下发 `"msg_id": 33538` 0x8302

| Field        | JSON Key name | Value Type | Value Type in JSON                                             |
|:------------:|:-------------:|:----------:|:--------------------------------------------------------------:|
| 标志         | flag          | byte       | integer                                                        |
| 问题内容长度 | length        | byte       | integer                                                        |
| 问题         | question      | string     | string                                                         |
| 候选答案列表 | answers       | list       | list of answer. `[{"id": ID, "len": LEN, "answer": ANS}, ...]` |
| 答案 ID      | id            | byte       | integer                                                        |
| 答案内容长度 | len           | byte       | integer                                                        |
| 答案内容     | answer        | string     | string                                                         |

<!-- TODO: len -> length or other length -> len -->

#### 提问应答 `"msg_id": 770` 0x0302

| Field      | JSON Key name | Value Type | Value Type in JSON |
|:----------:|:-------------:|:----------:|:------------------:|
| 应答流水号 | seq           | word       | integer            |
| 答案 ID    | id            | byte       | integer            |


#### 信息点播菜单设置 `"msg_id": 33539` 0x8303

| Field        | JSON Key name | Value Type | Value Type in JSON |
|:------------:|:-------------:|:----------:|:------------------:|
| 设置类型     | type          | byte       | integer            |
| 信息项总数   | length        | byte       | integer            |
| 信息项列表   | menus         | list       | list of menu       |
| 信息类型     | type          | byte       | integer            |
| 信息名称长度 | length        | word       | integer            |
| 信息名称     | info          | string     | string             |


#### 信息点播/取消 `"msg_id": 771` 0x0303

| Field         | JSON Key name | Value Type | Value Type in JSON |
|:-------------:|:-------------:|:----------:|:------------------:|
| 信息类型      | id            | byte       | integer            |
| 点拨/取消标志 | flag          | byte       | integer            |


#### 信息服务 `"msg_id": 33540` 0x8304

| Field    | JSON Key name | Value Type | Value Type in JSON |
|:--------:|:-------------:|:----------:|:------------------:|
| 信息类型 | type          | byte       | integer            |
| 信息长度 | length        | word       | integer            |
| 信息内容 | info          | string     | string             |


#### 电话回拨 `"msg_id": 33792` 0x8400

| Field    | JSON Key name | Value Type | Value Type in JSON |
|:--------:|:-------------:|:----------:|:------------------:|
| 标志     | type          | byte       | integer            |
| 电话号码 | phone         | string     | string             |


#### 设置电话本 `"msg_id": 33793` 0x8401

| Field      | JSON Key name | Value Type | Value Type in JSON |
|:----------:|:-------------:|:----------:|:------------------:|
| 设置类型   | type          | byte       | integer            |
| 联系人总数 | length        | byte       | integer            |
| 联系人项   | contacts      | list       | list of contact.   |
| 标志       | type          | byte       | integer            |
| 号码长度   | phone_len     | byte       | integer            |
| 电话号码   | phone         | string     | string             |
| 联系人长度 | name_len      | byte       | integer            |
| 联系人     | name          | string     | string             |

联系人项示例
```json
[{"type": TYPE, "phone_len", PH_LEN, "phone": PHONE, "name_len": NAME_LEN, "name": NAME}, ...]
```


#### 车辆控制 `"msg_id": 34048` 0x8500

##### JT/T 808-2013

| Field    | JSON Key name | Value Type | Value Type in JSON |
|:--------:|:-------------:|:----------:|:------------------:|
| 标志控制 | flag          | byte       | integer            |

##### JT/T 808-2019

| Field        | JSON Key name | Value Type | Value Type in JSON |
|:------------:|:-------------:|:----------:|:------------------:|
| 控制标志     | flag          | word       | integer            |
| 控制类型数量 | length        | byte       | integer            |
| 控制类型列表 | controls      | list       | list of control    |
| 控制类型 ID  | type_id       | byte       | integer            |
| 控制类型参数 | param         | binary     | string(base64 encoded) |

**注意**：2019 版本消息结构完全重构为控制类型数量+控制类型列表。


#### 车辆控制应答 `"msg_id": 1280` 0x0500

| Field              | JSON Key name | Value Type | Value Type in JSON |
|:------------------:|:-------------:|:----------:|:------------------:|
| 应答流水号         | seq           | word       | integer            |
| 位置信息汇报消息体 | location      | map        | map of location    |


#### 设置圆形区域 `"msg_id": 34304` 0x8600

##### JT/T 808-2013

| Field        | JSON Key name      | Value Type | Value Type in JSON |
|:------------:|:------------------:|:----------:|:------------------:|
| 设置属性     | type               | byte       | integer            |
| 区域总数     | length             | byte       | integer            |
| 区域项       | areas              | list       | list of area       |
| 区域 ID      | id                 | dword      | integer            |
| 区域属性     | flag               | word       | integer            |
| 中心点纬度   | center_latitude    | dword      | integer            |
| 中心点经度   | center_longitude   | dword      | integer            |
| 半径         | radius             | dword      | integer            |
| 起始时间     | start_time         | string     | string             |
| 结束时间     | end_time           | string     | string             |
| 最高速度     | max_speed          | word       | integer            |
| 超速持续时间 | overspeed_duration | byte       | integer            |

##### JT/T 808-2019 新增字段

| Field          | JSON Key name       | Value Type | Value Type in JSON |
|:--------------:|:-------------------:|:----------:|:------------------:|
| 夜间最高速度   | night_max_speed     | word       | integer            |
| 区域名称长度   | name_len            | word       | integer            |
| 区域名称       | name                | string     | string             |

**注意**：2019 版本在区域项中新增夜间最高速度、区域名称长度、区域名称字段。

区域列表示例
```json
[{"id": ID,
   "flag": FLAG,
   "center_latitude": CEN_LAT,
   "center_longitude": CEN_LON,
   "radius": RADIUS,
   "start_time": START_TIME,
   "end_time": END_TIME,
   "max_speed": MAX_SPEED,
   "overspeed_duration": OVERSPEED_DURATION,
   "night_max_speed": NIGHT_MAX_SPEED,
   "name_len": NAME_LEN,
   "name": NAME
   },
  ...
 ]
```


#### 删除圆形区域 `"msg_id": 34305` 0x8601

|    Field     | JSON Key name | Value Type | Value Type in JSON |
| :----------: | :-----------: | :--------: | :----------------: |
|    区域数    |    length     |    byte    |      integer       |
| 区域 ID 列表 |      ids      |    list    |     list of id     |
| 区域 ID 1~n  |       -       |   dword    |      integer       |

`[ID1, ID2, ...]`


#### 设置矩形区域 `"msg_id": 34306` 0x8602

##### JT/T 808-2013

| Field        | JSON Key name      | Value Type | Value Type in JSON       |
|:------------:|:------------------:|:----------:|:------------------------:|
| 设置属性     | type               | byte       | integer                  |
| 区域总数     | length             | byte       | integer                  |
| 区域项       | areas              | list       | list of rectangle area   |
| 区域 ID      | id                 | dword      | integer                  |
| 区域属性     | flag               | word       | integer                  |
| 左上点纬度   | lt_lat             | dword      | integer                  |
| 左上点经度   | lt_lng             | dword      | integer                  |
| 右下点纬度   | rb_lat             | dword      | integer                  |
| 右下点经度   | rb_lng             | dword      | integer                  |
| 起始时间     | start_time         | string     | string                   |
| 结束时间     | end_time           | string     | string                   |
| 最高速度     | max_speed          | word       | integer                  |
| 超速持续时间 | overspeed_duration | byte       | integer                  |

##### JT/T 808-2019 新增字段

| Field          | JSON Key name       | Value Type | Value Type in JSON |
|:--------------:|:-------------------:|:----------:|:------------------:|
| 夜间最高速度   | night_max_speed     | word       | integer            |
| 区域名称长度   | name_len            | word       | integer            |
| 区域名称       | name                | string     | string             |

**注意**：2019 版本在区域项中新增夜间最高速度、区域名称长度、区域名称字段。


#### 删除矩形区域 `"msg_id": 34307` 0x8603

|    Field     | JSON Key name | Value Type | Value Type in JSON |
| :----------: | :-----------: | :--------: | :----------------: |
|    区域数    |    length     |    byte    |      integer       |
| 区域 ID 列表 |      ids      |    list    |     list of id     |
| 区域 ID 1~n  |       -       |   dword    |      integer       |


#### 设置多边形区域 `"msg_id": 34308` 0x8604

##### JT/T 808-2013

| Field        | JSON Key name      | Value Type | Value Type in JSON |
|:------------:|:------------------:|:----------:|:------------------:|
| 区域 ID      | id                 | dword      | integer            |
| 区域属性     | flag               | word       | integer            |
| 起始时间     | start_time         | string     | string             |
| 结束时间     | end_time           | string     | string             |
| 最高速度     | max_speed          | word       | integer            |
| 超速持续时间 | overspeed_duration | byte       | integer            |
| 区域总顶点数 | length             | word       | integer            |
| 顶点项列表   | points             | list       | list of point      |
| 顶点纬度     | lat                | dword      | integer            |
| 顶点经度     | lng                | dword      | integer            |

##### JT/T 808-2019 新增字段

| Field          | JSON Key name       | Value Type | Value Type in JSON |
|:--------------:|:-------------------:|:----------:|:------------------:|
| 夜间最高速度   | night_max_speed     | word       | integer            |
| 区域名称长度   | name_len            | word       | integer            |
| 区域名称       | name                | string     | string             |

**注意**：2019 版本新增夜间最高速度、区域名称长度、区域名称字段。


#### 删除多边形区域 `"msg_id": 34309` 0x8605

|    Field     | JSON Key name | Value Type | Value Type in JSON |
| :----------: | :-----------: | :--------: | :----------------: |
|    区域数    |    length     |    byte    |      integer       |
| 区域 ID 列表 |      ids      |    list    |     list of id     |
| 区域 ID 1~n  |       -       |   dword    |      integer       |


#### 设置路线 `"msg_id": 34310` 0x8606

##### JT/T 808-2013

| Field            | JSON Key name      | Value Type | Value Type in JSON |
|:----------------:|:------------------:|:----------:|:------------------:|
| 路线 ID          | id                 | dword      | integer            |
| 路线属性         | flag               | word       | integer            |
| 起始时间         | start_time         | string     | string             |
| 结束时间         | end_time           | string     | string             |
| 路线总拐点数     | length             | word       | integer            |
| 拐点项           | points             | list       | list of point      |
| 拐点 ID          | point_id           | dword      | integer            |
| 路段 ID          | path_id            | dword      | integer            |
| 拐点纬度         | point_lat          | dword      | integer            |
| 拐点经度         | point_lng          | dword      | integer            |
| 路段宽度         | width              | byte       | integer            |
| 路段属性         | attrib             | byte       | integer            |
| 路段行驶过长阈值 | passed             | word       | integer            |
| 路段行驶不足阈值 | uncovered          | word       | integer            |
| 路段最高速度     | max_speed          | word       | integer            |
| 路段超速持续时间 | overspeed_duration | byte       | integer            |

##### JT/T 808-2019 新增字段

| Field            | JSON Key name         | Value Type | Value Type in JSON |
|:----------------:|:---------------------:|:----------:|:------------------:|
| 路段夜间最高速度 | night_max_speed       | word       | integer            |
| 路线名称长度     | name_len              | word       | integer            |
| 路线名称         | name                  | string     | string             |

**注意**：2019 版本在路段中新增路段夜间最高速度，以及路线名称长度、路线名称字段。


#### 删除路线 `"msg_id": 34311` 0x8607

| Field    | JSON Key name | Value Type | Value Type in JSON |
|:--------:|:-------------:|:----------:|:------------------:|
| 路线数   | length        | byte       | integer            |
| 路线列表 | ids           | list       | list of id         |
| 路线 ID  | -             | dword      | integer            |


#### 查询区域或路线数据 `"msg_id": 34312` 0x8608 (2019 新增)

| Field      | JSON Key name | Value Type     | Value Type in JSON |
|:----------:|:-------------:|:--------------:|:------------------:|
| 查询类型   | type          | byte           | integer            |
| 查询数量   | length        | dword          | integer            |
| 区域/路线 ID 列表 | ids    | byte(4*length) | list of integer    |

- 查询类型: 1-圆形区域, 2-矩形区域, 3-多边形区域, 4-路线


#### 查询区域或路线数据应答 `"msg_id": 1544` 0x0608 (2019 新增)

| Field          | JSON Key name | Value Type             | Value Type in JSON |
|:--------------:|:-------------:|:----------------------:|:------------------:|
| 查询类型       | type          | byte                   | integer            |
| 区域/路线数量  | length        | dword                  | integer            |
| 区域/路线项列表 | items        | binary                 | string(base64 encoded) |

- 区域/路线项列表内容根据查询类型不同而不同，详见协议规定


#### 行驶记录数据采集命令 `"msg_id": 34560` 0x8700

| Field  | JSON Key name | Value Type             | Value Type in JSON |
|:------:|:-------------:|:----------------------:|:------------------:|
| 命令字 | command       | byte                   | integer            |
| 数据块 | param         | string(base64 encoded) | string             |


#### 行驶记录数据上传 `"msg_id": 1792` 0x0700

| Field      | JSON Key name | Value Type             | Value Type in JSON |
|:----------:|:-------------:|:----------------------:|:------------------:|
| 应答流水号 | seq           | word                   | integer            |
| 命令字     | command       | byte                   | integer            |
| 数据块     | data          | string(base64 encoded) | string             |


#### 行驶记录参数下传命令 `"msg_id": 34561` 0x8701

| Field  | JSON Key name | Value Type             | Value Type in JSON |
|:------:|:-------------:|:----------------------:|:------------------:|
| 命令字 | command       | byte                   | integer            |
| 数据块 | param         | string(base64 encoded) | string             |


#### 电子运单上报 `"msg_id": 1793` 0x0701

| Field        | JSON Key name | Value Type             | Value Type in JSON |
|:------------:|:-------------:|:----------------------:|:------------------:|
| 电子运单长度 | length        | dword                  | integer            |
| 电子运单内容 | data          | string(base64 encoded) | string             |


#### 上报驾驶员身份信息请求 `"msg_id": 34562` 0x8702

空 JSON


#### 驾驶员身份信息采集上报 `"msg_id": 1794` 0x0702

##### JT/T 808-2013

| Field          | JSON Key name | Value Type | Value Type in JSON |
|:--------------:|:-------------:|:----------:|:------------------:|
| 状态           | status        | byte       | integer            |
| 时间           | time          | string     | string             |
| IC 卡读取结果  | ic_result     | byte       | integer            |
| 驾驶员姓名     | driver_name   | string     | string             |
| 从业资格证编码 | certificate   | string     | string             |
| 发证机构名称   | organization  | string     | string             |
| 证件有效期     | cert_expiry   | string     | string             |

##### JT/T 808-2019 新增字段

| Field          | JSON Key name | Value Type | Value Type in JSON |
|:--------------:|:-------------:|:----------:|:------------------:|
| 驾驶员身份证号 | id_card       | string     | string             |

**注意**：2019 版本新增驾驶员身份证号字段。


#### 定位数据批量上传 `"msg_id": 1796` 0x0704

| Field          | JSON Key name | Value Type | Value Type in JSON |
|:--------------:|:-------------:|:----------:|:------------------:|
| 位置数据类型   | type          | byte       | integer            |
| 数据项个数     | length        | word       | integer            |
| 位置汇报数据项 | location      | list       | list of location   |


#### CAN 总线数据上传 `"msg_id": 1797` 0x0705

| Field                | JSON Key name | Value Type | Value Type in JSON     |
|:--------------------:|:-------------:|:----------:|:----------------------:|
| 数据项个数           | length        | word       | integer                |
| CAN 总线数据接收时间 | time          | bcd(5)     | integer                |
| CAN 总线数据项       | can_data      | list       | list of can data.      |
| CAN 总线通道号       | channel       | 1 bit      | integer                |
| 帧类型               | frame_type    | 1 bit      | integer                |
| 数据采集方式         | data_method   | 1 bit      | integer                |
| CAN 总线 ID          | id            | 29 bits    | integer                |
| CAN 数据             | data          | binary     | string(base64 encoded) |


#### 多媒体时间信息上传 `"msg_id": 2048` 0x0800

| Field          | JSON Key name | Value Type | Value Type in JSON |
|:--------------:|:-------------:|:----------:|:------------------:|
| 多媒体数据 ID  | id            | dword      | integer            |
| 多媒体类型     | type          | byte       | integer            |
| 多媒体编码格式 | format        | byte       | integer            |
| 事件项编码     | event         | byte       | integer            |
| 通道 ID        | channel       | byte       | integer            |


#### 多媒体数据上传 `"msg_id": 2049` 0x0801

| Field          | JSON Key name | Value Type | Value Type in JSON     |
|:--------------:|:-------------:|:----------:|:----------------------:|
| 多媒体 ID      | id            | dword      | integer                |
| 多媒体类型     | type          | byte       | integer                |
| 多媒体编码格式 | format        | byte       | integer                |
| 事件项编码     | event         | byte       | integer                |
| 通道 ID        | channel       | byte       | integer                |
| 位置信息汇报   | location      | byte(28)   | map                    |
| 多媒体数据包   | multimedia    | binary     | string(base64 encoded) |

#### 多媒体数据上传应答 `"msg_id": 34816` 0x8800

| Field          | JSON Key name | Value Type | Value Type in JSON |
|:--------------:|:-------------:|:----------:|:------------------:|
| 多媒体 ID      | mm_id         | dword      | integer            |
| 重传包总数     | length        | byte       | integer            |
| 重传包 ID 列表 | retx_ids      | list       | list of retry IDs  |


#### 摄像头立即拍摄命令 `"msg_id": 34817` 0x8801

| Field             | JSON Key name | Value Type | Value Type in JSON |
|:-----------------:|:-------------:|:----------:|:------------------:|
| 通道 ID           | channel_id    | byte       | integer            |
| 拍摄命令          | command       | word       | integer            |
| 拍照间隔/录像时间 | period        | word       | integer            |
| 保存标志          | save          | byte       | integer            |
| 分辨率            | resolution    | byte       | integer            |
| 图像/视频质量     | quality       | byte       | integer            |
| 亮度              | bright        | byte       | integer            |
| 对比度            | contrast      | byte       | integer            |
| 饱和度            | saturate      | byte       | integer            |
| 色度              | chromaticity  | byte       | integer            |

**注意**：2019 版本分辨率字段新增 0x00（最低质量压缩）和 0xFF（最高质量压缩）取值。


#### 摄像头立即拍摄应答 `"msg_id": 2053` 0x0805

| Field          | JSON Key name | Value Type     | Value Type in JSON |
|:--------------:|:-------------:|:--------------:|:------------------:|
| 应答流水号     | seq           | word           | integer            |
| 结果           | result        | byte           | integer            |
| 多媒体 ID 个数 | length        | word           | integer            |
| 多媒体 ID 列表 | ids           | byte(4*length) | integer            |


#### 存储多媒体数据检索 `"msg_id": 34818` 0x8802

| Field      | JSON Key name | Value Type | Value Type in JSON |
|:----------:|:-------------:|:----------:|:------------------:|
| 多媒体类型 |               | byte       |                    |
| 通道 ID    |               | byte       |                    |
| 事件项编码 |               | byte       |                    |
| 起始时间   |               | string     |                    |
| 结束时间   |               | string     |                    |


#### 存储多媒体数据检索应答 `"msg_id": 2050` 0x0802

##### JT/T 808-2013

| Field            | JSON Key name | Value Type | Value Type in JSON    |
|:----------------:|:-------------:|:----------:|:---------------------:|
| 应答流水号       | seq           | word       | integer               |
| 多媒体数据项总数 | length        | word       | integer               |
| 检索项           | result        | list       | list of search result |
| 多媒体 ID        | id            | dword      | integer               |
| 多媒体类型       | type          | byte       | integer               |
| 通道 ID          | channel       | byte       | integer               |
| 事件项编码       | event         | byte       | integer               |
| 位置信息汇报     | location      | byte(28)   | map                   |

##### JT/T 808-2019

| Field            | JSON Key name | Value Type | Value Type in JSON    |
|:----------------:|:-------------:|:----------:|:---------------------:|
| 应答流水号       | seq           | word       | integer               |
| 多媒体数据项总数 | length        | word       | integer               |
| 检索项           | result        | list       | list of search result |
| 多媒体 ID        | id            | dword      | integer               |
| 多媒体类型       | type          | byte       | integer               |
| 通道 ID          | channel       | byte       | integer               |
| 事件项编码       | event         | byte       | integer               |
| 位置信息汇报     | location      | variable   | map                   |

**注意**：2019 版本位置信息汇报消息体由固定 28 字节改为可变长度。


#### 存储多媒体数据上传命令 `"msg_id": 34819` 0x8803

| Field      | JSON Key name | Value Type | Value Type in JSON |
|:----------:|:-------------:|:----------:|:------------------:|
| 多媒体类型 | type          | byte       | integer            |
| 通道 ID    | channel       | byte       | integer            |
| 事件项编码 | event         | byte       | integer            |
| 起始时间   | start_time    | string     | string             |
| 结束时间   | end_time      | string     | string             |
| 删除标志   | delete        | byte       | integer            |


#### 录音开始命令 `"msg_id": 34820` 0x8804

| Field      | JSON Key name | Value Type | Value Type in JSON |
|:----------:|:-------------:|:----------:|:------------------:|
| 录音命令   | command       | byte       | integer            |
| 录音时间   | time          | word       | integer            |
| 保存标志   | save          | byte       | integer            |
| 音频采样率 | rate          | byte       | integer            |


#### 单条存储多媒体数据检索上传命令 `"msg_id": 34821` 0x8805

| Field     | JSON Key name | Value Type | Value Type in JSON |
|:---------:|:-------------:|:----------:|:------------------:|
| 多媒体 ID | id            | dword      | integer            |
| 删除标志  | flag          | byte       | integer            |


#### 数据下行透传 `"msg_id": 35072` 0x8900

| Field        | JSON Key name | Value Type | Value Type in JSON     |
|:------------:|:-------------:|:----------:|:----------------------:|
| 透传消息类型 | type          | byte       | integer                |
| 透传消息内容 | data          | binary     | string(base64 encoded) |


#### 数据上行透传 `"msg_id": 2304` 0x0900

| Field        | JSON Key name | Value Type | Value Type in JSON     |
|:------------:|:-------------:|:----------:|:----------------------:|
| 透传消息类型 | type          | byte       | integer                |
| 透传消息内容 | data          | binary     | string(base64 encoded) |


#### 数据压缩上报 `"msg_id": 2305` 0x0901

| Field        | JSON Key name | Value Type | Value Type in JSON     |
|:------------:|:-------------:|:----------:|:----------------------:|
| 压缩消息长度 | length        | dword      | integer                |
| 压缩消息体   | data          | binary     | string(base64 encoded) |


#### 平台 RSA 公钥 `"msg_id": 35328` 0x8A00

| Field | JSON Key name | Value Type | Value Type in JSON     |
|:-----:|:-------------:|:----------:|:----------------------:|
| e     | e             | dword      | integer                |
| n     | n             | byte(128)  | string(base64 encoded) |


#### 终端 RSA 公钥 `"msg_id": 2560` 0x0A00

| Field | JSON Key name | Value Type | Value Type in JSON     |
|:-----:|:-------------:|:----------:|:----------------------:|
| e     | e             | dword      | integer                |
| n     | n             | byte(128)  | string(base64 encoded) |


#### 保留 0x8F00 ~ 0x8FFF

#### 保留 0x0F00 ~ 0x0FFF

#### 厂商自定义上行消息 0xE000 ~ 0xEFFF (2019 新增)

厂商自定义消息，消息体格式由厂商定义。

#### 厂商自定义下行消息 0xF000 ~ 0xFFFF (2019 新增)

厂商自定义消息，消息体格式由厂商定义。