天一应用系统客户端与采集服务间通信协议(84类别).doc

第 PAGE 12页 客户端与采集服务器间 通信协议 协议版本：V1.01 发布日期：2010年9月  1. 应用场景 采集服务器 采集服务器 客户端 TCP 基站 标签 标签 标签 标签 标签 基站 基站 TCP 序号 名称 解释 通讯协议标识 1 标签（卡） CID 2 基站（Reader） 通过基站天线接收标签（卡）数据，并定时发送到采集服务器 ReaderID 3 采集服务器 运行在PC上的采集软件，收到基站（Reader）的数据后，转发到连接到此采集服务器的客户端。 客户端可以通过向采集服务器发送命令的方式对采集服务器和基站进行配置。 4 客户端 使用采集服务器功能的软件，使用TCP协议连接到采集服务器，发送命令与采集服务器通讯，并接收采集服务器转发的基站（Reader）和标签（卡）的信息。  2. 通讯协议 客户端使用TCP协议连接到采集服务器, 客户端与采集服务器之间的通讯数据包有三类,分别是： 客户端 客户端 采集服务器 命令包 命令应答包 采集信息包 序号 名称 说明 １ 命令包 客户端向采集服务器发出的命令数据包，以配置基站相关工作参数。 ２ 命令应答包 采集服务器收到命令并执行后，向客户端发出对命令执行结果的反馈数据包。 ３ 采集信息包 采集服务器主动向客户端发出的关于基站及卡数据信息的数据包。该数据包无需客户端应答。 以上三类数据包按照下面的帧格式进行打包，以确保客户端和采集服务端能对帧边界进行正确的识别和解包： 每帧数据前四个字节分别为校验包头0x1F、0xF1、数据长度高八位、数据长度低八位 校验包头 数据长度2个字节 数据类型 基站号 数据正文 2个字节0x1F 0xF1 正文数据长度高8位 正文数据长度低8位 1字节 3字节，高位在前，低位在后 实际数据（见数据格式说明） 命令数据正文（帧格式中的数据正文内容）的基本格式采用XML格式，XML文档格式要求如下： 编码方式： UTF－8 编码 大小写： 区分大小写 分隔符： 分隔符采用半角字符 下面对三类数据包数据正文分别进行描述： 1. 命令包数据正文基本格式 Doc CommandType/CommandType ReaderID/ReaderID Content/Content /Doc 说明： CommandType：命令类型 ReaderID： 基站地址 Content： 命令内容 2. 命令响应包数据正文基本格式 Data CMD ProcessDetail/ ProcessDetail ProcessResult/ ProcessResult /CMD /Data 说明： ProcessDetail: 命令详细信息，类型：string ProcessResult : 命令处理结果, 1表示执行成功，0表示失败 举例： Data CMD ProcessDetail设置客户端停止接收数据成功/ ProcessDetail ProcessResult1/ ProcessResult /CMD /Data 3. 采集信息包基本格式  3.命令类型说明 客户端向采集服务器发送的命令包中的命令类型列表说明如下： 命令类型 命令含义 1 客户端开始接收基站数据 2 客户端停止接收基站数据 3 配置基站的上传时间间隔（秒） 4 配置基站接收灵敏度 5 配置基站IP和端口号（IP和端口以“,”号隔开） 6 配置基站接收频率 7 配置基站所连接采集服务器地址 8 配置基站天线工作状态 9 配置基站重连接时间间隔 10 应用系统登录 11 配置采集与基站通讯端口 12 配置采集与客户端通讯端口 13 配置基站指示灯工作状态 14 配置授权信息 15 配置射频发射功率 16 配置射频发射频率 3.1、客户端开始接收基站数据 下发命令内容： Doc CommandType1/CommandType ReaderID/ReaderID Content/Content /Doc 注：客户端连接上采集服务后，采集服务默认会向该客户端发送基站数据。 3.2、客户端停止接收基站数据 下发命令内容： Doc CommandType2/CommandType ReaderID/ReaderID Content/Content /Doc 3.3、配置基站的上传时间间隔（秒） 下发命令内容： 设置基站1000045的上传时间间隔为5秒 Doc CommandType3/CommandType ReaderID1000045/ReaderID Content5/Content /Doc 说明： 如果Reader