银山ys89A通讯规约.docx

1、银山ys89A通讯规约ys-89A/201A录波器通讯规约及离线软件相关部分的介绍1， 通讯接口：(1) 接口标准：采用以太网方式，TCP/IP协议；或者采用拨号网络方式，绑定TCP/IP协议；(2) 工作方式：控制命令的工作方式可以由配置文件设定采用TCP流式或UDP报式传输，默认采用TCP流式传输，默认的端口号为1518/1519，文件传输的工作方式采用TCP流式传输，默认端口号为1050。注：配置文件说明：（1） 文件名称：ys_comport.ini;（2） 控制命令及端口号定义方式： 设定名称默认值涵义以太网协议 =TCP/UDP通讯控制命令方式命令报文端口号 =1518文件压缩端口

2、号 =1519文件传输端口号 =1050 2， 报文格式：命令报文格式名称(标识)长度(字节)涵义ID1报文头SubAddr1Type1功能类型Answer1应答码Password_L1口令低位Password_H1口令高位PacketLen_L1包长度低位PacketLen_H1包长度高位Verify_L1校验码低位Verify_H1校验码高位Data_11数据位1Data_14991数据位1499(1) 远程录波命令格式0x680x010x85远程录波命令0xff0x000x000x0a报文长度0x000x000x00注：录波器端口号为1518，采用流式或报式链接；包长度为10个字节；命令

3、发送成功后，录波器返回一个应答包，长度为10个字节，结构如下：0x680x010x85远程录波命令0x00应答码0x000x000x0a报文长度0x000x000x00 注：关于应答码，应答码为 0x00成功 0x01系统错 0x02系统无应答(2) 远程校时命令格式0x680x010x87远程校时命令0xff0x000x000x13报文长度0x000x000x00Data_1Year_L (BCD码)Data_2Year_H(BCD码)Data_3Month(BCD码)Data_4Day(BCD码)Data_5Hour(BCD码)Data_6Minute(BCD码)Data_7Second(

4、BCD码)Data_80x00Data_90x00 注：录波器端口号为1518，采用流式或报式链接； 包长度为19个字节； 命令发送成功后，录波器返回一个应答包，长度为本10个字节，结构如下：0x680x010x87远程校时命令0x00应答码0x000x000x0a报文长度0x000x000x00 注：关于应答码，应答码为 0x00 校时成功 0x01 时间格式错(3) 工作状态命令格式0x680x010x80工作状态命令0xff0x000x000x0A报文长度低字节0x00报文长度高字节0x000x00 注：录波器端口号为1518，采用流式或报式链接； 包长度为10个字节； 命令发送成功后，

5、录波器返回一个应答包，长度为本819个字节，结构如下：名称(标识)长度(字节)涵义0x680x010x80工作状态命令0x00应答码0x000x000x33包长度低字节0x03包长度高字节0x000x00Data_1Data_89FileName_1_11FileName_1_281FaultType_11FaultLine_11FaultDistance_1_L1FaultDistance_1_H1SwitchBit_11StartChannel_11StartType_1_L1StartType_1_H1FileName_20_11FileName_20_281FaultType_201F

6、aultLine_201FaultDistance_20_L1FaultDistance_20_H1SwitchBit_201StartChannel_201StartType_20_L1StartType_20_H1 注：1，Data_1保留； 2，Data_2保留；3，Data_3-Data_4 前置机巡检信息 0x0000 前置机巡检正常 0x0080 前置机A巡检错 0x0040 前置机B巡检错 0x0020 前置机C巡检错 0x0010 前置机D巡检错 0x0008 前置机E巡检错 0x0004 前置机F巡检错 0x0002 前置机G巡检错 0x0001 前置机H巡检错 4，Data

7、_5-Data_24 为地区名称 5，Data_25-Data_44 为站名称 6，Data_45-Data_64 为机器名称 7，Data_65 为工作状态 Data_65 =0x80 正在高速录波 =0x40 正在压缩录波 =0x20 正在低速录波 =0x10 慢录波状态 =高三位同时为0，非录波状态 8，Data_66 为系统错误标识 Data_66 =0x80 启动错误 =0x40 C盘读写错 =0x20 D盘读写错 =0x10 E盘读写错 =0x08 F盘读写错 =0x04 G盘读写错 =0x02 H盘读写错 =0x01 工作参数错 9，Data_67-Data_82 为前置机错误信

8、息标识 Data_67,Data_68 为前置机A Data_69,Data_70 为前置机B Data_71,Data_72 为前置机C Data_73,Data_74 为前置机D Data_75,Data_76 为前置机E Data_77,Data_78 为前置机F Data_79,Data_80 为前置机G Data_81,Data_82 为前置机H 前置机A的错误信息：(低字节在Data_67，高字节在Data_68)0x0000 正常;0x0001 慢录波换页超时0x0002 快录波换页超时0x0003 快录波丢页0x0004 复位0x0005配置错前置机B,C,D,E,F,G,H信

