|
|
/****************************************************************************/
|
|
|
/* Copyright (c) 2007,许继集团有限公司 */
|
|
|
/* All rights reserved. */
|
|
|
/* */
|
|
|
/* 模块描述： */
|
|
|
/** 客户端站点管理模块，提供站点管理结构各属性的读写
|
|
|
* @file ac_srvmgs.h */
|
|
|
/* */
|
|
|
/* 日期 作者 注释 */
|
|
|
/* 2008/01/31 ZYZ 从ac_srvm.c中分离出来 */
|
|
|
/****************************************************************************/
|
|
|
|
|
|
#ifndef IEC61850_AC_SRVMGS_H
|
|
|
#define IEC61850_AC_SRVMGS_H
|
|
|
|
|
|
#include "glbtypes.h"
|
|
|
#include "mvl_defs.h"
|
|
|
#include "ai_obj.h"
|
|
|
#include "ac_sg.h"
|
|
|
#include "ac_reqm.h"
|
|
|
#include "mvl_acse.h"
|
|
|
#include "ac_acfg.h"
|
|
|
#include "ac_rpt.h"
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
extern "C" {
|
|
|
#endif
|
|
|
|
|
|
/**
|
|
|
* 通道状态枚举值
|
|
|
*/
|
|
|
typedef enum
|
|
|
{
|
|
|
CHNL_STATE_UNCONNECTED, /**< 通道未连接 */
|
|
|
CHNL_STATE_CONNECTING, /**< 通道正在连接 */
|
|
|
CHNL_STATE_CONNECTED /**< 通道已连接 */
|
|
|
}CHNL_STATE;
|
|
|
|
|
|
/**
|
|
|
* 对象空间创建状态枚举值
|
|
|
*/
|
|
|
typedef enum {
|
|
|
CRE_STATE_UNCREATED, /**< 未创建 */
|
|
|
CRE_STATE_CREATING, /**< 正在创建 */
|
|
|
CRE_STATE_CREATED, /**< 已创建 */
|
|
|
CRE_STATE_CREATERR /**< 创建出错 */
|
|
|
}CREATE_STATE;
|
|
|
|
|
|
/**
|
|
|
* 数据刷新状态枚举值
|
|
|
*/
|
|
|
typedef enum {
|
|
|
REFR_STATE_UNREFRESHED, /**< 未刷新 */
|
|
|
REFR_STATE_REFRESHING, /**< 正在刷新 */
|
|
|
REFR_STATE_REFRESHED, /**< 已刷新 */
|
|
|
REFR_STATE_REFRESHERR /**< 刷新出错 */
|
|
|
}REFRESH_STATE;
|
|
|
|
|
|
typedef struct
|
|
|
{
|
|
|
CHNL_STATE chnl_state;
|
|
|
MVL_NET_INFO *net_info;
|
|
|
ST_CHAR dib_name[MAX_IDENT_LEN+1];
|
|
|
ST_DOUBLE next_time;
|
|
|
ST_BOOLEAN keep_con;
|
|
|
}AC_CHANNEL_CTRL;
|
|
|
|
|
|
typedef struct
|
|
|
{
|
|
|
AC_CHANNEL_CTRL chnl_a;
|
|
|
AC_CHANNEL_CTRL chnl_b;
|
|
|
AC_CHANNEL active_chnl;
|
|
|
// CONNECT_STATE con_state;
|
|
|
}AC_CONNECT_CTRL;
|
|
|
|
|
|
|
|
|
/**
|
|
|
* 报告解析过程中使用的报告的数据集和报告的信息
|
|
|
* 应用程序在刷新对象空间后初始化
|
|
|
*/
|
|
|
typedef struct
|
|
|
{
|
|
|
ST_CHAR rpt_id[MAX_IDENT_LEN+1]; /**< RPTID*/
|
|
|
AI_DS_CTRL *ds; /**< 数据集指针*/
|
|
|
RUNTIME_TYPE *rt; /**< includebit的RUNTIME_TYPE指针*/
|
|
|
ST_INT includebit_TYPEID; /**< 传送了那些成员 BIT*/
|
|
|
ST_INT old_sqnum; /**< 已经接收到的报告SQNUM*/
|
|
|
ST_INT rcb_id; /**< 报告控制块的ID*/
|
|
|
// ST_BOOLEAN enable; /**< 报告控制块使能标志*/
|
|
|
EntryID_TDEF entryID; /**< 备份的ENTRYID*/
|
|
|
ST_BOOLEAN entryid_enable; /**< 要不要判断ENTRYID*/
|
|
|
}AC_RPT_INFO;
|
|
|
|
|
|
/**
|
|
|
* 报告解析过程中使用的报告的数据集和报告的信息，解析过程中使用的临时缓存指针
|
|
|
* 应用程序在刷新对象空间后初始化
|
|
|
*/
|
|
|
typedef struct
|
|
|
{
|
|
|
AC_RPT_INFO *rpt_info; /**< RPT信息数组*/
|
|
|
ST_INT rpt_num; /**< 报告个数*/
|
|
|
ST_VOID *data; /**< 解析报告时用的临时缓存*/
|
|
|
ST_BOOLEAN init_flag; /**< 是否初始化标志*/
|
|
|
}AC_IED_RPT_CTRL;
|
|
|
/**
|
|
|
* 保存报告控制块刷新信息
|
|
|
*/
|
|
|
typedef struct ac_rcb_ref_info
|
|
|
{
|
|
|
ST_INT ld_num;
|
|
|
ST_BOOLEAN is_br;
|
|
|
ST_INT id_br;
|
|
|
ST_INT id_lln0;
|
|
|
} AC_RCB_REF_INFO;
|
|
|
/**
|
|
|
* 站点管理数据结构，一个结构实例对应一个站点
|
|
|
*/
|
|
|
typedef struct ac_server_management
|
|
|
{
|
|
|
ST_INT srv_id;
|
|
|
ST_CHAR srv_name[MAX_IDENT_LEN+1]; /**< 装置名称，由SCD配置文件解析得到 */
|
|
|
|
|
|
AI_IED_CTRL *ied;
|
|
|
CREATE_STATE cre_state; /**< 对象空间创建状态 */
|
|
|
|
|
|
|
|
|
AC_RCB_REF_INFO a_rcb_ref_info;
|
|
|
AC_RCB_REF_INFO b_rcb_ref_info;
|
|
|
REFRESH_STATE refr_state; /**< 站点数据刷新状态 */
|
|
|
|
|
|
AC_IED_SG_CTRL sg_ctrl; /**< 定值管理信息 */
|
|
|
AC_IED_RCB_INFO rcb_info; /**< 报告管理信息 */
|
|
|
AC_REQ_CTRL *req_list; /**< 异步请求链表 */
|
|
|
AC_CONNECT_CTRL con_ctrl; /**< 站点网络状态结构 */
|
|
|
AI_IED_CFG *ied_cfg; /**< ied配置 */
|
|
|
} AC_SERVER_MANAGEMENT;
|
|
|
|
|
|
/**
|
|
|
* 取得站点个数接口
|
|
|
* @return ST_INT 返回站点个数
|
|
|
*/
|
|
|
ST_INT ac_get_srvm_num();
|
|
|
|
|
|
/**
|
|
|
* 获取站点重连标志位状态，该状态在初始化时默认为TRUE
|
|
|
* @param srv_id 服务器ID
|
|
|
* @param chnl 通道号
|
|
|
* @retval 连接标志
|
|
|
*/
|
|
|
ST_BOOLEAN ac_get_srvm_chnlKeepCon(ST_INT srv_id, AC_CHANNEL chnl);
|
|
|
/**
|
|
|
* 设置站点重连标志位状态，该状态在初始化时默认为TRUE
|
|
|
* @param srv_id 服务器ID，为-1时，认为设置所有服务器站点
|
|
|
* @param keep_con 保持连接标志，SD_TRUE,保持连接，SD_FALSE,不保持连接
|
|
|
* @param chnl 通道号
|
|
|
* @retval SD_SUCCESS 设置成功
|
|
|
* @retval SD_FAILURE 设置失败
|
|
|
*/
|
|
|
ST_RET ac_set_srvm_chnlKeepCon(ST_INT srv_id, ST_BOOLEAN keep_con, AC_CHANNEL chnl);
|
|
|
|
|
|
/**
|
|
|
* 通过装置ID获取一个站点
|
|
|
* @param srv_id 服务器ID
|
|
|
* @retval AC_SERVER_MANAGEMENT* 指向服务器结构的指针，失败返回NULL
|
|
|
*/
|
|
|
AC_SERVER_MANAGEMENT * ac_get_srvm_node(ST_INT srv_id);
|
|
|
|
|
|
/**
|
|
|
* 通过服务器ID获取站点的对象空间创建状态
|
|
|
* @param srv_id 服务器ID
|
|
|
* @param create_state 保存返回状态值的指针
|
|
|
* @retval SD_SUCCESS 获取成功
|
|
|
* @retval SD_FAILURE 获取失败
|
|
|
*/
|
|
|
ST_RET ac_get_srvm_createState(ST_INT srv_id, CREATE_STATE *create_state);
|
|
|
|
|
|
/**
|
|
|
* 设置站点的对象空间创建状态
|
|
|
* @param srv_id 服务器ID
|
|
|
* @param create_state 状态值
|
|
|
* @retval SD_SUCCESS 设置成功
|
|
|
* @retval SD_FAILURE 设置失败
|
|
|
*/
|
|
|
ST_RET ac_set_srvm_createState(ST_INT srv_id, CREATE_STATE create_state);
|
|
|
|
|
|
/**
|
|
|
* 通过服务器ID获取站点的数据刷新状态
|
|
|
* @param srv_id 服务器ID
|
|
|
* @param refr_state 保存返回状态值的指针
|
|
|
* @retval SD_SUCCESS 获取成功
|
|
|
* @retval SD_FAILURE 获取失败
|
|
|
*/
|
|
|
ST_RET ac_get_srvm_refrState(ST_INT srv_id, REFRESH_STATE *refr_state);
|
|
|
|
|
|
/**
|
|
|
* 设置站点的数据刷新状态
|
|
|
* @param srv_id 服务器ID
|
|
|
* @param refr_state 状态值
|
|
|
* @retval SD_SUCCESS 设置成功
|
|
|
* @retval SD_FAILURE 设置失败
|
|
|
*/
|
|
|
ST_RET ac_set_srvm_refrState(ST_INT srv_id, REFRESH_STATE refr_state);
|
|
|
|
|
|
/**
|
|
|
* 通过站点的ID获得站点的名称
|
|
|
* @param srv_id 服务器ID
|
|
|
* @retval ST_CHAR * 成功返回站点的名称，失败返回NULL
|
|
|
*/
|
|
|
ST_CHAR * ac_get_srvm_name(ST_INT srv_id);
|
|
|
|
|
|
/**
|
|
|
* 通过站点的名称获得站点的ID,如果没有找到，返回－1
|
|
|
* @param srv_name 服务器名称
|
|
|
* @retval ST_INT 成功返回站点的ID，失败返回－1
|
|
|
*/
|
|
|
ST_INT ac_get_srvm_srvId(ST_CHAR *srv_name);
|
|
|
|
|
|
/**
|
|
|
* 通过站点的ID获得装置对应的客户端对象空间IED对象
|
|
|
* @param srv_id 服务器ID
|
|
|
* @retval AI_IED_CTRL * 成功返回装置对应的客户端对象空间ied对象，失败返回NULL
|
|
|
*/
|
|
|
AI_IED_CTRL * ac_get_srvm_ied(ST_INT srv_id);
|
|
|
|
|
|
/**
|
|
|
* 通过站点的ID设置装置对应的客户端对象空间ied对象
|
|
|
* @param srv_id 服务器ID
|
|
|
* @param ied 服务器对象空间结构
|
|
|
* @retval SD_SUCCESS， SD_FAILURE
|
|
|
*/
|
|
|
ST_RET ac_set_srvm_ied(ST_INT srv_id, AI_IED_CTRL *ied);
|
|
|
/**
|
|
|
* 通过站点的ID获得和装置连接的主通道的net_info
|
|
|
* @param srv_id 服务器ID
|
|
|
* @retval MVL_NET_INFO * 返回和装置连接的通道MVL_NET_INFO对象，断开时返回NULL
|
|
|
*/
|
|
|
MVL_NET_INFO * ac_get_srvm_netInfo(ST_INT srv_id);
|
|
|
/**
|
|
|
* 通过站点的ID获得对应通道的net_info
|
|
|
* @param srv_id 服务器ID
|
|
|
* @param chnl 通道号
|
|
|
* @retval MVL_NET_INFO * 返回和装置连接的通道MVL_NET_INFO对象，断开时返回NULL
|
|
|
*/
|
|
|
MVL_NET_INFO * ac_get_srvm_chnlNetInfo(ST_INT srv_id, AC_CHANNEL chnl);
|
|
|
|
|
|
/**
|
|
|
* 设置装置的通道chnl的net_info
|
|
|
* @param srv_id 服务器ID
|
|
|
* @param net_info 装置连接通道
|
|
|
* @param chnl 通道号
|
|
|
* @retval SD_SUCCESS 设置成功
|
|
|
* @retval SD_FAILURE 设置失败
|
|
|
*/
|
|
|
ST_RET ac_set_srvm_chnlNetInfo(ST_INT srv_id, MVL_NET_INFO *net_info, AC_CHANNEL chnl);
|
|
|
|
|
|
/**
|
|
|
* 通过srv_id获取定值管理信息结构的地址
|
|
|
* @param srv_id 服务器ID
|
|
|
* @retval AC_IED_SG_CTRL* 定值管理信息结构的指针，失败返回NULL
|
|
|
*/
|
|
|
AC_IED_SG_CTRL *ac_get_srvm_sgCtrl(ST_INT srv_id);
|
|
|
|
|
|
|
|
|
/**
|
|
|
* 通过ID获取报告相关的信息 。
|
|
|
* @param srv_id SRVID
|
|
|
* @return AC_IED_RCB_INFO 报告块的指针
|
|
|
*/
|
|
|
AC_IED_RCB_INFO *ac_get_srvm_iedRcbInfo(ST_INT srv_id);
|
|
|
|
|
|
/**
|
|
|
* 读取通道状态
|
|
|
* @param srv_id 服务器ID
|
|
|
* @param chnla_state 保存返回的A通道状态
|
|
|
* @param chnlb_state 保存返回的A通道状态
|
|
|
* @param active_chnl 活动通道
|
|
|
* @retval SD_SUCCESS 成功
|
|
|
* @retval SD_FAILURE 失败
|
|
|
*/
|
|
|
ST_RET ac_get_srvm_chnlState(ST_INT srv_id, CHNL_STATE *chnla_state, CHNL_STATE *chnlb_state, AC_CHANNEL *active_chnl);
|
|
|
|
|
|
/**
|
|
|
* 设置某一通道状态,chnl为通道号state为通道状态
|
|
|
* @param srv_id 服务器ID
|
|
|
* @param state 通道状态
|
|
|
* @param chnl 通道号
|
|
|
* @retval SD_SUCCESS 成功
|
|
|
* @retval SD_FAILURE 失败
|
|
|
*/
|
|
|
ST_RET ac_set_srvm_chnlState(ST_INT srv_id, CHNL_STATE state, AC_CHANNEL chnl);
|
|
|
|
|
|
/**
|
|
|
* 设置主通道为chnl
|
|
|
* @param srv_id 服务器ID
|
|
|
* @param chnl 通道号
|
|
|
* @retval SD_SUCCESS 成功
|
|
|
* @retval SD_FAILURE 失败
|
|
|
*/
|
|
|
ST_RET ac_set_srvm_activeChnl(ST_INT srv_id, AC_CHANNEL chnl);
|
|
|
|
|
|
/**
|
|
|
* 获取当前主通道
|
|
|
* @param srv_id 服务器ID
|
|
|
* @retval 当前主通道
|
|
|
*/
|
|
|
AC_CHANNEL ac_get_srvm_activeChnl(ST_INT srv_id);
|
|
|
|
|
|
/**
|
|
|
* 设置通道重连时间
|
|
|
* @param srv_id 服务器ID
|
|
|
* @param chnl 通道号
|
|
|
* @param next_time 重连时间
|
|
|
* @retval SD_SUCCESS 成功
|
|
|
* @retval SD_FAILURE 失败
|
|
|
*/
|
|
|
ST_RET ac_set_srvm_chnlNextTime(ST_INT srv_id, AC_CHANNEL chnl, ST_DOUBLE next_time);
|
|
|
|
|
|
/**
|
|
|
* 获取特殊iedconfig
|
|
|
* @param srv_id 服务器ID
|
|
|
* @retval iedconfig
|
|
|
*/
|
|
|
AI_IED_CFG *ac_get_srvm_iedConfig(ST_INT srv_id);
|
|
|
/**
|
|
|
* 获取通道chnlDibName
|
|
|
* @param srv_id 服务器ID
|
|
|
* @param chnl 通道号
|
|
|
* @retval chnlDibName
|
|
|
*/
|
|
|
ST_CHAR *ac_get_srvm_chnlDibName(ST_INT srv_id, AC_CHANNEL chnl);
|
|
|
|
|
|
/**
|
|
|
* 一次取出一个完整的状态，防止在取的过程中被其他线程修改剩下未取到的状态值
|
|
|
* @param srv_id 服务器ID
|
|
|
* @param con_ctrl 网络信息结构
|
|
|
* @param cre_state 保存对象空间创建状态指针
|
|
|
* @param refr_state 保存数据刷新状态指针
|
|
|
* @retval SD_SUCCESS 取值成功
|
|
|
* @retval SD_FAILURE 取值失败
|
|
|
*/
|
|
|
ST_RET ac_get_srvm_wholeState(ST_INT srv_id,
|
|
|
AC_CONNECT_CTRL *con_ctrl,
|
|
|
CREATE_STATE *cre_state,
|
|
|
REFRESH_STATE *refr_state);
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
}
|
|
|
#endif
|
|
|
#endif
|