Files
STM32F4-Base/App/task/protect_task.c
T
wandering1 90db528032 W1 功能主线完成:内存台账三件套(W1-0) + IEC104 上行(B4) + protectTask 板端接线(B5)
W1-0 台账三件套:scripts/ram_baseline.py(四模式)+ ram_baseline.tsv 趋势 +
docs/内存管理/RAM预算台账.md + pre-commit mem-budget 钩子(RW_IRAM1/RW_CCM >92%
即 FAIL + Top-10 附表);审查报告 §5.5 三条闭环。

B4 IEC 60870-5-104 上行(被控站,TCP 2404):App/protocol/iec104/ 三模块
(asdu 编解码 / pts 点表+数据源 vtable / link APCI+FSM,纯逻辑零 I/O)+
App/task/iec104_serv.c(iec104Task,NET_READY 屏障 100ms 分片喂位)。
82 断言 L0.5 全绿 + iec104-unit-test 钩子(第 31 钩子);
设计说明 docs/子系统设计/IEC104上行设计说明.md 全量回填。

B5 protectTask(L3 板端接线):App/task/protect_task.c——20ms 判据节拍
prot_elm_run + L5-4 采样故障闭锁(adc_health 电平位→元件复位)+ L5-1 定值
校验和巡检;新增 prot_elm_request_reset() 收口跨上下文复归(104 YK11 落请求、
eval 头部消费);定值/元件初始化移入 app_main_init(内核前)。TC-PE-010
(prot_elm 28 用例)。

门禁与内存:TASK_WD_PROTECT=8 入 required_mask(产品 0x77→0x1F7、HW 层
0x1F5,看门狗单测 39 断言同步);FreeRTOS 堆 48→56KB(.ioc L1 参数 +
FreeRTOSConfig.h 同步,RAM预算台账 §6 登记配额 48→56KB)。
ZI 144,008→152,204(+8,196 B = 堆 +8KB,B5 扩容);Code=204,348。
stack_report:protectTask 512 words 静态链 872 B/余 57%、iec104Task
640 words 1456 B/余 43% 均 PASS;RW_IRAM1 73.1% / RW_CCM 87.9%(<92%)。

验证:@build 0 错 0 警;ci_local 全绿(31 钩子 + 13 主机侧单测);
doc-links 135 文档 PASS。登记簿 B4/B5 销项、W1 波次完成;保护规划/看门狗
说明/AGENTS(9 任务)/RAM 三文档全部同步。

遗留(验收窗口,非代码空洞):台架第三方 104 主站往返(送检窗口)、
标准源注入动作判据、@test PROT 锚点 + protect 栈水位 + 新堆 min_ever 复测。
2026-10-12 12:36:23 +08:00

106 lines
4.3 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.
/*
* 模块名称:保护任务(L3 板端接线,B5)——实现
* 模块功能:见 protect_task.h。每拍三件事:
* ① L5-4 采样故障闭锁:adc_health_flags() 电平位命中 → 元件状态
* 复位(防陈旧判据)+ 本拍不 eval;
* ② prot_set_selfcheck()(L5-1 定值完整性巡检,31 项 sum32,开销
* 可忽略;失配 → prot_set 内部闭锁,eval 自动复位全元件);
* ③ prot_elm_run()(phasor rms → 判据步进)+ 动作位图边沿日志。
* 定值/元件初始化在 app_main_init(内核前,B5);本任务只消费。
* 线程约定:prot_elm_run / prot_set_selfcheck 仅本任务上下文(prot_elm.h);
* 跨上下文复归(104 YK11)经 prot_elm_request_reset 落请求。
* 创建日期:2026-10-12(B5)
*/
#include "protect_task.h"
#include "cmsis_os2.h"
#define DBG_TAG "[PROT]"
#define DBG_LINE_BUF_MAX 128U
#include "dbg_log.h"
#include "adc_health.h"
#include "prot_elm.h"
#include "prot_set.h"
#include "task_watchdog.h"
/* L5-4 采样故障电平闭锁位:stall(可自愈)+ backward(锁存)都须停判据。
* 锁存类(FRSTDATA/HW_ERR 等)不在此列——它们是一次性事件痕迹,不构成
* "当前测量不可信";持续 stall/backward 才是。 */
#define PROT_HF_LOCK_MASK (ADC_HF_TPAFE_STALL | ADC_HF_STM32_STALL | ADC_HF_SEQ_BACKWARD)
static uint32_t s_prev_active; /* 上拍动作位图(边沿日志用) */
static uint8_t s_prev_hf_lock; /* 上拍采样闭锁态(边沿日志用) */
/*
* 函数功能:动作位图变化沿日志(逐变化元件打名字与状态)
* 入口参数:active - 本拍 prot_elm_active_mask()
* 函数说明:V0.1 无出口硬件(规划 R7),动作 = 遥信 + 日志;SOE 落盘随 L4。
*/
static void s_log_active_edge(uint32_t active) {
uint32_t chg = active ^ s_prev_active;
uint32_t i;
for (i = 0u; (i < (uint32_t)PE_COUNT) && (chg != 0u); i++) {
const uint32_t bit = 1u << i;
if ((chg & bit) != 0u) {
prot_elm_state_t st;
chg &= ~bit;
prot_elm_state((prot_elm_id_t)i, &st);
DBG_INFO("elm %s asserted=%u picked=%u",
prot_elm_name((prot_elm_id_t)i),
(unsigned)st.asserted, (unsigned)st.picked);
}
}
s_prev_active = active;
}
/*
* 函数功能:protectTask 线程入口
* 入口参数:argument - 未用
* 返 回 值:无(不返回)
* 函数说明:无就绪屏障(判据只依赖 phasor 使用区,未就绪时 prot_elm_run
* 整拍自跳;采样闭锁另有 adc_health 电平位兜底)→ 上电即跑。
* 每拍喂看门狗(TASK_WD_PROTECT,产品 required_mask 0x1F7)。
*/
void protect_task(void *argument) {
(void)argument;
DBG_INFO("protect task start: cycle=%ums elm=%u",
(unsigned)PROTECT_TASK_CYCLE_MS, (unsigned)PE_COUNT);
for (;;) {
uint32_t now = osKernelGetTickCount();
uint32_t hf = adc_health_flags();
if ((hf & PROT_HF_LOCK_MASK) != 0u) {
/* L5-4:测量链不可信 → 复位元件(本任务上下文,直接 init 合法)
* 并跳过判据;stall 自愈后下一拍自动恢复 */
if (s_prev_hf_lock == 0u) {
DBG_ERROR("sampling FAULT -> protection blocked (hf=0x%08lX)",
(unsigned long)(hf & PROT_HF_LOCK_MASK));
}
s_prev_hf_lock = 1u;
prot_elm_init();
} else {
if (s_prev_hf_lock != 0u) {
DBG_INFO("sampling recovered -> protection resumed");
s_prev_hf_lock = 0u;
}
/* L5-1 巡检:定值区与封存校验和不符 → prot_set 闭锁(下一拍起
* eval 自动复位全元件)。⚠ 与 104 定值写(iec104Task set+seal)
* 的竞态窗口为 µs 级:selfcheck 误锁后同一次写的 seal 即清锁
* (prot_set.c),V0.1 如实登记,P4 定值持久化时收口。 */
(void)prot_set_selfcheck();
prot_elm_run(now);
}
s_log_active_edge(prot_elm_active_mask());
task_wd_beat(TASK_WD_PROTECT);
osDelay(PROTECT_TASK_CYCLE_MS);
}
}