/************************************************************************************ * * Copyright (C) 2004-2005 SCADA Control Technology Co., Ltd. * All rights reserved. * * 文件名称：scadaprotect.h * 文件标识：SCADA内部保护通讯规约 * 摘 要： * * 当前版本：1.0 * 作 者：aaawen * 完成日期：2005/06/02 * * 取代版本：1.0 * 原作者 ：aaawen * 完成日期： * * 说 明：数据定义规则 * u8 --- BYTE(usigned char) * ch --- char * w --- WORD(u_short, usigned short) * sh --- short * b --- BOOL(bool) * i --- int * l --- long * u32 --- u_32 * ui --- unsigned int(u_int) * ul --- unsigned long(u_long) * f --- float * db --- double * c --- class * s --- struct * sta --- static * g --- 全局变量 * Array --- 数组 * a --- 数组 * m_ --- 数据成员 * p --- 指针 * str --- 字符串 * 全部大写 --- 常量 * 首字节必须大写--- 类名称，结构，函数 **************************************************************************************/ // buban103.h: interface for the buban103 class. // ////////////////////////////////////////////////////////////////////// #if !defined(_SCADABAOHU_H_200506020948__INCLUDED_) #define _SCADABAOHU_H_200506020948__INCLUDED_ #ifdef OS_LINUX #include "baohulib/common.h" #else #include "common.h" #endif ////////////////////////////////////////////////////////////////////////// // 宏定义 // // WEN 2005.06.02 // ////////////////////////////////////////////////////////////////////////// /*! 保护指令包(PROTECT->FEND) */ #define pPFV_PROTECT_BYPASS 1 /*! 保护数据包应答(FEND->PROTECT) */ #define fPFV_PROTECT_BYPASS_ACK 2 /*! 通道状态包(FEND->PROTECT) */ #define fPFV_STATUS 3 /*! 网络活动包(FEND<->PROTECT) */ #define fPFV_NETACTIVE 0xF0 //指令包操作码 /*! 读取定值 */ #define hREADFIX 0x01 /*! 读取定值区号 */ #define hREADFIXNO 0x07 /*! 读取保护模拟量 */ #define hREADPAI 0x09 /*! 读取保护开关量 */ #define hREADPDI 0x0b /*! 读取保护波形数据 */ #define hREADPWAVE 0x0d /*! 读取指定故障报告 */ #define hQUERYFAULT 0x11 /*! 读取指定的自检报告 */ #define hQUERYSELFCHECK 0x12 /*! 修改保护定值 */ #define hWRITEALLFIX 0x15 /*! 修改指定的保护定值 */ #define hWRITESPECIALFIX 0x16 /*! 保护定值确认 */ #define hWRITEFIXACK 0x17 /*! 保护定值不确认 */ #define hWRITEFIXNAK 0x18 /*! 修改保护定值区 */ #define hWRITEFIXNO 0x19 /*! 定值区修改确认 */ #define hWRITEFIXNOACK 0x1a /*! 定值区修改不确认 */ #define hWRITEFIXNONAK 0x1b /*! 保护信号复归 */ #define hRESETPROTECT 0x1c /*! 单个装置对时 */ #define hCHECKTIME 0x1d /*! 保护装置广播对时 */ #define hBROADCASTCHECKTIME 0x1e /*! 读取保护装置状态 */ #define hSTATUS 0x1f /*! 读取菜单单元值 */ #define hCOMMAND 0x20 /*! 读取扰动参数的命令 */ #define hDISTCOMMAND 0x21 /*! 保护操作取消 */ #define hCANCEL 0xFF //应答包操作码 /*! 数据申请中 */ #define hREADINGDATA 0x02 /*! 定值数据 */ #define hFIXDATA 0x03 /*! 数据申请结束 */ #define hREADDATAEND 0x04 /*! 数据申请无响应 */ #define hNORESPONSE 0x05 /*! 数据处理繁忙，稍后重试 */ #define hSYSTEMBUSY 0x06 /*! 定值区号数据 */ #define hFIXNODATA 0x08 /*! 保护模拟量数据 */ #define hPAIDATA 0x0a /*! 保护开关量数据 */ #define hPDIDATA 0x0c /*! 保护波行数据上送开始 */ #define hPWAVEDATASTART 0x0e /*! 保护波行数据 */ #define hPWAVEDATA 0x0f /*! 保护波行数据上送结束 */ #define hPWAVEDATAEND 0x10 /*! 带索引号的事件报告数据 */ #define hPEVENTDATAWITHID 0x13 /*! 字符串事件报告数据 */ #define hPEVENTDATAWITHSTRING 0x14 /*! 保护定值确认 */ #define hWRITEFIXACK 0x17 /*! 保护定值不确认 */ #define hWRITEFIXNAK 0x18 /*! 定值区修改确认 */ #define hWRITEFIXNOACK 0x1a /*! 定值区修改不确认 */ #define hWRITEFIXNONAK 0x1b /*! 定值数据带序号 */ #define hFIXDATAWITHNO 0x22 /*! 保护模拟量数据带序号 */ #define hPAIDATAWITHNO 0x23 /*! 保护开关量数据带序号 */ #define hPDIDATAWITHNO 0x24 // 数据项目属性 /*! 实际值 */ #define ITEM_ATTR_REALVALUE 1 /*! 缺省值 */ #define ITEM_ATTR_DEFAULTVALUE 2 /*! 量 程 */ #define ITEM_ATTR_MINMAXSTEP 3 /*! 备 用 */ #define ITEM_ATTR_STANDBY 4 /*! 精 度 */ #define ITEM_ATTR_PRECISION 5 /*! 因 子 */ #define ITEM_ATTR_FIGURE 6 /*! 参 比 */ #define ITEM_ATTR_RATE 7 /*! 列 表 */ #define ITEM_ATTR_LIST 8 /*! 量 纲 */ #define ITEM_ATTR_UNIT 9 /*! 描 述 */ #define ITEM_ATTR_DESCRIPTION 10 /*! 保护操作超时时间(秒) */ #define OPERPROTECTTIMEOUT 15 // 是pc机系统还是嵌入式系统 #ifdef PC_MACHINE #ifdef OS_WINDOWS #pragma pack (push,1) #else// OS_UNIX #pragma pack(1) #endif //OS_UNIX #endif typedef struct tagPROTECTCONTENTHEAD { u_32 ummid __attribute__ ((packed));// 操作用户 u_32 uAddr __attribute__ ((packed));// 保护地址 char cFixNo __attribute__ ((packed));// 定值区号 char cCPUNo __attribute__ ((packed));// CPU号 u_32 uFuncCode __attribute__ ((packed));// 操作功能码 u_32 uReserved __attribute__ ((packed));// 保留 }PROTECTCONTENTHEAD, *pPROTECTCONTENTHEAD; typedef struct { u_32 MsgType __attribute__ ((packed));// 信息类型 u_32 PortNumber __attribute__ ((packed));// 信息端口号 u_32 MsgLen __attribute__ ((packed));// 信息长度 //u_char MsgData[1]; // 信息数据 }PROTECTMSGHEAD; typedef struct { u_32 MsgType __attribute__ ((packed));// 信息类型 u_32 PortNumber __attribute__ ((packed));// 信息端口号 u_32 MsgLen __attribute__ ((packed));// 信息长度 u_char MsgData[MAX_RTU_MSG_SIZE] __attribute__ ((packed));// 信息数据 }PROTECTMSG; // 是pc机系统还是嵌入式系统 #ifdef PC_MACHINE #ifdef OS_WINDOWS #pragma pack (pop) #else// OS_UNIX #pragma pack (0) #endif //OS_UNIX #endif typedef struct { BOOL bPortIdle; // 端口保护操作空闲标识 u_32 timeOut; // 保护操作超时时间 u_32 mmid; // 保护操作用户 } PORTSTATUS, *pPORTSTATUS; typedef struct tagSCADAPROVDEVDEF { /*! \brief 装置的实际端口号 */ i_32 m_iRealCommid; /*! \brief 装置的转发地址(唯一确定一个装置) */ i_32 m_iProvAddr; /*! \brief 转发SOE数据参数 \note 用于历史记录的转发事件(应该是没有作用，已经遗弃) */ DEVPROVSOE m_sProvSoe; i_32 m_iStatusStn; i_32 m_iStatusPnt; DBORIENTATION m_sYxInfo; }SCADAPROVDEVDEF; typedef struct tagSCADAPROTECTPORTPARAM { /*! \var SCADAPROTECTPORTPARAM::m_achRecvBuf \brief 接收数据缓冲区 \note 缓冲区最大不超过 MAX_RTU_MSG_SIZE+12(包头) bytes\n */ char m_achRecvBuf[MAX_RTU_MSG_SIZE+12]; /*! \var SCADAPROTECTPORTPARAM::m_iRecvLen \brief 接收数据长度 */ int m_iRecvLen; /*! \var SCADAPROTECTPORTPARAM::m_iRecvLen \brief 网络活动包的发送时间 */ int m_iActiveTimeCnt; int m_iActiveTimeConst; /*! \var SCADAPROTECTPORTPARAM::m_iRecvLen \brief 通道状态包的发送时间 */ int m_iStatusTimeCnt; int m_iStatusTimeConst; /*! 保护装置数量 */ i_32 m_iDevNum; SCADAPROVDEVDEF *m_psProvDev; SINGLELIST m_sBaoHuData; char m_chArrayTempletFileName[256]; PORTSTATUS *m_pPrtPortStatus; /*! \brief 该规约的端口数据指针 */ SIO_PARAM_BAOHU_DEF *m_psBaoHu; }SCADAPROTECTPORTPARAM, *pSCADAPROTECTPORTPARAM; /////////////////////////以下为通用函数接口/////////////////////////// /*! \brief 读取配置函数 \param commid -- 端口号 \note 取值范围：0 -- MaxSerialPortNum + MaxNetPortNum -1\n */ void ScadaProtectReadConfig(int commid); // 初始化处理 /*! \brief 读取端口数据函数 \param commid -- 端口号 \note 取值范围：0 -- MaxSerialPortNum + MaxNetPortNum -1\n \param buf -- 数据源缓冲区指针 \param len -- 数据源长度 */ void ScadaProtectRecvData(int commid, u_char *buf, int len);// 规约读数据处理 /*! \brief 规约数据处理定时器函数 \param commid -- 端口号 \note 取值范围：0 -- MaxSerialPortNum + MaxNetPortNum -1\n */ void ScadaProtectTimer(int commid); // 定时器处理 /*! \brief 遥控遥调数据处理函数 \param commid -- 端口号 \note 取值范围：0 -- MaxSerialPortNum + MaxNetPortNum -1\n \param buf -- 数据源缓冲区指针 \param len -- 数据源长度 */ void ScadaProtectYkYtProcess(int commid, u_char *buf, int len); // 遥控遥调处理 /*! \brief 系统下发对时函数 \param commid -- 端口号 \note 取值范围：0 -- MaxSerialPortNum + MaxNetPortNum -1\n */ //void ScadaProtectSendSystemTime(int commid); // 系统对时 /*! \brief 系统退出时规约处理函数 \param commid -- 端口号 \note 取值范围：0 -- MaxSerialPortNum + MaxNetPortNum -1\n */ void ScadaProtectExit(int commid); // 规约退出 /*! \brief 保护命令处理函数 \param commid -- 端口号 \param rtumsg -- 下发的保护命令指针 \note 取值范围：0 -- MaxSerialPortNum + MaxNetPortNum -1\n */ void ScadaProtectBaoHuCmdProcess(int commid, RTUMSG *rtumsg, BOOL bUpData); /*! \brief 取保护数据库指针函数 \param commid -- 端口号 \param iProvAddr -- 统一编排的保护转发地址 \param ppBaoHuDB -- 存放保护数据指针的指针 \retval -- 返回该装置保护数据组数 */ int ScadaProtectGetBaohuDataBase(int commid, int iProvAddr, GROUPDEF **ppBaoHuDB); /////////////////////////通用函数接口结束/////////////////////////////// /////////////////////////以下为通用函数支持接口///////////////////////// void ScadaProtectProvMakeYkYtCommand(int commid, u_char *buf, int len); /////////////////////////通用函数支持接口结束/////////////////////////// ///////////////////////////以下为配置函数接口/////////////////////////// BOOL InitScadaInfoFromTempletFile(int commid, SCADAPROTECTPORTPARAM *psPortParam,\ char *ptrTemplate, BOOL bMaster); BOOL GetProvDevNumFromTemplateFileScada(int commid, HDSFILE hFile, SCADAPROTECTPORTPARAM *psPortParam); BOOL GetProvDevParamFromTemplateFileScada(int commid, HDSFILE hFile, SCADAPROTECTPORTPARAM *psPortParam); int FindProtectDevFromPntNoScada(SCADAPROTECTPORTPARAM *psPortParam, int iPntNo, int itype); /////////////////////////////配置函数接口结束/////////////////////////// ///////////////////////以下为规约处理函数接口/////////////////////////// void ReduceTimeOut(SCADAPROTECTPORTPARAM *psPortParam); BOOL IsProtectPortIdle(int commid, SCADAPROTECTPORTPARAM *psPortParam); BOOL GetProtectPortIdle(int commid, SCADAPROTECTPORTPARAM *psPortParam, PORTSTATUS *pStatus); BOOL SetProtectPortIdle(int commid, SCADAPROTECTPORTPARAM *psPortParam, PORTSTATUS *pStatus); BOOL SetProtectPortIdleEx(int commid, int iBaoHuCommid, PORTSTATUS *pStatus); void SendResponsetoMMI(int commid, int mmid, u_32 ResponseType, PROTECTMSG *pmsg); //将客户机报文所有的数据从网络字节循序转换成主机字节顺序函数 void AllNetToHostByteSequence(PROTECTMSG *userdata); //将客户机报文所有的数据从主机字节顺序转换成网络字节顺序函数 void AllHostToNetByteSequence(PROTECTMSG *userdata); BOOL ScadaProtectConvertToScadaFrameAndSend(int commid); BOOL ScadaProtectConvertTo103AndSend(int commid, PROTECTMSG *pmsg); //数据处理函数总入口 void ScadaProtectProcessData(int commid, SCADAPROTECTPORTPARAM *psPortParam, BOOL bProcess); void ScadaProtectByPassData(int commid, SCADAPROTECTPORTPARAM *psPortParam, PROTECTMSG *pmsg); BOOL FormatDataAndSend(int commid, PROTECTMSG *pmsg); void MakeInteractionCmd(int commid, int sourcommid, u_32 ResponseFunc, PROTECTCONTENTHEAD *pSourHead, BOOL bBoardCast); void MakeNetActivePacket(int commid); void MakeStatusPacket(int commid); BOOL MakeSoeDataPacket(int commid); /////////////////////////规约处理函数接口结束/////////////////////////// /////////////////////////以下为调试函数接口///////////////////////////// void DispPrtPortStatus(int commid, SCADAPROTECTPORTPARAM *psPortParam); ///////////////////////////调试函数接口结束///////////////////////////// #endif // !defined(_SCADABAOHU_H_200506020948__INCLUDED_)