银山ys89A通讯规约.docx

银山ys89A通讯规约.docx

《银山ys89A通讯规约.docx》由会员分享，可在线阅读，更多相关《银山ys89A通讯规约.docx（21页珍藏版）》请在冰豆网上搜索。

银山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

文件压缩端口号=

1519

文件传输端口号=

1050

2，报文格式：

命令报文格式

名称（标识）

长度（字节）

涵义

ID

1

报文头

SubAddr

1

Type

1

功能类型

Answer

1

应答码

Password_L

1

口令低位

Password_H

1

口令高位

PacketLen_L

1

包长度低位

PacketLen_H

1

包长度高位

Verify_L

1

校验码低位

Verify_H

1

校验码高位

Data_1

1

数据位1

…

…

…

Data_1499

1

数据位1499

（1）远程录波命令格式

0x68

0x01

0x85

远程录波命令

0xff

0x00

0x00

0x0a

报文长度

0x00

0x00

0x00

注：

录波器端口号为1518，采用流式或报式链接；

包长度为10个字节；

命令发送成功后，录波器返回一个应答包，长度为10个字节，结构如下：

0x68

0x01

0x85

远程录波命令

0x00

应答码

0x00

0x00

0x0a

报文长度

0x00

0x00

0x00

注：

关于应答码，应答码为0x00成功

0x01系统错

0x02系统无应答

（2）远程校时命令格式

0x68

0x01

0x87

远程校时命令

0xff

0x00

0x00

0x13

报文长度

0x00

0x00

0x00

Data_1

Year_L（BCD码）

Data_2

Year_H（BCD码）

Data_3

Month（BCD码）

Data_4

Day（BCD码）

Data_5

Hour（BCD码）

Data_6

Minute（BCD码）

Data_7

Second（BCD码）

Data_8

0x00

Data_9

0x00

注：

录波器端口号为1518，采用流式或报式链接；

包长度为19个字节；

命令发送成功后，录波器返回一个应答包，长度为本10个字节，结构如下：

0x68

0x01

0x87

远程校时命令

0x00

应答码

0x00

0x00

0x0a

报文长度

0x00

0x00

0x00

注：

关于应答码，应答码为0x00校时成功

0x01时间格式错

（3）工作状态命令格式

0x68

0x01

0x80

工作状态命令

0xff

0x00

0x00

0x0A

报文长度低字节

0x00

报文长度高字节

0x00

0x00

注：

录波器端口号为1518，采用流式或报式链接；

包长度为10个字节；

命令发送成功后，录波器返回一个应答包，长度为本819个字节，结构如下：

名称（标识）

长度（字节）

涵义

0x68

0x01

0x80

工作状态命令

0x00

应答码

0x00

0x00

0x33

包长度低字节

0x03

包长度高字节

0x00

0x00

Data_1

…

Data_89

FileName_1_1

1

…

…

FileName_1_28

1

FaultType_1

1

FaultLine_1

1

FaultDistance_1_L

1

FaultDistance_1_H

1

SwitchBit_1

1

StartChannel_1

1

StartType_1_L

1

StartType_1_H

1

…

…

FileName_20_1

1

…

…

FileName_20_28

1

FaultType_20

1

FaultLine_20

1

FaultDistance_20_L

1

FaultDistance_20_H

1

SwitchBit_20

1

StartChannel_20

1

StartType_20_L

1

StartType_20_H

1

注：

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_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启动错误

==0x40C盘读写错

==0x20D盘读写错

==0x10E盘读写错

==0x08F盘读写错

==0x04G盘读写错

==0x02H盘读写错

==0x01工作参数错

9，Data_67-Data_82为前置机错误信息标识

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信息同上

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为1…20）

13，FaultType_x为故障类型

FaultType==0A相接地

==1B相接地

==2C相接地

==3AB接地

==4BC接地

==5AC接地

==6AB相间

==7BC相间

==8AC相间

==9ABC三相短路

14，FaultLine_x为故障线路

15,FaultDistance_x_L,FaultDistance_x_H为故障距离，nDis=0xFF00*（FaultDistance_x_H<<8）+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通道越限

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）文件检索命令格式

名称（标识）

格式

涵义

0x68

0x01

0x81

文件检索命令

0xff

0x00

0x00

0x18

PacketLen_L

报文长度

0x00

PacketLen_H

0x00

0x00

Data_1

16进制

起始年低位

Data_2

16进制

