ESP通信協议.doc

网管通讯协议 协议流程 网管信息分为实时信息和普通信息两类。对于实时信息，如果主机采用询问的方式,可以一次获取一个整网的的所有实时信息；普通信息则采用主从问答的方式处理，即上位机向下位机发送一条查询或者配置的命令,每一条命令通常只对网络中的一端设备，相对应的下位机收到以后，针对该命令进行相应的处理并将结果返回给上位机。对于网络中的地址自动生成命令,则是按全网同时执行的,上位机只要发起命令,等配置完成时,由上位机查询完成其他的地址收集工作. 协议格式 上位机下发的命令按其管理方式可分为两种，即本地命令和网络命令。本地命令仅用于管理本地网管口相连的单端设备，对于局端和远端都适用；网络命令只有在上位机直接与局端设备相连时才有意义，即只有局端才能执行上位机下发的网络命令，远端会返回命令无法识别的错误码。 下位机收到的有效命令全有命令回应帧，若上位机发送命令后在约定的时间内没有回应，则下位机有可能没有收到数据或收帧错，用户应重发命令。当用户对下位机的配置项改变时，上位机应根据下位机的命令响应帧确定下位机是否接受配置的修改。 协议全部采用ASCII字符。 在下的协议中,所有的本地命令中,地址码不起件用,通常是发”0000”(只有对于全网实时信息发送本地命令时,地址要求与局端的设备地址一致,通常情况,查询全网实时信息使用网络命令,并使用查询网络的局端设备的地址);在使用网络命令时,所有地址有效. 错误代码说明： 1 —— 网管通道接收缓冲区溢出。 2 —— 命令帧校验和错误 3 —— 命令帧内容字符的数量不匹配 4 —— 未知的命令类型 5 —— 命令参数错误 6 —— 因命令执行的对象没有响应导致命令失败 局端设备的地址默认参数为：MasterNetID=0；SubNetID=0；DeviceAddrID=1。 在以下的命令中，CR代表回车符（十进制ASCII码13），LF代表换行符（十进制ASCII码10）， 代表空格，多个空格要出现多个这样字符，且字符间要有字字符分隔。 本协议采用异或的校验方式。校验码产生过程如下：从帧头后的第一个字符开始，依次与其后的字符进行异或运算，运算结果转换成ASCII码添加到命令帧的结尾。 协议中所用的参数凡涉及到有效范围的，由命令发起端保证其可靠性。 协议中凡涉及到对下位机进行参数设置的，由命令发起端负责对设置结果进行检验，一般流程为：发起设置命令——〉收到响应命令——〉发起查询命令——〉收到响应命令——〉检查结果。 为了查阅方便，以下命令格式中用下划线“ ”分隔命令码，实际传送的命令不包含下划线“ ”。 ——上位机下发命令的帧头。 @——上位机下发本地命令的帧头。 *——上位机下发网络命令的帧头。 ——下位机上发命令的帧头。 vv——校验。 CR——帧尾。 基本命令集 t命令：查询设备的局远端特性/ 命令格式： 本地名令： @ t xxxx vv CR 网络命令： * t xxxx vv CR 回 应： t xxxx C[R] n m vv CR 命令解释： 本命令用于查询设备的局远端特性。 xxxx代表地址号。 C[R]：如果设备为局端，则返回C，否则返回R。 n: 如果设备的EEPROM0是好的，则返回T，否则返回F。 m: 如果设备的EEPROM1是好的，则返回T，否则返回F。 附加说明：无。 测试例子： 局端： 发送:@t000034 接收:t0001C36 远端： 发送:@t000034 接收:t0002R24 注:上面例子中的最后两位是校验,下回回应的后两位也是校验,且后都有CR没有显示.在下的测试例子中,都有同此处. I命令：清空设备地址/ 命令格式： 网络命令： # I 9999 vv CR 命令解释： 本命令为广播命令，用于清空网络上所有设备的地址。 附加说明： 本命令只在局端执行有效。且没有回应;为确保此命令能安全执行,通常在间隔300ms左右时,连续执行3-5次. g命令：查询网络配置信息/ 命令格式： 本地名令： @ g xxxx vv CR 网络命令：没有 回 应： g xxxx T[F] vv CR 命令解释： 本命令用于查询设备构成网络时，其地址信息的配置情况。 xxxx代表地址号。 T[F]：如果当前网络所有设备的地址信息配置已经完成，则返回T，否则返回F。 附加说明： 本命令只在局端执行有意义；若对远端执行该命令，则无响应。 执行该命令时，最好用的“I”命令将全网设备的地址配置信息清零，然后用“j”命令启动地址自动配置，最后再用本命令查询网络配置情况。 如果全网已配置完成, 执行本命令后会返回T;此时,执行清楚地址命令,再执行本命令后会返回F;再执行地