地磁接收器与上位机通信协议

1、. 地磁接收器与上位机通信协议 版本号 1.0.0 苏州博朗明科技有限公司2015年8月目录目录1一、 前言4二、 范围4三、 系统拓朴图4四、术语和缩略语441术语44.1.1.传输控制协议/互联网络协议TCP/IP transmission control protocol/internet protocol44.1.2.传输时间间隔 transfer interval44.1.3.数据实体 entity44.1.4.上传 uploading44.1.5.下传 downloading542缩略语54.2.1.地磁接收器54.2.2.扩展板54.2.3.上位机54.2.4.下位机5五、5六、

2、通讯方式5七、 数据传输通信协议671通信链路的维持672特殊说明673协议格式674命令ID类别675命令编号列表776通信系统协议87.6.1.下行数据格式87.6.1.1 上位机命令应答(命令ID:0001H)87.6.1.2 时间同步指令（命令ID：0002H）87.6.1.3 设备时间获取指令（命令ID：0003H）87.6.1.4 设备重启指令（命令ID：0004H）97.6.1.5 查询地磁终端状态指令（命令ID:0005H）97.6.1.6 设备开关设置指令（命令ID:0006H）97.6.1.7 设置阀值指令（命令ID：0007H）97.6.1.8 设置灵敏度指令（命令ID：

3、0008H）97.6.1.9 设置采样间隔指令(命令ID：0009H)107.6.1.10 获得接收器参数指令(命令ID：000AH)107.6.1.11 读取车辆信息（命令ID:000BH）107.6.1.12 添加地磁终端（命令ID:000CH）107.6.1.13 删除地磁终端（命令ID:000DH）117.6.1.14 配置通讯参数指令（命令ID：0010）117.6.1.15 配置地磁参数指令（命令ID：0011H）117.6.2.上行数据格式117.6.2.1.地磁接收器命令应答（命令ID：0F01H）127.6.2.2.查询状态命令应答 （命令ID:0F05）127.6.2.3.

4、地磁接收器登录（命令ID：0F10H）127.6.2.4.故障指令（命令ID：0F11H）127.6.2.5.地磁终端参数上传指令（命令ID：0F12H）137.6.2.6.地磁接收器历史数据上传（命令ID：0F13H）13;13苏州博朗明科技有限公司 通信协议版本改动说明协议版本号改动说明时间修改人1.0.0通信协议初稿2015/8/20帅珠龙一、 前言地磁接收器与上位机通信协议，用于地磁配置软件或地磁数据采集监测软件与地磁接收器设备或带LAN接口扩展板之间数据通信标准协议。二、 范围PC端软件与硬件终端之间的标准通信。本协议由苏州博朗明科技有限公司研发部负责解释。三、 系统拓朴图四、 术语

5、和缩略语441 术语4.1.1. 传输控制协议/互联网络协议TCP/IP transmission control protocol/internet protocol一种网络通信协议，规范了网络上的所有通信设备，尤其是一个主机与另一个主机之间的数据往来格式以及传送方式。TCP/IP是INTERNET的基础协议，也是计算机数据打包和寻址的标准办法。4.1.2. 传输时间间隔 transfer interval是指数据上传或下发的时间间隔。4.1.3. 数据实体 entity是指各类数据传输对象。4.1.4. 上传 uploading地磁接收器或扩展板定时向上位机发送采集参数。4.1.5. 下传

6、 downloading配置软件或数据采集监测软件发送的查询指令或控制命令。42 缩略语4.2.1. 地磁接收器 指地磁系统中用于接收终端数据的中心处理设备。4.2.2. 扩展板指地磁系统中用于通信扩展和状态显示的附加设备。4.2.3. 上位机 安装有配置软件或数据采集监测软件的PC/服务器。4.2.4. 下位机 泛指通信系统网关或其它拥有控制，数据采集等功能的底层控制设备。五、 通讯方式通信双方采用TCP/IP长连接方式，通信双方以客户-服务器方式建立TCP连接，用于双方信息的相互提交。上位机作为服务器方，开监听端口，地磁接收器作为客户端连接成功后，上位机接收各地磁接收器发送的设备编号信息（

7、下属地磁终端信息），并对接收到的数据返回对应的回复消息，上位机主动下发设置及查询指令，地磁接收器或扩展板对接收到的数据返回对应的回复消息。六、 数据操作流程图 上位机-服务器方地磁接收器-客户端方主动上传主动下发应答回复回复应答回复回复七、 数据传输通信协议45671 通信链路的维持下位机与上位机通信链路的维持是通过互发心跳指令的方式。心跳指令由下位机向上位机周期性的发送，上位机收到心跳指令后回复一条心跳应答指令。下位机心跳上传周期为10秒。上位机间隔三个周期未收以心跳数据则认为该下位机已经断开，下位机若三个周期未收到心跳应答指令则认为与上位机链路断开进行重连。心跳指令有消息长度及下位机设备I