起始年高位

Data_3

16进制

起始月

Data_4

16进制

起始日

Data_5

16进制

起始时

Data_6

16进制

起始分

Data_7

16进制

终止年低位

Data_8

16进制

终止年高位

Data_9

16进制

终止月

Data_10

16进制

终止日

Data_11

16进制

终止时

Data_12

16进制

终止分

Data_13

16进制

文件类型

Data_14

16进制

填入0x00

注：

1，录波器端口号为1518，采用流式或报式链接；

2，包长度为24个字节；

3，Data_1-Data_6为起始时间，Data_7-Data_12为终止时间；

4，Data_13==0x01指定时间段内的录波文件

==0x02指定时间段内有故障的录波文件

==0x03指定时间段内的COMTRADE格式文件

==0x05指定时间段内的励磁机空载文件

==0x06指定时间段内的发电机空载文件

==0x07指定时间段内的发电机短路文件

==0x08指定时间段内的发电机灭磁文件

==0x09指定时间段内的同期文件

5，

（1）客户端检索（Data_13==0x01,0x02,0x03）类型的文件时，录波器成功接收到包以后，返回一个应答包，包中包含一个文件名和该文件的长度；该文件中存放的是指定时间段内的波形文件名，存放方式为文件名20个字节（含路径），文件名之间间隔为8个字节

（2）客户端检索（Data_13==0x05…0x09）类型的文件时，录波器成功接收到包以后，返回一个应答包，包中包含一个文件名和该文件的长度；该文件中存放的是指定时间段内的文件名，存放方式为文件名（含路径），长度不定，文件名之间以0x0d,0x0a为间隔符

文件检索应答包

0x68

0x01

0x81

文件检索命令

0x00

应答码

0x00

0x00

0x30

报文长度

0x00

0x00

0x00

Data_1

…

Data_38

注：

1，Data_1…Data_4为返回文件长度，nLen=Data_1+Data_2*2＾8+Data_3*2＾16+Data_4*2＾24

2,Data_5…Data_32为文件名称，以0x00为文件名结尾，本次返回的文件名称为:

c:

\recdir.lst\null

3，Data_33…Data_38为0x00

4，应答标志为0x00,成功运行了该次检索

应答标志为0x01,不存在该类型文件

应答标志为0x02,时间错

应答标志为0x04,系统忙

应答标志为0x05,包错

应答标志为0x0A,系统错

（5）文件拷贝命令格式

0x68

0x01

0x82

文件拷贝命令

0xff

0x00

0x00

0x46

报文长度低字节

0x00

报文长度高字节

0x00

0x00

Data_1

…

Data_60

注：

1，录波器端口号为1518，采用流式或报式链接；

2，包长度为70个字节；

3，Data_1…Data_4填入0x00；

4，Data_5…Data_54为要拷入的文件名（含路径），如:

d:

\kjsy\2003年12月18日17时45分21秒.sylk，剩余部分填入0x00；

5，Data_55…Data_58为已传输字节；

6，Data_59,Data_60为0x00；

7，录波器成功接收到包以后，返回一个应答包，结构如下：

文件拷贝应答包

0x68

0x01

0x82

文件拷贝命令

0x00

应答码

0x00

0x00

0x46

报文长度低字节

0x00

报文长度高字节

0x00

0x00

Data_1

…

Data_60

注：

1，Data_1…Data_4为要拷贝的文件长度，nLen=Data_1+Data_2*2＾8+Data_3*2＾16+Data_4*2＾24；

2，Data_5…Data_58和文件拷贝命令包相同；

3，Data_59,Data_60填入0x00；

4，应答码为0x00，成功，可以传文件；

为0x01，文件不存在；

为0x02，系统错；

为0x03，包错；

为0x04，文件打开错；

为0x07，续传以完成；

为0x08，传输忙。

5，在成功收到返回包后，采用流式连接方式连接到录波器的1050端口，每次读取2048个字节，直到文件传输完成为止。

（6）参数上传命令格式

0x68

0x01

0x83

参数上传命令

0xff

Pass_L

录波器口令低字节

Pass_H

录波器口令高字节

0x28

报文长度

0x00

0x00

0x00

Data_1

…

Data_30

注：

1，录波器端口号为1518，采用流式或报式链接；

2，包长度为40个字节；

3，Data_1…Data_4为要上传文件的长度，nLen=Data_1+Data_2*2＾8+Data_3*2＾16+Data_4*2＾24；

