设备终端接入协议1-JTEXT

JTEXT-车载终端扩展协议版本号修订日期修订内容修订人备注V1.02015.02.19创建LyV1.12015.03.02目前支持9种报文LyV1.22015.04.28按照2013版JTT808修改透传内容LyJTEXT-车载终端扩展协议 11 说明 22 接入流程 23 消息类型 24 消息流 34.1 设备注册 34.2 设备注销 44.3 登录鉴权 44.4 保持心跳 54.5 上报数据点 54.6 查询数据流最新值 64.7 设备间数据透传上行 74.8 设备间数据透传下行 8

说明基于《道路运输车辆卫星定位系统北斗兼容车载终端通信协议规范.pdf》实现扩展功能。消息头中的终端手机号，最长12位，若使用专网卡，则填入卡号后12位。协议中未使用字段，请使用0x00填充。接入流程Onenet门户/注册用户，设置页面查看用户ID；通过设备管理页面或调用API接口添加设备，只需填写title和activate_code两个域，其中title为任意自定义字符串，activate_code包括两个域："activate_code":{ "mt":"A",//终端型号，自定义，长度不超过19个字节 "mid":"2CX31B",//终端ID，自定义，长度不超过6字节 }设备出厂第一次登录，发送激活码进行注册，注册成功后平台下发授权码，设备需要持久化存储授权码；后续登录，设备利用授权信息进行登录认证。平台服务器地址2，TCP端口4362，UDP端口4363消息类型支持如下JTT808消息类型:消息ID消息体名称格式定义（见T808）0x0001终端通用应答8.10x8001平台通用应答8.20x0002终端心跳8.30x0100终端注册8.40x8100终端注册应答8.50x0101终端注销8.60x0102终端鉴权8.70x8900数据下行透传8.490x0900数据上行透传8.50扩展消息:JTT808消息ID透传消息类型说明0x09000xF0设备上报数据点到平台进行存储0xF2设备查询本设备上指定数据流最新值0xF4设备透传自定义数据到另外的设备或业务平台0x89000xF3平台返回查询的数据流最新值0xF5设备接收来自某个设备或平台透传的自定义数据消息流设备注册该流程只在终端出厂后第一次上电时执行，且只执行一次，根据激活码，注册获取授权信息。消息流程图3.1 终端注册消息，携带信息（即，激活信息）包括：制造商ID：填写设备云注册用户后得到的用户ID的整型值（非ASCII码），占5个字节，例如用户ID10021，则该字段需要编码为：0x0000002725（而非0x3130303231）；终端型号：填写在设备云注册设备时，填写激活码的mt部分，ASCII码，最多20字节，不足在后面补0x00；终端ID：填写在设备云注册设备时，填写激活码的mid部分，ASCII码，最多7字节，不足在后面补0x00；终端注册消息中的其他未使用字段填0x00。 若注册成功，平台在应答消息中将下发授权码，设备持久化保存授权码，之后的登录，需要使用该授权码进行登录鉴权。设备注销该流程重置设备于非激活状态，不能用于普通的登出。登录鉴权设备注册后每次在与平台建立连接后，应立即进行鉴权。鉴权成功前终端不得发送其它消息。平台响应平台通用应答消息。（注：同一次连接中，注册后不用在发送登录鉴权）。保持心跳在没有数据发送时，若需保持连接，设备应每隔30秒主动向平台发送心跳，平台立即回复通用应答消息。上报数据点利用数据上行透传消息（ID：0x0900）上报数据点，每次只能上报一种数据点，该消息消息体格式：起始字节字段数据类型描述及要求0透传消息类型BYTE固定值0xF01数据点类型BYTE1：json数据;2：二进制数据2数据点内容BYTE[]有两种数据点，见后面表格描述 有两种数据点，封装方法：A普通json数据点，内容格式：Json包长度DWORD描述json长度(小于1M)Json数据点数组BYTE[][{”ds_id”:”image”,//数据流ID，（必填）“at”:”2014-10-2512:23:23”,//时间，（可选）”value”://数字，字符串，object}]B二进制数据点，每次传递一个二进制数据点，内容格式：Json包长度WORD描述json长度(小于4K)二进制数据json描述BYTE[]{”ds_id”:”image”,//数据流ID，（必填）“at”:”2014-10-2512:23:23”,//时间，（可选）”desc”:字符串或json对象//对后二进制数据的描述（可选）}二进制数据长度DWORD用户二进制数据总大小（小于1M）二进制数据BYTE[]用户需要保存的二进制数据内容消息流程：查询数据流最新值利用JTT808数据上行透传消息（ID：0x0900）查询该设备上报的某个数据流最新值，消息体格式：起始字节字段数据类型描述及要求0透传消息类型BYTE固定值0xF21数据流ID长度WORD本条消息的长度（数据流ID1长度）3数据流ID字符串BYTE[]需要查询的数据流ID字符串查询数据流最新响应平台收到请求后，利用JTT808数据下行透传消息（ID：0x8900）按照顺序返回每个数据流的当前值，消息体格式：起始字节字段数据类型描述及要求0透传消息类型BYTE固定值0xF35Json长度DWORD后面json数据结构长度7查询结果json内容BYTE[]{”ds_id”:”temperature”,//数据流ID“at”:”2014-10-2512:23:23”,//时间”value”:22.4//数字，字符串，object}消息流程：设备间数据透传上行利用JTT808数据上行透传消息（ID：0x0900），将用户自定义的数据，传递给某个设备。消息体格式：起始字节字段数据类型描述及要求0透传消息类型BYTE固定值0xF41目的地址长度WORD本条消息的长度3目的设备IDBYTE[]添加设备时平台分配的设备ID3+m透传数据长度DWORD上行透传数据长度(小于64K)3+4+m透传数据BYTE[]用户透传数据平台收到数据后，回复通用应答消息。设备间数据透传下行利用JTT808数据下行透传消息（ID：0x8900）