9、息同上 10，Data_83-Data_89 为返回状态的时间 Data_83 年的低位 Data_84 年的高位 Data_85 月 Data_86 日 Data_87 时 Data_88 分 Data_89 秒 11，FileName_1_1-StartType_20_H 为最近20个录波文件的信息，共720个字节 12，FileName_x_1-FileName_x_28 为波形文件名(x为120) 13，FaultType_x 为故障类型 FaultType =0 A相接地 =1 B相接地 =2 C相接地 =3 AB接地 =4 BC接地 =5 AC接地 =6 AB相间 =7 BC相间

10、=8 AC相间 =9 ABC三相短路 14，FaultLine_x 为故障线路 15, FaultDistance_x_L,FaultDistance_x_H为故障距离，nDis=0xFF00*(FaultDistance_x_H8)+0x00FF*FaultDistance_x_L 16， SwitchBit_x 为变位的开关 17， StartChannel_x 为故障通道号 18， StartType_x_L,StartType_x_H为通道故障类型 StartType_x_L=0x01 幅值突变 StartType_x_L=0x02 “” StartType_x_L=0x04 通道越限

11、 StartType_x_L=0x08 正序越限 StartType_x_L=0x10 负序越限 StartType_x_L=0x20 频率越限 StartType_x_L=0x40 频率突变 StartType_x_L=0x80 振荡 StartType_x_H=0x01 三次谐波 StartType_x_H=0x02 逆功率 StartType_x_H=0x04 过激磁 StartType_x_H=0x08 低励磁 19， 应答码 为0x00 成功 为0x01 系统错 为0x02 系统无应答 (4)文件检索命令格式名称(标识)格式涵义0x680x010x81文件检索命令0xff0x000x

12、000x18PacketLen_L报文长度0x00PacketLen_H0x000x00Data_116进制起始年低位Data_216进制起始年高位Data_316进制起始月Data_416进制起始日Data_516进制起始时Data_616进制起始分Data_716进制终止年低位Data_816进制终止年高位Data_916进制终止月Data_1016进制终止日Data_1116进制终止时Data_1216进制终止分Data_1316进制文件类型Data_1416进制填入0x00 注：1，录波器端口号为1518，采用流式或报式链接； 2，包长度为24个字节； 3，Data_1-Data_6为

13、起始时间，Data_7-Data_12为终止时间； 4，Data_13 =0x01 指定时间段内的录波文件 =0x02 指定时间段内有故障的录波文件 =0x03 指定时间段内的COMTRADE格式文件 =0x05 指定时间段内的励磁机空载文件 =0x06 指定时间段内的发电机空载文件 =0x07 指定时间段内的发电机短路文件 =0x08 指定时间段内的发电机灭磁文件 =0x09 指定时间段内的同期文件 5，(1)客户端检索(Data_13=0x01,0x02,0x03)类型的文件时，录波器成功接收到包以后，返回一个应答包，包中包含一个文件名和该文件的长度；该文件中存放的是指定时间段内的波形文件

14、名，存放方式为文件名20个字节(含路径)，文件名之间间隔为8个字节 (2)客户端检索(Data_13=0x050x09)类型的文件时，录波器成功接收到包以后，返回一个应答包，包中包含一个文件名和该文件的长度；该文件中存放的是指定时间段内的文件名，存放方式为文件名(含路径)，长度不定，文件名之间以0x0d,0x0a为间隔符 文件检索应答包0x680x010x81文件检索命令0x00应答码0x000x000x30报文长度0x000x000x00Data_1Data_38 注：1，Data_1Data_4为返回文件长度，nLen=Data_1+Data_2*28+Data_3*216+Data_4*

15、224 2, Data_5Data_32为文件名称，以0x00为文件名结尾，本次返回的文件名称为:c:recdir.lstnull 3，Data_33Data_38为0x00 4，应答标志为 0x00,成功运行了该次检索 应答标志为 0x01,不存在该类型文件 应答标志为 0x02,时间错 应答标志为 0x04,系统忙 应答标志为 0x05,包错 应答标志为 0x0A,系统错 (5)文件拷贝命令格式0x680x010x82文件拷贝命令0xff0x000x000x46报文长度低字节0x00报文长度高字节0x000x00Data_1Data_60 注：1，录波器端口号为1518，采用流式或报式链接

16、； 2，包长度为70个字节； 3，Data_1Data_4填入0x00； 4，Data_5Data_54为要拷入的文件名(含路径)，如:d:kjsy2003年12月18日17时45分21秒.sylk，剩余部分填入0x00； 5，Data_55Data_58为已传输字节； 6，Data_59,Data_60为0x00； 7，录波器成功接收到包以后，返回一个应答包，结构如下： 文件拷贝应答包0x680x010x82文件拷贝命令0x00应答码0x000x000x46报文长度低字节0x00报文长度高字节0x000x00Data_1Data_60 注：1，Data_1Data_4为要拷贝的文件长度，nL

