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

客户端与采集服务间 协议 1. 应用场景 序号 名称 解释 通讯协议标识 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. 命令格式 CMD ProcessDetail/ ProcessDetail ProcessResult/ ProcessResult /CMD /Data 说明： ProcessDetail: 命令详细信息 ProcessResult : 命令处理结果1表示执行成功，0失败CMD ProcessDetail设置客户端停止接收数据成功/ ProcessDetail ProcessResult/ ProcessResult /CMD /Data 3. 采集信息包基本格式  3.命令说明说明如下：命令类型 命令含义 1 客户端开始接收基站数据 2 客户端停止接收基站数据 3 配置基站的上传时间间隔 4 配置基站接收灵敏度 5 配置基站IP和端口号（IP和端口以“,”号隔开） 6 配置基站接收频率 7 配置基站所连接采集服务器地址 8 配置基站天线工作状态 9 配置基站连接时间间隔 10 11 配置采集与基站通讯端口 12 配置采集与客户端通讯端口 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 说明：.4、配置基站接收灵敏度 下发命令内容：配置基站1000045天线2的接收灵敏度为1 Doc CommandType4/CommandType ReaderID1000045/ReaderID Content2,1/Content /Doc 说明： 1. 基站接收灵敏度，天线选择（1为天线1，2为天线2）和灵敏度之间用逗号“,”隔开 2. 如果ReaderID为0则为配置所有基站 3.5、配置基站所连接采集服务器的地址 下发命令内容：配置基站1000045