元捷能耗监测系统YC-EMS01－能耗监测管理软件与网络控制器接口规范_v

1、. 能耗监测管理软件与网络控制器接口规范 版本号 1.0.1 苏州元澄智能科技有限公司2012年11月目录目录1一、 前言4二、 范围4三、 引用标准和文件、修订说明4四、 术语和缩略语441术语44.1.1.传输控制协议/互联网络协议TCP/IP transmission control protocol/internet protocol44.1.2.传输时间间隔 transfer interval44.1.3.数据实体 entity44.1.4.上传 uploading54.1.5.下传 downloading542缩略语54.2.1.网络控制器54.2.2.数据采集器5五、 系统结构5

2、51系统拓扑结构552传输机制6六、 通讯方式6七、 数据传输通信协议771通信链路的维持772特殊说明773协议格式774命令ID类别875命令列表876门禁系统协议87.6.1.下行数据格式87.6.2.1 上位机命令应答(命令ID:0001H)87.6.2.2 时间同步指令（命令ID：0002H）87.6.2.3 设备时间获取指令（命令ID：0003H）97.6.2.4 网络控制器重启指令（命令ID：0004H）97.6.2.5 配置中心服务器通讯参数指令（命令ID：0005H）97.6.2.6 设备极值获取指令（命令ID:0006H）97.6.2.7 电量查询指令（命令ID：0007H

3、）107.6.2.8 采集周期设置指令（命令ID：0008H）107.6.2.9 校验指令（命令ID：0009H）107.6.2.10 断电指令(命令ID：000AH)107.6.2.11 电量监控开始指令（命令ID：000BH）107.6.2.12 电量监控结束指令（命令ID：0010H）117.6.2.13 添加采集器（命令ID:0011H）11该指令需要网络控制器应答,网络控制器收到该指令后才会上传该采集器数据117.6.2.14 删除采集器（命令ID:0012H）11该指令需要网络控制器应答,网络控制器收到该指令后不会上传该采集器数据117.6.2.上行数据格式117.6.2.1 络控

4、制器登录（命令ID：0101H）117.6.2.2 网络控制器命令应答（命令ID：0102H）127.6.2.3 设备当前时间（命令ID：0103H）127.6.2.4 设备极值应答指令（命令ID：0106）127.6.2.5 故障指令（命令ID：0105H）137.6.2.6 电表电量信息上传指令（命令ID：0107H）13*;苏州元澄智能科技有限公司厅 接口规范版本改动说明协议版本号改动说明时间修改人1.0.0接口规范初稿2012-11-30吕耀华1.0.1修改时间格式、配置中心服务器通讯参数指令2012-12-07吕耀华1.0.2添加两条指令7.6.2.13/7.6.2.142012-1

5、2-18帅珠龙一、 前言能耗监测管理系统与门禁网络控制器接口规范，用于能耗监测管理软件控制门禁设备及能耗监测设备汇报相关硬件信息。二、 范围能耗监测管理软件与门禁网络控制器之间交互。本规范由苏州元澄智能科技有限公司研发部负责解释。三、 引用标准和文件、修订说明修订说明：四、 术语和缩略语41 术语4.1.1. 传输控制协议/互联网络协议TCP/IP transmission control protocol/internet protocol一种网络通信协议，规范了网络上的所有通信设备，尤其是一个主机与另一个主机之间的数据往来格式以及传送方式。TCP/IP是INTERNET的基础协议，也是计算

6、机数据打包和寻址的标准办法。4.1.2. 传输时间间隔 transfer interval是指数据上传或下发的时间间隔。4.1.3. 数据实体 entity是指各类数据传输对象。如：电表功率值信息 (详细参见以下“数据传输内容”章节)。4.1.4. 上传 uploading网络控制器、就地控制器信息与定时汇报信息数据。4.1.5. 下传 downloading能耗监测管理软件下发各种消息与指令。42 缩略语4.2.1. 网络控制器4.2.2. 数据采集器五、 系统结构51 系统拓扑结构能耗监测系统的拓扑结构图52 传输机制上位机数据传输机制为通过局域网网络控制器上传和上位机下发数据两种交互方式