8、D，其它信息都没有。72 特殊说明Ø 超过一个字节存储空间的整数，协议中采用高位在前，低位在后的大端模式存放；Ø 在本规范中所有指令包含的时间均为GMT时间；Ø 本协议中所使用的ASCII字符指：0AH、0DH及20H到7EH之间的ASCII字符；Ø 本协议中汉字均采用GB2312编码；Ø 设备ID编号由三个字节组成，首字节代表下位机地址；第二，三个字节代表该接收器所属的地磁终端地址，如果为0x0000则表示对该网络系统中所有地磁广播。ID第二,三字节含义OX0000该接收器所属的所有地磁终端(广播)0X0001ID为0001的地磁OXFFFF

9、仅对地磁接收器操作，不涉及地磁终端73 协议格式 协议格式表起始字节字段长度（字节）说明0起始符10A1消息长度1消息的总长度（字节数），从第一个字节到最后一个字节。2设备ID号3设备ID编号，第一个字节代表接收器ID，第二，三个字节代表所属地磁编号。5命令ID2第一个字节表示命令ID类别，第二个字节表示命令编号。7命令序号1从0开始循环累加注：分包（按协议）发送的数据，命令序号需累加8信息内容-不定长，详见7.6N结束符3EOF74 命令ID类别目前定义的命令ID类别有3类，以后视需要可以扩展：序号命令ID类别编号通信方向说明1通信系统协议00H下行由上位机发送给下位机20FH上行由下位机发

10、送给上位机75 命令编号列表 命令号 命令内容传输方向0001上位机应答下行0002时间同步下行0003读取设备时间下行0004设备重启下行0005查询地磁终端状态下行0006设备开关设置下行0007设置阀值下行0008设置灵敏度下行0009设置采样间隔下行000A读取接收器参数下行000B读取车辆信息下行000C添加地磁终端下行000D删除地磁终端下行0010配置接收器通信参数下行0011配置地磁参数下行0F01地磁接收器应答上行0F05查询状态命令应答上行0F10地磁接收器登录上行0F11故障上传上行0F12地磁终端参数上传上行0F13接收器历史数据上传上行76 通信系统协议7.6.1.

11、下行数据格式4.24.34.44.54.64.771727374757676.17.6.1.7.6.2.7.6.3.7.6.1.1 上位机命令应答(命令ID:0001H)上位机必须对地磁接收器的某些指令应答（除地磁接收器应答指令和已指定不需上位机应答的数据），否则地磁接收器超时后会重发，地磁接收器按照设定的重发次数（出厂默认为2次）和重发间隔（出厂默认为8秒）重发。该指令默认无需地磁接收器应答。信息内容如下：起始字节字段长度（字节）说明8应答命令序号1需要应答的那条命令序号9命令ID2地磁接收器上发指令的ID11校验码1第一个字符至校验码前一个字符的算术和，取低8位11结束符3EOF7.6.1

12、.2 时间同步指令（命令ID：0002H）该指令只对下位机进行时间同步，下位机收到该指令后返回应答指令。如广播指令无需应答。信息内容如下：起始字节字段长度（字节）说明8时间7开始一个字节代表年(2012年为0x0C)，第二个字节代表周，第三个字节代表月，第四个字节代表日，第五个字节代表小时，第六个字节代表分，第七个字节代表秒15校验码1第一个字符至校验码前一个字符的算术和，取低8位16结束符3EOF7.6.1.3 设备时间获取指令（命令ID：0003H）该指令用于获取指定地磁接收器或指定地磁终端（如有时间功能）的系统时间，地磁接收器/地磁终端收到该指令后返回该设备的系统时间。起始字节字段长度（

13、字节）说明8校验码1第一个字符至校验码前一个字符的算术和，取低8位9结束符3EOF7.6.1.4 设备重启指令（命令ID：0004H）该指令用于重启地磁接收器（地磁终端），地磁接收器（地磁终端）收到该指令后返回应答指令，返回应答后地磁接收器（地磁终端）进行重启操作。起始字节字段长度（字节）说明8校验码1第一个字符至校验码前一个字符的算术和，取低8位9结束符3EOF7.6.1.5 查询地磁终端状态指令（命令ID:0005H）该指令用于获取地磁终端当前参数。设备收到该指令后立即返回当前所有工作参数。起始字节字段长度（字节）说明8校验码1第一个字符至校验码前一个字符的算术和，取低8位9结束符3EOF

