75 lines
5.7 KiB
C
75 lines
5.7 KiB
C
/*
|
||
* 104计数量召唤(C_CI_NA_1):读取应用提供的电能量快照,或由应用执行冻结/复位。
|
||
* 本模块提供种类规则和创建/动作入口;事件、调度、广播、期限与清理由共用引擎维护。
|
||
* 返回的句柄沿用Interrogation的驱动接口,所有调用在所属事件循环中串行执行。
|
||
* 配置由IEC104_Startup_Config_Default的counter_config输出初始化,GI/CI分别持有配置与广播工作区。
|
||
* 计数量完成不计入Startup要求的真实全站总召,不能用来开放缓存补发门禁。
|
||
*/
|
||
#ifndef IEC104_COUNTER_INTERROGATION_H
|
||
#define IEC104_COUNTER_INTERROGATION_H
|
||
#include "IEC104_Interrogation.h"
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
/**
|
||
* 功能:创建计数量实例:复制配置、借用Slave;参数或容量不满足要求时返回NULL,不操作网络。
|
||
* 输入参数:slave——所属从站服务。
|
||
* config——配置。
|
||
* 输出参数:无。
|
||
* 返回值:返回IEC104_Interrogation_Create_With_Rules(slave, config, &IEC104_COUNTER_INTERROGATION_RULES)的结果。
|
||
* 说明:同一Slave可同时拥有总召和计数量各一个实例,须分别提供广播状态区并接收全部连接/启停通知。
|
||
* RQT=1..4选择分组,5选择全部;FRZ=0接受Type15(SQ=0/1)或Type37(SQ=0),
|
||
* 以及仅限RQT=5、数据COT=37的Type206/207(均SQ=0/1);后两者不接受分组COT=38..41。
|
||
* 数据COT使用request.data_cause;104计数量不接受带CP24时标的Type16。
|
||
* 206/207提供float32+QDS(207再带CP56),单位和倍率来自应用点表,模块不做Wh/kWh换算;
|
||
* 它们没有BCR序号/CY/CA字段。一次ASDU保持同一类型,不把15/37与206/207对象混装。
|
||
* 这里只处理召唤应答;同类电能的COT=3主动上送使用Spontaneous入口。
|
||
* FRZ=1冻结,2冻结并复位,3仅复位;肯定ACT_CON提交后即完成,不生成NEED_DATA或ACT_TERM。
|
||
* gi_submitted在此实例统计完成响应的提交次数:读取为ACT_TERM,动作命令为ACT_CON。
|
||
* 不支持COT=8撤销,回COT=45;合法TEST冻结/复位保持T位肯定确认,但不执行真实动作。
|
||
* 同关联键的后到忙否定须等原ACT_CON交接;关联比较使用完整QCC(RQT及FRZ),不把读取与冻结混同。
|
||
* 不产生第二个BEGIN或重复动作,不刷新原期限;不同OA/TEST/QCC的就绪回复仍可提前发送。
|
||
* 销毁前先Cancel并读完FINISHED;连接关闭会同时影响共享该连接的其他业务。
|
||
*/
|
||
IEC104_Interrogation_t *IEC104_CounterInterrogation_Create(IEC104_Slave_t *slave,
|
||
const IEC104_InterrogationConfig_t *config);
|
||
|
||
/* 同步动作回调:context为应用上下文,request为引擎保存的请求信息,仅在回调期间借用。
|
||
* true表示所选组的动作已完成;false必须保证未改变任何计数器,不能部分清零后报告失败。
|
||
* 应先检查整个组的资源和条件,再提交修改;动作须短时完成,不访问网络或执行阻塞I/O。
|
||
* 不得重入引擎或推进协议事件循环;真实计数器值、冻结值、序号和品质均由应用维护。 */
|
||
typedef bool (*IEC104_CounterInterrogationAction_t)(void *context,
|
||
const IEC104_InterrogationRequest_t *request);
|
||
|
||
/**
|
||
* 功能:应答已取出的FRZ=1..3 BEGIN;event须原样传回,action非NULL,context原样传给回调。
|
||
* 输入参数:self——本模块实例。
|
||
* event——事件。
|
||
* action——动作回调。
|
||
* context——调用方上下文。
|
||
* 输出参数:self——本模块实例的更新结果。
|
||
* 返回值:返回IEC104_Interrogation_Execute_Action(self, event, &IEC104_COUNTER_INTERROGATION_RULES, action, context)的结果。
|
||
* 说明:先校验实例、事件、会话和期限;WAIT/STALE/ERROR均不调用action,也不会修改计数器。
|
||
* 校验通过后先消费BEGIN;普通请求调用一次action,TEST请求直接肯定且不调用action。
|
||
* 返回OK表示交互已消费,不表示真实动作一定成功;普通action返回true/false分别排队肯定/否定确认。
|
||
* TEST不修改真实计数器、冻结值、序号或锁,其肯定确认只证明协议过程,不证明真实动作成功。
|
||
* 同一事件再次提交返回STALE;只保证本次BEGIN不重复执行,主站重发的新请求仍可能再次执行。
|
||
* 动作成功后等待肯定确认期间停止业务期限,避免计数器已改变却因排队超时改发否定确认。
|
||
* 传输超时、STOP、断线及本地Cancel仍可终结协议任务并交付FINISHED,但不回滚已执行动作。
|
||
* 本接口不管理异步外部电表事务;这类事务须另定义执行状态、迟到结果和重复请求策略。
|
||
* FRZ=0使用Reply_Begin及数据接口,整轮读取(含WAIT重试)应保持同一数据快照;
|
||
* 使用206传当前电能量、207传带原冻结时刻的冻结电能量时,快照均由应用提供;
|
||
* 207的值、QDS和CP56须来自同一份记录,校时、分帧或重试不能重填原冻结时刻。
|
||
* QDS的IV表示数据无效,CP56的IV表示时间无效,两者独立;本模块不会替应用修正它们。
|
||
* 动作命令没有NEED_DATA,拿其BEGIN调用Submit_Batch会返回STALE,不发送数据。
|
||
*/
|
||
IEC104_InterrogationReplyResult_t IEC104_CounterInterrogation_Execute_Begin(
|
||
IEC104_Interrogation_t *self, const IEC104_InterrogationEvent_t *event,
|
||
IEC104_CounterInterrogationAction_t action, void *context);
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
#endif /* IEC104_COUNTER_INTERROGATION_H */
|