FGL-3000电力故障录波装置通信规约.doc

fgl-3000系列录波装置通信规约 哈尔滨国力电气有限公司fgl电力故障录波装置以太网通信规约（2.1 版）哈尔滨国力电气有限公司二五年七月一日一、通信接口1. 接口标准：10m/100m 自适应以太网接口。2. 通信协议：tcp/ip 协议。3. tcp 端口号：764ah（30282）。4. 传输模式：平衡传输。5. 主从方式：录波装置为从机。二、报文格式1 数据类型定义符号宽度(字节)范围说明char100h7fh8 位有符号数值，常用来表示一个ascii 字符。short20000h7fffh16 位有符号数值。long400000000h7fffffffh32 位有符号数值。byte100hffh8 位无符号数值。word20000hffffh16 位无符号数值。dword400000000h7fffffffh32 位无符号数值。float432 位有符号的浮点数double864 位有符号的浮点数2 报文的结构字节偏移域符号数据类型意义03typdword报文类型（32 位无符号整数）47lendworddat 域长度（32 位无符号整数）88+lendat任意类型报文数据（由len 指定长度）3说明1 字节序是低字节在前，高字节在后。2 根据typ 的不同，dat 域可以是任意类型的数据或数据结构（struct）。3 报文的最大长度为16384 字节，因此len 的最大值是16384-8=16376。4 如果报文中包含字符串信息，则字符串以00h 字符结束。如字符串“abc”在报文中的数据会占用4 个字节，依次是：41h，42h，43h，00h。三、报文类型1控制方向typ 值类型名含义00000001hptype_return对上一条命令的响应(packet_return 结构)00000003hptype_packetsize请求录波装置传送文件时的分包大小00000004hptype_framedelay请求录波装置发送数据时祯间隔时间00000011hptype_file_data单个文件的数据00000012hptype_file_get要求对方传送指定的文件(file_get 结构)0000003ahptype_work_path要求对方回应程序的工作目录0000003bhptype_data_path要求对方回应录波数据的存放目录0000006ehptype_cancel要求对方中止当前的传输任务00000205hptype_record遥控录波00000300hptype_getnewstatus请求录波器的新状态00000301hptype_resetnewstatus复归录波器的新状态2监视方向typ 值类型名含义00000001hptype_return对上一条命令的响应(packet_return 结构)00000003hptype_packetsize返回录波装置传送文件时的分包大小00000004hptype_framedelay返回录波装置发送数据时祯间隔时间00000011hptype_file_data单个文件的数据00000013hptype_file_put要求对方接收文件(file_info 结构)0000003ahptype_work_path回应程序的工作目录(file_info 结构)0000003bhptype_data_path回应录波数据的存放目录(file_info 结构)0000006ehptype_cancel要求对方中止当前的传输任务00000300hptype_getnewstatus回应录波器的新状态四、结构定义1 date_time 结构字节偏移域符号宽度（字节）范围说明01yearword，219802100时间的年份数23monthword，2112时间的月份数45dayword，2131时间的日期数67hourword，2023时间的小时数89minuteword，2059时间的分钟数1011secondword，2059时间的秒数1213msword，20999时间的毫秒数1415usword，20999时间的微秒数2 packet_return 结构字节偏移域符号宽度（字节）说明03codedword，4错误码47senderdword，4发送者8263messagechar256，256对错误码的文本表述说明：a) sender 域定义如下：0sender_unkown未知1sender_recorder子站节点（录波装置）2sender_branch分站节点3sender_center主站节点b) code 域定义如下：71000econn_remoteclose远方已经关闭71001econn_toomany连接太多71002econn_noack远方没有应答71003econn_ptype数据包类型错误71004econn_remotecancel远方取消了当前操作71005econn_localcancel本地取消了当前操作71006econn_nounitid没有找到指定的设备71200econn_filecreate创建文件失败71201econn_fileopen打开文件失败71202econn_memory内存分配失败71250econn_dbconn连接数据库失败71300econn_nodllfun动态库中无函数71301econn_command无效的命令（该命令系统不支持）71302econn_no_data没有所请求的数据71303econn_db_exception数据库异常71304econn_busy系统繁忙71305econn_param参数错误或无效0econn_success成功（无错误）165535操作系统定义的错误码3 file_info 结构字节偏移域符号宽度（字节）说明03fromdword，4文件来源419timedate_time 结构，16文件时间2023sizedword，4文件大小2427 attrdword，4文件属性2831offsetdword，4发送的文件偏移3235lengthdword，4发送的文件长度36291namechar256，256文件名说明：a) from 域定义如下：0file_from_disk来源于磁盘b) attr 域各二进制位定义如下：00000001hfile_attribute_readonly只读00000002hfile_attribute_hidden隐藏00000004hfile_attribute_system系统00000010hfile_attribute_directory文件夹00000020hfile_attribute_archive存档00000080hfile_attribute_normal一般00000100hfile_attribute_temporary临时4 file_get 结构字节偏移域符号宽度（字节）说明01fromword，2文件来源23flagword，2标记47offsetdword，4文件偏移，用于断点续传811fidlong，4根据flag 域的区别含义不同12267namechar256，256文件名说明：a) from 域定义如下：0file_from_disk来源于磁盘b) flag 域各二进制位定义如下：00000001hfile_flag_zip传送之前压缩文件00000002hfile_flag_del传送之后删除文件c) fid 域当flag 为0 时，fid 域也为0；5 fault_info 结构字节偏移域符号宽度（字节）说明01typeword，2文件类型23datnumshort，2数据文件数目（总为1）45connumshort，2配置文件数目（未使用）69faultidlong，4故障编号1013filesizedword，4文件大小1417devidlong，4设备节点id（未使用）1821lineidlong，4故障线路id（未使用）2225staidlong，4子站节点id（未使用）2629faulttypedword，4故障类型3037fdistdouble，8故障距离（km）3853timedate_time，16故障时间54117linenamechar64，64故障元件名称118373filenamechar256，256故障文件名称374501stichar128，128启动信息说明：a) faulttype 域定义如下：0000hfault_none无故障0001hfault_ana 相接地故障0002hfault_bnb 相接地故障0004hfault_cnc 相接地故障0008hfault_abab 短路故障0010hfault_bcbc 短路故障0020hfault_caca 短路故障0040hfault_abnab 短路接地故障0080hfault_bcnbc 短路接地故障0100hfault_canca 短路接地故障0200hfault_abc三相短路故障0400hfault_abcn三相短路接地故障0800hfault_other其他类型故障1000hfault_bus母线故障2000hfault_out区外故障2001hfault_trn变压器内部故障7fffhfault_noana尚未分析五、通信流程1 初始化（建立连接）的过程主站子站成功建立socket 连接；回答报文：typ=ptype_return；len=8 或0；如果len=8，则：dat=packet_return 结构；packet_return:code=econn_success；packet_return:center=0；packet_return:message=无内容；否则只有报文头。初始化过程完成；成功2 召唤单个文件数据的过程主站子站发送报文：typ=ptype_file_get；len=12+file_get:name 字符串长度+1；dat=file_get 结构；file_get:from=0；file_get:flag=0；file_get:offset=0；file_get:fid=0；file_get:name=全路经文件名；回答报文：typ=ptype_file_put；len=292；dat=file_info 结构；file_info:from=0；file_info:length=文件长度；file_info:size=文件长度；file_info:offset=0；其他都是0；发送若干包ptype_file_data 报文；typ=ptype_file_data；len=x；dat=文件数据；发送ptype_file_data 报文；typ=ptype_file_data；len=0；dat=无内容；通信过程完成；成功成功收到ptype_file_put 报文；typ=ptype_file_put；len=292；dat=file_info 结构；file_info:from=0；file_info:length=文件长度；file_info:size=文件长度；file_info:offset=0；其他都是0；收到若干包ptype_file_data 报文；typ=ptype_file_data；len=x；dat=文件数据；收到ptype_file_data 报文；typ=ptype_file_data；len=0；dat=无内容；通信过程完成；回答报文：typ=ptype_return；len=8+packet_return:message 字符串长度+1；dat=packet_return 结构；packet_return:code=错误编码；packet_return:center=0；packet_return:message=错误信息；通信过程完成；出错出错收到ptype_return 报文；typ=ptype_return；len=8+packet_return:message 字符串长度+1；dat=packet_return 结构；packet_return:code=错误编码；packet_return:center=0；packet_return:message=错误信息；通信过程完成；如果通信成功，则将接收到的ptype_file_data 报文的dat 域内容按顺序组装成一个文件就是要传送的文件；双方在通信过程中的任何时候收到ptype_cancel 报文均表示该次通信过程中止；主站端在收到一个ptype_file_data 报文之后，通信过程完成之前的任何时候收到非ptype_file_data 报文均表示通信过程出错，中止该次通信； 3.查询装置新状态的过程主站子站发送报文：typ=ptype_getnewstatus；len=0；dat=无内容；回答报文：typ=ptype_getnewstatus；len=4；dat=newstatus；通信过程完成；成功成功收到ptype_getnewstatus 报文；typ=ptype_getnewstatus；len=4；dat=newstatus；通信过程完成；回答报文：typ=ptype_return；len=8+packet_return:message 字符串长度+1；dat=packet_return 结构；packet_return:code=错误编码；packet_return:center=0；packet_return:message=错误信息；通信过程完成；出错出错收到ptype_return 报文；typ=ptype_return；len=8+packet_return:message 字符串长度+1；dat=packet_return 结构；packet_return:code=错误编码；packet_return:center=0；packet_return:message=错误信息；通信过程完成；newstatus 数据是一个dword 类型的值，其各二进制位定义如下：bit0=1 表示有新录波；bit1=1 表示定值改变；bit2=1 表示配置改变。每次重新连接之后，所有的位都会被设置成1，即重新连接后第一次接收到的newstatus 总是为ffffffffh。4.复归装置新状态的过程主站子站发送报文：typ=ptype_resetnewstatus；len=4；dat=newstatus_bit；回答报文：typ=ptype_return；len=8；dat=packet_return 结构；packet_return:code=econn_success；packet_return:center=0；packet_return:message=无内容；通信过程完成；成功成功收到ptype_getnewstatus 报文；typ=ptype_return；len=8；dat=packet_return 结构；packet_return:code=econn_success；packet_return:center=0；packet_return:message=无内容；通信过程完成；回答报文：typ=ptype_return；len=8+packet_return:message 字符串长度+1；dat=packet_return 结构；packet_return:code=错误编码；packet_return:center=0；packet_return:message=错误信息；通信过程完成；出错出错收到ptype_return 报文；typ=ptype_return；len=8+packet_return:message 字符串长度+1；dat=packet_return 结构；packet_return:code=错误编码；packet_return:center=0；packet_return:message=错误信息；通信过程完成；newstatus_bit 是一个dword 类型的数值；假如要复归新录波的状态，则newstatus_bit=00000001h；假如要复归定值改变的状态，则newstatus_bit=00000002h；当主站得到录波装置的新状态信息后，应对新状态作出相应的处理，然后复归该状态。如得到新录波的状态后就应将新的录波数据传送上来，然后复归该状态。5请求装置工作目录的过程主站子站发送报文：typ=ptype_work_path；len=0；dat=无内容；回答报文：typ=ptype_work_path；len=工作目录的字符串长度+1；dat=path；通信过程完成；成功成功收到ptype_work_path 报文；typ=ptype_work_path；len=工作目录的字符串长度+1；dat=path；通信过程完成；回答报文：typ=ptype_return；len=8+packet_return:message 字符串长度+1；dat=packet_return 结构；packet_return:code=错误编码；packet_return:center=0；packet_return:message=错误信息；通信过程完成；出错出错收到ptype_return 报文；typ=ptype_return；len=8+packet_return:message 字符串长度+1；dat=packet_return 结构；packet_return:code=错误编码；packet_return:center=0；packet_return:message=错误信息；通信过程完成；path 是char 型的字符数组，表示系统软件的工作目录，目录包含结尾的“”；如：e:zyhd6.请求录波装置传送文件时分包大小的过程主站子站发送报文：typ=ptype_packetsize；len=2；dat=word 数据类型；当dat=248 并且dat=0 并且dat=30000 时，表示要求录波装置改变传送文件时祯与祯之间的时间间隔为dat 指定的毫秒数；当dat=fff