Files
STM32F4-Base/IEC60870-Slave/104/business/IEC104_CounterInterrogation.c
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

115 lines
6.0 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的QCC,限定RQT和读取数据类型,选择完成方式。
* 规则函数不保存状态、不访问网络;计数器存储及冻结/复位由应用提供。
* 创建和动作入口只委托共用引擎,避免另建一套任务、广播、期限及取消流程。
*/
#include "IEC104_CounterInterrogation.h"
#include "IEC104_Interrogation_Internal.h"
/**
* 功能:从首对象取IOA和QCC;对象层已将低6位RQT与高2位FRZ拆开。
* 输入参数:info——查询信息。
* ioa——信息体地址。
* qualifier——限定词。
* freeze——uint8_t *所指数据。
* 输出参数:ioa——信息体地址的更新结果。
* qualifier——限定词的更新结果。
* freeze——uint8_t *所指数据的更新结果。
* 返回值:IEC60870_Asdu_Get_Element(info, 0U, &command, sizeof(command)) != IEC60870_ASDU_OK时返回false;其余分支返回false、true。
* 说明:这里只解析,不校验是否支持该分组;失败时不写调用方的输出。
*/
static bool Counter_Decode(const IEC60870_AsduInfo_t *info, uint32_t *ioa, uint8_t *qualifier, uint8_t *freeze)
{
IEC60870_CounterInterrogationCommand_t command;
if (IEC60870_Asdu_Get_Element(info, 0U, &command, sizeof(command)) != IEC60870_ASDU_OK) { return false; }
*ioa = command.object.ioa;
*qualifier = command.qualifier;
*freeze = command.freeze;
return true;
}
/**
* 功能:RQT=1..4为分组,5为总请求;
* 输入参数:qualifier——限定词。
* 输出参数:无。
* 返回值:RQT为1..5返回true,其余值返回false。
* 说明:0未用、6..63保留。具体分组是否配置由应用在BEGIN决定。
*/
static bool Counter_Qualifier_Valid(uint8_t qualifier) { return qualifier >= 1U && qualifier <= 5U; }
/**
* 功能:引擎准入后使用:总请求的数据COT为37,第1..4组依次为38..41。
* 输入参数:qualifier——限定词。
* 输出参数:无。
* 返回值:返回(uint8_t)(qualifier == 5U ? IEC60870_ASDU_COT_COUNTER_INTERROGATION : IEC60870_ASDU_COT_COUNTER_INTERROGATION + qualifier)的结果。
* 说明:这里只由RQT计算原因,不决定应答类型;206/207另由Counter_Data_Allowed限制为37,
* 因此不能通过给分组应答改填COT=37绕过原请求,外层还会核对request.data_cause。
*/
static uint8_t Counter_Data_Cause(uint8_t qualifier)
{
return (uint8_t)(qualifier == 5U ? IEC60870_ASDU_COT_COUNTER_INTERROGATION :
IEC60870_ASDU_COT_COUNTER_INTERROGATION + qualifier);
}
/**
* 功能:只有读取存在数据阶段;
* 输入参数:freeze——uint8_t值。
* 输出参数:无。
* 返回值:FRZ为0的读取请求返回true,冻结或复位请求返回false。
* 说明:冻结/复位在肯定确认提交后直接完成。
*/
static bool Counter_Has_Data(uint8_t freeze) { return freeze == 0U; }
/**
* 功能:判定应用提交的数据ASDU是否属于本计数量请求允许的类型和形态。
* 输入参数:info——共用引擎已解析的非空数据头;freeze——原QCC的FRZ位,0表示读取。
* 输出参数:无。
* 返回值:true表示通过本种类规则,false表示不可作为此事务的数据批次;不产生副作用。
* 说明:15/37沿用整数累计量规则,其中37在本业务入口仅允许SQ=0;16不用于104。
* 206/207按细则§7.8允许SQ=0/1,但仅接受电能量总请求的数据COT=37,
* 不把旧整数模式的分组COT=38..41自动扩展到新类型;COT=3由Spontaneous发送。
* FRZ=1..3没有数据阶段。完整布局、数量、CA/OA/TEST及请求COT匹配仍由外层校验,
* 此函数返回true不等于整个ASDU可直接发送,也不采集、冻结或复位应用电能值。
*/
static bool Counter_Data_Allowed(const IEC60870_AsduInfo_t *info, uint8_t freeze)
{
return freeze == 0U && (info->type_id == IEC60870_ASDU_M_IT_NA_1 ||
(info->type_id == IEC60870_ASDU_M_IT_TB_1 && info->is_sequence == 0U) ||
((info->type_id == IEC60870_ASDU_M_IT_NB_1 || info->type_id == IEC60870_ASDU_M_IT_TC_1) &&
info->cause_of_transmission == IEC60870_ASDU_COT_COUNTER_INTERROGATION));
}
/* 只读规则存活至进程结束;has_deactivation=false使COT=8按未知传送原因处理。 */
const IEC104_InterrogationRules_t IEC104_COUNTER_INTERROGATION_RULES = {
IEC60870_ASDU_C_CI_NA_1, false, Counter_Decode, Counter_Qualifier_Valid,
Counter_Data_Cause, Counter_Data_Allowed, Counter_Has_Data
};
/**
* 功能:用计数量规则创建独立实例;
* 输入参数:slave——所属从站服务。
* config——配置。
* 输出参数:无。
* 返回值:返回IEC104_Interrogation_Create_With_Rules(slave, config, &IEC104_COUNTER_INTERROGATION_RULES)的结果。
* 说明:配置、站点引用、重复实例和状态区重叠统一由引擎校验。
*/
IEC104_Interrogation_t *IEC104_CounterInterrogation_Create(IEC104_Slave_t *slave,
const IEC104_InterrogationConfig_t *config)
{
return IEC104_Interrogation_Create_With_Rules(slave, config, &IEC104_COUNTER_INTERROGATION_RULES);
}
/**
* 功能:传入本种类规则作为身份约束,防止误把总召句柄交给动作入口。
* 输入参数:self——本模块实例。
* event——事件。
* action——动作回调。
* context——调用方上下文。
* 输出参数:self——本模块实例的更新结果。
* 返回值:返回IEC104_Interrogation_Execute_Action(self, event, &IEC104_COUNTER_INTERROGATION_RULES, action, context)的结果。
* 说明:内部调用:IEC104_Interrogation_Execute_Action。
*/
IEC104_InterrogationReplyResult_t IEC104_CounterInterrogation_Execute_Begin(
IEC104_Interrogation_t *self, const IEC104_InterrogationEvent_t *event,
IEC104_CounterInterrogationAction_t action, void *context)
{
return IEC104_Interrogation_Execute_Action(self, event, &IEC104_COUNTER_INTERROGATION_RULES, action, context);
}