wandering1/STM32F4-Base
1
0
Fork 0
Code Issues 30 Pull Requests Actions Packages Projects 2 Releases Wiki Activity

feat(保护标定): 卡5 未标定闭锁 + 卡6 下游三常数重定 + 卡7 量纲回归单测

Browse Source 
卡 5（protect_task.c 第⑤闭锁源，「数据可信」§4.3 决策 1=闭锁）：
- UA/UN/IA 的 adc_cal VALID 未全置位 → prot_elm_init + 本拍不 eval；每拍现查
  flags、无自有状态（卡 12 标定写入后自动解锁）；判据链优先级 = 采样可信在前、
  标定可用在后（数据都是旧的谈不上标定）
- 边沿日志用 DBG_INFO 而非 [ERR]：未标定是出厂常态、非故障，且 @test 禁用
  [ERR]（「默认构建保护不动作 = 期望」的台架判据同步项已在 MR 报 lead）；
  SOE 分型 SOE_T_CAL_BLOCK/RESUME（soe_rec.h 枚举尾追加，值 6/7——reader 侧
  显示标签映射归道B reader，MR 已报）
- 台架旁路 = 编译期宏 DTU_BENCH（§4.3：不进 cfg 不进 104；本仓所有提交目标
  都不定义它 = 产品恒强制闭锁）

卡 6（下游三常数按工程量重定，依据同源 docs/任务规划/数据可信.md §2.3）：
- FREQ_AMP_MIN（freq.h）：语义从拟定码值域重定为二次值 V——50 V = 0.5×Un
  （标称 100 V），断保险/PT 空载/浮空必低于之；数值沿用 50.0f 属巧合并在
  注释明写；eng=0 过渡期本门恒失效 → OF/UF 按必不启动填充，与卡 5 同向安全
- k_yc[].deadband（iec104_pts.c）：9 点按「额定 0.5 %」规则重定：电压类
  0.5 %×100 V=0.5、电流类 0.5 %×1 A=0.005、频率维持 0.5 Hz 绝对值（非额定
  比，卡 10 运行参数化）；标称基准与 prot_set 头部同源，防两处真相
- g_prot_set_meta[]（prot_set.c）：数值/范围复核结论=不动（0~4×标称自洽），
  文件头补量纲口径块：A/V = 二次值、标称 100 V/1 A、OV120=1.2Un/UV20=.2Un/
  3U0 15=.15Un、OC1/2/3=10/5/2×Ir、OL=1.0×Ir；PS_ID_COUNT/blob VER 未动
- iec104 套件 TC-008 死区用例同步重定标（100.4 带内 / 101.25 越带），97/97

卡 7（test/host/prot_dim 新套件，真实链 adc_cal→ring→phasor→prot_elm）：
- 用例从 ADC 码值出发、显式写出 code↔二次值互逆换算（dim_code vs apply），
  折算点被旁路或量纲再错位断言立刻翻转（M4 判据⑥「不该动作时不动作」）
- 合成 ROM 覆写（#undef K_Q16 宏）模拟卡 12 标定后板级口径，走 adc_cal_set
  正规路径置 VALID；b=-30 码全链对消进 rms 断言
- 38/38：基线静默（含 OL 低定值陷阱）、反错配对照（raw 码值灌环复现历史事故
  必假动作 vs 经折算必静默）、OC1/2/3+OL+OV+UV+3U0 七类逐一：越限定值→
  受控启动拍→dly-2 不动作/+5 动作→返回系数带内保持→跌破释放、双件聚合位图
  独立性（撤 IA 只回 OC1）

测试与注册：prot-dim-unit-test 钩子 + TC-HOST-PROTDIM 族（游标 010，B 层口径
同 ADCHEALTH/ADCCAL 先例）；无新 MCU 源文件（uvprojx/SIM_EXEMPT 零改动）

