参考协议(TCPIP)-数据访问协议V10.docVIP

LBMP GPS数据访问协议 V1.0 2006-8-1  更改履历 版本号 更改时间 更改的 图表或章节号 状态 更改简要描述 更改人 批准人 2006-8-1 N 注：状态可以为N-新建、A-增加、M-更改、D-删除。 目 录 1. 文档介绍 4 1.1 文档目的与背景 4 1.2 文档范围 4 1.3 参考文献 4 1.4 术语与缩写解释 4 2. 概述 4 3. 协议数据包组成 5 3.1 数据类型定义 5 3.2 Ga数据包定义 6 4. 命令字定义 7 5. 协议数据包定义 7 5.1 bind 7 5.2 bind_resp 8 5.3 unbind 8 5.4 unbind_resp 8 5.5 query_gps_info 8 5.6 qgi_resp 9 5.7 put_gps_info 10 5.8 pgi_resp 11 5.9 active_test 11 5.10 active_test_resp 11 6. 状态码定义 11  文档介绍 文档目的与背景 文档范围 参考文献编号 资料名称 作者 日期 单位 术语与缩写解释 缩写、术语 解 释 Gt GPS terminal，GPS终端协议 Ga GPS data access，GPS数据访问协议 概述 业务系统基于TCP/IP网络与LBMP平台连接通信，LBMP平台做为server端提供GPS数据访问服务，业务系统为client端，连接到LBMP平台后交换GPS数据。业务系统连接过程需要鉴权，通信支持异步模式，采用长连接，长时间无数据交换时需要进行连接检测，数据流图如下： 协议数据包组成 数据类型定义 类型 说明 ASCII整数 以ASCII码串表示的整数，例如：整数123表示为 0x31 0x32 0x33，即 ”123”。对于定长要求但不足位数的前补’0’，例如：整数64用4字节ASCII整数表示为 0x30 0x30 0x36 0x34，即 ”0064” ASCII字符串 ASCII码表示的字符串，对于定长要求但不足位数的后补空格（0x20），例如：手机号用16字节ASCII字符串表示为0x31 0x33 0x38 0x31 0x32 0x33 0x34 0x35 0x36 0x37 0x38 0x20 0x20 0x20 0x20 0x20，即 ” ASCII小数 以ASCII码串表示的小数，对于定长要求但不足位数的小数点后补’0’，例如：23.46用8字节ASCII小数表示为 “23.46000”，-123表示为 ”-123.000” Ga数据包定义 Ga数据包 Ga数据包头 Ga数据包体 见下文描述 见下文描述 Ga数据包头定义如下： Ga数据包头 数据包长度 命令字 状态码 序列号 4字节ASCII整数 4字节ASCII整数，定义该数据包进行的操作 4字节ASCII整数 4字节ASCII整数 数据包长度： 定义整个Ga数据包的字节长度，包含自身，最大支持9999。 状态码： 在请求包中必须为“0000”，应答包中表示应答状态。“0000”表示成功，其它表示处理失败，具体原因参见第6章状态码定义。 序列号： 标识一个Ga数据包，0-9999循环使用，由通信发起方维护，通信过程中应答包中的序列号与对应请求包相同，可以用于匹配请求-应答对。 命令字定义 命令字为4字节ASCII整数，最大范围为0000-9999，头字节用于整体区分数据包，目前定义两种取值，具体如下： 头字节值 含义 0 定义命令请求包，一般用于业务系统向LBMP平台查询或推送GPS数据 1 命令请求包的应答包，与0对应，后3字节的值与命令请求包相同，表示对该命令请求包的应答 命令值的后三个字节用于表示具体的命令，取值范围为001-999，000用于其它目的，具体命令字列表如下： 命令 数值 发起方 描述 bind 0001 业务系统 业务系统向LBMP申请连接鉴权 bind_resp 1001 LBMP bind命令应答 unbind 0002 业务系统 业务系统向LBMP申请中断连接 unbind_resp 1002 LBMP unbind命令的应答 query_gps_info 0010 业务系统 查询GPS信息 qgi_resp 1010 LBMP query_gps_inf