14、7.6.1.6 设备开关设置指令（命令ID:0006H）该指令用于打开或关闭地磁终端，需地磁接收器应答。起始字节字段长度（字节）说明8数据内容100关机01开机9校验码1第一个字符至校验码前一个字符的算术和，取低8位10结束符3EOF7.6.1.7 设置阀值指令（命令ID：0007H）该指令用于设置阀值，需地磁接收器应答起始字节字段长度（字节）说明8设定阀值19校验码1第一个字符至校验码前一个字符的算术和，取低8位10结束符3EOF7.6.1.8 设置灵敏度指令（命令ID：0008H）该指令用于设置灵敏度，需地磁接收器应答。起始字节字段长度（字节）说明8灵敏度19校验码1第一个字符至校验码前一

15、个字符的算术和，取低8位10结束符3EOF7.6.1.9 设置采样间隔指令(命令ID：0009H)该指令用于设置采样间隔，需地磁接收器应答。起始字节字段长度（字节）说明8采样间隔19校验码1第一个字符至校验码前一个字符的算术和，取低8位10结束符3EOF7.6.1.10 获得接收器参数指令(命令ID：000AH)该指令用于获得设备参数（如阀值，灵敏度，采样间隔等）。需地磁接收器应答。起始字节字段长度（字节）说明8校验码1第一个字符至校验码前一个字符的算术和，取低8位9结束符3EOF7.6.1.11 读取车辆信息（命令ID:000BH）该指令用于读取地磁上车辆信息，需地磁接收器应答。起始字节字段

16、长度（字节）说明8校验码1第一个字符至校验码前一个字符的算术和，取低8位9结束符3EOF7.6.1.12 添加地磁终端（命令ID:000CH）该指令需要地磁接收器应答,地磁接收器收到该指令后才会上传已添加地磁终端数据起始字节字段长度（字节）说明8地磁终端ID210校验码1第一个字符至校验码前一个字符的算术和，取低8位11结束符3EOF7.6.1.13 删除地磁终端（命令ID:000DH）该指令需要地磁接收器应答,地磁接收器收到该指令后不会上传该地磁终端数据起始字节字段长度（字节）说明8地磁终端ID 210校验码1第一个字符至校验码前一个字符的算术和，取低8位11结束符3EOF7.6.1.14

17、配置通讯参数指令（命令ID：0010）此处的通讯参数即为上位机IP地址和端口号，当地磁接收器收到该指令并修完成后返回应答指令，重新启动网络控制器后该参数生效，网络控制器连接设置的IP地址及端口。起始字节字段长度（字节）说明8服务器通讯IP地址4例如：10.20.37.19表示为0x0A 0x14 0x25 0x1312服务器通讯端口号2数值范围0-6553514地磁接收器IP地址4同IP16地磁接收器端口号2同端口号20网关IP地址4同IP24子网掩码4同IP25地磁接收器ID10-25526校验码1第一个字符至校验码前一个字符的算术和，取低8位27结束符3EOF7.6.1.15 配置地磁参数

18、指令（命令ID：0011H） 用来配置所属地磁的基本参数，需下位机应答起始字节字段长度（字节）说明8参数1-1010相关参数定义参照地磁通信协议18校验码1第一个字符至校验码前一个字符的算术和，取低8位19结束符3EOF7.6.2. 上行数据格式1.2.3.4.5.6.7.7.1.7.2.7.3.7.4.7.5.7.6.7.6.1.7.6.2.7.6.2.1. 地磁接收器命令应答（命令ID：0F01H）地磁接收器必须对上位机的某些指令应答，否则上位机超时后会重发，上位机按照重发次数据（默认2次）和重发间隔（默认8秒）重发。该指令无需上位机应答。起始字节字段长度（字节）说明8命令ID2上位机下发

19、指令的ID10应答命令序号1需要应答的那条命令序号11操作结果100失败，01成功12校验码1第一个字符至校验码前一个字符的算术和，取低8位13结束符3EOF7.6.2.2. 查询状态命令应答 （命令ID:0F05）地磁接收器对上位机查询状态指令（0F05）进行应答，该指令无需上位机应答。起始字节字段长度（字节）说明8应答命令序号2需要应答的那条命令序号10地磁终端参数49设备状态00离线，01在线10信号量00-FF11电池电量00-FF 12预留14校验码1第一个字符至校验码前一个字符的算术和，取低8位15结束符3EOF7.6.2.3. 地磁接收器登录（命令ID：0F10H）地磁接收器开启或重启后第一次向上位机发送数据时，必须首先发送登录指令，登录指令携带地磁终端编号列表，该指令默认需要上位机返回命令应答。该指令提供地磁接收器判断当前登录的上位机是否有效。起始字节字段长度（字节）说明8地磁终端12地磁终端1 ID-地磁终端n2地磁终端n ID-校验