乐高易车联网网关中间件使用手册
广西乐高易网络有限公司
www.legaoyi.com
修订日期：2024年2月20日
目录
1.引用标准............................................................................................................................3
2.系统架构............................................................................................................................3
3.消息定义............................................................................................................................3
3.1 数据交换方式.....................................................................................................................3
3.2 数据交换队列/主题...........................................................................................................3
3.3 数据交换消息类型.............................................................................................................3
3.4 位置信息汇报0x0200........................................................................................................3
3.5 上传基本信息指令0x0900................................................................................................8
3.6 报警附件信息消息0x1210..............................................................................................10
3.7 文件信息上传0x1211......................................................................................................11
3.8 文件上传完成消息0x1212..............................................................................................12
3.9 设置终端参数0x8103......................................................................................................13
3.10 基本信息查询指令0x8900............................................................................................14
3.11 报警附件上传指令0x9208............................................................................................15
3.12 文件上传完成消息应答0x9212....................................................................................16
4.二次开发..........................................................................................................................17
4.1 告警附件上传...................................................................................................................17
4.2 其他...................................................................................................................................18
乐高易软件 乐高易车联网网关中间件 技术支持：78772895（QQ）
1.引用标准
JT/T808-2011《道路运输车辆卫星定位系统终端通信协议及数据格式》
JT/T-808-2013《道路运输车辆卫星定位系统北斗兼容车载终端通信协议技术规范》
JT/T-1078-2016《道路运输车辆卫星定位系统车载视频通信协议》
T/JSATL12-2017《道路运输车辆主动安全智能防控系统（通讯协议规范）》（江苏省团体标准）
2.系统架构
参考《乐高易车联网网关中间件使用手册(JT1078-2016)》文档对应章节。
3.消息定义
3.1 数据交换方式
参考《乐高易车联网网关中间件使用手册(JT1078-2016)》文档对应章节。
3.2 数据交换队列/主题
参考《乐高易车联网网关中间件使用手册(JT1078-2016)》文档对应章节。
3.3 数据交换消息类型
参考《乐高易车联网网关中间件使用手册(JT1078-2016)》文档对应章节。
3.4 位置信息汇报0x0200
消息概述
(1)消息名称：位置信息汇报
(2)消息Id：0x0200
(3)消息方向：车载终端设备->车联网网关->业务平台
(4)业务逻辑：苏标对808协议的0200消息进行了扩展，其中扩展部分字段见以下描述（原有的808协议字段仍然保持不变）。
消息体定义
乐高易软件 乐高易车联网网关中间件 技术支持：78772895（QQ）
字段名
类型
描述
adasAlarm
Map
高级驾驶辅助系统报警信息
dsmAlarm
Map
驾驶员状态监测系统报警信息
tpmAlarm
Map
胎压监测系统报警信息
bsdAlarm
Map
盲区监测系统报警信息
adasAlarm高级驾驶辅助系统报警信息
alarmId
Long
报警 ID
flag
Int
标志状态
0x00：不可用
0x01：开始标志
0x02：结束标志
该字段仅适用于有开始和结束标志类型的报警或事件，报警类型或事件类型无开始和结束标志，则该位不可用，填入 0x00 即可。
type
Int
报警/事件类型
0x01：前向碰撞报警
0x02：车道偏离报警
0x03：车距过近报警
0x04：行人碰撞报警
0x05：频繁变道报警
0x06：道路标识超限报警
0x07：障碍物报警
0x08~0x0F：用户自定义
0x10：道路标志识别事件
0x11：主动抓拍事件
0x12~0x1F：用户自定义
level
Int
报警级别
0x01：一级报警
0x02：二级报警
frontSpeed
Int
前车车速
单位 Km/h。范围 0~250，仅报警类型为 0x01 和 0x02 时有效。
frontDistance
Int
前车/行人距离
单位 100ms，范围 0~100，仅报警类型为 0x01、0x02 和0x04 时有效。
deviationType
Int
偏离类型
0x01：左侧偏离
0x02：右侧偏离
仅报警类型为 0x02 时有效
roadSignType
Int
道路标志识别类型
0x01：限速标志
0x02：限高标志
0x03：限重标志
仅报警类型为 0x06 和 0x10 时有效
roadSignData
Int
道路标志识别数据
speed
Int
车速
altitude
Int
高程
lat
Double
纬度
乐高易软件 乐高易车联网网关中间件 技术支持：78772895（QQ）
lng
Double
经度
time
String
日期时间
state
Int
车辆状态
terminalId
String
报警标识号-终端ID
alarmTime
String
报警标识号-时间
alarmSeq
Int
报警标识号-序号
totalFile
Int
报警标识号-附件数量
alarmExt
Int
报警标识号-预留
dsmAlarm驾驶员状态监测系统报警信息
alarmId
Long
报警 ID
flag
Int
标志状态
0x00：不可用
0x01：开始标志
0x02：结束标志
该字段仅适用于有开始和结束标志类型的报警或事件，报警类型或事件类型无开始和结束标志，则该位不可用，填入 0x00 即可
type
Int
报警/事件类型
0x01:疲劳驾驶报警
0x02:接打电话报警
0x03:抽烟报警
0x04:分神驾驶报警
0x05:驾驶员异常报警
0x06~0x0F：用户自定义
0x10：自动抓拍事件
0x11：驾驶员变更事件
0x12~0x1F：用户自定义
level
Int
报警级别
0x01：一级报警
0x02：二级报警
fatigueDegree
Int
疲劳程度
范围 1~10。数值越大表示疲劳程度越严重，仅在报警类型为 0x01 时有效
ext
Int
预留
speed
Int
车速
altitude
Int
高程
lat
Double
纬度
lng
Double
经度
time
String
日期时间
state
Int
车辆状态
terminalId
String
报警标识号-终端ID
alarmTime
String
报警标识号-时间
alarmSeq
Int
报警标识号-序号
totalFile
Int
报警标识号-附件数量
alarmExt
Int
报警标识号-预留
alarmId
Long
报警 ID
乐高易软件 乐高易车联网网关中间件 技术支持：78772895（QQ）
tpmAlarm胎压监测系统报警信息
alarmId
Long
报警 ID
flag
Int
标志状态
0x00：不可用
0x01：开始标志
0x02：结束标志
该字段仅适用于有开始和结束标志类型的报警或事件，报警类型或事件类型无开始和结束标志，则该位不可用，填入 0x00 即可
speed
Int
车速
altitude
Int
高程
lat
Double
纬度
lng
Double
经度
time
String
日期时间
state
Int
车辆状态，
见协议文档表 5-9
terminalId
String
报警标识号-终端ID
alarmTime
String
报警标识号-时间
alarmSeq
Int
报警标识号-序号
totalFile
Int
报警标识号-附件数量
alarmExt
Int
报警标识号-预留
alarmList
List
胎压监测系统报警/事件信息列表
alarmList.seq
Int
报警轮胎位置编号（从左前轮开始以 Z 字形从 00 依次编号，编号与是否安装 TPMS 无关）
alarmList.type
Int
报警/事件类型
0 表示无报警，1 表示有报警
bit0：胎压（定时上报）
bit1：胎压过高报警
bit2：胎压过低报警
bit3：胎温过高报警
bit4：传感器异常报警
bit5：胎压不平衡报警
bit6：慢漏气报警
bit7：电池电量低报警
bit8~bit15：自定义
alarmList.pressure
Int
胎压，单位 Kpa
alarmList.temperature
Int
胎温，单位 ℃
alarmList.electricity
Int
电池电量，单位 %
bsdAlarm盲区监测系统报警信息
alarmId
Long
报警 ID
乐高易软件 乐高易车联网网关中间件 技术支持：78772895（QQ）
flag
Int
标志状态
0x00：不可用
0x01：开始标志
0x02：结束标志
该字段仅适用于有开始和结束标志类型的报警或事件，报警类型或事件类型无开始和结束标志，则该位不可用，填入 0x00 即可
type
Int
报警/事件类型
0x01：后方接近报警
0x02：左侧后方接近报警
0x03：右侧后方接近报警
speed
Int
车速
altitude
Int
高程
lat
Double
纬度
lng
Double
经度
time
String
日期时间
state
Int
车辆状态
terminalId
String
报警标识号-终端ID
alarmTime
String
报警标识号-时间
alarmSeq
Int
报警标识号-序号
totalFile
Int
报警标识号-附件数量
alarmExt
Int
报警标识号-预留
消息示例
{ "exchangeId":"36", "messageId":"0000", "gatewayId":"elink-iov-message-gateway", "message":{ "messageHeader":{ "messageId":"0200", "messageSeq":323, "protocol":"jt808", "protocolVersion":"tjsatl_2017", "deviceSn":"013100000000" }, "messageBody":{ "":" ……（808协议0200其他字段）", "bsdAlarm":{ "alarmId":1, "":"其他字段" }, "tpmAlarm":{ "alarmId":1, "":"其他字段"
乐高易软件 乐高易车联网网关中间件 技术支持：78772895（QQ）
}, "dsmAlarm":{ "alarmId":1, "":"其他字段" }, "adasAlarm":{ "alarmId":1, "":"其他字段" } } }, "createTime":1540915278102, "dataLength":80}
3.5 上传基本信息指令0x0900
消息概述
(1)消息名称：上传基本信息指令
(2)消息Id：0x0900
(3)消息方向：车载终端设备->车联网网关->业务平台
(4)业务逻辑：终端接收到业务平台下发的“8900”消息后，立即上传该消息应答业务平台。业务平台接收到该消息之后，可根据自身业务进行处理。
消息体定义
字段名
类型
描述
type
Int
透传消息类型,
状态查询: 0xF7,外设状态信息：外设工作状态、设备报警信息;
信息查询:0xF8,外设传感器的基本信息：公司信息、 产品代码、 版本号、 外设 ID、 客户代码
messageList
list
extDeviceId
Int
外设ID
state
Int
外设工作状态
0x01：正常工作
0x02：待机状态
0x03：升级维护
0x04：设备异常
0x10：断开连接
乐高易软件 乐高易车联网网关中间件 技术支持：78772895（QQ）
alarm
long
报警状态
按位设置：0 表示无，1 表示有
bit0：摄像头异常
bit1：主存储器异常
bit2：辅存储器异常
bit3：红外补光异常
bit4：扬声器异常
bit5：电池异常
bit6~bit9：预留
bit10：通讯模块异常
bit11：定位模块异常
bit12~bit31：预留
enterpriseName
string
公司名称
productType
string
产品型号
hardwareVersion
string
硬件版本号
softwareVersion
string
软件版本号
deviceId
string
设备ID
clientCode
string
客户代码
消息示例
{ "exchangeId":"36", "messageId":"0000", "message":{ "messageHeader":{ "protocol":"jt808", "protocolVersion":"tjsatl_2017", "deviceSn":"013100000002", "messageId":"0900", "messageSeq":7 }, "messageBody":{ "type":0xf7, "messageList":[ { "extDeviceId":0x64, "state":1, "alarm":30202 } ] } }}
乐高易软件 乐高易车联网网关中间件 技术支持：78772895（QQ）
3.6 报警附件信息消息0x1210
消息概述
(1)消息名称：报警附件信息消息
(2)消息Id：0x1210
(3)消息方向：车载终端设备->车联网网关->业务平台
(4)业务逻辑：终端根据附件上传指令连接附件服务器，并向服务器发送报警附件信息消息，业务平台一般不必处理，做保存数据库即可。
消息体定义
字段名
类型
描述
terminalId
String
报警标识号,终端ID
alarmTime
String
报警标识号,时间
alarmSeq
Int
报警标识号,序号
alarmExt
Int
报警标识号,预留
totalFile
int
报警标识号,附件数量
alarmId
String
报警编号
type
int
信息类型
0x00：正常报警文件信息
0x01：补传报警文件信息
fileList
附件信息列表
fileList.name
String
附件名称，<文件类型>_<通道号>_<报警类型>_<序号>_<报警编号>.<后缀名>
fileList.size
Long
附件大小，单位：字节
消息示例
{ "exchangeId":"36", "messageId":"0000", "message":{ "messageHeader":{ "protocol":"jt808", "protocolVersion":"tjsatl_2017", "deviceSn":"013100000002", "messageId":"0900", "messageSeq":7 }, "messageBody":{ "terminalId":"1000000", "alarmTime":"2010-11-01 09:00:00", "alarmSeq":20, "alarmExt":10,
乐高易软件 乐高易车联网网关中间件 技术支持：78772895（QQ）
"totalFile":1, "alarmId":"123456000000", "type":20, "fileList":[ { "name":"00_1_64_2_1073560748069879809.png", "size":100022 } ] } }}
3.7 文件信息上传0x1211
消息概述
(1)消息名称：文件信息上传
(2)消息Id：0x1211
(3)消息方向：车载终端设备->车联网网关->业务平台
(4)业务逻辑：终端向附件服务器发送报警附件信息指令并得到应答后，向附件服务器发送附件文件信息消息，业务平台一般不必处理，做保存数据库即可。
消息体定义
字段名
类型
描述
fileName
String
文件名称，<文件类型>_<通道号>_<报警类型>_<序号>_<报警编号>.<后缀名>
fileType
int
文件类型
0x00：图片
0x01：音频
0x02：视频
0x03：文本
0x04：其它
fileSize
long
文件大小，单位：字节
消息示例
{ "exchangeId":"36", "messageId":"0000", "message":{ "messageHeader":{ "protocol":"jt808", "protocolVersion":"tjsatl_2017", "deviceSn":"013100000002",
乐高易软件 乐高易车联网网关中间件 技术支持：78772895（QQ）
"messageId":"1211", "messageSeq":7 }, "messageBody":{ "fileName":"02_1_64_1_1073560748069879809.h264", "fileType":2, "fileSize":504583 } }}
3.8 文件上传完成消息0x1212
消息概述
(1)消息名称：文件上传完成通知
(2)消息Id：0x1212
(3)消息方向：车载终端设备->车联网网关->业务平台
(4)业务逻辑：终端向附件服务器完成一个文件数据发送时，向附件服务器发送文件发送完成消息。业务平台接收到该消息之后，根据自身的业务需求对附件进行处理，如附件上传ftp，关联告警信息等。
消息体定义
字段名
类型
描述
fileName
String
文件名称，<文件类型>_<通道号>_<报警类型>_<序号>_<报警编号>.<后缀名>
fileType
int
文件类型
0x00：图片
0x01：音频
0x02：视频
0x03：文本
0x04：其它
fileSize
long
文件大小，单位：字节
filePath
String
文件存放在服务器的本地路径
消息示例
{ "exchangeId":"36", "messageId":"0000", "message":{ "messageHeader":{ "protocol":"jt808", "protocolVersion":"tjsatl_2017", "deviceSn":"013100000002",
乐高易软件 乐高易车联网网关中间件 技术支持：78772895（QQ）
"messageId":"1212", "messageSeq":7 }, "messageBody":{ "fileName":"02_1_64_1_1073560748069879809.mp4", "fileType":2, "fileSize":504583, "filePath":"/data/013100000004/20230210110713_02_1_64_1_1073560748069879809.mp4" } }}
3.9 设置终端参数0x8103
消息概述
(1)消息名称：设置终端参数
(2)消息Id：0x8103
(3)消息方向：业务平台->车联网网关->车载终端设备
(4)业务逻辑：平台通过发送设置终端参数消息设置终端音视频相关的参数，终端回复终端通用应答消息。苏标协议对808协议进行了扩展，具体可参考协议文档。
消息体定义
字段名
类型
描述
paramList
Object
参数项列表，key/val键值对，key对应参数id，参考协议表中的定义，如F364；val为要设置的终端参数的值的十六进制字符串的组合，参数值之间用逗号“,”分隔
消息示例
{ "exchangeId":"36", "messageId":"8000", "message":{ "messageHeader":{ "protocol":"jt808", "protocolVersion":"tjsatl_2017", "deviceSn":"013100000002", "messageId":"8103", "messageSeq":7 }, "messageBody":{
乐高易软件 乐高易车联网网关中间件 技术支持：78772895（QQ）
"paramList":{ "F364":"1e,6,ff,3c,c8,3,2,ff,ff,10fff,3,0,1e,32,5,3,2,3c,5,32,5,3,2,32,5,3,2,1b,32,5,3,2,1e,32,5,3,2,a,32,5,3,2,3,0,2" } } }}
3.10 基本信息查询指令0x8900
消息概述
(1)消息名称：基本信息查询指令
(2)消息Id：0x8900
(3)消息方向：业务平台->车联网网关->车载终端设备
(4)业务逻辑：基本信息查询指令，平台通过向车载终端设备发送该指令，车载终端应答0900消息上传终端当前基本信息。
消息体定义
字段名
类型
描述
type
Int
透传类型
idList
List
Id列表
消息示例
{ "exchangeId":"2c9299d466679ce60166bf97b06f0012", "messageId":"8000", "message":{ "messageHeader":{ "messageSeq":178, "messageId":"8900", "simCode":"013400000000" }, "messageBody":{ "type":0xF7, "idList":[ 0x64, 0x65 ] } }}
乐高易软件 乐高易车联网网关中间件 技术支持：78772895（QQ）
3.11 报警附件上传指令0x9208
消息概述
(1)消息名称：报警附件上传指令
(2)消息Id：0x9208
(3)消息方向：业务平台->车联网网关->车载终端设备
(4)业务逻辑：业务平台接收到带有附件的报警/事件信息的位置信息后，根据业务需要向终端下发附件上传指令。该指令由业务平台根据位置信息的告警判断是否需要上传附件。
消息体定义
字段名
类型
描述
ip
String
附件服务器 IP地址
tcpPort
int
附件服务器端口tcp端口号
udpPort
int
附件服务器端口udp端口号
terminalId
String
报警标识号,终端ID
alarmTime
String
报警标识号,时间
alarmSeq
Int
报警标识号,序号
alarmExt
Int
报警标识号,预留
totalFile
int
报警标识号,附件数量
alarmId
String
报警编号
消息示例
{ "exchangeId":"36", "messageId":"8000", "message":{ "messageHeader":{ "protocol":"jt808", "protocolVersion":"tjsatl_2017", "deviceSn":"013100000002", "messageId":"9208", "messageSeq":7 }, "messageBody":{ "tcpPort":6031, "totalFile":4, "alarmExt":15, "ip":"127.0.0.1", "alarmTime":1675998427000, "alarmId":"1073560748069879809", "terminalId":"1234567", "alarmSeq":69
乐高易软件 乐高易车联网网关中间件 技术支持：78772895（QQ）
} }}
3.12 文件上传完成消息应答0x9212
消息概述
(1)消息名称：文件上传完成消息应答
(2)消息Id：0x9212
(3)消息方向：业务平台->车联网网关->车载终端设备
(4)业务逻辑：附件服务器收到终端上报的文件发送完成消息时，向终端发送文件上传完成消息应答。该消息由网关自动发送，业务平台不需要关注该消息
消息体定义
字段名
类型
描述
fileName
int
文件名称
fileType
int
文件类型
result
int
上传结果
0x00：完成
0x01：需要补传
packageList
List
补传数据包列表
消息示例
{ "exchangeId":"36", "messageId":"8000", "message":{ "messageHeader":{ "protocol":"jt808", "protocolVersion":"tjsatl_2017", "deviceSn":"013100000002", "messageId":"9212", "messageSeq":7 }, "messageBody":{ "fileName":"02_1_64_1_1073560748069879809.mp4", "fileType":1, "result":0 } }}
乐高易软件 乐高易车联网网关中间件 技术支持：78772895（QQ）
4.二次开发
4.1 告警附件上传
苏标ADAS、DSM告警一般都会包含告警附件，对于告警产生的附件，业务平台根据自身的业务是否需要车载设备把告警附件上传至指定的附件服务器。具体的业务流程如下图：
1、 业务平台对接收到的位置信息数据进行数据检查，若发现位置信息中存在告警附件，则向消息网关中间件发布“9208消息”，通知车载设备上传告警附件至指定的苏标附件消息网关中间件中；
2、 消息网关中间件对接收到“9208消息”进行编码之后，下发给车载设备；
3、 车载设备接收到“9028 消息”后，连接消息中指定的苏标附件消息网关中间件，把向苏标附件消息网关中间件发送“1210消息”；
4、 苏标附件消息网关中间件经过解码“1210消息”转换成json消息，并发布给业务平台；
5、 业务平台接收到“1210消息”，需要对消息中的设备ID进行校验，并把校验结果通过
乐高易软件 乐高易车联网网关中间件 技术支持：78772895（QQ）
“8102消息”发布给苏标附件消息网关中间件（注：苏标附件消息网关中间件会把该消息当作鉴权消息，模拟设备上线流程，避免受到非法设备的恶意流量攻击）；
6、 苏标附件消息网关中间件根据“8102消息”应答结果，向车载设备发送“8001消息”通知车载设备是否可以上传附件；
7、 车载设备向业务平台发送“1211消息”，告知平台即将要上传的附件信息；
8、 苏标附件消息网关中间件接收到“1211消息”后，应答“8001消息”通知车载设备可以上传附件；
9、 车载设备向苏标附件消息网关中间件发送附件数据；
10、 苏标附件消息网关中间件接收附件数据并缓存；
11、 车载设备完成附件数据上传之后，向苏标附件消息网关中间件发送“1212消息”，通知苏标附件消息网关中间件附件数据已上传完毕；
12、 苏标附件消息网关中间件对附件数据进行校验无丢包之后，应答“9212消息”并且组装附件数据到指定目录的下的文件中，最后向业务平台发布“1212消息”告知上传完成一个附件；
13、 业务平台接收到“1212消息”之后，根据自身的业务需求处理附件，如是否需要对附件中的音视频进行转码，是否需要把附件上传ftp等
14、 车载设备收到“9212消息”后，继续上传其他告警附件，直至所有的附件都上传完毕。
4.2 其他
参考《乐高易车联网网关中间件使用手册(JT1078-2016)》文档对应章节。