Files
STM32F4-Base/App/protocol/iec60870/104/business/IEC104_CounterInterrogation.c
T
wandering1 2e9272cc8a feat(iec104): 在模拟器跑通共享协议核心与标准DTU点表
引入成熟 IEC 60870-5-104 子站的只读子集(App/protocol/iec60870,28 个源文件
按原字节复制,UPSTREAM.sha256 记录来源,兼容补丁保留全部断言与容量),在其上
装配单属主共享核心(Start/Poll/Stop/Get_Status),并把标准 DTU 演示点表全量
接入为唯一真源。

- iec104_core:threadless 推进,poll 零等待,通知/交互/COV 扫描全部有界;
  生命周期区分失败启动待重试、重复启动拒绝、断线保固化 RAM。
- iec104_dtu_table / iec104_source:标准 DTU 全点表注册,无数据源的点读 0,
  遥控只做模拟状态可读回,不触碰实际出口。
- iec104_sim:仅窗口与独立服务模式起真实 TCP,无头黄金模式保持确定性假统计。
- test/host/iec104_dtu:独立真实 TCP 11 项、传输层 10 项、生命周期与借用负例。

验证:lvgl_sim 真实 TCP 11/11、传输 10/10,UI 像素回归未回退;AC5 单 TU
编译 0 错误 0 诊断。板端尚未切换:完整库闭包 RAM 超 92% 门禁净增预算 25730B,
结论为停止转实施,记录在 IEC104_MCU最小可行性验证.md。旧实现与 board 服务
保持原样,未提交 MDK 工程改动,未烧板。
2026-11-17 20:48:00 +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);
}