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

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