项目需求说明书-终端部分v1.1.docVIP

GBLC R 终端部分 需 求 说 明 书 目录 1 第一部分 地理信息终端采集部分 4 1.1 概述 4 1.2 采集 4 1.2.1 实时采集 4 1.2.2 报告位置 5 1.2.3 调试要求 5 1.2.4 参数设置 6 1.2.5 UI功能要求 6 1.2.6 UI外观要求 6 1.2.7 扩展性要求 6 1.2.8 接口规范 6 1.3 登录签到 8 1.3.1 签到 8 1.4 在线升级 9 1.4.1 升级通知 9 1.4.2 查看版本号 9 1.5 画图 9 日期 版本 内容 1.0 采集、版本升级 1.1 签到 第一部分 地理信息终端采集部分 概述 通过终端模块将地理信息采集到指定系统。终端模块包括手机终端和自定义终端，平台包括andriod、ios和单片机。 采集 采集地理信息到指定服务器。 实时采集 将经纬度数据按一定频率通过socket发送到指定的服务器。为了能够节省流量，频率可以参数化设置。服务器地址在参数设置功能里设定。 Socket的报文格式如下： 服务名：00001 请求包包体 序号 字段名 字段长度 1 经度 20，不足右补空 2 纬度 20，不足右补空 应答无包体 报告位置 单击定位按钮后，页面显示采集到的经度和纬度数据，然后在文本框中输入详细地址，再点击发送按钮，经纬度数据就通过00002接口送到服务端。 Socket的报文格式如下： 服务名：00002 请求包包体 序号 字段名 字段长度 1 经度 20，不足右补空 2 纬度 20，不足右补空 3 详细地址 50，不足右补空格 正常情况应答无包体，异常情况包体返回异常错误信息 调试要求 终端采集功能可以看到调试信息，调试信息包括详细的输出信息，用于定位故障原因和非技术人员远程准确报告问题，或者能将异常信息通过按钮再设置目标号码后以短信方式提交异常报告。 参数设置 可以随时设置目标IP地址和端口，发送频率、开机自动起进程、自动打开网络。 UI功能要求 能简单区分出当前工作状态是异常还是正常。异常情况下，显示最早发生异常的时间。异常恢复后，后续如果再发生异常，最早发生异常的时间就随之变化。 能够从实时采集状态唤醒到报告位置的界面。 能够从报告位置的界面进入到实时采集。 能够从实时采集状态进入参数设置界面。 UI外观要求 界面设计美观，易用。 扩展性要求 UI界面功能要考虑扩展后期功能，如进入地图。 接口规范 采集和服务端的通信采用socket的通信方式。Socket通信报文分包头和包体两部分。包头字段和字段长度固定，包头字段数固定，包体字段数每个接口不同。包头和包体的字段都是定长。包头格式如下： 序号 字段名 字段长度 1 版本信息 2，可空 2 包长度 5，必填 3 流水号 20，可空 4 标志位 1，可空 5 服务类型 6，必填 6 业务号码 20，必填（可填IMSI） 7 号码类型 1，必填 8 采集点 6，可空 9 采集终端 8，必填（唯一编号） 10 包编号 5，必填 11 尾包标志 1，必填 12 错误码 5，必填 采集终端：通过签到后才获取唯一编号，签到数据包填写AAAAAAAA 尾包标志：0 不是最后一包 1 最后一包 错误码： 00000 正确 其他 表示异常 异常情况在包体中返回错误描述 连接方式：短连接方式。 每次发送前，先连接，发送完，关闭连接。 登录签到 签到 终端在开始采集或者报告位置前，先要向服务器进行签到。签到成功后，服务器返回终端对应的唯一编号。后续报告位置或者采集地理信息都要在包头发送该唯一编号。 签到的报文格式如下： 服务名：00003 请求包包体 序号 字段名 字段长度 1 账号或者车牌号码 10，不足右补空 2 密码 10，不足右补空 应答无包体 正常情况应答无包体，异常情况包体返回异常错误信息 包头中返回采集终端唯一编号和版本号。 在线升级 升级确认 每次登录签到完成后查询是否有可升级版本，如果有则开始进行在线升级。 确认升级的报文格式如下： 服务名：00004 请求包包体 序号 字段名 字段长度 3 版本号 5，不足右补空 版本号：软件版本号，从固定位置读取版本号 应答包包体 序号 字段名 字段长度 1 是否可升级 1，（0没有升级版本，1强行升级，2用户可选择升级） 备注： 0 没有升级版本，就继续进入签到过程 1 强行升级，直接要求终端升级后才能进入主界面 2 选择升级，提示用户有新版本，可选择是否升级 查看版本号 可以查看当前程序版本信息，版本信息随升级而发生变化。 画图