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

能耗监测管理软件与网络控制器接口规范能耗监测管理软件与网络控制器接口规范 版本号版本号 1.0.11.0.1 苏州元澄智能科技有限公司苏州元澄智能科技有限公司 2012 年年 11 月月 1 目录目录 目录1 一、一、 前言前言4 二、二、 范围范围4 三、三、 引用标准和文件、修订说明引用标准和文件、修订说明.4 四、四、 术语和缩略语术语和缩略语.4 41术语术语.4 4.1.1.传输控制协议/互联网络协议 TCP/IP transmission control protocol/internet protocol.4 4.1.2.传输时间间隔 transfer interval.4 4.1.3.数据实体 entity.4 4.1.4.上传 uploading.5 4.1.5.下传 downloading5 42缩略语缩略语.5 4.2.1.网络控制器.5 4.2.2.数据采集器.5 五、五、 系统结构系统结构.5 51系统拓扑结构系统拓扑结构.5 52传输机制传输机制.6 六、六、 通讯方式通讯方式.6 七、七、 数据传输通信协议数据传输通信协议7 71通信链路的维持通信链路的维持.7 72特殊说明特殊说明.7 73协议格式协议格式.7 74命令命令ID类别类别8 75命令列表命令列表.8 76门禁系统协议门禁系统协议.8 7.6.1.下行数据格式下行数据格式.8 7.6.2.1 上位机命令应答(命令 ID:0001H) .8 7.6.2.2 时间同步指令（命令 ID：0002H）.8 7.6.2.3 设备时间获取指令（命令 ID：0003H）.9 7.6.2.4 网络控制器重启指令（命令 ID：0004H）.9 7.6.2.5 配置中心服务器通讯参数指令（命令 ID：0005H）.9 7.6.2.6 设备极值获取指令（命令 ID:0006H）9 7.6.2.7 电量查询指令（命令 ID：0007H）.10 7.6.2.8 采集周期设置指令（命令 ID：0008H）.10 7.6.2.9 校验指令（命令 ID：0009H）.10 7.6.2.10 断电指令(命令 ID：000AH)10 7.6.2.11 电量监控开始指令（命令 ID：000BH）.10 7.6.2.12 电量监控结束指令（命令 ID：0010H）.11 7.6.2.13 添加采集器（命令 ID:0011H）11 2 该指令需要网络控制器应答,网络控制器收到该指令后才会上传该采集器数据.11 7.6.2.14 删除采集器（命令 ID:0012H）11 该指令需要网络控制器应答,网络控制器收到该指令后不会上传该采集器数据.11 7.6.2.上行数据格式上行数据格式.11 7.6.2.1 络控制器登录（命令 ID：0101H）.11 7.6.2.2 网络控制器命令应答（命令 ID：0102H）.12 7.6.2.3 设备当前时间（命令 ID：0103H）.12 7.6.2.4 设备极值应答指令（命令 ID：0106） .12 7.6.2.5 故障指令（命令 ID：0105H）.13 7.6.2.6 电表电量信息上传指令（命令 ID：0107H）.13 苏州元澄智能科技有限公司厅 3 接口规范版本改动说明接口规范版本改动说明 协议版本 号 改动说明时间修改人 1.0.0接口规范初稿2012-11-30吕耀华 1.0.1修改时间格式、配置中心服务器通讯参 数指令 2012-12-07吕耀华 1.0.2添加两条指令 7.6.2.13/7.6.2.142012-12-18帅珠龙 苏州元澄智能科技有限公司厅 4 一、一、 前言前言 能耗监测管理系统与门禁网络控制器接口规范，用于能耗监测管理软件控制门禁设备 及能耗监测设备汇报相关硬件信息。 二、二、 范围范围 能耗监测管理软件与门禁网络控制器之间交互。 本规范由苏州元澄智能科技有限公司研发部负责解释。 三、三、 引用标准和文件、修订说明引用标准和文件、修订说明 修订说明：修订说明： 四、四、 术语和缩略语术语和缩略语 41术语术语 4.1.1.传输控制协议/互联网络协议 TCP/IP transmission control protocol/internet protocol 一种网络通信协议，规范了网络上的所有通信设备，尤其是一个主机与另一个主机之 间的数据往来格式以及传送方式。TCP/IP是INTERNET的基础协议，也是计算机数据打包和 寻址的标准办法。 4.1.2. 传输时间间隔 transfer interval 是指数据上传或下发的时间间隔。 4.1.3.数据实体 entity 是指各类数据传输对象。如：电表功率值信息 (详细参见以下“数据传输内容”章节)。 苏州元澄智能科技有限公司厅 5 4.1.4.上传 uploading 网络控制器、就地控制器信息与定时汇报信息数据。 4.1.5.下传 downloading 能耗监测管理软件下发各种消息与指令。 42缩略语缩略语 4.2.1.网络控制器 4.2.2.数据采集器 五、五、 系统结构系统结构 51系统拓扑结构系统拓扑结构 能耗监测系统的拓扑结构图 苏州元澄智能科技有限公司厅 6 52传输机制传输机制 上位机数据传输机制为通过局域网网络控制器上传和上位机下发数据两种交互方式。 上位机可以与多个网络控制器进行通信，网络控制器将电表电量实时数据信息及设备 的故障信息主动上传到上位机服务器上，上位机可以设置网络控制器人员信息及参数信息。 六、六、 通讯方式通讯方式 通信双方采用 TCP/IP 长连接方式，通信双方以客户-服务器方式建立 TCP 连接，用于 双方信息的相互提交。 数据采集时上位机作为服务器方，开监听端口，网络控制器作为客户端连接成功后， 上位机方接收各网络控制器发送的就地控制器及采集器编号信息，并对接收到的数据返回 对应的回复消息，上位机主动下发设置及查询指令，网络控制器对接收到的数据返回对应 的回复消息。 数据操作流程示例如图所示。 数据操作流程图 上位机-服务器方网络控制器-客户端方 主动上传 主动下发 应答回复 回复 应答回复 回复 苏州元澄智能科技有限公司厅 7 七、七、 数据传输通信协议数据传输通信协议 71通信链路的维持通信链路的维持 网络控制器与上位机通信链路的维持是通过互发心跳指令的方式。 心跳指令由网络控制器向上位机周期性的发送，上位机收到心跳指令后回复一条心跳 应答指令。网络控制器心跳上传周期为10秒。上位机间隔三个周期未收以心跳数据则认为 该网络控制器已经断开，网络控制器若三个周期未收到心跳应答指令则认为与上位机链路 断开进行重连。心跳指令有消息长度及网络控制器ID，其它信息都没有。 72特殊说明特殊说明 超过一个字节存储空间的整数，协议中采用高位在前，低位在后的大端模式存放； 在本规范中所有指令包含的时间均为GMT时间； 本协议中所使用的ASCII字符指：0AH、0DH及20H到7EH之间的ASCII字符； 本协议中汉字均采用GB2312编码； 设备ID编号由二个字节组成，第一个字节代表网络控制器，第二个字节代表就地 控制器；如果就地控制器为0x00则表示只对网络控制器交互，如果就地控制器为 0xFF而且读卡器为0x00表示对该网络控制器下的所有就地控制器进行交互。 网络控制器ID就地控制器ID含义 0xFF0x00 网络控制器通信 0XFF0XFF 全网广播 去除0x00/0xFF 0x00 单个网络控制器通信 去除0x00/0xFF 0xFF 某个网络控制器网络的广播 73协议格式协议格式 协议格式表 起始字节字段长度（字节）说明 1 消息长度 2 消息的总长度（字节数），从第一个 字节到最后一个字节。 3 设备ID号 2 设备ID编号，第一个字节代表网络控 制器编号，第二个字节代表就地控制 器编号。 5 采集器类型 1 01电02水03煤气04 6 命令ID 2 第一个字节表示命令ID类别，第二个 字节表示命令编号。 8 命令序号 2 从0开始循环累加 注：分包（按协议）发送的数据，命 令序号需累加 10 信息内容 - 不定长，详见7.6 苏州元澄智能科技有限公司厅 8 74命令命令 IDID 类别类别 目前定义的命令ID类别有3类，以后视需要可以扩展： 序号命令ID类别编号通信方向说明 100H 下行 2 门禁系统协议 01H 上行 元捷能耗监测系统。 75命令列表命令列表 命令号命令号 传送方向传送方向 76门禁系统协议门禁系统协议 7.6.1.下行数据格式下行数据格式 7.6.2.1 上位机命令应答(命令 ID:0001H) 上位机必须对网络控制器的某些指令应答（除网络控制器应答指令和已指定不需上位 机应答的数据），否则网络控制器超时后会重发，网络控制器按照设定的重发次数（出厂 默认为2次）和重发间隔（出厂默认为8秒）重发。该指令默认无需网络控制器应答。 上位机命令应答 起始字节字段长度（字节）说明 10 应答命令序号 2 需要应答的那条命令序号 12 命令ID 2 网络控制器上发指令的ID 14 校验码 1MOD 15 结束符 3EOF 7.6.2.2 时间同步指令（命令 ID：0002H） 该指令只对网络控制器进行时间同步，网络控制器收到该指令后返回应答指令。 起始字节字段长度（字节）说明 10 时间 7 开始一个字节代表年(2012年为0x0C)， 第二个字节代表周，第三个字节代表 月，第四个字节代表日，第五个字节 苏州元澄智能科技有限公司厅 9 代表小时，第六个字节代表分，第七 个字节代表秒 17 校验码 1 18 结束符 3EOF 7.6.2.3 设备时间获取指令（命令 ID：0003H） 该指令用于获取指定网络控制器及该网络控制器下面所有就地控制器的系统时间，网 络控制器收到该指令后返回该网络控制器所有相关设备的系统时间。 起始字节字段长度（字节）说明 10 校验码 1 11 结束符 3EOF 7.6.2.4 网络控制器重启指令（命令 ID：0004H） 该指令用于重启网络控制器，网络控制器收到该指令后返回应答指令，返回应答后网 络控制器进行重启操作。 起始字节字段长度（字节）说明 10 校验码 1 13 结束符 3EOF 7.6.2.5 配置中心服务器通讯参数指令（命令 ID：0005H） 此处的中心服务器通讯参数即为上位机IP地址和端口号，当网络控制器收到该指令并 修完成后返回应答指令，重新启动网络控制器后该参数生效，网络控制器连接设置的IP地 址及端口。 起始字节字段长度（字节）说明 10 服务器通讯IP 地址 4 例如：10.20.37.19表示为0x0A 0x14 0x25 0x13 14 服务器通讯端 口号 2 数值范围0-65535 16 网络控制器IP 地址 4 20 网络控制器端 口号 2 22 网关IP地址 4 26 子网掩码 4 30 校验码 1 31 结束符 3EOF 7.6.2.6 设备极值获取指令（命令 ID:0006H） 苏州元澄智能科技有限公司厅 10 该指令用于获取电表的数值的最大可表示值及最小可表示值。 起始字节字段长度（字节）说明 10 校验码 1 11 结束符 3EOF 7.6.2.7 电量查询指令（命令 ID：0007H） 该指令不需要网络控制器应答，当数据采集器收到该指令后立马上传一条电表电量信 息指令。 起始字节字段长度（字节）说明 10 校验码 1 11 结束符 3EOF 7.6.2.8 采集周期设置指令（命令 ID：0008H） 该指令需要网络控制器应答，指令用于设置网络控制器电表电量上传周期时间间隔。 起始字节字段长度（字节）说明 9 时间间隔 1 单位为分钟，该值表示网络控制器上 传电表电量的时间间隔时长 10 校验码 1 11 结束符 3EOF 7.6.2.9 校验指令（命令 ID：0009H） 该指令需要网络控制器应答，采集器收到该指令后对电表做一次校验操作，并把操作 结果返回给上位机。 起始字节字段长度（字节）说明 9 校验码 1 10 结束符 3EOF 7.6.2.10 断电指令(命令 ID：000AH) 该指令需要网络控制器应答，采集器收到该指令后使电表断电了。 起始字节字段长度（字节）说明 9 校验码 1 10 结束符 3EOF 7.6.2.11 电量监控开始指令（命令 ID：000BH） 苏州元澄智能科技有限公司厅 11 该指令需要网络控制器应答，采集器收到该指令后，如果电表电量有变化则上传该电 表值。 起始字节字段长度（字节）说明 9 校验码 1 10 结束符 3EOF 7.6.2.12 电量监控结束指令（命令 ID：0010H） 该指令需要网络控制器应答，采集器收到该指令后，使命令ID：000AH指令功能失效。 起始字节字段长度（字节）说明 9 校验码 1 10 结束符 3EOF 7.6.2.13 添加采集器（命令 ID:0011H） 该指令需要网络控制器应答,网络控制器收到该指令后才会上传该采集器数据 起始字节字段长度（字节）说明 9 校验码 1 10 结束符 3EOF 7.6.2.14 删除采集器（命令 ID:0012H） 该指令需要网络控制器应答,网络控制器收到该指令后不会上传该采集器数据 起始字节字段长度（字节）说明 9 校验码 1 10 结束符 3EOF 7.6.2.上行数据格式上行数据格式 7.6.2.1 络控制器登录（命令 ID：0101H） 网络控制器开启或重启后第一次向上位机发送数据时，必须首先发送登录指令，登录 指令携带就地控制器及读卡器编号列表，该指令默认需要上位机返回命令应答。 该指令提供网络控制器判断当前登录的上位机是否有效。 起始字节字段长度（字节）说明 9 就地控制器编 号1 3 - - 就地控制器编 号n 3 苏州元澄智能科技有限公司厅 12 - 校验码 1 - 结束符 3EOF 7.6.2.2 网络控制器命令应答（命令 ID：0102H） 网络控制器必须对上位机的某些指令应答，否则上位机超时后会重发，上位机按照重 发次数据（默认2次）和重发间隔（默认8秒）重发。该指令无需上位机应答。 起始字节字段长度（字节）说明 9 应答命令序号 2 需要应答的那条命令序号 11 命令ID 2 上位机下发指令的ID 13 校验码 1 14 结束符 3EOF 7.6.2.3 设备当前时间（命令 ID：0103H） 该指令作为查询设备当前时间信息指令（命令ID：0003H）对应的应答信息，该指令需 要上位机返回应答指令。 起始字节字段长度（字节）说明 9 时间 7 开始一个字节代表年(2012年为0x0C)， 第二个字节代表周，第三个字节代表 月，第四个字节代表日，第五个字节 代表小时，第六个字节代表分，第七 个字节代表秒 16 校验码 1 17 结束符 3EOF 7.6.2.4 设备极值应答指令（命令 ID：0106） 该指令作为设备极值获取指令（命令ID:0006H