wandering1
77779d49d6
UI 面：ui_data 增加深度 4 参数写队列（请求 168 B、队列 .bss 672 B）与状态机 OK/ERR_RANGE/ERR_LOCKED/ERR_BUSY，ui_data_feed 出队后按注入 ops 走「闭锁 → 整批 预检 → 逐项 prot_set_set_sealed」，只提交改动位图；par 帧尾追加 cal_block （口径 = UA/UN/IA 三路 ADC_CAL_F_VALID，与 protect_task 判据同构，不用 rt.eng 反推，V0.1 下 eng 恒 0）、UI_DATA_VER 升到 2。参数/定值/控制字/软压板四叶绑定 内容页（UI_PAGE_MAP_COUNT 12→16，复用四个查看模块，零新增 .c），编辑态按 is_editable 分派，LOCK（写不进去）与「未标定」（仍可改值）两源两通道两词。 记录面：syslog_request_clear/state/apply 三段式删除 API（UI 只发请求，落地在 defaultTask 的 drain 尾部且必须后置，卷锁一律 try，幂等只认 FR_NO_FILE）； 事故/告警/启动/操作/遥控五类各有一个真实写入点，记录类型 = 日志 ID 本身 （一类一个 /log 严格 8.3 文件；64B 定长体没有类型字段位，塞字段会砸掉既有读者）。 为守 protectTask 872 B 静态最坏链另拆 syslog_post_quiet()（无 DBG 的投递核， 丢弃留痕挪到 drain 侧差值补发），syslog_post 对外语义逐字不变。 为什么两道合成一笔而不是各一笔（实测，不是省事）：simulator/main.c 同时消费 两道新增 API（整定 pump 与 logtest 清除用例），按道切文件会让中间提交编不过； RAM 受管快照与体积同码凭证描述的是合并后的 .map，拆开必落在「台账与 .map 不同 码」这条红线上。pre-commit 跑钩子前会 stash 未 staged 部分，这类耦合没法绕。 实测：@build 0 错误 0 警告；Code 228,260 / RO 24,960 / RW 1,440 / ZI 135,976 B； RW_IRAM1 79,992 B = 61.0%、RW_CCM 87.9%（阈值 92%）；九个任务静态最坏链全 PASS， protectTask 872 B / 57% 改前后逐字节不变（记录投递没垫栈）。主机单测 ui_data 82→ 164、sys_log_mcu 106→137、prot_elm 47→60、iec104 141→154、iec104_serv 28→34， 既有断言零删改；48 个钩子 --all-files 全绿；编号门禁可判定 86.34%（基线 86.0%）、 不可判定 1,153 处低于上限 1,166；doc-links 无法判定 0；UI 黄金 18 页扩到 27 页 连跑两次逐字节一致；字库 diff 空。 顺手修掉三处既有缺陷（都是本轮第一个消费者才暴露）：sim_syslog.c 的 s_paths 行宽 16 而 "sim_selftest.log" 正好 16 字符没有 NUL 位（stat/remove 读越过数组尾，此前 靠后面 .rodata 碰巧为 0）；ui_w_setlist 二态行 ENTER 不回绕（控制字与软压板出厂值 全在最后一项，按了像没反应而叠层里已是越界值）；生成物 ui_menu_tab.h 与 gen_menu.py 模板漂移（上一笔改了模板没重跑生成器），现随生成器输出对齐。 未收口（不算完成）：保存后重启值保持与主站 C_RD 读回两条只能上板，台架窗口执行； LOCK 屏显与越界反显的页面侧在模拟器造不出来（模拟器不跑定值自检、无 NAND）， 已由生成侧单测与代码注释点名差距；同类页数与钩子数陈述残留另立待办。
144 lines
7.9 KiB
C
144 lines
7.9 KiB
C
/*
|
||
* 模块名称：保护元件框架（L3，P1 子集）
|
||
* 模块功能：通用"越限 + 返回系数滞回 + 定时限"元件核 + 实例表（数据驱动，
|
||
* 同 phasor 实例表模式）。判据为**纯逻辑**（吃测量值 + 定值），
|
||
* 主机侧可离线单测；出口/SOE（L4）与任务编排为后续。
|
||
*
|
||
* V0.1 有效实例（双转换器无共同采样触发 → 仅 TPAFE 三路）：
|
||
* OC1/OC2/OC3 三段式相间过流（A 相 IA，L3-1）
|
||
* OL 过负荷（A 相 IA，L3-3）
|
||
* OV/UV 过压/欠压（UA，L3-4）
|
||
* 3U0 零序过压（UN 外部零序电压通道，L3-6）
|
||
* OF/UF 过频/低频（测量量 = freq 层测得频率，L3-5，B8 落地）
|
||
*
|
||
* 测量数组口径：相量类实例 = 基波有效值（A/V）；OF/UF = 测得频率（Hz）。
|
||
* run() 按实例表 src 字段取数（0=phasor rms，1=freq）。freq 无有效读数
|
||
* （未启动收敛或幅值门失效）→ 该行按方向填"必不启动"值（过量填 0、
|
||
* 欠量填极大值 → 滞回核比较恒假 → 元件复位不误动），**不整拍跳过**
|
||
* （否则浮空台架会把 OC/UV 等全部饿死，B5 行为回归）。
|
||
*
|
||
* 与参考系统的口径差异（有意简化，均已在规划文档登记）：
|
||
* - 返回门槛 = 定值 × 返回系数（参考经 CN_SET_RET 独立定值，等价）；
|
||
* - 返回**即时**（参考 GRly_TimeRelay 带 10 ms 返回延时——V0.1 无出口硬件，
|
||
* 抖动只影响日志，P4 接出口时再补返回延时）；
|
||
* - 复压/方向/无压无流闭锁（dwSetFyCtrl 类）随 P2/P3 元件扩展；
|
||
* - 测量输入 = adc_task 经 adc_cal_apply() 折算后的工程量（L1.5，卡 2 已落地）：
|
||
* 未标定（VALID=0）时单位只是 ADC 引脚电压——该域下判据必然错配，由
|
||
* protectTask 的未标定闭锁（卡 5）停走整条判据链，元件核本身不掺和
|
||
* 标定语义（保持纯逻辑）；标定后单位 = 二次值，定值口径才名副其实。
|
||
*
|
||
* 线程约定：init 内核启动前或保护消费者任务上下文；eval/run 仅保护消费者任务
|
||
* 上下文（B5 起 = protectTask）；request_reset 任意上下文（跨上下文复归请求，
|
||
* 如 104 遥控 YK11 在 iec104Task 落请求、下一拍 eval 头部消费）。板端接线
|
||
* 走栈预算 + IWDG 心跳门禁。
|
||
*
|
||
* 创建日期：2026-10-11
|
||
*/
|
||
#ifndef PROT_ELM_H
|
||
#define PROT_ELM_H
|
||
|
||
#include <stdint.h>
|
||
|
||
/* 元件实例编号（枚举序 = 实例表序 = 测量数组序；尾追加，编号不回收） */
|
||
typedef enum {
|
||
PE_OC1 = 0, /* 过流 Ⅰ 段（IA） */
|
||
PE_OC2, /* 过流 Ⅱ 段（IA） */
|
||
PE_OC3, /* 过流 Ⅲ 段（IA） */
|
||
PE_OL, /* 过负荷（IA） */
|
||
PE_OV, /* 过压（UA） */
|
||
PE_UV, /* 欠压（UA，欠量方向） */
|
||
PE_3U0, /* 零序过压（UN） */
|
||
PE_OF, /* 过频（测量量 = freq 层测得频率，B8，L3-5） */
|
||
PE_UF, /* 低频（测量量 = freq 层测得频率，欠量方向，B8，L3-5） */
|
||
PE_COUNT
|
||
} prot_elm_id_t;
|
||
|
||
/* 单元件状态快照（读侧拷贝语义，见 prot_elm_state） */
|
||
typedef struct {
|
||
uint8_t enabled; /* 本拍投入（定值投退 && 未闭锁） */
|
||
uint8_t picked; /* 越限启动（滞回后电平） */
|
||
uint8_t asserted; /* 定时限到点（动作） */
|
||
uint32_t pick_ms; /* 本次启动起始时基（0 = 未启动过；asserted 延时观测用） */
|
||
} prot_elm_state_t;
|
||
|
||
/*
|
||
* 函数功能：复位全部元件状态（定值不动；幂等，内核启动前可调）
|
||
* 限定条件：内核启动前，或保护消费者任务上下文（跨上下文请用 request_reset）
|
||
*/
|
||
void prot_elm_init(void);
|
||
|
||
/*
|
||
* 函数功能：登记"复归元件状态"请求（任意上下文安全，单字标志）
|
||
* 函数说明：下一拍 prot_elm_eval() 头部消费并执行 prot_elm_init()。
|
||
* 104 遥控 YK11（iec104Task 上下文）必须走本接口，不得直接调
|
||
* prot_elm_init()（会与 protectTask 的 eval 竞态）。
|
||
*/
|
||
void prot_elm_request_reset(void);
|
||
|
||
/*
|
||
* 函数功能：纯判据步进——按当前定值（prot_set RAM）+ 给定测量值推进所有元件
|
||
* 入口参数：now_ms - 单调时基（tick ms，回绕安全：差值法）
|
||
* meas - PE_COUNT 个测量值（工程量：A / V），NULL 视为全 0
|
||
* 返 回 值：无
|
||
* 限定条件：仅保护消费者任务上下文；调用方保证定值已装载
|
||
* 函数说明：越限方向由实例表决定；投退=0 或定值闭锁（L5-1）→ 状态复位、
|
||
* 不判据。延时判定用 (uint32_t)(int32_t)(now - t0) >= dly，回绕安全。
|
||
*/
|
||
void prot_elm_eval(uint32_t now_ms, const float meas[PE_COUNT]);
|
||
|
||
/*
|
||
* 函数功能：适配层——从 phasor 使用区取 rms 组装测量数组后调 prot_elm_eval
|
||
* 入口参数：now_ms - 同上
|
||
* 说明：phasor 未就绪（-2，未满一周波）的实例本拍按"测量=上一拍值"处理会
|
||
* 引入陈旧判据 → 直接**整拍跳过**（不 eval），与 adc_task 跳拍同口径。
|
||
*/
|
||
void prot_elm_run(uint32_t now_ms);
|
||
|
||
/* 状态快照拷贝（NULL 安全；越界全零） */
|
||
void prot_elm_state(prot_elm_id_t id, prot_elm_state_t *out);
|
||
|
||
/* 动作位图（bit i = 元件 i asserted），供 L4 出口 / 心跳日志 */
|
||
uint32_t prot_elm_active_mask(void);
|
||
|
||
/* 启动位图（bit i = 元件 i picked），供「保护启动」记录边沿（task-10，2026-10-26）：
|
||
* picked 是越限滞回后的电平，早于（或同拍于）asserted——只看 active_mask 会让
|
||
* "启动了但没到点"这一整段在记录里彻底消失，而它正是"保护启动"页要看的东西。 */
|
||
uint32_t prot_elm_pick_mask(void);
|
||
|
||
/*
|
||
* 元件动作边沿的记录归属（task-10「五类记录」）。
|
||
* ⚠ 本枚举刻意**不**用 syslog_id_t：那会把 App/log 的头拽进 algo 层，而
|
||
* App/algo/prot_elm.c 同时被 test/host/prot_dim 编进测试单元（那个运行器的
|
||
* include 路径里没有 App/log，且不在本道写域）→ 一改就在别人的单测上爆错。
|
||
* "元件 → 哪一类"是判据域事实（属主在本文件），"哪一类 → 哪个日志文件"是
|
||
* 记录域映射（属主在 App/task/protect_task.c 的一行三元），两边各自单源。
|
||
*/
|
||
typedef enum {
|
||
PROT_REC_TRIP = 0u, /* 跳闸型动作 → 事故记录 */
|
||
PROT_REC_ALARM, /* 告警型动作 → 保护告警记录 */
|
||
PROT_REC_NONE /* id 越界 → 调用方一条都不许落 */
|
||
} prot_rec_kind_t;
|
||
|
||
/*
|
||
* 函数功能：判定"该元件若发生动作上升沿，应归哪一类记录"
|
||
* 入口参数：id - 元件编号 prot_elm_id_t
|
||
* 返回值：PROT_REC_TRIP / PROT_REC_ALARM / PROT_REC_NONE（越界） prot_rec_kind_t
|
||
* 限定条件：任意上下文（只读 k_pe[] + prot_set RAM，不落任何状态）
|
||
* 函数说明：判据**唯一来源** = 该元件的跳闸投退定值项 g_prot_set_meta 里的
|
||
* PS_*_TRIP（其枚举注释即"0 告警 / 1 跳闸"）。元件→投退项的对应关系
|
||
* 放在实例表 k_pe[] 的 trip_ctl 列（与 en_id/set_id/dly_id 同一张表，
|
||
* 新增元件只加一行）；**本函数里没有第二份"哪些元件算跳闸"的名单**，
|
||
* 所以它不会与 g_prot_set_meta / k_pe[] / 整定视图门禁互相打架。
|
||
* 过压/欠压/零序过压/过频/低频五项本就没有 TRIP 投退项（告警类）→
|
||
* trip_ctl = PROT_ELM_NO_TRIP → 恒 PROT_REC_ALARM，这是照实反映，
|
||
* 不是兜底猜测。
|
||
* 定值巡检闭锁（prot_set_locked）不影响本判定：闭锁态下元件会被复位、
|
||
* 根本走不到动作上升沿，调用方无需在此重复判闭锁。
|
||
*/
|
||
prot_rec_kind_t prot_elm_record_kind(prot_elm_id_t id);
|
||
|
||
/* 实例名（ROM 常量，日志用） */
|
||
const char *prot_elm_name(prot_elm_id_t id);
|
||
|
||
#endif /* PROT_ELM_H */
|