7、。上位机可以与多个网络控制器进行通信，网络控制器将电表电量实时数据信息及设备的故障信息主动上传到上位机服务器上，上位机可以设置网络控制器人员信息及参数信息。六、 通讯方式通信双方采用TCP/IP长连接方式，通信双方以客户-服务器方式建立TCP连接，用于双方信息的相互提交。数据采集时上位机作为服务器方，开监听端口，网络控制器作为客户端连接成功后，上位机方接收各网络控制器发送的就地控制器及采集器编号信息，并对接收到的数据返回对应的回复消息，上位机主动下发设置及查询指令，网络控制器对接收到的数据返回对应的回复消息。 数据操作流程示例如图所示。上位机-服务器方网络控制器-客户端方主动上传主动下发应答回

8、复回复应答回复回复数据操作流程图七、 数据传输通信协议71 通信链路的维持网络控制器与上位机通信链路的维持是通过互发心跳指令的方式。心跳指令由网络控制器向上位机周期性的发送，上位机收到心跳指令后回复一条心跳应答指令。网络控制器心跳上传周期为10秒。上位机间隔三个周期未收以心跳数据则认为该网络控制器已经断开，网络控制器若三个周期未收到心跳应答指令则认为与上位机链路断开进行重连。心跳指令有消息长度及网络控制器ID，其它信息都没有。72 特殊说明Ø 超过一个字节存储空间的整数，协议中采用高位在前，低位在后的大端模式存放；Ø 在本规范中所有指令包含的时间均为GMT时间；Ø

9、 本协议中所使用的ASCII字符指：0AH、0DH及20H到7EH之间的ASCII字符；Ø 本协议中汉字均采用GB2312编码；Ø 设备ID编号由二个字节组成，第一个字节代表网络控制器，第二个字节代表就地控制器；如果就地控制器为0x00则表示只对网络控制器交互，如果就地控制器为0xFF而且读卡器为0x00表示对该网络控制器下的所有就地控制器进行交互。网络控制器ID就地控制器ID含义0xFF0x00网络控制器通信0XFF0XFF全网广播去除0x00/0xFF0x00单个网络控制器通信去除0x00/0xFF0xFF某个网络控制器网络的广播73 协议格式 协议格式表起始字节字段长

10、度（字节）说明1消息长度2消息的总长度（字节数），从第一个字节到最后一个字节。3设备ID号2设备ID编号，第一个字节代表网络控制器编号，第二个字节代表就地控制器编号。5采集器类型101电02水03煤气046命令ID2第一个字节表示命令ID类别，第二个字节表示命令编号。8命令序号2从0开始循环累加注：分包（按协议）发送的数据，命令序号需累加10信息内容-不定长，详见7.674 命令ID类别目前定义的命令ID类别有3类，以后视需要可以扩展：序号命令ID类别编号通信方向说明1门禁系统协议00H下行元捷能耗监测系统。201H上行75 命令列表 命令号 传送方向76 门禁系统协议7.6.1. 下行数据格

11、式7.6.2.1 上位机命令应答(命令ID:0001H)上位机必须对网络控制器的某些指令应答（除网络控制器应答指令和已指定不需上位机应答的数据），否则网络控制器超时后会重发，网络控制器按照设定的重发次数（出厂默认为2次）和重发间隔（出厂默认为8秒）重发。该指令默认无需网络控制器应答。上位机命令应答起始字节字段长度（字节）说明10应答命令序号2需要应答的那条命令序号12命令ID2网络控制器上发指令的ID14校验码1MOD15结束符3EOF7.6.2.2 时间同步指令（命令ID：0002H）该指令只对网络控制器进行时间同步，网络控制器收到该指令后返回应答指令。起始字节字段长度（字节）说明10时间7

12、开始一个字节代表年(2012年为0x0C)，第二个字节代表周，第三个字节代表月，第四个字节代表日，第五个字节代表小时，第六个字节代表分，第七个字节代表秒17校验码118结束符3EOF7.6.2.3 设备时间获取指令（命令ID：0003H）该指令用于获取指定网络控制器及该网络控制器下面所有就地控制器的系统时间，网络控制器收到该指令后返回该网络控制器所有相关设备的系统时间。起始字节字段长度（字节）说明10校验码111结束符3EOF7.6.2.4 网络控制器重启指令（命令ID：0004H）该指令用于重启网络控制器，网络控制器收到该指令后返回应答指令，返回应答后网络控制器进行重启操作。起始字节字段长度

13、（字节）说明10校验码113结束符3EOF7.6.2.5 配置中心服务器通讯参数指令（命令ID：0005H）此处的中心服务器通讯参数即为上位机IP地址和端口号，当网络控制器收到该指令并修完成后返回应答指令，重新启动网络控制器后该参数生效，网络控制器连接设置的IP地址及端口。起始字节字段长度（字节）说明10服务器通讯IP地址4例如：10.20.37.19表示为0x0A 0x14 0x25 0x1314服务器通讯端口号2数值范围0-6553516网络控制器IP地址420网络控制器端口号222网关IP地址426子网掩码430校验码131结束符3EOF7.6.2.6 设备极值获取指令（命令ID:000

