接口介绍
接口地址
JT/T808设备接入地址为:jtt808.ctwing.cn,接入端口为6001。
(1)消息格式
包含标识位(0x7e)、消息头、消息体、校验码、标识位五部分。需要对0x7e、0x7d进行转义。转义规则为:0x7e ---> 0x7d02 0x7d ---> 0x7d01
1byte | 12或16byte | n byte | 1byte | 1byte |
标识位(0x7e) | 消息头 | 消息体 | 检验码 | 标识位(0x7e) |
(2)消息头
如果报文有分包,则每包消息头长度为16字节;不分包,则消息头长度为12字节。平台解码消息体属性中的分包标记判断是否有分包。消息头格式定义如下:
起始字节 | 字段 | 数据类型 | 描述 |
0 | 消息ID | WORD | |
2 | 消息体属性 | WORD | 结构图见下图 |
4 | 终端手机号 | BCD[6] | 不足12位则在前补0 |
10 | 消息流水号 | WORD | 从0开始循环累加 |
12 | 消息包封装项 | 不分包,则无该选项 |
消息头属性的定义:
消息包封装项定义:
起始字节 | 字段 | 数据类型 | 描述 |
0 | 消息总包数 | WORD | 消息分包后总包数 |
2 | 包序号 | WORD | 从1开始 |
(3)消息体
平台对以下消息的消息体进行解析:
序号 | 消息体名称 | 消息ID |
1 | 终端通用应答 | 0x0001 |
2 | 平台通用应答 | 0x8001 |
3 | 终端注册 | 0x0100 |
4 | 终端注册应答 | 0x8100 |
5 | 终端鉴权 | 0x0102 |
6 | 终端心跳 | 0x0002 |
7 | 终端注销 | 0x0003 |
8 | 数据上行透传 | 0x0900 |
9 | 数据下行透传 | 0x8900 |
其余消息类型,消息体透传,平台不做解析。
终端通用应答(消息ID:0x0001)消息体格式:
起始字节 | 字段 | 数据类型 | 描述 |
0 | 应答流水号 | WORD | 对应的平台消息的流水号 |
2 | 应答ID | WORD | 对应的平台消息的ID |
4 | 结果 | BYTE | 0:成功/确认;1:失败;2:消息有误;3:不支持 |
平台通用应答(消息ID:0x8001)消息体格式:
起始字节 | 字段 | 数据类型 | 描述 |
0 | 应答流水号 | WORD | 对应的终端消息的流水号 |
2 | 应答ID | WORD | 对应的终端消息的ID |
4 | 结果 | BYTE | 0:成功/确认;1:失败;2:消息有误;3:不支持;4:报警处理确认 |
(4)校验码
校验码指从消息头第一个字节开始,同后一字节异或,直到校验码前最后一个字节,最终得到的异或结果。校验码占用一个字节。