Files
STM32F4-Base/IEC60870-Slave/104/business/IEC104_CounterInterrogation.h
T
STF bdcc8b6500
CI / L0 静态门禁 (pre-commit) (push) Failing after 7m46s
CI / L0.5 主机侧单测 (MSVC) (push) Successful in 21s
添加遥控、参数装载、文件传输等业务
2026-11-16 22:19:17 -08:00

75 lines
5.7 KiB
C
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/*
* 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 */