refactor(编号·批次二): 代码与测试侧 215 处保护功能号改成功能名,零行为改动

用户裁定「不要用字母加数字的编号,语义标识是最好的」后的批次二代码半(道 ui-param 执行,逐文件站点数与
自证见其交付)。唯一口径 = 映射表 ci-artifacts/lprot_map.tsv 的功能名列原文,**零自造同义词**;L2.5 与
L-TEST 经实测各 0 处(不是本族),TC 族一字未动。

固件 22 文件 128 处(adc_task.c 21、phasor.c 22、phasor.h 13…),主机测试 13 文件 87 处(pha
sor_test.c
57…);设计文档指针新增 19 行,另 16 只文件本来就写着规划文档 ⇒ 不重复加。

**两条只有真改过 215 处才会踩到的坑,都写进注释规范实践**:
· 指针**不能接在原句尾部**——那会替原文一个未闭合的半括号封口,实测咬坏 App/algo/sample_ring.h 这类
  跨行句 ⇒ 指针一律**单独成行**;
· 号删掉会留下**叠词**(「自检失败闭锁 闭锁判定」「定值校验和 定值巡检」)⇒ 复扫并收口 4 处,措辞只用
  映射名本身;具体对象需要留住时写成「自检失败闭锁(采样故障闭锁)」。

自证(不靠嘴说):改前把 35 只文件原文备份到仓外 temp,逐文件比 `/*`、`*/` 计数、三类括号计数、行数增量
恰等于指针行数、全角括号增删相等、残留号 0 ⇒ **35/35 通过**;Lead 复核后跑权威 @build **0 错 0 警**,
Program Size `Code=233900 RO=26104 RW=1536 ZI=136808` —— **与三条道各自改前改后测的四数逐
字节同数**,
这就是「只动注释与文本」的机器证据;八套主机单测 exit 0,cppcheck 按钩子参数零发现,coding-standard 0。

文件头「修改记录」里的号**一并换名、不还原**(Lead 裁定):这些号是全仓退役的,留一个查无此号的引用比
留一条改过名的条目更坏——「冻结历史不回改」保护的是**别替历史改口**,不是保护一个再也查不到的字符串;
id-check 对变更记录行本就豁免,两种选择都不影响门禁。
This commit is contained in:
2026-10-27 08:59:26 +08:00
parent 26a97e99f9
commit b7c0889cc7
48 changed files with 239 additions and 219 deletions
+8 -7
View File
@@ -1,9 +1,10 @@
/*
* 模块名称:保护任务(L3 板端接线,B5)——实现
* 模块功能:见 protect_task.h。每拍三件事:
* ① L5-4 采样故障闭锁:adc_health_flags() 电平位命中 → 元件状态
* ① 自检失败闭锁 采样故障闭锁:adc_health_flags() 电平位命中 → 元件状态
*(保护功能清单见 docs/算法/继电保护功能复现规划.md)
* 复位(防陈旧判据)+ 本拍不 eval;
* ② prot_set_selfcheck()(L5-1 定值完整性巡检,40 项 sum32——
* ② prot_set_selfcheck()(定值校验和 完整性巡检,40 项 sum32——
* B8 后 PS_ID_COUNT=40,开销
* 可忽略;失配 → prot_set 内部闭锁,eval 自动复位全元件);
* ③ prot_elm_run()(phasor rms → 判据步进)+ 动作位图边沿日志;
@@ -26,7 +27,7 @@
* 跨上下文复归(104 YK11)经 prot_elm_request_reset 落请求。
* 创建日期:2026-10-12(B5)
* 修改记录:
* v1.0 2026-10-12 王建锋 创建:L5-4 采样故障闭锁 + L5-1 定值巡检 + 判据节拍
* v1.0 2026-10-12 王建锋 创建:自检失败闭锁(采样故障闭锁)+ 定值校验和 巡检 + 判据节拍
* v1.1 2026-10-21 王建锋 ①之外增加**兜底新鲜度门**:本任务用自己的时基直接
* 看两个中断侧计数器是否还在前进(ADC_HF_STALE)。
* adc_health 的 stall 位依赖 adcTask 每拍跑 check(),
@@ -64,7 +65,7 @@
#include "task_watchdog.h"
#include "tpafe5160.h" /* tpafe5160_frame_seq():帧序号(BUSY EXTI 写) */
/* L5-4 采样故障电平闭锁位:stall(可自愈)+ backward(锁存)都须停判据。
/* 自检失败闭锁 采样故障电平闭锁位:stall(可自愈)+ backward(锁存)都须停判据。
* 锁存类(FRSTDATA/HW_ERR 等)不在此列——它们是一次性事件痕迹,不构成
* "当前测量不可信";持续 stall/backward 才是。 */
#define PROT_HF_LOCK_MASK (ADC_HF_TPAFE_STALL | ADC_HF_STM32_STALL | \
@@ -195,7 +196,7 @@ void protect_task(void *argument) {
uint32_t now = osKernelGetTickCount();
uint32_t hf = adc_health_flags();
/* 兜底新鲜度门(L5-4 的独立通道):节拍源停摆时 adcTask 会永久阻塞在
/* 兜底新鲜度门(自检失败闭锁 的独立通道):节拍源停摆时 adcTask 会永久阻塞在
* osThreadFlagsWait(那是刻意的 fail-safe),check() 不再执行 → stall 位
* 永远是 0。这里用本任务自己的时基直接读两个**中断侧递增**的计数器,
* 与 adcTask 的存亡无关;两者都只要 TIM3 还在触发就会前进。
@@ -218,7 +219,7 @@ void protect_task(void *argument) {
}
if ((hf & PROT_HF_LOCK_MASK) != 0u) {
/* L5-4:测量链不可信 → 复位元件(本任务上下文,直接 init 合法)
/* 自检失败闭锁:测量链不可信 → 复位元件(本任务上下文,直接 init 合法)
* 并跳过判据;stall 自愈后下一拍自动恢复 */
if (s_prev_hf_lock == 0u) {
DBG_ERROR("sampling FAULT -> protection blocked (hf=0x%08lX)",
@@ -256,7 +257,7 @@ void protect_task(void *argument) {
SOE_ELM_NONE, 1u);
s_prev_cal_lock = 0u;
}
/* L5-1 巡检:定值区与封存校验和不符 → prot_set 闭锁(下一拍起
/* 定值校验和 巡检:定值区与封存校验和不符 → prot_set 闭锁(下一拍起
* eval 自动复位全元件)。B7 收口:104 定值写改走
* prot_set_set_sealed(影子区写+封存后单字交换),selfcheck 另有
* seqlock 式复核(提交撞见 = 本轮跳过),误锁窗口已消除。 */