FGL-3000電力故障錄波裝置通信規(guī)約.doc

fgl-3000系列錄波裝置通信規(guī)約 哈爾濱國(guó)力電氣有限公司fgl電力故障錄波裝置以太網(wǎng)通信規(guī)約（2.1 版）哈爾濱國(guó)力電氣有限公司二五年七月一日一、通信接口1. 接口標(biāo)準(zhǔn)：10m/100m 自適應(yīng)以太網(wǎng)接口。2. 通信協(xié)議：tcp/ip 協(xié)議。3. tcp 端口號(hào)：764ah（30282）。4. 傳輸模式：平衡傳輸。5. 主從方式：錄波裝置為從機(jī)。二、報(bào)文格式1 數(shù)據(jù)類型定義符號(hào)寬度(字節(jié))范圍說(shuō)明char100h7fh8 位有符號(hào)數(shù)值，常用來(lái)表示一個(gè)ascii 字符。short20000h7fffh16 位有符號(hào)數(shù)值。long400000000h7fffffffh32 位有符號(hào)數(shù)值。byte100hffh8 位無(wú)符號(hào)數(shù)值。word20000hffffh16 位無(wú)符號(hào)數(shù)值。dword400000000h7fffffffh32 位無(wú)符號(hào)數(shù)值。float432 位有符號(hào)的浮點(diǎn)數(shù)double864 位有符號(hào)的浮點(diǎn)數(shù)2 報(bào)文的結(jié)構(gòu)字節(jié)偏移域符號(hào)數(shù)據(jù)類型意義03typdword報(bào)文類型（32 位無(wú)符號(hào)整數(shù)）47lendworddat 域長(zhǎng)度（32 位無(wú)符號(hào)整數(shù)）88+lendat任意類型報(bào)文數(shù)據(jù)（由len 指定長(zhǎng)度）3說(shuō)明1 字節(jié)序是低字節(jié)在前，高字節(jié)在后。2 根據(jù)typ 的不同，dat 域可以是任意類型的數(shù)據(jù)或數(shù)據(jù)結(jié)構(gòu)（struct）。3 報(bào)文的最大長(zhǎng)度為16384 字節(jié)，因此len 的最大值是16384-8=16376。4 如果報(bào)文中包含字符串信息，則字符串以00h 字符結(jié)束。如字符串“abc”在報(bào)文中的數(shù)據(jù)會(huì)占用4 個(gè)字節(jié)，依次是：41h，42h，43h，00h。三、報(bào)文類型1控制方向typ 值類型名含義00000001hptype_return對(duì)上一條命令的響應(yīng)(packet_return 結(jié)構(gòu))00000003hptype_packetsize請(qǐng)求錄波裝置傳送文件時(shí)的分包大小00000004hptype_framedelay請(qǐng)求錄波裝置發(fā)送數(shù)據(jù)時(shí)禎間隔時(shí)間00000011hptype_file_data單個(gè)文件的數(shù)據(jù)00000012hptype_file_get要求對(duì)方傳送指定的文件(file_get 結(jié)構(gòu))0000003ahptype_work_path要求對(duì)方回應(yīng)程序的工作目錄0000003bhptype_data_path要求對(duì)方回應(yīng)錄波數(shù)據(jù)的存放目錄0000006ehptype_cancel要求對(duì)方中止當(dāng)前的傳輸任務(wù)00000205hptype_record遙控錄波00000300hptype_getnewstatus請(qǐng)求錄波器的新狀態(tài)00000301hptype_resetnewstatus復(fù)歸錄波器的新狀態(tài)2監(jiān)視方向typ 值類型名含義00000001hptype_return對(duì)上一條命令的響應(yīng)(packet_return 結(jié)構(gòu))00000003hptype_packetsize返回錄波裝置傳送文件時(shí)的分包大小00000004hptype_framedelay返回錄波裝置發(fā)送數(shù)據(jù)時(shí)禎間隔時(shí)間00000011hptype_file_data單個(gè)文件的數(shù)據(jù)00000013hptype_file_put要求對(duì)方接收文件(file_info 結(jié)構(gòu))0000003ahptype_work_path回應(yīng)程序的工作目錄(file_info 結(jié)構(gòu))0000003bhptype_data_path回應(yīng)錄波數(shù)據(jù)的存放目錄(file_info 結(jié)構(gòu))0000006ehptype_cancel要求對(duì)方中止當(dāng)前的傳輸任務(wù)00000300hptype_getnewstatus回應(yīng)錄波器的新狀態(tài)四、結(jié)構(gòu)定義1 date_time 結(jié)構(gòu)字節(jié)偏移域符號(hào)寬度（字節(jié)）范圍說(shuō)明01yearword，219802100時(shí)間的年份數(shù)23monthword，2112時(shí)間的月份數(shù)45dayword，2131時(shí)間的日期數(shù)67hourword，2023時(shí)間的小時(shí)數(shù)89minuteword，2059時(shí)間的分鐘數(shù)1011secondword，2059時(shí)間的秒數(shù)1213msword，20999時(shí)間的毫秒數(shù)1415usword，20999時(shí)間的微秒數(shù)2 packet_return 結(jié)構(gòu)字節(jié)偏移域符號(hào)寬度（字節(jié)）說(shuō)明03codedword，4錯(cuò)誤碼47senderdword，4發(fā)送者8263messagechar256，256對(duì)錯(cuò)誤碼的文本表述說(shuō)明：a) sender 域定義如下：0sender_unkown未知1sender_recorder子站節(jié)點(diǎn)（錄波裝置）2sender_branch分站節(jié)點(diǎn)3sender_center主站節(jié)點(diǎn)b) code 域定義如下：71000econn_remoteclose遠(yuǎn)方已經(jīng)關(guān)閉71001econn_toomany連接太多71002econn_noack遠(yuǎn)方?jīng)]有應(yīng)答71003econn_ptype數(shù)據(jù)包類型錯(cuò)誤71004econn_remotecancel遠(yuǎn)方取消了當(dāng)前操作71005econn_localcancel本地取消了當(dāng)前操作71006econn_nounitid沒(méi)有找到指定的設(shè)備71200econn_filecreate創(chuàng)建文件失敗71201econn_fileopen打開文件失敗71202econn_memory內(nèi)存分配失敗71250econn_dbconn連接數(shù)據(jù)庫(kù)失敗71300econn_nodllfun動(dòng)態(tài)庫(kù)中無(wú)函數(shù)71301econn_command無(wú)效的命令（該命令系統(tǒng)不支持）71302econn_no_data沒(méi)有所請(qǐng)求的數(shù)據(jù)71303econn_db_exception數(shù)據(jù)庫(kù)異常71304econn_busy系統(tǒng)繁忙71305econn_param參數(shù)錯(cuò)誤或無(wú)效0econn_success成功（無(wú)錯(cuò)誤）165535操作系統(tǒng)定義的錯(cuò)誤碼3 file_info 結(jié)構(gòu)字節(jié)偏移域符號(hào)寬度（字節(jié)）說(shuō)明03fromdword，4文件來(lái)源419timedate_time 結(jié)構(gòu)，16文件時(shí)間2023sizedword，4文件大小2427 attrdword，4文件屬性2831offsetdword，4發(fā)送的文件偏移3235lengthdword，4發(fā)送的文件長(zhǎng)度36291namechar256，256文件名說(shuō)明：a) from 域定義如下：0file_from_disk來(lái)源于磁盤b) attr 域各二進(jìn)制位定義如下：00000001hfile_attribute_readonly只讀00000002hfile_attribute_hidden隱藏00000004hfile_attribute_system系統(tǒng)00000010hfile_attribute_directory文件夾00000020hfile_attribute_archive存檔00000080hfile_attribute_normal一般00000100hfile_attribute_temporary臨時(shí)4 file_get 結(jié)構(gòu)字節(jié)偏移域符號(hào)寬度（字節(jié)）說(shuō)明01fromword，2文件來(lái)源23flagword，2標(biāo)記47offsetdword，4文件偏移，用于斷點(diǎn)續(xù)傳811fidlong，4根據(jù)flag 域的區(qū)別含義不同12267namechar256，256文件名說(shuō)明：a) from 域定義如下：0file_from_disk來(lái)源于磁盤b) flag 域各二進(jìn)制位定義如下：00000001hfile_flag_zip傳送之前壓縮文件00000002hfile_flag_del傳送之后刪除文件c) fid 域當(dāng)flag 為0 時(shí)，fid 域也為0；5 fault_info 結(jié)構(gòu)字節(jié)偏移域符號(hào)寬度（字節(jié)）說(shuō)明01typeword，2文件類型23datnumshort，2數(shù)據(jù)文件數(shù)目（總為1）45connumshort，2配置文件數(shù)目（未使用）69faultidlong，4故障編號(hào)1013filesizedword，4文件大小1417devidlong，4設(shè)備節(jié)點(diǎn)id（未使用）1821lineidlong，4故障線路id（未使用）2225staidlong，4子站節(jié)點(diǎn)id（未使用）2629faulttypedword，4故障類型3037fdistdouble，8故障距離（km）3853timedate_time，16故障時(shí)間54117linenamechar64，64故障元件名稱118373filenamechar256，256故障文件名稱374501stichar128，128啟動(dòng)信息說(shuō)明：a) faulttype 域定義如下：0000hfault_none無(wú)故障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區(qū)外故障2001hfault_trn變壓器內(nèi)部故障7fffhfault_noana尚未分析五、通信流程1 初始化（建立連接）的過(guò)程主站子站成功建立socket 連接；回答報(bào)文：typ=ptype_return；len=8 或0；如果len=8，則：dat=packet_return 結(jié)構(gòu)；packet_return:code=econn_success；packet_return:center=0；packet_return:message=無(wú)內(nèi)容；否則只有報(bào)文頭。初始化過(guò)程完成；成功2 召喚單個(gè)文件數(shù)據(jù)的過(guò)程主站子站發(fā)送報(bào)文：typ=ptype_file_get；len=12+file_get:name 字符串長(zhǎng)度+1；dat=file_get 結(jié)構(gòu)；file_get:from=0；file_get:flag=0；file_get:offset=0；file_get:fid=0；file_get:name=全路經(jīng)文件名；回答報(bào)文：typ=ptype_file_put；len=292；dat=file_info 結(jié)構(gòu)；file_info:from=0；file_info:length=文件長(zhǎng)度；file_info:size=文件長(zhǎng)度；file_info:offset=0；其他都是0；發(fā)送若干包ptype_file_data 報(bào)文；typ=ptype_file_data；len=x；dat=文件數(shù)據(jù)；發(fā)送ptype_file_data 報(bào)文；typ=ptype_file_data；len=0；dat=無(wú)內(nèi)容；通信過(guò)程完成；成功成功收到ptype_file_put 報(bào)文；typ=ptype_file_put；len=292；dat=file_info 結(jié)構(gòu)；file_info:from=0；file_info:length=文件長(zhǎng)度；file_info:size=文件長(zhǎng)度；file_info:offset=0；其他都是0；收到若干包ptype_file_data 報(bào)文；typ=ptype_file_data；len=x；dat=文件數(shù)據(jù)；收到ptype_file_data 報(bào)文；typ=ptype_file_data；len=0；dat=無(wú)內(nèi)容；通信過(guò)程完成；回答報(bào)文：typ=ptype_return；len=8+packet_return:message 字符串長(zhǎng)度+1；dat=packet_return 結(jié)構(gòu)；packet_return:code=錯(cuò)誤編碼；packet_return:center=0；packet_return:message=錯(cuò)誤信息；通信過(guò)程完成；出錯(cuò)出錯(cuò)收到ptype_return 報(bào)文；typ=ptype_return；len=8+packet_return:message 字符串長(zhǎng)度+1；dat=packet_return 結(jié)構(gòu)；packet_return:code=錯(cuò)誤編碼；packet_return:center=0；packet_return:message=錯(cuò)誤信息；通信過(guò)程完成；如果通信成功，則將接收到的ptype_file_data 報(bào)文的dat 域內(nèi)容按順序組裝成一個(gè)文件就是要傳送的文件；雙方在通信過(guò)程中的任何時(shí)候收到ptype_cancel 報(bào)文均表示該次通信過(guò)程中止；主站端在收到一個(gè)ptype_file_data 報(bào)文之后，通信過(guò)程完成之前的任何時(shí)候收到非ptype_file_data 報(bào)文均表示通信過(guò)程出錯(cuò)，中止該次通信； 3.查詢裝置新狀態(tài)的過(guò)程主站子站發(fā)送報(bào)文：typ=ptype_getnewstatus；len=0；dat=無(wú)內(nèi)容；回答報(bào)文：typ=ptype_getnewstatus；len=4；dat=newstatus；通信過(guò)程完成；成功成功收到ptype_getnewstatus 報(bào)文；typ=ptype_getnewstatus；len=4；dat=newstatus；通信過(guò)程完成；回答報(bào)文：typ=ptype_return；len=8+packet_return:message 字符串長(zhǎng)度+1；dat=packet_return 結(jié)構(gòu)；packet_return:code=錯(cuò)誤編碼；packet_return:center=0；packet_return:message=錯(cuò)誤信息；通信過(guò)程完成；出錯(cuò)出錯(cuò)收到ptype_return 報(bào)文；typ=ptype_return；len=8+packet_return:message 字符串長(zhǎng)度+1；dat=packet_return 結(jié)構(gòu)；packet_return:code=錯(cuò)誤編碼；packet_return:center=0；packet_return:message=錯(cuò)誤信息；通信過(guò)程完成；newstatus 數(shù)據(jù)是一個(gè)dword 類型的值，其各二進(jìn)制位定義如下：bit0=1 表示有新錄波；bit1=1 表示定值改變；bit2=1 表示配置改變。每次重新連接之后，所有的位都會(huì)被設(shè)置成1，即重新連接后第一次接收到的newstatus 總是為ffffffffh。4.復(fù)歸裝置新狀態(tài)的過(guò)程主站子站發(fā)送報(bào)文：typ=ptype_resetnewstatus；len=4；dat=newstatus_bit；回答報(bào)文：typ=ptype_return；len=8；dat=packet_return 結(jié)構(gòu)；packet_return:code=econn_success；packet_return:center=0；packet_return:message=無(wú)內(nèi)容；通信過(guò)程完成；成功成功收到ptype_getnewstatus 報(bào)文；typ=ptype_return；len=8；dat=packet_return 結(jié)構(gòu)；packet_return:code=econn_success；packet_return:center=0；packet_return:message=無(wú)內(nèi)容；通信過(guò)程完成；回答報(bào)文：typ=ptype_return；len=8+packet_return:message 字符串長(zhǎng)度+1；dat=packet_return 結(jié)構(gòu)；packet_return:code=錯(cuò)誤編碼；packet_return:center=0；packet_return:message=錯(cuò)誤信息；通信過(guò)程完成；出錯(cuò)出錯(cuò)收到ptype_return 報(bào)文；typ=ptype_return；len=8+packet_return:message 字符串長(zhǎng)度+1；dat=packet_return 結(jié)構(gòu)；packet_return:code=錯(cuò)誤編碼；packet_return:center=0；packet_return:message=錯(cuò)誤信息；通信過(guò)程完成；newstatus_bit 是一個(gè)dword 類型的數(shù)值；假如要復(fù)歸新錄波的狀態(tài)，則newstatus_bit=00000001h；假如要復(fù)歸定值改變的狀態(tài)，則newstatus_bit=00000002h；當(dāng)主站得到錄波裝置的新狀態(tài)信息后，應(yīng)對(duì)新狀態(tài)作出相應(yīng)的處理，然后復(fù)歸該狀態(tài)。如得到新錄波的狀態(tài)后就應(yīng)將新的錄波數(shù)據(jù)傳送上來(lái)，然后復(fù)歸該狀態(tài)。5請(qǐng)求裝置工作目錄的過(guò)程主站子站發(fā)送報(bào)文：typ=ptype_work_path；len=0；dat=無(wú)內(nèi)容；回答報(bào)文：typ=ptype_work_path；len=工作目錄的字符串長(zhǎng)度+1；dat=path；通信過(guò)程完成；成功成功收到ptype_work_path 報(bào)文；typ=ptype_work_path；len=工作目錄的字符串長(zhǎng)度+1；dat=path；通信過(guò)程完成；回答報(bào)文：typ=ptype_return；len=8+packet_return:message 字符串長(zhǎng)度+1；dat=packet_return 結(jié)構(gòu)；packet_return:code=錯(cuò)誤編碼；packet_return:center=0；packet_return:message=錯(cuò)誤信息；通信過(guò)程完成；出錯(cuò)出錯(cuò)收到ptype_return 報(bào)文；typ=ptype_return；len=8+packet_return:message 字符串長(zhǎng)度+1；dat=packet_return 結(jié)構(gòu)；packet_return:code=錯(cuò)誤編碼；packet_return:center=0；packet_return:message=錯(cuò)誤信息；通信過(guò)程完成；path 是char 型的字符數(shù)組，表示系統(tǒng)軟件的工作目錄，目錄包含結(jié)尾的“”；如：e:zyhd6.請(qǐng)求錄波裝置傳送文件時(shí)分包大小的過(guò)程主站子站發(fā)送報(bào)文：typ=ptype_packetsize；len=2；dat=word 數(shù)據(jù)類型；當(dāng)dat=248 并且dat=0 并且dat=30000 時(shí)，表示要求錄波裝置改變傳送文件時(shí)禎與禎之間的時(shí)間間隔為dat 指定的毫秒數(shù)；當(dāng)dat=fff