gate：@build 0 错 0 警（Code=215640 RO=21388 RW=1220 ZI=131980 vs 基线
215440/19780/1220/131980 → Flash +1808 B、RAM 零增量）；protectTask 静态最坏
链 872 B/margin 1176 B（57%）PASS，adcTask 不变；staged 门禁除 mem-numbers/
mem-budget（台账漂移，回填归 lead）外全绿：
gate: only mem-budget/mem-numbers pending lead ledger backfill
BOM/CR/U+FFFD/字面量 ASCII 已逐文件自查（本轮未触碰带 BOM 文件）
This commit is contained in:
Wanderingss
2026-10-25 05:22:17 +08:00
parent a5f7385cad
commit ffd462ef3c
13 changed files with 711 additions and 37 deletions
Download Patch File Download Diff File Expand all files Collapse all files
App/algo/freq.h
+9 -3
View File
@@ -49,9 +49,15 @@
#define FREQ_INST_MIN_HZ 35.0f
#define FREQ_INST_MAX_HZ 65.0f
/* 幅值门限（有效值，**原始码值口径**，L1-5 标定未实现）：低于该值判
* "无有效波形"。⚠ 拟定值（远小于正常波形千级码值、远大于浮空噪声），
* 标定落地后须按工程量口径复核（同 prot_set 默认值"拟定"口径）。 */
/* 幅值门限（有效值，**二次值 V 口径**，「数据可信」卡 6 重定，依据其 §2.3 表第 1 行）：
* 低于该值判"无有效波形"。取值 50 V = 0.5×Un（相电压标称 100 V，与
* App/algo/prot_set.c 头部量纲基准同源）：正常带载 UA 在 0.9~1.1×Un，
* 50 V 之下只可能是断保险/PT 空载/浮空噪声（浮空实测 ~1.7 V 引脚域、
* 二次域更小），不会吃掉正常纹波（纹波谷值远大于 0.5×Un）。
* ⚠ 过渡期行为（eng=0，卡 12 标定前）：帧值还是引脚电压（≤5 V < 50 V），
* 本门**恒失效** → freq_valid()=0 → OF/UF 按"必不启动"填充复位——与卡 5
* 未标定闭锁同向（判据链本就停走），不构成额外风险；标定后自动恢复本意。
* 数值沿用原 50.0f 属巧合（原为"远小于千级码值"的拟定值），不是漏改。 */
#define FREQ_AMP_MIN 50.0f
/* 相位增量滑窗环容量（拍）：96 拍 = 96 ms 上限。实际平均窗长**自适应**
App/algo/prot_elm.c
+2 -1
View File
@@ -189,7 +189,8 @@ void prot_elm_eval(uint32_t now_ms, const float meas[PE_COUNT]) {
* 函数功能：适配层——按实例表 src 组装测量数组后调判据核
* 入口参数：now_ms - 单调时基（tick ms）
* 返 回 值：无
* 限定条件：仅保护消费者任务上下文；工程量↔码值换算 = 1（L1-5 标定未实现）
* 限定条件：仅保护消费者任务上下文；测量已是 L1.5 工程量（未标定域由
* protectTask 卡 5 闭锁挡在门外，本函数不感知标定态）
* 函数说明：src=PHASOR 行任一相量未就绪（未满一周波）→ **整拍跳过**，
* 不引入陈旧/半新测量（B5 口径）。src=FREQ 行：freq 有有效读数
* （started 且幅值门 OK）→ 填测得频率；否则按方向填"必不启动"值
App/algo/prot_elm.h
+4 -1
View File
@@ -22,7 +22,10 @@
* - 返回**即时**（参考 GRly_TimeRelay 带 10 ms 返回延时——V0.1 无出口硬件，
* 抖动只影响日志，P4 接出口时再补返回延时）；
* - 复压/方向/无压无流闭锁（dwSetFyCtrl 类）随 P2/P3 元件扩展；
* - 工程量↔码值换算系数暂为 1（L1-5 标定未实现，同 phasor 层口径）。
* - 测量输入 = adc_task 经 adc_cal_apply() 折算后的工程量（L1.5，卡 2 已落地）：
* 未标定（VALID=0）时单位只是 ADC 引脚电压——该域下判据必然错配，由
* protectTask 的未标定闭锁（卡 5）停走整条判据链，元件核本身不掺和
* 标定语义（保持纯逻辑）；标定后单位 = 二次值，定值口径才名副其实。
*
* 线程约定：init 内核启动前或保护消费者任务上下文；eval/run 仅保护消费者任务
* 上下文（B5 起 = protectTask）；request_reset 任意上下文（跨上下文复归请求，
App/algo/prot_set.c
+8
View File
@@ -5,6 +5,14 @@
* ⚠ 默认值/范围为拟定值（参考 EEPROM 出厂默认表不在本仓库，规划 §10.3 待补）；
* 通讯地址逐项对照参考 Comm/Pub/Const_CommSetPara.c g_tCommSetParaTab。
*
* 量纲口径（「数据可信」卡 6 复核，2026-10-25）：A/V 项 = **二次值**工程量，
* 标称基准 100 V / 1 A（UA/UB/UC 相电压、3U0、OV/UV 同域——OV 120 = 1.2×Un、
* UV 20 = 0.2×Un、3U0 15 = 0.15×Un；OC1/2/3 = 10/5/2 ×Ir、OL = 1.0×Ir，
* 三段递升与过负荷低于速断均自洽）。ADC 帧仅在 adc_cal VALID 置位后才处
* 于此域（未标定 = 引脚电压域，由卡 5 闭锁停走判据，见 protect_task.c）；
* min/max 范围覆盖 0~4×标称，无需随本卡改动数值——换算依据与三处下游
* 常数同源，见 docs/任务规划/数据可信.md §2.3。
*
* 创建日期：2026-10-11
*/
#include "prot_set.h"
App/log/soe_rec.h
+4
View File
@@ -69,6 +69,10 @@ typedef enum {
SOE_T_PLATE_IN,
SOE_T_SAMPLE_BLOCK,
SOE_T_SAMPLE_RESUME,
/* 未标定闭锁（「数据可信」卡 5，2026-10-25 道A 追加）：UA/UN/IA 的 VALID
* 未全置位 → 判据停走；与采样闭锁分型，边沿各留一条记录 */
SOE_T_CAL_BLOCK,
SOE_T_CAL_RESUME,
SOE_T_COUNT /* 哨兵值，非有效类型 */
} soe_type_t;
App/protocol/iec104/iec104_pts.c
+24 -11
View File
@@ -5,6 +5,11 @@
* 遥测死区）。点表口径见 iec104_pts.h 文件头与设计文档 §3。
* 线程约定：init/bind 建服务前；其余仅 104 服务任务上下文（快照非原子）。
* 创建日期：2026-10-12（B4）
* 修改记录：
* 2026-10-25 DTU 项目组 卡 6（「数据可信」）：YC 死区由拟定码值域重定为
* 二次值工程量域（额定 0.5 % 规则），判据依据见
* k_yc 表头注释；数值随卡 9 迁运行参数，本表将退化为
* ROM 默认载体。
*/
#include "iec104_pts.h"
@@ -16,23 +21,31 @@
#include "prot_set.h" /* 板端源：定值 + 闭锁 */
#include "adc_input.h" /* adc_semantic_t（phasor 实例按语义绑定） */
/* ---------------- YC 表（§1.5 点号 4011+；死区 = 拟定码值，L1-5 后复核） -- */
/* ---------------- YC 表（§1.5 点号 4011+；死区 = 二次值工程量域） --------- */
typedef struct {
uint32_t ioa;
int8_t sem; /* 绑定的 phasor 语义通道（-1 = 无 phasor 源，恒无效） */
float deadband; /* 死区（工程量绝对值） */
float deadband; /* 死区（二次值工程量绝对值，「数据可信」卡 6 重定） */
} pts_yc_def_t;
/* 死区规则 = 额定二次值的 0.5 %（「数据可信」§2.3 表第 2 行建议规则，卡 6 采纳；
* 额定基准 100 V / 1 A 与 App/algo/prot_set.c 头部同源，勿在此另立口径）：
* 电压类 0.5 % × 100 V = 0.5 V 电流类 0.5 % × 1 A = 0.005 A
* 频率点不适用"额定百分比"（额定附近 0.5 Hz 与旧值同量级，维持 0.5 并随
* 卡 10 运行参数段可调）。IV 品质点（sem=-1）数值仅为将来启用预留同型。
* ⚠ 过渡期（eng=0 引脚电压域，卡 12 标定前）：上送值本身非二次值，死区
* 按本域判定无意义但也不会漏报——104 侧 IV/数据可信度语义由 M5 快照层
* （卡 8/9）统一处理，本卡只把"量纲错位"这一处常量债还掉。 */
static const pts_yc_def_t k_yc[] = {
{ 0x4011u, (int8_t)ADC_SEM_UA, 10.0f }, /* 1Ua */
{ 0x4012u, -1, 10.0f }, /* 1Ub：V0.1 削顶 → IV */
{ 0x4013u, -1, 10.0f }, /* 1Uc：同上 */
{ 0x4014u, (int8_t)ADC_SEM_UN, 10.0f }, /* 1U0（外部零序专用通道） */
{ 0x4015u, (int8_t)ADC_SEM_IA, 10.0f }, /* 1Ia */
{ 0x4016u, -1, 10.0f }, /* 1Ib */
{ 0x4017u, -1, 10.0f }, /* 1Ic */
{ 0x4018u, -1, 10.0f }, /* 1I0 */
{ 0x401Du, -1, 0.5f }, /* 1f：L1-7 未实现 → IV */
{ 0x4011u, (int8_t)ADC_SEM_UA, 0.5f }, /* 1Ua：0.5 % × 100 V */
{ 0x4012u, -1, 0.5f }, /* 1Ub：V0.1 削顶 → IV */
{ 0x4013u, -1, 0.5f }, /* 1Uc：同上 */
{ 0x4014u, (int8_t)ADC_SEM_UN, 0.5f }, /* 1U0（外部零序专用通道） */
{ 0x4015u, (int8_t)ADC_SEM_IA, 0.005f }, /* 1Ia：0.5 % × 1 A */
{ 0x4016u, -1, 0.005f }, /* 1Ib */
{ 0x4017u, -1, 0.005f }, /* 1Ic */
{ 0x4018u, -1, 0.005f }, /* 1I0 */
{ 0x401Du, -1, 0.5f }, /* 1f：Hz 绝对死区（非额定比）→ IV */
};
#define YC_N ((uint8_t)(sizeof(k_yc) / sizeof(k_yc[0])))
App/task/protect_task.c
+80 -18
View File
@@ -8,7 +8,16 @@
* 可忽略；失配 → prot_set 内部闭锁，eval 自动复位全元件）；
* ③ prot_elm_run()（phasor rms → 判据步进）+ 动作位图边沿日志；
* ④ 全局软压板 PS_GLOBAL_EN（104 YK12 两段式投退，B7）：退出 =
* 复位元件 + 停判据（与采样闭锁同构，独立边沿日志）。
* 复位元件 + 停判据（与采样闭锁同构，独立边沿日志）；
* ⑤ 未标定闭锁（「数据可信」卡 5，M4 唯一新增行为变更）：UA/UN/IA
* 的 adc_cal VALID 位未全置位 → 工程量还只是 ADC 引脚电压
* （eng=0），拿去比二次值定值必然错判 → 复位元件 + 本拍不 eval。
* 默认构建（未标定）恒闭锁是**期望行为**：边沿用 DBG_INFO 而非
* [ERR]（未标定是出厂常态、不是故障；每次开机都走这条沿，
* [ERR] 还会误触 @test 禁用标记）；台架旁路只走编译期宏
* DTU_BENCH（「数据可信」§4.3：不进 cfg、不进 104，本仓任何
* 提交目标都不定义它）。判定优先级 = 采样可信在前、标定可用
* 在后（数据都旧了谈不上标定）。
* 定值/元件初始化在 app_main_init（内核前，B5）；本任务只消费。
* 线程约定：prot_elm_run / prot_set_selfcheck 仅本任务上下文（prot_elm.h）；
* 跨上下文复归（104 YK11）经 prot_elm_request_reset 落请求。
@@ -20,6 +29,12 @@
* adc_health 的 stall 位依赖 adcTask 每拍跑 check()，
* 节拍源一停本任务就再没有任何人判"数据新不新"，
* 而相量冻在最后一帧上还会被本任务继续用于判据
* v1.2 2026-10-25 DTU 项目组 卡 5：新增第⑤路「未标定闭锁」（adc_cal_flags
* VALID 口径，docs/任务规划/数据可信.md §4.3）：
* 采样恢复分支内、巡检/压板之前判；边沿 INFO 对
* + SOE_T_CAL_BLOCK/RESUME（不用 [ERR]：未标定是
* 常态非故障，且 @test 禁用 [ERR]）；DTU_BENCH
* 编译期旁路（本仓目标不定义 = 产品恒强制闭锁）
*/
#include "protect_task.h"
@@ -31,6 +46,7 @@
#include "adc_input.h" /* adc_input_stm32_seq()：DMA 完成计数（中断侧写） */
#include "adc_health.h"
#include "adc_cal.h" /* 卡 5：adc_cal_flags() VALID = 未标定闭锁源 */
#include "console_log.h" /* dbg_console_writer_ready()：启动锚点行门控（B6） */
#include "prot_elm.h"
#include "prot_set.h"
@@ -60,6 +76,33 @@ static adc_health_age_t s_age_a1; /* STM32 车道 */
static uint32_t s_prev_active; /* 上拍动作位图（边沿日志用） */
static uint8_t s_prev_hf_lock; /* 上拍采样闭锁态（边沿日志用） */
static uint8_t s_prev_plate_out; /* 上拍全局软压板退出态（边沿日志用，B7） */
static uint8_t s_prev_cal_lock; /* 上拍未标定闭锁态（边沿日志用，卡 5） */
/*
* 函数功能：未标定闭锁判定（「数据可信」卡 5 / §4.3）
* 入口参数：无
* 返 回 值：1 - 闭锁（判据停走）；0 - 放行 uint8_t
* 限定条件：仅本任务上下文（adc_cal_flags 纯读，任意上下文可读）
* 函数说明：判据 = UA/UN/IA 三路 VALID **全**置位——恰好是 V0.1 唯一有效的
* 三个测量通道（N-18）；UB/UC/IB/IC/IN 即使将来标定也另受 CLIPPED
* 品质约束（M5 快照层处理），不掺和进本闭锁源。VALID 随 cfg
* load/poll 与卡 12 标定自动翻转，本函数无自有状态（每拍现查，
* 无陈旧标志位）。台架调试旁路 = 编译期 -DDTU_BENCH（§4.3 决策 1
* 的例外通道，仅本地台架构建自行定义；产品恒强制）。
*/
/* 形态说明：用 #ifndef DTU_BENCH 把"产品默认路径"留在主分支（而非 #ifdef
* 双分支）——cppcheck 对未定义宏取真分支，双分支写法会把它引到旁路分支上
* 报 knownConditionTrueFalse 假信号（实测 2026-10-25）。 */
static uint8_t s_cal_locked(void) {
#ifndef DTU_BENCH
if (((adc_cal_flags(ADC_SEM_UA) & ADC_CAL_F_VALID) == 0u) ||
((adc_cal_flags(ADC_SEM_UN) & ADC_CAL_F_VALID) == 0u) ||
((adc_cal_flags(ADC_SEM_IA) & ADC_CAL_F_VALID) == 0u)) {
return 1u;
}
#endif
return 0u;
}
/*
* 函数功能：动作位图变化沿日志 + SOE 投递（逐变化元件）
@@ -153,29 +196,48 @@ void protect_task(void *argument) {
SOE_ELM_NONE, 0u);
s_prev_hf_lock = 0u;
}
/* L5-1 巡检：定值区与封存校验和不符 → prot_set 闭锁（下一拍起
* eval 自动复位全元件）。B7 收口：104 定值写改走
* prot_set_set_sealed（影子区写+封存后单字交换），selfcheck 另有
* seqlock 式复核（提交撞见 = 本轮跳过），误锁窗口已消除。 */
(void)prot_set_selfcheck();
/* 全局软压板（PS_GLOBAL_EN，104 YK12 两段式投退，B7）：退出 =
* 保护停止判据并复位元件状态（重新投入从干净快照起步） */
if (prot_set_get_ctl(PS_GLOBAL_EN) == 0u) {
if (s_prev_plate_out == 0u) {
DBG_INFO("global plate OUT -> protection disabled");
(void)soe_store_post((uint8_t)SOE_T_PLATE_OUT,
/* 卡 5：未标定闭锁——夹在「采样可信」与「巡检/压板」之间：
* eng=0 域（引脚电压）拿去比二次值定值必然错判（UV 尤甚），
* 标定 VALID 未全置位前整条判据链停走（「数据可信」§4.3 决策 1） */
if (s_cal_locked() != 0u) {
if (s_prev_cal_lock == 0u) {
DBG_INFO("uncalibrated -> protection blocked (UA/UN/IA VALID not all set)");
(void)soe_store_post((uint8_t)SOE_T_CAL_BLOCK,
SOE_ELM_NONE, 0u);
s_prev_plate_out = 1u;
s_prev_cal_lock = 1u;
}
prot_elm_init();
} else {
if (s_prev_plate_out != 0u) {
DBG_INFO("global plate IN -> protection enabled");
(void)soe_store_post((uint8_t)SOE_T_PLATE_IN,
if (s_prev_cal_lock != 0u) {
DBG_INFO("calibration VALID -> protection unlocked");
(void)soe_store_post((uint8_t)SOE_T_CAL_RESUME,
SOE_ELM_NONE, 1u);
s_prev_plate_out = 0u;
s_prev_cal_lock = 0u;
}
/* L5-1 巡检：定值区与封存校验和不符 → prot_set 闭锁（下一拍起
* eval 自动复位全元件）。B7 收口：104 定值写改走
* prot_set_set_sealed（影子区写+封存后单字交换），selfcheck 另有
* seqlock 式复核（提交撞见 = 本轮跳过），误锁窗口已消除。 */
(void)prot_set_selfcheck();
/* 全局软压板（PS_GLOBAL_EN，104 YK12 两段式投退，B7）：退出 =
* 保护停止判据并复位元件状态（重新投入从干净快照起步） */
if (prot_set_get_ctl(PS_GLOBAL_EN) == 0u) {
if (s_prev_plate_out == 0u) {
DBG_INFO("global plate OUT -> protection disabled");
(void)soe_store_post((uint8_t)SOE_T_PLATE_OUT,
SOE_ELM_NONE, 0u);
s_prev_plate_out = 1u;
}
prot_elm_init();
} else {
if (s_prev_plate_out != 0u) {
DBG_INFO("global plate IN -> protection enabled");
(void)soe_store_post((uint8_t)SOE_T_PLATE_IN,
SOE_ELM_NONE, 1u);
s_prev_plate_out = 0u;
}
prot_elm_run(now);
}
prot_elm_run(now);
}
}