ONENET设备终端接入协议JTEXT

1、JTEXT-车载终端扩展协议版本号修订日期修订内容修订人备注V1.02015.02.19创建LyV1.12015.03.02目前支持9种报文LyV1.22015.04.28按照2013版JTT808修改透传内容LyV1.32015.12.17新增上报自定义格式数据点和上报位置信息V1.42016.06.03删除上报位置信息，修改设备间数据透传上行消息中的透传数据长度字段类型lxV1.52016.06.24新增上报位置信息JTEXT-车载终端扩展协议11 说明22 接入流程23 消息类型24 消息流34.1 设备注册34.2 设备注销44.3 登录鉴权44.4 保持心跳54.5 上报数据点54.

2、6 上报自定义格式数据点64.7 查询数据流最新值64.8 查询数据流最新响应74.9 上报设备位置信息71说明基于道路运输车辆卫星定位系统北斗兼容车载终端通信协议规范.pdf实现扩展功能。消息头中的终端手机号，最长12位，若使用专网卡，则填入卡号后12位。协议中未使用字段，请使用0x00填充。2接入流程2.1 Onenet门户2.2 通过设备管理页面或调用API接口添加设备，只需填写title和activate_code两个域，其中title为任意自定义字符串，activate_code包括两个域："activate_code":"mt":"

3、A",/终端型号，自定义，长度不超过19个字节"mid":"2CX31B",终端ID,自定义，长度不超过6字节2.3 设备出厂第一次登录，发送激活码进行注册，注册成功后平台下发授权码，设备需要持久化存储授权码；2.4 后续登录，设备利用授权信息进行登录认证。平台服务器地址183.230.40.42,TCP端口4362,UD嘲口43633消息类型支持如下JTT808消息类型：消息ID消息体名称格式定义（见T808）0x0001终端通用应答8.10x8001平台通用应答8.20x0002终端心跳8.30x0100终端注册8.40x8100终端注册应

4、答8.50x0101终端注销8.60x0102终端鉴权8.70x8900数据下行透传8.490x0900数据上行透传8.50扩展消息：JTT808消息ID；透传消息类型说明0x09000xF0设备上报数据点到平台进行存储0xF2设备查询本设备上指定数据流最新值0xF4r设备透传自定义数据到另外的设备或业务平台0x89000xF3平台返回查询的数据流最新值0xF5设备接收来自某个设备或平台透传的自定义数据4消息流4.1 设备注册该流程只在终端出厂后第一次上电时执行，且只执行一次，根据激活码，注册获取授权信息。平台消息流程图3.1终端注册消息，携带信息（即，激活信息）包括：制造商ID:填写设备云新

5、建项目后得到的项目ID的整型值（非ASCII码），占5个字节，例如用户ID10021,则该字段需要编码为：0x0000002725（而非0x3130303231）;终端型号：填写在设备云注册设备时，填写激活码的mt部分，ASCII码，最多20字节，不足在后面补0x00;终端ID：填写在设备云注册设备时，填写激活码的mid部分，ASCII码，最多7字节，不足在后面补0x00;终端注册消息中的其他未使用字段填0x00。若注册成功，平台在应答消息中将下发授权码，设备持久化保存授权码，之后的登录，需要使用该授权码进行登录鉴权。4.2 设备注销该流程重置设备于非激活状态，不能用于普通的登出。4.3 登录

6、鉴权设备注册后每次在与平台建立连接后，应立即进行鉴权。鉴权成功前终端不得发送其它消息。平台响应平台通用应答消息。（注：同一次连接中，注册后不用在发送登录鉴权）。4.4 保持心跳在没有数据发送时，若需保持连接，设备应每隔30秒主动向平台发送心跳，平台立即回复通用应答消息。4.5 上报数据点利用数据上行透传消息（ID:0x0900）上报数据点，每次只能上报一种数据点，该消息消息体格式：起始字节字段数据类型描述及要求0透传消息类型BYTE固定值0xF01数据点类型BYTE1:json数据；2：二进制数据2数据点内容BYTE有两种数据点，见后面表格描述有两种数据点，封装方法:A普通json数据点，内容

7、格式:Json包长度DWORD描述json长度（小于1M）Json数据点数组BYTE"ds_id":"image”,数据流ID,（必填）at":“2014-10-2512:23:23H时间，（可选）"value":/数字,字符串,objectB二进制数据点，每次传递一个二进制数据点，内容格式:Json包长度WORD描述json长度（小于4K）二进制数据json描述BYTE"ds_id":"image”,数据流ID,（必填）况”:“2014-10-2512:23:23",/时间，（可选）“desc

8、”:字符串或json对象对后二进制数据的描述（可选）二进制数据长度DWORD用户二进制数据总大小（小于1M）二进制数据BYTE用户需要保存的二进制数据内容消息流程:4.6 上报自定义格式数据点利用数据上行透传消息（ID:0x0900）上报数据点，该消息消息体格式:起始字节字段数据类型描述及要求0透传消息类型BYTE固定值0xF91自定义格式类型WORD3自定义数据点BYTE4.7 查询数据流最新值利用JTT808数据上行透传消息（ID:0x0900）查询该设备上报的某个数据流最新值,消息体格式：起始字节字段数据类型描述及要求0透传消息类型BYTE固定值0xF21数据流ID长度WORD本条消息的长度（数据流ID1长度）3数据流ID字符串BYTE需要查询的数据流ID字符串4.8 查询数据流最新响应平台收到请求后，利用JTT808数据下行透传消息(ID:0x8900)按照顺序返回每个数据流的当前值，消息体格式：起始字节字段数据类型描述及要求0透传消息类型BYTE固定值0xF35Json长度DWORD后面json数据结构长度7查询结果json内容BYTE"ds_id”'temperature",数据流IDat":“2014-10-2512:23:23”,时间"value”:22.4数字，字符串，object)消息流程:设备*j1数据上行透