马蹄锁808通信协议接口文档

智能手表、三基同创协议、马蹄锁808通信协，非常不错的学习接口文档　Nokelockwww.nokelock.com范围本标准规定了马蹄锁终端(以下简称终端)与监控平台(以下简称平台)之间的通讯协议与数据格式,包括协议基础、通讯连接、消息处理、协议分类与说明及数据格式。本标准适用于物联锁808协议终端和平台之间的通讯,2规范性引用文件《交通部808全套协议规范.pdf》3术语、定义和缩略语31术语和定义下列术语和定义适用于本文件3.1.1数据通讯链路异常 abnorma| data com munication|ink无线通讯链路断开,或暂时挂起(如通话过程中)3.1.2注册gister终端向平台发送消息告知其安装在某台车辆上3.1.3注销de终端向平台发送消息告知其从所安装车钠上卸下。3.1.4authentication终端连接上平台是向平台发送消息,以使平台验证自己身份3.1.5位置汇报策略 location reporting strategy定时汇报。32缩略语下列缩略语适用于本文件。PN—接入点名称( access point name)GZIP个GNU自由软件的文件压缩稈序 GNUZipLCD—液晶显示屏( Liquid Crystal Display)RSA种非对称密码算法SMS一短消息服务( short message service)TCP——传输控制协议( transmission control protocol)TTS—文本到语音( text to speech)Nokelockwww.nokelock.comUDP用户数据包协议( user datagram protocol)4协议基础41通信方式通讯协议采用TCP,平台作为服务尜端,终端作为客户端42数据类型协议消息中使用的数据类型见表1表数据类型数据类型描述及要求Byte无符号单字节整型(字节,8位Word无符号双字节整型(字,16位)DWord无符号四字节整型(双字,32位)Byte[n字节BCD8421码,n字节StringGBK编码,若无数据,置空4.3传输规则协议采用打端模式的网络字节序来传递字和双字。约定如下宇节(Byte)的传输约定:按照宇节沇的方式伎输。一一字(Word)的传输约定:先传高八位,冉传低八位。双字( DWord)的传输约定:先传递高24位,然后传递高16位,再传递高8位,最后传递低8位44消息的组成44.1消息结构每条信息由标识位、消息头、消息体、校验码组成。消息结构如图1表示。图1消息结构匚标识位消息头消息体校验码标识位44.2标识位釆用0κ7e表示,若校验码、消息头以及消息体中岀现0x7e,则要进行转义处理。转义处理定义如下OX7e7d后紧跟一个0x7d后紧跟一个0x0转移过程如下发送消息时:消息封装→计算并填充效验码→转义接收消息时:转乂还原→验证校验码→解析消息。Nokelockwww.nokelock.com示例发送一包数据为:0x300x7e0x080x7d0x55的数据包,则结果封装后如下:0x300x7d0x020x080x7d0x010x5544.3消息头消息头内容详见表2表2消息头内容剋始字节数据类型措述及要求消息、IDWord消息体属性Mord|消息体属性格式结构见图2终端手机号BCD6]默认设备编号(设备ID)10消息流水号Wrd按发送顺序从0开始环累加如果消息体属性中相关标识位确定消息分包处消息包封装项则该项有内容,否则无该项。消息体属性格式结构如图2所示图2消息体属性校式结构图15141312111098765332101保留分包数据加密方式消息体长度数据加密方式bit0bit12为数据加密标识位。当此三位都为0,表示消息体不加密。当第10位为1,表示消息体经过RSA算法加密。一其他保留。分包:当消息体属性中第13位为1时表示消息体为长消息,进行分包发送处理,具体分包信息由消息包封装项决定;若第13位为0,则消息头中无消息包封装项字段。消息包封装项内容见表3衣3消息包封装项内谷起始字节字段数据类型描述及要求0消息包总数Word该消息分包后的总包数包序号Word从1开始4.4.4校验码校验码指从消息头开始,同后·字节异或,直到效验码前·个宇节,占用·个字节。5通信连接1连接的建立终端与平台的数据日常连接采用TCP方式,终端复位后应尽快与平台建立连接,连接建Nokelockwww.nokelock.com立后立即向平台发送终端鉴权消息进行鉴权。5,2连接的维持连接建立和终端鉴权成功后,终端应周期性地向平台发送终端心跳消息,平台收到后向终端发送通用应答消息,发送周期由终端参数指定。5.3连接的断开平台和终端均可根据TCP协议主动断开连接,双方都应主动判断TCP连接是否断开。平台判断TCP连接断廾的方法:根据TCP协议判断出终端主动断开。相同身份的终端建立新连接,表面原连接已断开。在一定时间内未收到终端发出的消息,如终端心跳。终端判断TCP连接断开的方法:根据TCP协议判断出终端主动断丿—一数据通讯链路断开。数据通讯链路正常,达到重传次数后仍未收到应答6消息处理6.1TCP消息处理6.1.1平台主发的消息所有平台上发的消息均要求终端应答。应答分为通用应答和专门应答,由各具体功能协议决定。发送方等待应答超时后,应对消息进行重发。应答超时时间和重传次数由平台参数指定,每次重传后的应答超时时间的计算公式见式(1)7+=7kX(M(1式中:T—一每次重传后的应答超时时间7-一前一次的应答超时时间N重传次数6.1.2终端主发的消息6.1.2.1数据通讯链路止常数据通讯链路正常时,所有终端主发的消息均要求平台应答,应答分为通用应答和专门应答,由各具体功能协议决定。终端笭待应答超时后,应对消息进行重发。应答超时时间和重传次数由终端参数指定,每次重传后的应答超时时间按式(1)进行计算。对于终端发送的关键消息,若达到重传次数后仍未收到应答,则应对其进行保存。以后在发送其他消息前要先发送保存饿关键报警消息。6.1.2.2数据通讯链路异常数据通讯链路异常时,终端应对需要发送的位置信息汇报消息进行保存。在数据通信链路恢复正常后,立即发送保存的信息、。Nokelockwww.nokelock.com7协议分类与说明71概述以下按功能分类对协议进行描述。采用TCP通信方式。7.2终端管理类协议终端注册/注销终端在未注册状态下,应首先进行注册,注册成功后终端将获得鉴权码并进行保存,鉴杈码在终端登录时使用。车辆需要拆除或者更换终端前,终端应执行注销操作,取消终端和辆的应对关系。7.2.2终端鉴权终端注册后每次在于平台建立连接后,应立即进行鉴权。鉴权成功前终端不得发送其他消息。终端通过发送终端鉴权消息进行鉴权,平台回复平台通用应答消息。7.2.3改置/查询终端参数平台通过发送设置终端参数消息设置终端参数,终端回复终端通用应答消息。平台通过发送査询终端参数消息査询终端参数,终端回复査询终端参数应答消息。不同网络制式下的终端应支持各自网络的一些特有参数。7.3位置/报警协议7.3.1位置信息汇报终端根据参数设定周期性发送位置信息汇报消息。7.3.2终端报警终端判断满足报警条件时发送位置信息汇报消总,在位置汇报消息中设置相应的报警标志位,平台可通过回复平台通用应答消息进行报警处理。各报警类型见位置信息汇报消息体中的描述。7.4车辆控制类协议平台通过发送车钠控制消恳,要求终端按指定的操作对车辆进行控制。终端收到后立即回复终端通用应答消息。之后终端对车辆进行控制,根椐结果再叵复车辆控制应答消息8数据格式8.1终端通用应答消息ID:0×0001终端通用应答消息体数据格式见表4表4终端迸用应答消息体数据格式起始字节字段数据类型描述及要求应答流水号Wrd对应的平台消息的流水号Nokelockwww.nokelock.com应答Wrd对应的平台消息的1D0,成功/确认;1,尖败;2,消息有误:3,不结果Byte支持8.2平台通用应答消息ID:0x800平台通用消息体格式见表5表5平台通用应答消息体数据格式起始字节字段数据类型措述及要求应答流水号Word对应的终端消息的流水号2应答1word对应的终端消息的D结果0,成功/确认;1,失败;2,消息有误;3,不By te支持;4,报警处理确认8.3终端心跳消息ID:0x0002终端心跳数据消息体为空8.4终端注册消息ID:0x0100终端注册消息体数据格式见表6表6终端注册消息体数据格式起始字节」字段数据类型描述及要求标示终端安装车辆所在的省域。0保留,由省域⊥DWord平台取默认值。省域ID采用GB/T2260中规定的行政区域规划代码六位中前两位标示终端安装车辆所在的市和县域。0保市域 DWOrd留,由平台取默认值。市县ID采用GB/T2260中规定的行政区域规划代码六位中后四位4制造商1DBte155个字节,终端制造商代码终端型号BYTE[20]十个字节,此终端型号由制造商自行定义,位数不足时,后补“0X00”。rs蓝牙设备时,前6个字节放蓝牙WAC蓝牙mac地地址表小蓝牙物理地址(如17Byte L7A:B:C:D:E:F,传址0xaa,0xbb,Oxcc,0xd,0xee,0xff六个字节后补0x00)0x01表示纯gprs设备,0x02衣示gprs+监24锁类型Byte牙ble设备SIM卡的如 icsid是12345678901234567890就上传25BCD100x120x30x560x780x900x120x310X56cid号0x780x90)Nokelockwww.nokelock.com8.5终端注册应答消息ID:0x8100终端注册应答消息体数据格式见表7。表7终端注册应答消息体数据格式起始字节字段数据类型措述及要求应答流水号Word对于的终端注册消息的流水号0,成功/确认;1,车辆已注册;2,数据库中结果Byte无该车辆:3,终端已被注册:4,数据库中无该终端鉴杖码String只有在注册成功后才有该宇段8.6终端鉴权消息ID:0x0102终端鉴权消息体数据格式见表表8终端鉴权消息体数据格式起始字节字段数据类型措述及要求鉴权码tring终端重连后上报鉴权码8.7设置终端参数消息ID:0x8103设置终端参数消息体数据格式见衣9表9改置终端参数消息体薮据格式起始字节字段数据类型描述及要求参数总数Byte参数项列表参数项格式见衣10表10终端参数项数据格式字段数据类型描述及要求参数ID参数ID定义见表11参数长度Byte参数值表11终端参数设置各参数项定义及说明参数ID数据类型描述及要求0x0010 STRING主服务器APN003 STRING主服务器地址,P或域名0x0018DWORD服务器TCP端口0x0029DWORD缺省时间汇报间隔,单位为秒(s),用于设置锁为丌状态时的位置回传间隔。下发0XFEE并且锁是开的状态时,设备进入运输模式,只有手动关锁才会进入工作模Nokelockwww.nokelock.com式0x0027DWORD休眠时汇报时间间隔,单位为秒(s),>0,用」设置锁为关状态时的位置回传间隔8.8查询终端参数消息ID:0x8查询终端参数消息体为空。8.9查询终端参数应答消息ID:0x010A查询终端参数应答消息体数据格式见表12表12查询终端参数应答消息体数据格式起始字节字段数据类型描述及要求应答流水号Word对应的终端参数查询消息的流水号应答参数个数Byte参数项列表参数项格式见和第一表108.10查询终端属性消息ID:0x810查询终端属性消息体为空8.11査询终端属性应答消息ID:0x010查询终端属性应答消息体数据格式见表20。表20查询终端属性应答消息体数据格式起始字节字段数据类型描述及要求0终端类型Word保留制造商IDBYTE[5]终端制造商编码终端型号BYTE[20]20个字节,此终端型号由制造商自行定义,位数不足时,后补“0KX00”。gprs+蓝牙设备时,前6个字节放蓝牙MAC地址表示蓝牙物理地址(如蓝牙mac地址Byte7|A:B:CC:D:EF,传六个字节后补0x00)终端SIM卡BCD[10终端SIM卡 ICCID号⊥CCLD