银山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成功，否则查询失败。
注：
对已有功能与对外规约相异的，以对外规约为准。
升级会员 