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

本页定义了 emqx_jt808 和 EMQX 之间数据交换的格式。

约定:

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

JSON 结构示例 ​

终端到服务器 ​

{
  "header" : {
    "msg_id" : 1,
    "encrypt": 0,
    "len": VAL,
    "phone": 13900000000,
    "msg_sn": 0
  },
  "body": {
    "seq": 1,
    "id": 1,
    "result": 0
  }
}

服务器到终端 ​

{
  "header": {
    "msg_id": 32769,
    "encrypt": 0,
    "phone": 13900000000,
    "msg_sn": 0
  },
  "body": {
    "seq": 1,
    "id": 1,
    "result": 0
  }
}

数据类型对照表 ​

字段对照表 ​

消息头字段对照表 ​

• 存在 frag_total 与 frag_sn 时表示消息体为长消息，进行分包处理

消息体字段对照表 ​

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

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

终端心跳 "msg_id": 2 0x0002 ​

空 JSON

补传分包请求 "msg_id": 32771 0x8003 ​

终端注册 "msg_id": 256 0x0100 ​

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

只有成功后才有此字段

终端注销 "msg_id": 3 0x0003 ​

空 JSON

终端鉴权 "msg_id": 258 0x0102 ​

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

参数 ID 说明见协议规定。

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

空 JSON

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

参数 ID 列表中元素为 integer

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

参数 ID 说明见协议规定.

终端控制 "msg_id": 33029 0x8105 ​

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

空 JSON

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

• 终端硬件版本号长度、终端固件版本号长度，将被用于二进制报文解析，不向上暴露

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

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

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

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

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

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

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

• IO 状态位, 置于 map io_status 内

• 模拟量, 置于 map analog 内

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

• 信号状态, 置于 map signal 内

示例:

{
  "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 ​

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

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

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

事件设置 "msg_id": 33537 0x8301 ​

事件报告 "msg_id": 769 0x0301 ​

提问下发 "msg_id": 33538 0x8302 ​

提问应答 "msg_id": 770 0x0302 ​

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

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

信息服务 "msg_id": 33540 0x8304 ​

电话回拨 "msg_id": 33792 0x8400 ​

设置电话本 "msg_id": 33793 0x8401 ​

联系人项示例

[{"type": TYPE, "phone_len", PH_LEN, "phone": PHONE, "name_len": NAME_LEN, "name": NAME}, ...]

车辆控制 "msg_id": 34048 0x8500 ​

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

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

区域列表示例

[{"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
   },
  ...
 ]

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

[ID1, ID2, ...]

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

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

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

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

设置路线 "msg_id": 34310 0x8606 ​

删除路线 "msg_id": 34311 0x8607 ​

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

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

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

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

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

空 JSON

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

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

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

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

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

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

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

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

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

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

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

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

单条存储多媒体j叔叔检索上传命令 "msg_id": 34821 0x8805 ​

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

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

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

平台 RSA 公钥 "msg_id": 35328 0x8A00 ​

终端 RSA 公钥 "msg_id": 2560 0x0A00 ​

保留 0x8F00 ~ 0x8FFF ​

保留 0x0F00 ~ 0x0FFF ​