ONENET设备终端接入协议1.docx

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.6 上报自定义格式数据点 64.7 查询数据流最新值 64.8 查询数据流最新响应 74.9 上报设备位置信息 71 说明基于《道路运输车辆卫星定位系统北斗兼容车载终端通信协议规范pdf》实现扩展功能 消息头中的终端号，最长12 位，若使用专网卡，则填入卡号后12位协议中未使用字段，请使用0x00填充2 接入流程2.1 Onenet门户 通过设备管理页面或调用API接口添加设备，只需填写title和activate_code两 个域，其中title为任意自定义字符串，activate_code包括两个域："activate_code":{"mt"："A1,//终端型号，自定义，长度不超过19个字节 "mid":"2CX31B",〃终端ID,自定义，长度不超过6字节 }2.3 设备出厂第一次登录，发送激活码进行注册，注册成功后平台下发授权码，设备 需要持久化存储授权码；2.4 后续登录，设备利用授权信息进行登录认证。

平台服务器地址 183.230.40.42, TCP 端口 4362, UDP 端口 43633 消息类型支持如下 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设备接收来自某个设备或平台透传的自定义数据4 消息流4.1 设备注册该流程只在终端出厂后第一次上电时执行，且只执行一次，根据激活码，注册获取授权 信息终端注册消息（携带激活信息）终端注册应答消息携带授权信息）消息流程图 3.1终端注册消息，携带信息（即，激活信息）包括：制造商ID：填写设备云新建项目后得到的项目ID的整型值（非ASCII码），占5个字节， 例如用户ID10021,则该字段需要编码为：0x0000002725 （而非0x3130303231）； 终端型号：填写在设备云注册设备时，填写激活码的mt部分，ASCII码，最多20字节，不 足在后面补 0x00；终端ID：填写在设备云注册设备时，填写激活码的mid部分，ASCII码，最多7字节，不 足在后面补 0x00；终端注册消息中的其他未使用字段填0x00。

若注册成功，平台在应答消息中将下发授权码，设备持久化保存授权码，之后的登录 需要使用该授权码进行登录鉴权4.2 设备注销该流程重置设备于非激活状态，不能用于普通的登出4.3 登录鉴权设备注册后每次在与平台建立连接后，应立即进行鉴权鉴权成功前终端不得发送其它 消息平台响应平台通用应答消息注：同一次连接中，注册后不用在发送登录鉴权）4.4 保持心跳在没有数据发送时，若需保持连接，设备应每隔30 秒主动向平台发送心跳，平台立即 回复通用应答消息4.5 上报数据点利用数据上行透传消息（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-25 12:23:23”, 〃时间,（可选） "value”: 〃数字，字符串 ‘object}]B 二进制数据点，每次传递一个二进制数据点，内容格式：Json包长度WORD描述json长度（小于4K）二进制数据json描述BYTE[]{”ds id”:”image”, 〃数据流ID，（必填）"at”:”2014-10-25 12:23:23”, 〃时间,（可选）”desc”:字符串或json对象对后二进制数据的描述（可选 }二进制数据长 度DWORD用户二进制数据总大小（小于1M）二进制数据BYTE[]用户需要保存的二进制数据内容4.6 上报自定义格式数据点利用数据上行透传消息（ID： 0x0900）上报数据点，该消息消息体格式:起始字节字段数据类型描述及要求0透传消息类型BYTE固定值0xF91自定义格式类型WORD3自定义数据点BYTE[]4.7 查询数据流最新值利用JTT808数据上行透传消息（ID： 0x0900）查询该设备上报的某个数据流最新值,消息体格式：起始字节字段数据类型描述及要求0透传消息类型BYTE固定值0xF21数据流ID长度WORD本条消息的长度（数据流ID1长度）3数据流ID字符串BYTE[]需要查询的数据流ID字符串4.8 查询数据流最新响应设备数据上行透传消息 （透传消息类型0x82）数据下行透传消息 （透传消息类型0x83）平台收到请求后，利用JTT808数据下行透传消息（ID： 0x8900）按照顺序返回每个数据流的当前值，消息体格式：起始字节字段数据类型描述及要求0透传消息类型BYTE固定值0xF35Json长度DWORD后面json数据结构长度7查询结果json内 容BYTE[]{”ds_id”:”temperature”, 〃数据流ID "at”:”2014-10-25 12:23:23”, //时间 "value” :22.4//数字，字符串 ‘object }消息流程：4.9 上报设备位置信息利用JTT808位置信息汇报消息（ID: 0x0200），上报设备的位置信息。

平台收到后将设备的位 置信息存入LOCATION数据流注意：平台将以位置汇报信息中的时间作为数据点的时间。