4，Data_5…Data_24为不含路径上传文件名，如：

param.0000；

5，Data_25…Data_26为校验码；

6，录波器成功接收到包后，返回一个应答包，结构如下：

0x68

0x01

0x83

参数上传命令

0x00

应答码

0x00

0x00

0x0a

报文长度

0x00

CheckSum_L

校验码低字节

CheckSum_H

校验码高字节

注：

1，应答码为0，成功，可以上传参数文件；

为2，口令错误；

2，在成功收到返回包以后，采用流式连接方式连接到录波器1050端口，每次发送2048个字节，直至参数文件上传完毕。

（7）实时监测命令格式

0x68

0x01

0x84

实时监测命令

0xff

Pass_L

Pass_H

0x0a

报文长度

0x00

0x00

0x00

注：

1，录波器端口号为1518，采用流式或报式链接；

2，包长度为10个字节；

3，录波器成功接收到包以后，返回一个应答包，结构如下：

0x68

0x00

0x84

实时监测命令

0x00

应答码

Pass_L

录波器口令低位

Pass_H

录波器口令高位

0x12

报文长度低字节

0x03

报文长度高字节

CheckSum_L

校验码低位

CheckSum_H

校验码高位

Data_1

…

Data_776

注：

1，包长度为786个字节；

2，Data_1…Data_776参见如下结构：

Struct{

chartime[18];

floatdata[168];

intfreq[21];

shortwavetype;}

（1）前18个字节为时间标记，如”20050420150012100”，表示2005年4月20日15时0分12秒100毫秒；

（2）结构成员data数组表示7块板84个通道的经傅立叶变换的a,b值，依次为a0,b0,a1,b1,a2,b2…；（对应的值为采样值，接收方需要进行相关的转换才能得出其二次值，包括进行零漂处理，AD变换系数400./16384处理，幅值系数修正等。

（3）为7块板21组频率值，接收端需要进行实际频率值计算公式为：

50.+freq/0x7fff;

（4）wavetype备用。

3，应答码为0，实时监测成功；

为1，系统忙；

为2，实时监测失败；

为3，实时监测超时。

（8）文件压缩命令格式

0x68

0x01

0x70

文件压缩命令

0xff

Pass_L

录波器口令低字节

Pass_H

录波器口令高字节

0x46

报文长度低字节

0x00

报文长度高字节

CheckSum_L

校验码低字节

CheckSum_H

校验码高字节

Data_1

…

Data_60

注：

1，录波器端口号为1519，采用流式或报式链接；

2，包长度为70个字节；

3，Data_1…Data_60为要压缩传输的文件名；

4，录波器成功接收到包后，返回一个应答包，结构如下：

0x68

0x01

0x70

文件压缩命令

0x00

应答码

Pass_L

录波器口令低字节

Pass_H

录波器口令高字节

0x46

报文长度低字节

0x00

报文长度高字节

0x00

0x00

Data_1

…

Data_60

注：

1，包长度为70个字节；

2，Data_1…Data_4为压缩前文件的长度，Data_4…Data_8为压缩后文件的长度；

3，Data_9…Data_58为已压缩的文件名称，如：

c:

\param_C.0001，即参数文件被压缩并改了名称以便区别；

4，应答码为0，成功进行了压缩，可以传输被压缩的文件；

为3，超时；

5，成功收到返回包以后，以被压缩的文件名（含路径）为参数发拷贝文件命令，传输文件至本机后再解压。

（9）录波器类型及软件版本号查询命令格式

0x68

0x00

0x79

版本查询命令

0xff

0x00

0x00

0x0a

报文长度

0x00

0x00

0x00

注：

1，录波器端口号为1518，采用流式或报式链接；

2，包长度为10个字节；

3，录波器在成功接收到包后，返回一个应答包，结构如下：

0x68

0x00

0x79

版本查询命令

0x00

0x00

0x00

0x28

报文长度

0x00

CheckSum_L

校验码低字节

CheckSum_H

校验码高字节

Data_1

…

Data_30

注：

1，包长度为40个字节；

2，Data_1…Data_30参见如下结构：

struct{

charMachType[10];

charSoftVer[10];

charOther[10];}

MachType为10个字节的机器类型，SoftVer为10个字节的软件版本号，Other为预留的10个字节；

3，应答码为0成功，否则查询失败。

注：

对已有功能与对外规约相异的，以对外规约为准。