14、6H）该指令用于获取电表的数值的最大可表示值及最小可表示值。起始字节字段长度（字节）说明10校验码111结束符3EOF7.6.2.7 电量查询指令（命令ID：0007H）该指令不需要网络控制器应答，当数据采集器收到该指令后立马上传一条电表电量信息指令。起始字节字段长度（字节）说明10校验码111结束符3EOF7.6.2.8 采集周期设置指令（命令ID：0008H）该指令需要网络控制器应答，指令用于设置网络控制器电表电量上传周期时间间隔。起始字节字段长度（字节）说明9时间间隔1单位为分钟，该值表示网络控制器上传电表电量的时间间隔时长10校验码111结束符3EOF7.6.2.9 校验指令（命令ID

15、：0009H）该指令需要网络控制器应答，采集器收到该指令后对电表做一次校验操作，并把操作结果返回给上位机。起始字节字段长度（字节）说明9校验码110结束符3EOF7.6.2.10 断电指令(命令ID：000AH)该指令需要网络控制器应答，采集器收到该指令后使电表断电了。起始字节字段长度（字节）说明9校验码110结束符3EOF7.6.2.11 电量监控开始指令（命令ID：000BH）该指令需要网络控制器应答，采集器收到该指令后，如果电表电量有变化则上传该电表值。起始字节字段长度（字节）说明9校验码110结束符3EOF7.6.2.12 电量监控结束指令（命令ID：0010H）该指令需要网络控制器应

16、答，采集器收到该指令后，使命令ID：000AH指令功能失效。起始字节字段长度（字节）说明9校验码110结束符3EOF7.6.2.13 添加采集器（命令ID:0011H）该指令需要网络控制器应答,网络控制器收到该指令后才会上传该采集器数据起始字节字段长度（字节）说明9校验码110结束符3EOF7.6.2.14 删除采集器（命令ID:0012H）该指令需要网络控制器应答,网络控制器收到该指令后不会上传该采集器数据起始字节字段长度（字节）说明9校验码110结束符3EOF7.6.2. 上行数据格式7.6.2.1 络控制器登录（命令ID：0101H）网络控制器开启或重启后第一次向上位机发送数据时，必须首

17、先发送登录指令，登录指令携带就地控制器及读卡器编号列表，该指令默认需要上位机返回命令应答。该指令提供网络控制器判断当前登录的上位机是否有效。起始字节字段长度（字节）说明9就地控制器编号13-就地控制器编号n3-校验码1-结束符3EOF7.6.2.2 网络控制器命令应答（命令ID：0102H）网络控制器必须对上位机的某些指令应答，否则上位机超时后会重发，上位机按照重发次数据（默认2次）和重发间隔（默认8秒）重发。该指令无需上位机应答。起始字节字段长度（字节）说明9应答命令序号2需要应答的那条命令序号11命令ID2上位机下发指令的ID13校验码114结束符3EOF7.6.2.3 设备当前时间（命令

18、ID：0103H）该指令作为查询设备当前时间信息指令（命令ID：0003H）对应的应答信息，该指令需要上位机返回应答指令。起始字节字段长度（字节）说明9时间7开始一个字节代表年(2012年为0x0C)，第二个字节代表周，第三个字节代表月，第四个字节代表日，第五个字节代表小时，第六个字节代表分，第七个字节代表秒16校验码117结束符3EOF7.6.2.4 设备极值应答指令（命令ID：0106）该指令作为设备极值获取指令（命令ID:0006H）对应的应答信息，该指令需要上位机返回应答指令。起始字节字段长度（字节）说明9最大值所包含字节数110最大值整数值-最大值小数位数1-最小值所包含字节数1-最小整数值-最小小数位数1-校验码1-结束符3EOF7.6.2.5 故障指令（命令ID：0105H）当电表设备出现故障时，网络控制器主动上传故障信息，该指令需要上位机返回应答指令。起始字节字段长度（字节）说明9预留值211校验码112结束符3EOF7.6.2.6 电表电量信息上传指令（命令ID：0107H）该指令由网络控制器主动上传电表的电量信息，该指令需要上位机返回应答指令。起始字节字段长度（字节）说