GPS车载系统接口协议.doc

GPS车载系统接口协议声 明本文件所有权和解释权归谷度计算机科技有限公司所有，未经书面许可，不得复制或向第三方公开。修订历史记录版本日期AMD修订者说明V0.12010-4-6A张耀良初稿V0.22010-4-24M陈晓聪（A-添加，M-修改，D-删除）1概述41.1、文档内容41.2、连接方式41.3、报文协议详述51.3.1、TCP/IP报文结构51.3.2、TCP/IP协议说明61.3.3、短信报文结构61.3.4、短信协议说明71.4、接口协议例子72.业务定义82.1、终端器基本(10000)接口定义82.1.1、终端验证（10000）82.1.2、终端停机（10001）92.1.3、重启终端（10001）102.1.2、终端初始化以及初始化信息修改（10002）102.2、防盗器（20000）接口定义122.2.1、后台服务器与终端对防盗器状态数据交互协议、（20001）终端开机后回送是否连接防盗器。、（20002）指挥防盗器上锁，防盗器的遥控不能解锁。、（20003）指挥防盗器上锁，防盗器的遥控可以解锁。、（20004）指挥防盗器解锁，并且清除所有警戒状态(包括取消断油断电)。、（20005）指挥防盗器断油断电，遥控器不能解除、（20006）防盗器主动上送终端162.3、GPS定位数据(30000)接口定义172.3.1、GPS定位信息（30008）172.4、后台服务器与短信平台数据交互(40000)接口定义182.4.1、短信平台向后台服务器请求操作终端信息（40001）182.5、短信平台与用户短信交互接口定义192.5.1、防盗191 概述1.1、文档内容本文档将最终作为GPS车载系统和客服系统之间的接口协议。1.2、连接方式根据业务逻辑来划分，客服系统的接口进程是客户端，GPS车载系统的接口进程是服务端。GPS车载系统的接口进程提供一个或多个监听端口。客服系统主动发起连接请求，并负责断连后的重连。(常连接)客服通讯接口进程可以向GPS车载系统接口进程的一个或者多个监听端口建立一条或者多条连接，这些连接可以采用负荷分担的方式，也可以根据不同的业务报文走不同的连接。而且客服系统可以支持向多个GPS车载系统的通讯接口进程建立连接。客服系统的接口通讯进程既可以采用负荷分担的方式和多个GPS车载系统接口进程通讯，也可以根据不同的业务报文走不同的GPS车载系统接口进程。（这些实现必须GPS车载系统的接口进程要支持）。在实际应用中，GPS车载系统的接口进程可以采用上面所述方式中的一种。譬如：在实际应用中，自动业务的请求报文，对于应答时间要求比较严格，但是查询的结果数据集不多，一条应答报文就可以实现。而人工业务的某些查询请求，可能有许多的应答包，这些应答包在传输时会占用连接资源。所以一般将较短的请求，应答报文和较大的请求，应答报文分别走不同的连接，可以提高系统的响应速度。客服系统和GPS车载系统之间交换数据可以通过网络来传输和短信方式：1、网络传输协议采用TCP/IP协议，双方的通讯进程在TCP协议之上采用SOCKET方式建立一条或者多条TCP连接。客服系统向GPS车载系统建立TCP连接之后，双方就采用该连接进行数据交换，该连接由客服系统来维护，当发生网络故障造成断连后，客服系统会自动重连。客服系统通过某个TCP连接向GPS车载系统发送请求报文后，只要有新的请求报文，都可以使用该TCP连接发送出去(非阻塞方式)。这种方式可以充分利用TCP连接资源，一般建立一个TCP连接即可。网络字节顺序：由于在数据交换时，会涉及到不同主机硬件，而字节顺序的处理可能不一致。所以对于通讯报文采用统一的字节顺序即网络字节顺序。注意字节顺序只对存储空间超过一个字节的类型有意义，对于字符串以及单字节整型数是无所谓的。字节对齐方式：由于不同的编译器其默认的字节对齐方式是不同的，为保证统一，要求都按照单字节对齐的方式设定编译开关。最大包长：客服系统只能支持一个包最大1K的长度，所以所有的协议报文不能超过1K。对于客服的任何一个请求，若GPS车载系统端的返回内容小于等于1K，则GPS车载系统端必须将所有返回内容（可能包含多条记录）放到一个包中返回；若GPS车载系统端的返回内容超过1K，则GPS车载系统需要将返回内容划分为多个包返回，且除最后一个返回包（可能包含多条记录）之外，其余所有的返回包（可能包含多条记录）必须在不切断单条记录的前提下尽可能达到1K。2、短信方式通过移动SP运营商，通过短信端口发送到客服系统，短信信息采用的是以字符串形式发送数据。GPS车载系统以短信方式发送报文后，只要有新的请求报文，都可以通过移动运营商提供的短信端口和协议以POST方式发送出去。由于短信发送的报文，是一个整体地发送字符，不需要指定包的总长度大小。最大包长：由于短信发送最多能发送140个字符（注：70个中文字符，由于中文字符占用两个字节），所以所有的协议报文不能超过140个字符。对于客服的任何一个请求，若GPS车载系统端的返回内容小于等于140个字符，则GPS车载系统端必须将所有返回内容（可能包含多条记录）放到一个包中返回；若GPS车载系统端的返回内容超过140个字符，则GPS车载系统需要将返回内容划分为多个包返回，且除最后一个返回包（可能包含多条记录）之外，其余所有的返回包（可能包含多条记录）必须在不切断单条记录的前提下尽可能达到140个字符。1.3、报文协议详述1.3.1、TCP/IP报文结构TCP/IP报文结构分为两部分，包头和包体：1) 包头占用12个字节，包控制信息：内容长度（字节）备注PK_LEN4包的总长度，为包控制信息和实际传送内容长度之和MORE_PK 1是否还有后续包 ,1有，0无（传输编码为十六进制： 0x01 0x00）CMD_ID5命令字,最大长度为5RESERVER11数据校验位，PK_LEN 为奇数时 为1，偶数是为0;判断奇，偶数为 PK_LEN % 2RESERVER21保留2保留日后扩展, 默认为0若要发送命令字为10001数据包，包体为空时： 00 00 00 0C包的总长度 00是否还有后续包 31 30 30 30 31命令字 00保留1 00保留2 2) 协议包结构内容长度（字节）备注HEADER_PK12包头控制信息，包的总长度，为包控制信息和实际传送内容长度之和LIST_PK不定长，长度=“包的总长度 12字节”。(包的总长度包含在包控制信息中)传送内容，从包控制信息后开始依次为数据内容，1.3.2、TCP/IP协议说明1包为变长，总长度由“包的总长度”域指定；2发送包和接受包都使用此结构；3根据连接的IP地址和端口号唯一识别一个客户端，判断将哪些数据包回送给哪个客户端连接；4“传送内容” 为实际发送或接收的数据内容，实际上为一个变长数组，数据内容依次向后放；5客服系统发送数据包内容： 参数1参数2参数3.参数n；6. 数据校验位为PK_LEN模2，得到是否为奇偶数，由于数据发送一般很少会出现 00 或 01。1.3.3、短信报文结构短信报文结构分为两部分，包头和包体：1) 包头占用6个字节，包控制信息：内容长度（字节）备注MORE_PK 1是否还有后续包 ,1有，0无（传输编码为十六进制： 031 0x30）CMD_ID5命令字,最大长度为5若要发送命令字为10001数据包，包体为空时： 1是否后续包10001命令字 2) 协议包结构内容长度（字节）备注HEADER_PK6包头控制信息，包的总长度，为包控制信息和实际传送内容长度之和LIST_PK不定长，长度=“包的总长度 6字节”。(包的总长度包含在包控制信息中)传送内容，从包控制信息后开始依次为数据内容，1.3.4、短信协议说明1包为变长，由于短信发送的报文，是一个整体地发送字符，不需要指定包的总长度大小。；2发送包和接受包都使用此结构；3根据连接的IP地址和端口号唯一识别一个客户端，判断将哪些数据包回送给哪个客户端连接；4“传送内容” 为实际发送或接收的数据内容，实际上为一个变长数组，数据内容依次向后放；5客服系统发送数据包内容： 参数1参数2参数3.参数n6. 数据校验位为PK_LEN模2，得到是否为奇偶数，由于数据发送一般很少会出现 00 或 01。1.4、接口协议例子1.4.1、后台服务器与终端接口协议终端验证（10000）1、功能详述：终端器每次通过TCP/IP连接服务器后，必须发送10000命令字进行验证。(类似身份验证。)2、命令字：100003、报文详述：发送报文：终端主动回送报文,服务器不需要发送报文回送报文：datatrans: terminalIDphoneNopassword描述：终端IDSIM手机号参数说明： 1)、terminalID /终端ID（六位字母或者数字）2)、phoneNo /终端GSM卡手机号码3）、password /验证密码,暂时只做简单验证，后期将使用MD5做验证。例子：123456AB135600866848888884、相关说明：1）、所有交易中，如果协议确认需要提供数据段的，则以记录分隔符分号 ”;” 结束，如：内容：数据段1；数据段2；数据段N；）1.4.2、后台服务器与短信平台接口协议1.5、名词解析1、后台服务器：后台交互的服务器。它一方面与终端通过TCP/IP相连接；另一方与短信平台连接。2、短信平台：一个与SP合作的平台，由我司根据项目的业务需求研发的通信子系统的一部分。3、终端：一个研发出来，指挥操作防盗器的车载OEM设备，设备自带了GSM模块和GPS模块。4、防盗器：安装在车辆上的防盗器。2. 后台服务器与终端接口定义注：发送报文：服务器向终端发送报文回送报文：终端向服务器发送报文2.1、终端器基本(10000)接口定义2.1.1、终端验证（10000）1、功能详述：终端器每次通过TCP/IP连接服务器后，必须发送10000命令字进行验证。(类似身份验证。)2、命令字：100003、报文详述：发送报文：终端主动回送报文,服务器不需要发送报文回送报文：datatrans: terminalIDphoneNopassword描述：终端IDSIM手机号验证密码参数说明： 1)、terminalID /终端ID（六位字母或者数字）2)、phoneNo /终端GSM卡手机号码3）、password /验证密码,暂时只做简单验证，后期将使用MD5做验证。例子：123456AB135600866848888884、相关说明：1）、所有交易中，如果协议确认需要提供数据段的，则以记录分隔符分号 ”;” 结束，如：内容：数据段1；数据段2；数据段N；）2.1.2、终端停机（10001）1、功能详述：终端器停机。2、命令字：100013、报文详述：发送报文：datatrans: nCodesType参数说明：nCode=11/11表示停机sType ： 1/申请停机，系统关闭，等待所有业务完成， 2/强制停机，强制关闭，不等待所有业务完成，直接退出例子：111112回送报文：datatrans： ret参数说明： ret=0/表示成功ret=111/表示失败例子：04、相关说明：1）、所有交易中，如果协议确认需要提供数据段的，则以记录分隔符分号 ”;” 结束，如：内容：数据段1；数据段2；数据段N；）2）、申请停机：用于客户主动申请3）、强制停机：当操作员发现有资料不符时做强制停机操作2.1.3、重启终端（10001）1、功能详述：终端器停机。2、命令字：100013、报文详述：发送报文：datatrans: nCodesType参数说明：nCode=12 /12 表示重启终端sType ： 1/申请重启终端 2/强制重启终端例子：121 122回送报文：datatrans： ret参数说明： ret=0/表示成功ret=111/表示失败例子：04、相关说明：1）、所有交易中，如果协议确认需要提供数据段的，则以记录分隔符分号 ”;” 结束，如：内容：数据段1；数据段2；数据段N；）2）、申请停机：用于客户主动申请3）、强制停机：当操作员发现有资料不符时做强制停机操作2.1.2、终端初始化以及初始化信息修改（10002）1、功能详述：终端初始化以及修改。2、命令字：100023、报文详述：发送报文：datatrans:terminalIDphoneNopasswordServerNoReserveNonTypenAddressnPortnFrequency描述：终端ID终端GSM卡号码终端密码服务器号码备用号码监听类型域名或IP端口GPS发送频率参数说明： 1)、terminalID /终端ID2)、phoneNo /当前终端GSM卡的手机号码，进行初始化设定。3）、password/终端密码。终端连接服务器的需要发送给服务器做终端验证。4)、ServerNo/设定服务器号码与终端对应5)、ReserveNo/设定备用号码与终端对应。当服务器无法连接的时候，此号码也可做终端验证使用。6)、nType/监听类型。 0：表示监听ip 1：表示监听域名7)、nAddress/监听 域名或者IP8)、nPort/监听的端口9)、nFrequency /GPS定位数据发送频率。如：/10秒每次；/15秒每次；/20秒每次；/1分钟每次；/5分钟每次。/30分钟每次。例子：12345AB13560086684888888135600866841356008668400580001512345AB13560086684888888135600866841356008668418000152.2、防盗器（20000）接口定义描述：后台服务器接收用户指令，指挥终端对防盗器进行操作，如开启车门，上锁车门等。防盗器上传命令nType：防盗器上传命令字终端和服务器nType描 述11H0上锁状态。 回复上位机指令 或 遥控操作时主动发送。12H1静音上锁状态。回复上位机指令 或 遥控操作时主动发送。21H2解锁状态。 回复上位机指令 或 遥控操作时主动发送。3AH3断油断电状态。回复上位机指令。44H4执行上位机指令失败！（服务器主动请求）61H5震动报警。报警时主动发送。52H6非法开门报警。报警时主动发送。51H7非法点火报警。报警时主动发送。81H8应答上位机的握手指令(7AH)。（服务器主动请求）2.2.1、（20001）终端开机后回送是否连接防盗器。1、功能详述：开机后上位发送，以确定是否连接防盗器。在这里，终端在开机后应主动发送当前防盗器的状态到服务器。2、命令字：200013、报文详述：发送报文：终端主动回送报文,服务器不需要发送报文回送报文：datatrans: sType描述：防盗器状态参数说明：防盗器状态:sType: 0 /上锁状态 11H：1 /静音上锁状态 12H: 2 /解锁状态 21H例子：0124、相关说明：1）、所有交易中，如果协议确认需要提供数据段的，如：内容：数据段1；数据段2；数据段N；）2.2.2、（20002）指挥防盗器上锁，防盗器的遥控不能解锁。1、功能详述：指挥防盗器上锁，防盗器的遥控不能解锁。2、命令字：200023、报文详述：发送报文：内容:无参数说明：无 回送报文：datatrans: sType描述：防盗器状态参数说明：防盗器状态:sType: 0 /上锁状态 11H：1 /静音上锁状态 12H: 4 /执行上位机指令失败 44H例子：0144、相关说明：1）、所有交易中，如果协议确认需要提供数据段的，则以记录分隔符分号 ”;” 结束，如：内容：数据段1；数据段2；数据段N；）2.2.3、（20003）指挥防盗器上锁，防盗器的遥控可以解锁。1、功能详述：指挥防盗器上锁，防盗器的遥控可以解锁。2、命令字：200033、报文详述：发送报文：内容:无参数说明：无 回送报文：datatrans: sType描述：防盗器状态参数说明：防盗器状态: 0 /上锁状态 11H：1 /静音上锁状态 12H: 4 /执行上位机指令失败 44H例子： 0144、相关说明：1）、所有交易中，如果协议确认需要提供数据段的，则以记录分隔符分号 ”;” 结束，如：内容：数据段1；数据段2；数据段N；）2.2.4、（20004）指挥防盗器解锁，并且清除所有警戒状态(包括取消断油断电)。1、功能详述：指挥防盗器解锁，并且清除所有警戒状态(包括取消断油断电)到服务器。(本指令相当于对防盗器进行复位)。2、命令字：200043、报文详述：发送报文：内容:无参数说明：无 回送报文：datatrans: sType描述：防盗器状态参数说明：防盗器状态: 2 /解锁状态 21H: 4 /执行上位机指令失败 44H例子： 244、相关说明：1）、所有交易中，如果协议确认需要提供数据段的，则以记录分隔符分号 ”;” 结束，如：内容：数据段1；数据段2；数据段N；）2.2.5、（20005）指挥防盗器断油断电，遥控器不能解除 1、功能详述：指挥防盗器断油断电，遥控器不能解除。2、命令字：200053、报文详述：发送报文：内容:无参数说明：无 回送报文：datatrans: sType描述：防盗器状态参数说明：防盗器状态:sType: 3 /断油断电状态 3AH: 4 /执行上位机指令失败 44H例子： 344、相关说明：1）、所有交易中，如果协议确认需要提供数据段的，则以记录分隔符分号 ”;” 结束，如：内容：数据段1；数据段2；数据段N；）2.2.6、（20006）防盗器主动上送终端1、功能详述：防盗器主动上送终端。2、命令字：200063、报文详述：发送报文：终端主动回送,不需要发送报文。回送报文：datatrans: sType描述：防盗器状态参数说明：防盗器状态: 0 /上锁状态 11H: 1 /静音上锁状态 12H: 2 /解锁状态 21H：3 /断油断电状态。3AH: 5 /震动报警 61H: 6 /非法开门报警 52H: 7 /非法点火报警 51H例子： 12.4、相关说明：1）、所有交易中，如果协议确认需要提供数据段的，则以记录分隔符分号 ”;” 结束，如：内容：数据段1；数据段2；数据段N；）2.3、GPS定位(30000)接口定义2.3.1、GPS定位信息（30008）1、功能详述：终端按照固定频率发送GPS定位数据到服务器。2、命令字：300083、报文详述：发送报文：终端主动回送,不需要发送报文。回送报文：datatrans:LatitudeLongitudePosTimeSpeedMoveDirectIsEnabledCapacityGSMSignalGPSSignalSatellite描述：纬度经度定位时间速度行驶方向有效性电瓶电量GSM信号强度GPS信号强度卫星数；参数说明： 1）、Latitude/纬度。纬度区分，北半球（N）或南半球（S）。如：S23.12273958392422）、Longitude/经度。经度区分，东（E）半球或西（W）半球。如; N113.2608032226563）、PosTime/定位时间。标准定位时间（UTC time）格式：时时分分秒秒.秒秒秒（hhmmss.sss）。如：2010-04-24 12:27:384）、Speed/相对位移速度。如：1051.8。单位：海里小时。范围：0.0 至 1851.8 knots5）、MoveDirect/相对位移方向。 如：300。 单位：度。 范围：000.0 至 359.9度6）、IsEnabled/当前定位数据是否有效（A-有效；V-无效）。7）、Capacity/当前终端电量(电瓶电量)。单位：V 如：12V（小车）；24V（货车）8）、GSMSignal /GSM信号强度（RPRS）。；如：29。范围：min0max31；99=无效，链接失败（ 15连接GPRS就比较弱）9）、GPSSignal /GPS信号强度（信噪比/讯噪比）。讯号噪声比（C/No）。如：85dB; 无表未接收到讯号。（收到卫星信号的平均值。）范围：00 至 99。单位：dB10）、Satellite/天空中收到讯号的卫星总数。如：3。范围：020。单位：颗例子：S23.1227395839242N113.2608032226562010-04-24 12:27:381051.860A5029701