17、en=Data_1+Data_2*28+Data_3*216+Data_4*224； 2，Data_5Data_58和文件拷贝命令包相同； 3，Data_59,Data_60填入0x00； 4，应答码为 0x00，成功，可以传文件； 为 0x01，文件不存在； 为 0x02，系统错； 为 0x03，包错； 为 0x04，文件打开错； 为 0x07，续传以完成； 为 0x08，传输忙。 5，在成功收到返回包后，采用流式连接方式连接到录波器的1050端口，每次读取2048个字节，直到文件传输完成为止。 (6)参数上传命令格式0x680x010x83参数上传命令0xffPass_L录波器口令低字节P

18、ass_H录波器口令高字节0x28报文长度0x000x000x00Data_1Data_30注：1，录波器端口号为1518，采用流式或报式链接； 2，包长度为40个字节； 3，Data_1Data_4为要上传文件的长度，nLen=Data_1+Data_2*28+Data_3*216+Data_4*224； 4，Data_5Data_24为不含路径上传文件名，如：param.0000； 5，Data_25Data_26为校验码；6，录波器成功接收到包后，返回一个应答包，结构如下：0x680x010x83参数上传命令0x00应答码0x000x000x0a报文长度0x00CheckSum_L校验码

19、低字节CheckSum_H校验码高字节 注：1，应答码为0，成功，可以上传参数文件； 为2，口令错误； 2，在成功收到返回包以后，采用流式连接方式连接到录波器1050端口，每次发送2048个字节，直至参数文件上传完毕。 (7)实时监测命令格式0x680x010x84实时监测命令0xffPass_LPass_H0x0a报文长度0x000x000x00 注：1，录波器端口号为1518，采用流式或报式链接； 2，包长度为10个字节； 3，录波器成功接收到包以后，返回一个应答包，结构如下：0x680x000x84实时监测命令0x00应答码Pass_L录波器口令低位Pass_H录波器口令高位0x12报文

20、长度低字节0x03报文长度高字节CheckSum_L校验码低位CheckSum_H校验码高位Data_1Data_776 注：1，包长度为786个字节； 2，Data_1Data_776参见如下结构： Struct char time18; float data168; int freq21; short wavetype; (1)前18个字节为时间标记，如”20050420150012100”，表示2005年4月20日15时0分12秒100毫秒； (2)结构成员data数组表示7块板84个通道的经傅立叶变换的a,b值，依次为a0,b0,a1,b1,a2,b2；（对应的值为采样值，接收方需要进

21、行相关的转换才能得出其二次值，包括进行零漂处理，AD变换系数400./16384处理，幅值系数修正等。 (3)为7块板21组频率值，接收端需要进行实际频率值计算公式为：50.+freq/0x7fff;(4)wavetype备用。 3，应答码为0，实时监测成功； 为1，系统忙； 为2，实时监测失败； 为3，实时监测超时。 (8)文件压缩命令格式0x680x010x70文件压缩命令0xffPass_L录波器口令低字节Pass_H录波器口令高字节0x46报文长度低字节0x00报文长度高字节CheckSum_L校验码低字节CheckSum_H校验码高字节Data_1Data_60 注：1，录波器端口号

22、为1519，采用流式或报式链接； 2，包长度为70个字节； 3，Data_1Data_60为要压缩传输的文件名； 4，录波器成功接收到包后，返回一个应答包，结构如下：0x680x010x70文件压缩命令0x00应答码Pass_L录波器口令低字节Pass_H录波器口令高字节0x46报文长度低字节0x00报文长度高字节0x000x00Data_1Data_60 注：1，包长度为70个字节； 2，Data_1Data_4为压缩前文件的长度，Data_4Data_8为压缩后文件的长度； 3，Data_9Data_58为已压缩的文件名称，如：c:param_C.0001，即参数文件被压缩并改了名称以便区

23、别； 4，应答码 为0，成功进行了压缩，可以传输被压缩的文件； 为3，超时； 5，成功收到返回包以后，以被压缩的文件名(含路径)为参数发拷贝文件命令，传输文件至本机后再解压。 (9)录波器类型及软件版本号查询命令格式0x680x000x79版本查询命令0xff0x000x000x0a报文长度0x000x000x00 注：1，录波器端口号为1518，采用流式或报式链接； 2，包长度为10个字节； 3，录波器在成功接收到包后，返回一个应答包，结构如下：0x680x000x79版本查询命令0x000x000x000x28报文长度0x00CheckSum_L校验码低字节CheckSum_H校验码高字节Data_1Data_30 注：1，包长度为40个字节； 2，Data_1Data_30参见如下结构： struct char MachType10; char SoftVer10; char Other10; MachType为10个字节的机器类型，SoftVer为10个字节的软件版本号，Other为预留的10个字节； 3，应答码 为0成功，否则查询失败。 注：对已有功能与对外规约相异的，以对外规约为准。