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

feat(ui)+chore(docs): UI 补齐清单清空；数据可信销项与「卡」号清退

Browse Source 
本笔含两组收尾工作（同一工作区内交错在 6 个共享文档/门禁配置里，
拆开会产生"文档声称的页数与树里黄金数不一致"的中间提交，故合为一笔）：

一、UI 补齐（清单清空）
- 新建 6 个内容页模块：ui_page_accident / oper / alarm / start / yk
  复用 ui_w_records 共享组件（分页、空态"无记录"、按实例读盘缓存），
  记录层与五个写入点已由道F task-10 / 道G task-12 落地，本批只补页面；
  ui_page_runreport 为 13 行 2 页只读统计，四个数逐个挂范围标签
  （自电池周期 / 本次开机），boot_ready=0 显 "--" 不显 0。
- 数据面：ui_data_info_t 尾部追加 9 字段，ui_data_feed 用
  boot_stats_get() + iec104_serv_get_stats() 纯搬运；模拟器填确定值假数据
  （差异登记 docs/测试说明/模拟器差距清单.md §2.3 两行）。
- 接线：菜单树 6 叶绑 #page=，绑定叶 22→28、UI_PAGE_MAP_COUNT=28；
  字库 185→218 字 / 280→313 字形；双端注册 uvprojx +30、CMakeLists +6。
- 回归：内容页黄金 53→60（含 runreport_p2 真拍第 2 页），文本断言
  425 正向 / 36 反向；存量 53 张逐字节零漂移；记录 5 页各用独立空目录
  （模拟器把操作留痕写进 cwd 的 sim_oper.log，共用 tmp 会让空态拍不到）。

二、数据可信销项 + 「数据可信」任务卡号整族清退
- 删除已闭环的"已知电压注入验证"行与闭环结论块（证据在
  docs/硬件平台/ADC通道映射说明.md §8.1 与
  docs/测试说明/ADC前端注入验证流程.md §5~§7），§5 标识列改语义短语。
- 卡 0/0b/1~12 共 14 个号全仓 288 站点 / 56 文件清退成语义短语，
  代码注释、测试、门禁配置与文档一并改；换算表入 docs/编号规范.md §9.3。
  这一族是中文前缀，不进 check_ids 语料，刻意不入 id_aliases.json。

验证（实测）
- @build 0 错 0 警：Code=236456 RO=28124 RW=1876 ZI=137084；
  RAM +464 B（RW +304 / ZI +160），RW_IRAM1 62.2% / RW_CCM 87.9%，
  体积同码凭证与 RAM 台账已回填。
- check_menu_rows 8 状态 rc=0（池 5368/5448 常量未动）；
  check_content_pages 60 页 rc=0；check_font_charset / registration /
  coding-standard / bom-drift / mojibake / doc-links --all / layer-deps /
  nested-comment 全 rc=0；check_ids --strict 无错误；主机单测
  ui_data 295 / boot_stats 21 / sys_log_mcu 141 / soe 32 / soe_store 27。

未做（不是遗漏）
- 六页真机判据（真记录翻页、掉电保持、清除后归零、boot_count 自增、
  拔 RTC 电池落 RESTARTED、IWDG 复位落 rst_cause、主站连一次 conn_up+1）
  已登记 docs/任务规划/登记簿.md §7；模拟器结构上照不到。
- docs/产品需求/产品需求设计文档.md 属另一条在飞改动，本笔不含；
  其中我已同步 6 处现状数字（28 叶 / 60 页 / 218 字），随该笔入库。
This commit is contained in:
Wanderingss
2026-10-28 07:23:16 +08:00
parent 8f7c141a0b
commit 94b0d79026
113 changed files with 1934 additions and 615 deletions
Download Patch File Download Diff File Expand all files Collapse all files
App/algo/README.md
+11 -11
View File
@@ -11,8 +11,8 @@
|---|---|---|---|---|
| `adc_input.h` / `.c` | L1 | 统一语义取数：两片转换器的码值按语义（`UA…IN` / 温度）暴露，并消费 STM32 ADC1 的 DMA 乒乓缓冲 | `adc_input_init()` `adc_input_poll()` `adc_input_raw()` | TPAFE 快照消费 / STM32 ADC1 启动与扫描 / 通道语义映射 |
| `adc_health.h` / `.c` | L1 | 采样有效性判定：吃计数快照，产出静默 / 丢帧 / 单调性 / 错误增量故障位（判定与告警编排分离）；「采样通道自检」残余的码值贴轨观察器同层 | `adc_health_check()` `adc_health_flags()` `adc_health_rail_watch()` | 「采样有效性校验」/「采样通道自检」（残余） |
| `adc_cal.h` / `.c` | L1.5 | 通道标定折算（「数据可信」卡 2/卡 4）：工程量 =(code+b)×k，Q16 系数/零点两段落盘 + 三态 flags + 合法带哨兵 + 两点公式 | `adc_cal_apply()` `adc_cal_flags()` `adc_cal_set()` | 「通道标定（一次系数 + 零漂）」（M4 半边） |
| `meas.h` / `.c` | L2 发布 | 遥测快照（「数据可信」卡 8，M5 地基）：200 ms 基波有效值 + 品质快照，双区无锁读，全仓唯一发布者 = adcTask | `meas_tick()` `meas_get()` `meas_seq()` | M5（卡 9/11 与 UI 是读者） |
| `adc_cal.h` / `.c` | L1.5 | 通道标定折算（「数据可信」标定折算与落盘整定）：工程量 =(code+b)×k，Q16 系数/零点两段落盘 + 三态 flags + 合法带哨兵 + 两点公式 | `adc_cal_apply()` `adc_cal_flags()` `adc_cal_set()` | 「通道标定（一次系数 + 零漂）」（M4 半边） |
| `meas.h` / `.c` | L2 发布 | 遥测快照（「数据可信」遥测快照发布，M5 地基）：200 ms 基波有效值 + 品质快照，双区无锁读，全仓唯一发布者 = adcTask | `meas_tick()` `meas_get()` `meas_seq()` | M5（104 改读快照与频率点绑定、UI 是读者） |
| `sample_ring.h` / `.c` | L2 输入 | 按语义通道存最近 2 周波（40 点），供相量层"以当前时刻为终止"取窗 | `sample_ring_push_frame()` `sample_ring_window()` | L2 输入（为「每 1 ms 滑动窗刷新」供数） |
| `phasor.h` / `.c` | L2 | 全周傅氏：一周波 20 点 DFT → 基波 / 谐波相量（有效值口径），双区原子切换供无锁读 | `phasor_run()` `phasor_get()` `phasor_calc()` | 全周傅氏系数表 / 基波相量实例 / 相量有效值输出 / 每 1 ms 滑动窗刷新 / 双区指针原子交换 |
| `freq.h` / `.c` | L2 派生量 | 频率测量：相邻两拍基波相量共轭乘积取角 + 自适应窗滑动平均 + 假值钳制 + 幅值门（UA→IA 源回退） | `freq_run()` `freq_get()` `freq_valid()` | 「过频 / 低频」测量侧（测频范围 → `docs/算法/继电保护功能复现规划.md` §4.2） |
@@ -35,7 +35,7 @@
`adc_input_poll()` → `adc_input_raw()` ×9 → `adc_cal_apply()` ×9（L1.5 折算，现口径 =
ADC 引脚电压 V）+ `adc_health_rail_watch()` ×9（「采样通道自检」，码值域）→ `sample_ring_push_frame()`
→ `phasor_run()` → `freq_run()` → 消费者（`adcTask` 心跳与 L1 健康判定；`protectTask` 每 20 ms 取相量 / 频率跑
`prot_elm_run()`；**每 200 ms** `meas_tick()` 发布遥测快照供 iec104Task / uiTask 读，卡 8）。节拍 = TIM3 1 kHz 更新事件，两片转换器同源触发。
`prot_elm_run()`；**每 200 ms** `meas_tick()` 发布遥测快照供 iec104Task / uiTask 读，即「数据可信」遥测快照发布）。节拍 = TIM3 1 kHz 更新事件，两片转换器同源触发。
完整数据流图与初始化落点 → `docs/算法/采集与算法层设计说明.md` §2。
## 3. 逐文件要点（只留"改代码时必须知道"的；机制与理由见设计文档）
@@ -90,29 +90,29 @@ ADC 引脚电压 V）+ `adc_health_rail_watch()` ×9（「采样通道自检」
- 源切换即废相位基准重建（UA / IA 无共同相位基准，即双转换器无共同采样触发）。
- 判据 **J1~J6** 与实测口径 → `docs/算法/采集与算法层设计说明.md` §7.2（与 `test/host/freq/freq_test.c` 文件头同源）。
### 3.8 `adc_cal.c` / `.h` — L1.5 通道标定折算（「数据可信」卡 2 / 卡 4）
### 3.8 `adc_cal.c` / `.h` — L1.5 通道标定折算（「数据可信」标定折算与落盘整定）
- 折算模型：工程量 = (code + b) × k；**k 落盘用 int32 Q16（µV/码 × 65536）**、b 用
int32 码值（负零点靠 `CFG_VAL_INT`）——单位与定点格式的选型依据见
`docs/任务规划/数据可信.md` §4.1，勿改回 V/码 直存（Q16 只剩 20 个刻度）。
- **ROM 默认 = 卡 1 定死的引脚侧 LSB**（TPAFE 152.59 / STM32 805.66 µV/码，
- **ROM 默认 = 量程口径冻结定死的引脚侧 LSB**（TPAFE 152.59 / STM32 805.66 µV/码，
`docs/硬件平台/ADC通道映射说明.md` §7.1）；表下标 = 语义枚举（UA0…IN7），
V0.2 改版与本目录 `adc_input` 映射表同步改。
- 三态可用性 `adc_cal_flags()`：VALID（已按变比标定，二次值成立——卡 0b/12 前恒 0）
- 三态可用性 `adc_cal_flags()`：VALID（已按变比标定，二次值成立——端子变比确认与两点标定前恒 0）
/ CLIPPED（运行期按来源派生，V0.2 后自动清零）。**消费者判「能不能信」只许查它**，
`adc_cal_apply()` 不返回可用性（「数据可信」§8 风险表）。
- 合法带哨兵：k ∉ ROM×[0.5,2.0] 或 |b| > 8192 → 折算回退 ROM + 每通道每开机一条
`[ERR]` + VALID 被压制（**即便文件位图说已标定**）；这层兜底同时挡坏文件与坏标定。
- `adc_cal_set()` / `adc_cal_two_point()`：整定与两点公式的算术核已齐备（单测还原合成
k/b）；**台架两点标定（卡 12）待实测**，本层不含注入。
k/b）；**台架两点标定待实测**，本层不含注入。
- cfg 两段 `[adc_cal]` / `[adc_cal_ofs]` **不挂回调**（RAM 副本即生效值，引擎 load/poll
原地改写，逐点现读）；注册在 `app_main_init()` 内核前完成，必须先于 `cfg_file_load`。
### 3.9 `meas.c` / `.h` — 遥测快照发布（L2 发布侧，「数据可信」卡 8）
### 3.9 `meas.c` / `.h` — 遥测快照发布（L2 发布侧，「数据可信」波次）
- **唯一发布者 = adcTask**：`phasor_run()`/`freq_run()` 同拍、200 ms **tick 经过**分频
调 `meas_tick()`（非拍计数——idle/skip 拍拉长名义节拍）。docs/任务规划/数据可信.md §8
风险表"快照双写"行 = 评审判据：全仓 `meas_tick` 调用点数须为 1；iec104Task /
uiTask 只读。
- 值口径（批 2 卡 8 A-lite 裁决）：**基波有效值瞬时透传**，与 phasor 使用区
- 值口径（批 2「遥测快照发布」的 A-lite 裁决）：**基波有效值瞬时透传**，与 phasor 使用区
**同拍同核逐位相等**（单测钉死）；**不做** 4 点平均 / 谐波方和根——按
docs/任务规划/数据可信.md §4.5"上送节拍非平均窗，再平均引入滞后"；谐波 k-bin 轨
（docs/算法/继电保护功能复现规划.md 「遥测谐波轨（可选）」）扩展只许结构尾部追加，
@@ -122,7 +122,7 @@ ADC 引脚电压 V）+ `adc_health_rail_watch()` ×9（「采样通道自检」
三态表；由 adc_task 编排注入，本层不链 `adc_cal`）；TEMP = 最新一拍原始值透传 +
`NT`（「数据可信」决策 5）；`MEAS_QDS_*` 低字节与 104 QDS 线上字节同值
（本层**不** include 协议层头——分层方向）。
- 104 死区迁移 / 频率点绑定 = 卡 9/卡 11（道D 后续分支）；读数与注入源比对 = **待台架实测**。
- 104 死区迁移 / 频率点绑定 = 104 改读快照那一波（道D 后续分支）；读数与注入源比对 = **待台架实测**。
## 4. 构建与测试
@@ -151,7 +151,7 @@ ADC 引脚电压 V）+ `adc_health_rail_watch()` ×9（「采样通道自检」
`@build` 0 错误 0 警告 → `@test` 看 `[ADC_TASK]` 首拍 / 心跳（`phasor(...)`、`freq(...)`、
`cal: ua_mv=… vl=0x00 cl=0xE6 rail=…`、`ring` / `skip` / `adc1_*` / `tgap`）；
健康判据 = **零 `[ERR]`**（健康告警与标定哨兵全以 `[ERR]` 开头，误报会被闭环直接抓住；
`vl` 在未标定默认构建必须为 0x00，卡 5 闭锁落地后 `cal:` 行就是台架期望的直接证据）。
`vl` 在未标定默认构建必须为 0x00，未标定即闭锁落地后 `cal:` 行就是台架期望的直接证据）。
→ `docs/算法/采集与算法层设计说明.md` §12。
## 5. 新增一个算法模块的固定动作
App/algo/adc_cal.c
+10 -10
View File
@@ -3,7 +3,7 @@
* 模块功能：见 adc_cal.h。折算模型（工程量 = (code + b) × k × 1e-6，k 为 Q16
* µV/码）与两段 cfg 布局（[adc_cal]：k_* + valid 位图；[adc_cal_ofs]：
* b_*）照 docs/任务规划/数据可信.md §4.1 / §4.4 落地；系数口径
* （ROM 默认 = 卡 1 定死的引脚侧 LSB）见 docs/硬件平台/ADC通道映射说明.md
* （ROM 默认 = 量程口径冻结定死的引脚侧 LSB）见 docs/硬件平台/ADC通道映射说明.md
* §7.1。
* 并发契约：cfg RAM 副本属主 = 配置引擎（defaultTask 的 load/poll 原地
* 改写），本层逐点折算现读——int32 对齐字在 Cortex-M4 上读写原子，
@@ -15,10 +15,10 @@
* VALID，每通道每次开机首见沿打一条 [ERR]（adc_cal_init 重置留痕）。
* 适用平台：STM32F407ZGTx（Cortex-M4F，硬件 FPU）
* 作者：DTU 项目组
* 创建日期：2026-10-25（道A 卡 2/卡 4）
* 创建日期：2026-10-25（道A 标定折算与落盘整定）
* 修改记录：
* v1.0 2026-10-25 DTU 项目组 创建：Q16 系数/零点两段落盘 + 折算 + 三态 flags
* v1.1 2026-10-25 DTU 项目组 卡 10（道D）：新增 adc_cal_b_codes() 生效零点
* v1.1 2026-10-25 DTU 项目组 运行参数段（道D）：新增 adc_cal_b_codes() 生效零点
* 读取口；set() 授权写者扩至 iec104Task 直通路径
* （run_par 0x8040~/0x8048~，契约同 §4.4）
* + 合法带哨兵回退 + 两点标定公式（台架注入待跑）
@@ -61,7 +61,7 @@ typedef struct {
uint8_t valid;
} adc_cal_kcfg_t;
/* [adc_cal_ofs] 段 RAM 副本：b 按语义下标 0..7（int32 有符号，卡 3 的
/* [adc_cal_ofs] 段 RAM 副本：b 按语义下标 0..7（int32 有符号，有符号零点类型
* CFG_VAL_INT 是负零点偏移能干净落盘的前提） */
typedef struct {
int32_t b[8];
@@ -70,12 +70,12 @@ typedef struct {
static adc_cal_kcfg_t s_kcfg; /* 生效系数副本（引擎原地更新） */
static adc_cal_bcfg_t s_bcfg; /* 生效零点副本 */
/* 工厂默认（ROM 理论系数，卡 1 定死，「数据可信」§4.4）：**下标 = 语义枚举**
/* 工厂默认（ROM 理论系数，量程口径冻结定死，「数据可信」§4.4）：**下标 = 语义枚举**
* （UA0 / UB1 / UC2 / UN3 / IA4 / IB5 / IC6 / IN7）——UA/UN/IA 走 TPAFE
* （16 位 ±5 V 档），UB/UC/IB/IC/IN 走 STM32 ADC1；逐路对过
* docs/硬件平台/ADC通道映射说明.md §3（IN=ADC11/STM32，勿再按分组顺序误写）。
* ROM 表按**当前 V0.1 来源排布**显式书写（不查 desc 运行期派生），因为它是
* 卡 1 定稿的存档事实；V0.2 改版（消除双转换器无共同采样触发）时本表与 adc_input 映射表同步改，
* 量程口径冻结定稿的存档事实；V0.2 改版（消除双转换器无共同采样触发）时本表与 adc_input 映射表同步改，
* 上层语义与 API 不动。CLIPPED 位则**运行期按来源派生**（见 adc_cal_flags） */
static const adc_cal_kcfg_t s_kcfg_rom = {
/* idx0 UA / idx1 UB / idx2 UC / idx3 UN */
@@ -341,7 +341,7 @@ float adc_cal_k_uv(adc_semantic_t sem) {
* 入口参数：sem - 语义通道 adc_semantic_t
* 返 回 值：b[码值]（越带时 s_eff_kb 已回 0）；TEMP/越界返 0 float
* 限定条件：无（任意上下文，纯读）
* 函数说明：卡 10 的 104 b 覆盖回显 + k 单侧改写 RMW 读侧（App/algo/run_par.c）
* 函数说明：运行参数段的 104 b 覆盖回显 + k 单侧改写 RMW 读侧（App/algo/run_par.c）
*/
float adc_cal_b_codes(adc_semantic_t sem) {
int32_t k;
@@ -355,11 +355,11 @@ float adc_cal_b_codes(adc_semantic_t sem) {
}
/*
* 函数功能：整定入口——写通道系数与零点，并置位 VALID（「数据可信」卡 4）
* 函数功能：整定入口——写通道系数与零点，并置位 VALID（「数据可信」标定落盘与整定入口）
* 入口参数：sem - 语义通道；k_q16 - 系数（µV/码×65536）；b_codes - 零点（码值）
* 返 回 值：0 - 成功；-1 - 参数非法/越出合法带（RAM 不动，[ERR] 留痕） int
* 限定条件：整定路径上下文（defaultTask 整定/标定链；iec104Task 经 run_par
* 直通为卡 10 授权写者，单字原子契约同 §4.4）；落盘由属主经 cfg_file_save
* 直通为运行参数段授权写者，单字原子契约同 §4.4）；落盘由属主经 cfg_file_save
* 函数说明：见 adc_cal.h 同名声明
*/
int adc_cal_set(adc_semantic_t sem, int32_t k_q16, int32_t b_codes) {
@@ -408,7 +408,7 @@ void adc_cal_note_persisted(void) {
}
/*
* 函数功能：两点标定公式（卡 12 的算术核，纯函数无状态）
* 函数功能：两点标定公式（标定项的算术核，纯函数无状态）
* 入口参数：c_lo/c_hi、v_lo_uv/v_hi_uv、p_k_q16/p_b 见 adc_cal.h 同名声明
* 返 回 值：0 成功 / -1 参数或斜率非法 / -2 零点越 ±B_MAX int
* 限定条件：无（int64 中间量，主机可测；台架注入待跑）
App/algo/adc_cal.h
+17 -17
View File
@@ -1,5 +1,5 @@
/*
* 模块名称：通道标定与量纲折算（L1.5，「数据可信」卡 2/卡 4）
* 模块名称：通道标定与量纲折算（L1.5，「数据可信」标定折算与落盘整定）
* 模块功能：把 adc_input 的原始码值折算成工程量——模型与系数口径的唯一落点：
* 工程量 = (code + b) × k_f，k_f = k[µV/码] × 1e-6
* k 以 int32 **Q16**（µV/码 × 65536）落盘、b 以 int32 码值落盘，
@@ -8,14 +8,14 @@
* 即生效值，逐点折算现取现用（1 kHz × 9 通道 = 9k 次/秒浮点乘，可忽略）。
* 三态可用性：ADC_CAL_F_VALID（已按变比标定 → 工程量为二次值）与
* ADC_CAL_F_CLIPPED（V0.1 硬件削顶）由 adc_cal_flags() 单点查询，
* 104 / UI / 保护闭锁（卡 5）共用（docs/任务规划/数据可信.md §4.2）。
* 104 / UI / 保护闭锁（未标定即闭锁）共用（docs/任务规划/数据可信.md §4.2）。
* **未标定闭锁的判定本身也归本层**（`adc_cal_prot_blocked()`）：它讲的是
* 「这几路标定齐了没」，属标定层事实，不是任务编排逻辑——保护任务与 UI
* 组装器都只是它的消费者（道F task-16 把此前的两份实现收成一份）。
* ⚠ 输出单位口径 = **ADC 引脚电压 V**（eng=0）：ROM 默认系数按卡 1
* ⚠ 输出单位口径 = **ADC 引脚电压 V**（eng=0）：ROM 默认系数按量程口径冻结
* 定死的引脚侧 LSB（TPAFE 152.59 µV/码、STM32 805.66 µV/码，见
* docs/硬件平台/ADC通道映射说明.md §7.1）；端子变比（卡 0b）与两点
* 标定（卡 12）完成前不得把输出当二次值消费。TEMP 不参与线性标定
* docs/硬件平台/ADC通道映射说明.md §7.1）；端子/子板变比确认与两点
* 标定完成前不得把输出当二次值消费。TEMP 不参与线性标定
* （决策 5），adc_cal_apply() 原样透传码值。
* 本层**纯算法 + 纯数据**：不碰寄存器、不等事件；adc_cal_init() 内核前
* 可调（注册进引擎必须先于 cfg_file_load，FTP 鉴权确立的契约）；apply/flags
@@ -23,10 +23,10 @@
* 与 defaultTask 的 load/poll 复位存在 µs 级混窗——设计接受，见 .c 头）。
* 适用平台：STM32F407ZGTx（Cortex-M4F）；主机侧 L0.5 单测 test/host/adc_cal/
* 作者：DTU 项目组
* 创建日期：2026-10-25（道A 卡 2/卡 4）
* 创建日期：2026-10-25（道A 标定折算与落盘整定）
* 修改记录：
* v1.0 2026-10-25 DTU 项目组 创建：Q16 系数/零点 + 折算/flags/集
* v1.1 2026-10-25 DTU 项目组 卡 10：+adc_cal_b_codes()（run_par 回显/RMW 用）
* v1.1 2026-10-25 DTU 项目组 运行参数段：+adc_cal_b_codes()（run_par 回显/RMW 用）
* v1.2 2026-10-26 DTU 项目组 道F task-16：+adc_cal_prot_blocked()——「UA/UN/IA
* 三路 VALID 是否齐」这份判据停走条件从
* protect_task.c 与 ui_data_feed.c 的两份重复实现收成本层
@@ -45,11 +45,11 @@ extern "C" {
#endif
/* 通道可用性标志（adc_cal_flags() 返回值位） */
#define ADC_CAL_F_VALID (0x01u) /* k 已按变比标定 → 工程量为二次值（卡 12 后置位） */
#define ADC_CAL_F_VALID (0x01u) /* k 已按变比标定 → 工程量为二次值（两点标定后置位） */
#define ADC_CAL_F_CLIPPED (0x02u) /* 硬件削顶（V0.1 STM32 侧单极性无偏置）→ 交流量不可信 */
/*
* ROM 默认系数（int32 Q16 = µV/码 × 65536，卡 1 定死的引脚侧口径）：
* ROM 默认系数（int32 Q16 = µV/码 × 65536，量程口径冻结定死的引脚侧口径）：
* TPAFE ±5 V 档：10 V 跨度 / 65536 码 = 152.587890625 µV/码 → ×65536 = 10,000,000（整）
* STM32 0~3.3 V：3.3 V / 4096 码 = 805.6640625 µV/码 → ×65536 = 52,800,000（整）
* 两个默认值在 Q16 下**无舍入**（系数定点舍入项从误差预算里抹掉，
@@ -99,7 +99,7 @@ float adc_cal_apply(adc_semantic_t sem, int32_t code);
uint32_t adc_cal_flags(adc_semantic_t sem);
/*
* 函数功能：**未标定闭锁判定**——保护判据所需的三路标定是否齐（「数据可信」卡 5
* 函数功能：**未标定闭锁判定**——保护判据所需的三路标定是否齐（「数据可信」未标定即闭锁
* / §4.3；道F task-16 把它从两处重复实现收敛成这一份真源）
* 入口参数：无
* 返 回 值：1 - 闭锁（UA/UN/IA 中至少一路 `ADC_CAL_F_VALID` 未置位，判据链应停走）；
@@ -144,18 +144,18 @@ float adc_cal_k_uv(adc_semantic_t sem);
* 入口参数：sem - 语义通道 adc_semantic_t
* 返 回 值：b[码值]（越带时为 0，与折算同视图）；TEMP/越界返 0 float
* 限定条件：无
* 函数说明：104 运行参数段（「数据可信」卡 10）b 覆盖回显与 k 单侧改写的 RMW
* 函数说明：104 运行参数段（「数据可信」这一项）b 覆盖回显与 k 单侧改写的 RMW
* 读侧用（App/algo/run_par.c）；勿据其反推二次值（看 flags）。
*/
float adc_cal_b_codes(adc_semantic_t sem);
/*
* 函数功能：整定入口——写通道系数与零点，并置位 VALID（「数据可信」卡 4）
* 函数功能：整定入口——写通道系数与零点，并置位 VALID（「数据可信」标定落盘与整定入口）
* 入口参数：sem - 语义通道（电气 8 路） adc_semantic_t
* k_q16 - 系数，µV/码 × 65536 内 int32_t
* b_codes - 零点偏移，码值 内 int32_t
* 返 回 值：0 - 成功；-1 - 参数非法/越出合法带（RAM 不动，[ERR] 留痕） int
* 限定条件：**整定路径上下文**（defaultTask 标定流程/整定链；卡 10 起 iec104Task
* 限定条件：**整定路径上下文**（defaultTask 标定流程/整定链；运行参数段落地起 iec104Task
* 经 App/algo/run_par.c 的 0x8040~/0x8048~ 直通写亦为授权写者——写的仍是
* 引擎对齐 int32 单字，µs 级混窗契约同「数据可信」§4.4）。勿在 adcTask 调用
* 函数说明：**只写 RAM 副本，不置脏、不落盘、不返回"稍后会存"的承诺**——落盘由属主经
@@ -167,7 +167,7 @@ float adc_cal_b_codes(adc_semantic_t sem);
int adc_cal_set(adc_semantic_t sem, int32_t k_q16, int32_t b_codes);
/*
* 函数功能：两点标定公式（「数据可信」卡 12 的算术核，纯函数无状态）
* 函数功能：两点标定公式（「数据可信」标定项的算术核，纯函数无状态）
* 入口参数：c_lo/c_hi - 两点码值（c_hi > c_lo） int32_t
* v_lo_uv/v_hi_uv - 两点实测电压（µV，v_hi > v_lo，端子/引脚域均可） int32_t
* p_k_q16 / p_b - 输出：系数（Q16）与零点偏移（码值） int32_t *
@@ -210,7 +210,7 @@ int adc_cal_rail_ths(adc_semantic_t sem, int32_t *p_lo_th, int32_t *p_hi_th);
* 0 0 盘与 RAM 齐（或压根没改过）——健康
* >0 1 改了、还没到落盘时机——正常在途
* >0 0 **改了且永远不会落盘**：写者绕过 run_par 的语义
* setter 直调 adc_cal_set()（本卡起的事）
* setter 直调 adc_cal_set()（运行参数段起的事）
*
* 消费者告诫（与 vol_lock_get_stats() 同一套，别重犯）：
* ① 本组接口不取锁、不取时刻，任意上下文可读；三个数各自是 uint32 单字读写，
@@ -220,10 +220,10 @@ int adc_cal_rail_ths(adc_semantic_t sem, int32_t *p_lo_th, int32_t *p_hi_th);
* 本层不存时刻——存了就得连带管溢出与单位。
* ③ 这些计数**不参与任何判定**：能不能信只看 adc_cal_flags() /
* adc_cal_prot_blocked()，要不要落盘只看 run_par 的脏标志。别拿差额去改控制流，
* 那等于把观测升级成第二真源（本卡第①项已由 run_par 语义 setter 收口，不再加口）。
* 那等于把观测升级成第二真源（标定写入口已由 run_par 语义 setter 收口，不再加口）。
* ④ 写清盲区：本层刻意**不挂** cfg_file 回调，因此"盘 → RAM 的覆盖"（cfg_file_load
* 与外部变更重载）不产生任何计数；未落盘的改值被一次重载无声吞掉，正是这三个
* 数照不到的那一条。要照它得先给本层挂回调 = 行为改动，另卡处置。
* 数照不到的那一条。要照它得先给本层挂回调 = 行为改动，另行立项处置。
*/
typedef struct {
uint32_t set_ok; /* 成功改写 RAM 副本次数（见上方唯一落点） */
App/algo/adc_health.h
+1 -1
View File
@@ -206,7 +206,7 @@ uint32_t adc_health_rail_watch(uint8_t ch, int32_t code, int32_t lo_th, int32_t
* 入口参数：无
* 返 回 值：bit ch = 该通道曾检出贴轨（1 kHz × 9 路 → 低 9 位有效） uint32_t
* 限定条件：无
* 函数说明：供心跳日志 / 后续品质位映射（卡 8/9 的 qds 消费者）只读。
* 函数说明：供心跳日志 / 后续品质位映射（遥测快照发布与 104 消费的 qds 消费者）只读。
*/
uint32_t adc_health_rail_sticky(void);
App/algo/freq.h
+4 -4
View File
@@ -50,14 +50,14 @@
#define FREQ_INST_MIN_HZ 35.0f
#define FREQ_INST_MAX_HZ 65.0f
/* 幅值门限（有效值，**二次值 V 口径**，「数据可信」卡 6 重定，依据其 §2.3 表第 1 行）：
/* 幅值门限（有效值，**二次值 V 口径**，「数据可信」下游常数按工程量重定的结果，依据其 §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
* 未标定闭锁同向（判据链本就停走），不构成额外风险；标定后自动恢复本意。
* ⚠ 过渡期行为（eng=0，两点标定完成前）：帧值还是引脚电压（≤5 V < 50 V），
* 本门**恒失效** → freq_valid()=0 → OF/UF 按"必不启动"填充复位——与未标定即闭锁
* 同向（判据链本就停走），不构成额外风险；标定后自动恢复本意。
* 数值沿用原 50.0f 属巧合（原为"远小于千级码值"的拟定值），不是漏改。 */
#define FREQ_AMP_MIN 50.0f
App/algo/meas.c
+2 -2
View File
@@ -1,5 +1,5 @@
/*
* 模块名称：遥测快照发布层（L2 派生·发布侧，「数据可信」卡 8）
* 模块名称：遥测快照发布层（L2 派生·发布侧，「数据可信」§4.5）
* 模块功能：实现见 meas.h——200 ms 基波有效值 + 品质快照，双区无锁读。
* 本文件纯算法：输入 = sample_ring 取窗 + 调用方注入（频率/削顶位图），
* 无 RTOS / 无寄存器 / 无日志（「数据可信」层内禁令：本目录不写日志）。
@@ -11,7 +11,7 @@
* 单核顺序执行，无需内存屏障；volatile 阻编译器把字段写入挪到翻转后。
* 适用平台：STM32F407ZGTx（Cortex-M4F，硬件 FPU）
* 作者：DTU 项目组
* 创建日期：2026-10-25（道D 卡 8）
* 创建日期：2026-10-25（道D 遥测快照发布）
* 修改记录：
* v1.0 2026-10-25 DTU 项目组 创建：200 ms 遥测快照 + 双区无锁读
*/
App/algo/meas.h
+9 -9
View File
@@ -1,11 +1,11 @@
/*
* 模块名称：遥测快照发布层（L2 派生·发布侧，「数据可信」卡 8）
* 模块名称：遥测快照发布层（L2 派生·发布侧，「数据可信」§4.5）
* 模块功能：每 **200 ms** 从 L2 层取一次基波有效值 + 品质，产出一份全仓唯一的
* 遥测快照（meas_snap_t，布局权威 = docs/任务规划/数据可信.md §4.5），
* 让 104 与 UI **共用同一份上游**——"什么时候算新值、品质怎么判"只此
* 一处决定（M5 遥测链的地基；104 改读快照属卡 9，UI 侧 ui_data_feed 属
* 一处决定（M5 遥测链的地基；104 侧消费见「数据可信」104 改读快照，UI 侧 ui_data_feed 属
* 「UI 扩展」波次，两者都只是本快照的读者）。
* 值口径（批 2 卡 8 的 A-lite 裁决，2026-10-25）：**基波有效值瞬时透传**
* 值口径（批 2「遥测快照发布」的 A-lite 裁决，2026-10-25）：**基波有效值瞬时透传**
* （同拍 phasor 使用区口径，系数已在 L1.5 折算进帧值——现单位 = ADC
* 引脚电压 V，二次值语义等 adc_cal_flags() 出 VALID，见
* docs/算法/采集与算法层设计说明.md §10 红线③）；**不做** 4 点平均 /
@@ -28,7 +28,7 @@
* §8 风险表"快照双写"行）；其余任务/模块**只读**。
* 适用平台：STM32F407ZGTx（Cortex-M4F，硬件 FPU）
* 作者：DTU 项目组
* 创建日期：2026-10-25（道D 卡 8）
* 创建日期：2026-10-25（道D 遥测快照发布）
* 修改记录：
* v1.0 2026-10-25 DTU 项目组 创建：200 ms 遥测快照 + 双区无锁读
*/
@@ -51,19 +51,19 @@ extern "C" {
/* 每点品质位（uint16）。**低字节与线上 104 QDS 字节同值**（OV/NT/IV，数值
* 口径同 App/protocol/iec104/iec104_asdu.h 的 IEC104_QDS_*）——但本层**不得**
* include 协议层头（分层方向：算法层在协议层之下，反向依赖禁止），故在此自
* 定义同值常量；卡 9 的 104 侧消费直接截低字节上送，一致性由本目录单测与
* 定义同值常量；104 侧消费（104 改读快照）直接截低字节上送，一致性由本目录单测与
* test/host/iec104/ 既有断言双向钉住。高字节为 meas 域扩展位（线上不直接
* 出现，由消费者映射）： */
#define MEAS_QDS_OV (0x0001u) /* 溢出（留位，卡 8 不产出——判据待运行参数化） */
#define MEAS_QDS_OV (0x0001u) /* 溢出（留位，本项不产出——判据待运行参数化） */
#define MEAS_QDS_NT (0x0020u) /* 非当前值：未就绪 / 语义未处理（TEMP） */
#define MEAS_QDS_IV (0x0080u) /* 无效：该路取窗失败，无有效读数 */
#define MEAS_QDS_CLIPPED (0x0100u) /* 硬件削顶（adc_cal_flags 位图直通，
* 「数据可信」§4.2 三态表；AC 量不可信，
* 消费者应映射为品质无效，如卡 9 的 104 IV） */
* 消费者应映射为品质无效，如 104 改读快照侧的 IV） */
/* 遥测快照（docs/任务规划/数据可信.md §4.5 权威布局；实测 72 B，2×72 ≈ 144 B
* 双区 = 卡 8 DoD 预算口径，由 test/host/meas/ 的布局钉死用例锁字段偏移——
* 改字段 = 破协议，须同步卡 9 / UI） */
* 双区 = 本项 DoD 预算口径，由 test/host/meas/ 的布局钉死用例锁字段偏移——
* 改字段 = 破协议，须同步 104 改读快照 / UI） */
typedef struct {
uint32_t seq; /* 只增；消费者据此判断是否换帧 */
uint32_t tick_ms; /* 发布拍时基（osKernelGetTickCount 原值） */
App/algo/prot_elm.c
+1 -1
View File
@@ -205,7 +205,7 @@ void prot_elm_eval(uint32_t now_ms, const float meas[PE_COUNT]) {
* 入口参数：now_ms - 单调时基（tick ms）
* 返 回 值：无
* 限定条件：仅保护消费者任务上下文；测量已是 L1.5 工程量（未标定域由
* protectTask 卡 5 闭锁挡在门外，本函数不感知标定态）
* protectTask 未标定即闭锁挡在门外，本函数不感知标定态）
* 函数说明：src=PHASOR 行任一相量未就绪（未满一周波）→ **整拍跳过**，
* 不引入陈旧/半新测量（B5 口径）。src=FREQ 行：freq 有有效读数
* （started 且幅值门 OK）→ 填测得频率；否则按方向填"必不启动"值
App/algo/prot_elm.h
+2 -2
View File
@@ -23,9 +23,9 @@
* - 返回**即时**（参考 GRly_TimeRelay 带 10 ms 返回延时——V0.1 无出口硬件，
* 抖动只影响日志，P4 接出口时再补返回延时）；
* - 复压/方向/无压无流闭锁（dwSetFyCtrl 类）随 P2/P3 元件扩展；
* - 测量输入 = adc_task 经 adc_cal_apply() 折算后的工程量（L1.5，卡 2 已落地）：
* - 测量输入 = adc_task 经 adc_cal_apply() 折算后的工程量（L1.5，标定折算已落地）：
* 未标定（VALID=0）时单位只是 ADC 引脚电压——该域下判据必然错配，由
* protectTask 的未标定闭锁（卡 5）停走整条判据链，元件核本身不掺和
* protectTask 的「数据可信」未标定即闭锁停走整条判据链，元件核本身不掺和
* 标定语义（保持纯逻辑）；标定后单位 = 二次值，定值口径才名副其实。
*
* 线程约定：init 内核启动前或保护消费者任务上下文；eval/run 仅保护消费者任务
App/algo/prot_set.c
+3 -3
View File
@@ -6,12 +6,12 @@
* ⚠ 默认值/范围为拟定值（参考 EEPROM 出厂默认表不在本仓库，规划 §10.3 待补）；
* 通讯地址逐项对照参考 Comm/Pub/Const_CommSetPara.c g_tCommSetParaTab。
*
* 量纲口径（「数据可信」卡 6 复核，2026-10-25）：A/V 项 = **二次值**工程量，
* 量纲口径（「数据可信」下游常数按工程量重定一项复核，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×标称，无需随本卡改动数值——换算依据与三处下游
* 于此域（未标定 = 引脚电压域，由未标定即闭锁停走判据，见 protect_task.c）；
* min/max 范围覆盖 0~4×标称，无需随这一项改动数值——换算依据与三处下游
* 常数同源，见 docs/任务规划/数据可信.md §2.3。
*
* 创建日期：2026-10-11
App/algo/run_par.c
+4 -4
View File
@@ -1,13 +1,13 @@
/*
* 模块名称：运行参数段（L2/L3 整定层，「数据可信」卡 10）——实现
* 模块功能：见 run_par.h。工厂默认 = 「数据可信」卡 6 额定 0.5 % 档（电压 500
* 模块名称：运行参数段（L2/L3 整定层，「数据可信」这一项）——实现
* 模块功能：见 run_par.h。工厂默认 = 「数据可信」下游常数按工程量重定后的额定 0.5 % 档（电压 500
* mV / 电流 5 mA / 频率 500 mHz，毫单位 int32 定点落盘）；[run_par]
* 段 9 键（db_ua…db_freq，均 ≤15 字符）≤ CFG_FILE_MAX_KEYS 不拆段
* （通道系数覆盖**不落本段**——直通 adc_cal 的 [adc_cal]/[adc_cal_ofs]，
* 系数唯一真源在那两段，lead 裁②a）。
* 适用平台：STM32F407ZGTx（Cortex-M4F，硬件 FPU）
* 作者：DTU 项目组
* 创建日期：2026-10-25（道D 卡 10）
* 创建日期：2026-10-25（道D 运行参数段）
* 修改记录：
* v1.0 2026-10-25 DTU 项目组 创建：[run_par] 段 + 104 映射 + 直通 adc_cal
* + B7 式脏标志落盘请求
@@ -52,7 +52,7 @@ typedef struct {
} run_par_db_t;
static const run_par_db_t s_db_rom = {
{ 500L, 500L, 500L, 500L, /* UA/UB/UC/UN：0.5 V（卡 6 额定档） */
{ 500L, 500L, 500L, 500L, /* UA/UB/UC/UN：0.5 V（工程量重定后的额定档） */
5L, 5L, 5L, 5L, /* IA/IB/IC/IN：0.005 A */
500L } /* 频率：0.5 Hz（绝对档，非额定百分比） */
};
App/algo/run_par.h
+6 -6
View File
@@ -1,17 +1,17 @@
/*
* 模块名称：运行参数段（L2/L3 整定层，「数据可信」卡 10）
* 模块名称：运行参数段（L2/L3 整定层，「数据可信」这一项）
* 模块功能：遥测死区（9 点）与通道标定系数覆盖（k/b 各 8 路）的**单一真源**：
* - 死区 = 本模块 int32 毫单位 RAM 副本（注册进 cfg 引擎 [run_par] 段，
* 工厂默认 = 「数据可信」卡 6 额定 0.5 % 档），104 消费侧
* 工厂默认 = 「数据可信」下游常数按工程量重定后的额定 0.5 % 档），104 消费侧
* （App/protocol/iec104/iec104_pts.c）每拍实时读取——无投递、无缓存
* 副本（卡 9 曾在 pts 侧留运行时副本 s_yc_db，卡 10 落地后收编于此，
* 副本（104 改读快照曾在 pts 侧留运行时副本 s_yc_db，运行参数段落地后收编于此，
* 双源必打架）；
* - 系数覆盖 = **直通 adc_cal_set()**（[adc_cal]/[adc_cal_ofs] 是系数
* 唯一真源，卡 4 已定；本模块只加 104 地址映射 + 落盘请求，不另存
* 唯一真源，标定落盘与整定入口已定；本模块只加 104 地址映射 + 落盘请求，不另存
* 一份系数——同 D1 裁"两处判断必打架"逻辑）。
* 104 地址映射（docs/算法/继电保护功能复现规划.md §5.1 运行参数类
* 0x8020H~0x8058H；逐项表原文"待补"（参考项目 CommPara_ConfigTable
* 不在仓），本表即卡 10 的落实，送检点表若另给权威地址只改常量段：
* 不在仓），本表即运行参数段的落实，送检点表若另给权威地址只改常量段：
* 0x8030~0x8038 = 死区 UA/UB/UC/UN/IA/IB/IC/IN/FREQ（工程量 V/A/Hz）；
* 0x8040~0x8047 = k 覆盖（µV/码）；0x8048~0x804F = b 覆盖（码值，可负）；
* 其余留白（未启用类别），**0x8027~0x802A 属 prot_set 告警段**，本表
@@ -41,7 +41,7 @@
* 接口级）→ 主机侧可单测（test/host/run_par，链真 cfg 引擎 + 真 adc_cal）。
* 适用平台：STM32F407ZGTx（Cortex-M4F，硬件 FPU）
* 作者：DTU 项目组
* 创建日期：2026-10-25（道D 卡 10）
* 创建日期：2026-10-25（道D 运行参数段）
* 修改记录：
* v1.0 2026-10-25 DTU 项目组 创建：[run_par] 段 + 104 地址映射 + 直通
* adc_cal + B7 式脏标志落盘请求
App/app/app_main.c
+5 -5
View File
@@ -25,8 +25,8 @@
#include "gd5f2gq5ue.h"
#include "tpafe5160.h"
#include "adc_input.h" /* L1 采集层：adc_input_init()（语义映射 + STM32 ADC1 扫描） */
#include "adc_cal.h" /* L1.5 标定层：adc_cal_init()（ROM 系数 + cfg 两段注册，道A 卡2/4） */
#include "run_par.h" /* 运行参数段：run_par_init()（[run_par] 注册 + 104 地址映射真源，道D 卡10） */
#include "adc_cal.h" /* L1.5 标定层：adc_cal_init()（ROM 系数 + cfg 两段注册，道A 标定折算与落盘整定） */
#include "run_par.h" /* 运行参数段：run_par_init()（[run_par] 注册 + 104 地址映射真源，道D 这一项） */
#include "iec104_comm.h" /* [comm] 段：iec104_comm_init()（ca/端口注册，道G task-8） */
#include "phasor.h" /* L2 相量层：phasor_init()（系数表 + 实例 + 双区交换） */
#include "freq.h" /* L2 派生量：freq_init()（相位解缠绕测频，B8） */
@@ -272,8 +272,8 @@ int app_main_init(void) {
(void)freq_init();
DBG_INFO("freq layer init: OK");
/* 4c-3) 通道标定层（L1.5，「数据可信」卡 2/卡 4）初始化：RAM 系数副本置
* ROM 默认（卡 1 定死的引脚侧 LSB，docs/硬件平台/ADC通道映射说明.md §7.1）
/* 4c-3) 通道标定层（L1.5，「数据可信」标定折算与落盘整定）初始化：RAM 系数副本置
* ROM 默认（量程口径冻结定死的引脚侧 LSB，docs/硬件平台/ADC通道映射说明.md §7.1）
* + 向配置引擎注册 [adc_cal] / [adc_cal_ofs] 两段。注册必须先于
* defaultTask 的 cfg_file_load（「先注册后 load」契约）→ 只能落内核前；
* 折算消费在 adcTask 每拍（adc_cal_apply），标定文件值随 load/poll 原地
@@ -282,7 +282,7 @@ int app_main_init(void) {
DBG_INFO("adc cal init: OK (k_q16 tpafe=%ld stm32=%ld)",
(long)ADC_CAL_K_Q16_TPAFE, (long)ADC_CAL_K_Q16_STM32);
/* 4c2) 运行参数段初始化（「数据可信」卡 10）：死区 9 点工厂默认 + 注册
/* 4c2) 运行参数段初始化（「数据可信」这一项）：死区 9 点工厂默认 + 注册
* [run_par] 段。同 adc_cal 的「先注册后 load」契约 → 必须内核前；
* 104 消费（COV 实时读 / 0x8020 段读写映射）在 iec104Task 启动后进行。 */
run_par_init();
App/app/sys_events.h
+1 -1
View File
@@ -34,7 +34,7 @@ extern osEventFlagsId_t sys_evtHandle;
#define SYS_EVT_PROT_SET_SAVE (1u << 7) /* 保护定值落盘请求（B7）：iec104Task 检测到定值脏置位，
* defaultTask（配置引擎属主）消费并写 /prot_set.bin
* （消费型命令位；写盘失败脏标志保留 → 下轮再通知重试） */
#define SYS_EVT_RUN_PAR_SAVE (1u << 8) /* 运行参数段落盘请求（「数据可信」卡 10）：iec104Task
#define SYS_EVT_RUN_PAR_SAVE (1u << 8) /* 运行参数段落盘请求（「数据可信」这一项）：iec104Task
* 检测到 run_par 脏（死区 9 键 / 系数覆盖联动 [adc_cal]）
* 置位，defaultTask 消费并 cfg_file_save 整档外科保存
* （消费型命令位；失败脏保留 → 下轮重试，B7 同款） */
App/app/ui_data_feed.c
+19 -2
View File
@@ -45,6 +45,8 @@
#include <string.h>
#include "cmsis_os.h" /* osKernelGetTickCount：与 adc_task 同一 ms 时基 */
#include "boot_stats.h" /* 运行报告：上电次数 + 本次复位原因快照（道G task-12 数据面） */
#include "iec104_serv.h" /* 运行报告：四个 104 只读观测计数（本次开机以来，跨重连不清零） */
#include "ui_data_feed.h"
@@ -145,7 +147,7 @@ static uint8_t s_map_done;
* par 帧有**三个各自独立**的变化源，任一变了就要重发一帧（详见 tick 里的门控注释）：
* s_par_sum 定值改动（校验和）
* s_par_locked 定值闭锁（定值校验和自检失配，校验和不动）
* s_par_cal_block 未标定闭锁（卡 12 标定完成，校验和也不动）
* s_par_cal_block 未标定闭锁（两点标定完成，校验和也不动）
* 后两个各占一字节——省下来就是"屏上状态与真值脱拍"这笔债 */
static uint32_t s_last_rt_ms;
static uint32_t s_par_sum;
@@ -732,6 +734,8 @@ static void feed_fill_par(ui_data_par_t *p_snap, uint32_t sum) {
*/
static void feed_fill_info(ui_data_info_t *p_snap, uint32_t tick_ms) {
const ftp_cfg_t *p_ftp = ftp_cfg_get();
boot_stats_t boot;
iec104_serv_stats_t st104;
p_snap->valid = 1u;
p_snap->uptime_s = tick_ms / 1000u;
@@ -747,6 +751,19 @@ static void feed_fill_info(ui_data_info_t *p_snap, uint32_t tick_ms) {
} else {
p_snap->ftp_user[0] = '\0';
}
/* 运行报告四数（2026-10-28 UI 补齐）：纯搬运，页面不得自己去 include 这两个头。
* uptime_s 仍由本函数用 tick 差算——boot_stats 不提供时长，别在那里再算一份。 */
boot_stats_get(&boot);
iec104_serv_get_stats(&st104);
p_snap->boot_count = boot.boot_count;
p_snap->boot_seq_state = boot.seq_state;
p_snap->boot_write_failed = boot.write_failed;
p_snap->rst_cause = boot.rst_cause;
p_snap->boot_ready = boot.ready;
p_snap->iec104_conn_up = st104.conn_up;
p_snap->iec104_apdu_tx = st104.apdu_tx;
p_snap->iec104_tx_fail = st104.tx_fail;
p_snap->iec104_rx_bytes = st104.rx_bytes;
}
/*
@@ -817,7 +834,7 @@ void ui_data_feed_tick(void) {
* 但"校验和没变"不等于"页面该看的没变"——本帧里还有两个与校验和无关的事实：
* · locked（定值闭锁）：自检失配时置位，校验和一字不变，
* 而整定页保存行要显示 LOCK 并禁编辑；
* · cal_block（未标定闭锁）：卡 12 两点标定写完 [adc_cal] 的 valid 就翻转，
* · cal_block（未标定闭锁）：两点标定写完 [adc_cal] 的 valid 就翻转，
* 校验和同样不动，而标题上的"未标定"徽标要当场消失。
* 只盯校验和，这两件事都到不了屏上（真机现象：标定做完了屏上徽标永远挂着，
* 直到某次定值改动才被顺带刷掉——那是把两件不相干的事当同步点）。
App/cfg/cfg_file.c
+3 -3
View File
@@ -25,7 +25,7 @@
* s_gen_document 两处 `off += snprintf(...)` 改检查式（截断即
* 返回 -1，不再跳过缓冲末尾）；注册拒超长键名（≤ 15 字符），
* 使每行 112 字节余量成为可编译期验证的前提
* v1.5 2026-10-25 DTU 项目组 数据可信卡 3：新增值类型 CFG_VAL_INT（有符号十进制，
* v1.5 2026-10-25 DTU 项目组 「数据可信」有符号零点类型：新增值类型 CFG_VAL_INT（有符号十进制，
* len 1/2/4 小端补码）——s_decode_int() 用 strtol + ERANGE +
* 宽度上下界校验，s_encode() 带负号输出；负零点偏移从此可
* 干净落盘（动因见 docs/任务规划/数据可信.md §4.4 与 §7 决策 3）
@@ -43,7 +43,7 @@
#include <ctype.h>
#include <errno.h> /* ERANGE：strtol 饱和判别（INT 键解码需要，数据可信卡 3） */
#include <errno.h> /* ERANGE：strtol 饱和判别（INT 键解码需要，「数据可信」有符号零点类型） */
#include "cfg_file.h"
@@ -358,7 +358,7 @@ static int s_decode_uint(uint8_t *p_dst, size_t len, const char *p_val) {
}
/*
* 函数功能：解析有符号十进制值（小端补码写入，数据可信卡 3）
* 函数功能：解析有符号十进制值（小端补码写入，「数据可信」有符号零点类型）
* 入口参数：p_dst - 目标字段 uint8_t *
* len - 字段字节数（1/2/4） size_t
* p_val - 值文本（可带 +/- 号） const char *
App/cfg/cfg_file.h
+1 -1
View File
@@ -15,7 +15,7 @@
* 超长；超长处置补自检留痕
* v1.3 2026-10-15 王建锋 新增公开常量
* CFG_FILE_MAX_NAME_LEN（段名/键名上限 15 字符）
* v1.4 2026-10-25 DTU 项目组 数据可信卡 3：新增 CFG_VAL_INT 有符号十进制值类型
* v1.4 2026-10-25 DTU 项目组 「数据可信」有符号零点类型：新增 CFG_VAL_INT 有符号十进制值类型
* （len = 1/2/4，小端补码）——标定零点偏移等负值需有符号
* 落盘，动因与取舍见 docs/任务规划/数据可信.md §4.4
*/
App/log/README.md
+2 -2
View File
@@ -42,7 +42,7 @@
`syslog_request_clear()` 调用内就删完了，因此 `WAIT` 态在模拟器上永不出现
（同 `syslog_post` 在两端"有队列 / 直写无队列"的差异）
### 五类记录与「记录类型 = 日志 ID」（道F task-10，2026-10-26；task-11 记录 5 页按此做）
### 五类记录与「记录类型 = 日志 ID」（道F task-10，2026-10-26；task-11 记录 5 页按此做，2026-10-28 五页已落地）
**决策一：记录类型就是 `syslog_id_t` 本身，一类记录 = `/log` 下一个严格 8.3 短名的文件。**
64B 定长记录体里**没有类型字段位**：`[0..18]` 时标 / `[19]` 空格 / `[20..29]` epoch /
@@ -78,7 +78,7 @@
任务用（**protectTask、iec104Task 必须用它**），丢弃只累加 `syslog_post_dropped()`、
由唯一写者 defaultTask 在 `syslog_drain()` 里按差值补一条留痕——同 `soe_store_post`
当年那条 `872 → 1192 B FAIL` 的实证纪律。收/丢判据两个口完全一致。
- **读侧契约（给 task-11）**：`syslog_count(id)` + `syslog_get_record(id, idx, ts, ts_len,
- **读侧契约（给 task-11；2026-10-28 五页已按此接上）**：`syslog_count(id)` + `syslog_get_record(id, idx, ts, ts_len,
desc, desc_len)` 与运行/自检记录**同一枚 reader**，"最近 20 条"= 从 `count-20` 起读；
`count()==0` 就是空态，页面显示"无记录"。**不要**在共享代码里调 MCU 专属的
`syslog_clear_apply()`（模拟器不实现 → 链接期报错是故意的）；清除一律走
App/log/soe_rec.h
+2 -2
View File
@@ -61,7 +61,7 @@ extern "C" {
* 4 软压板投入 value = 1
* 5 采样闭锁 value = adc_health 闭锁位图（触发时的 hf & mask）
* 6 采样恢复 value = 0
* 7 标定闭锁 value = UA/UN/IA VALID 未齐的通道位图（卡 5，2026-10-25）
* 7 标定闭锁 value = UA/UN/IA VALID 未齐的通道位图（未标定即闭锁，2026-10-25）
* 8 标定复归 value = 0
*/
typedef enum {
@@ -71,7 +71,7 @@ typedef enum {
SOE_T_PLATE_IN,
SOE_T_SAMPLE_BLOCK,
SOE_T_SAMPLE_RESUME,
/* 未标定闭锁（「数据可信」卡 5，2026-10-25 道A 追加）：UA/UN/IA 的 VALID
/* 未标定闭锁（「数据可信」未标定即闭锁一项，2026-10-25 道A 追加）：UA/UN/IA 的 VALID
* 未全置位 → 判据停走；与采样闭锁分型，边沿各留一条记录 */
SOE_T_CAL_BLOCK,
SOE_T_CAL_RESUME,
App/log/sys_log.h
+2 -1
View File
@@ -44,7 +44,8 @@ extern "C" {
* 同理二进制 SOE 通道的 soe_type_t 本轮**不动**：改它必须同步 UI 侧的类型名表
* （类型名表在 UI 侧 <Drivers/BSP/UI/ui_w_soe.c>，不在本道写域），而且 SOE
* 页与这五页是两套读者。
* 口径与五个写入点已登记进 App/log/README.md（task-11「记录 5 页」按此做）。
* 口径与五个写入点已登记进 App/log/README.md（task-11「记录 5 页」按此做——五个页面已于
* 2026-10-28 落地：ui_page_accident / oper / alarm / start / yk，各页只读一个文件）。
*/
typedef enum {
SYSLOG_RUN = 0u, /* 运行记录 /log/run.log：上电/重启事件 */
App/protocol/iec104/iec104_pts.c
+28 -28
View File
@@ -1,24 +1,24 @@
/*
* 模块名称：IEC 60870-5-104 点表与数据源适配（实现）
* 模块功能：实现 iec104_pts.h——YC/YX/YK/定值点表（ROM）、板端默认源
* （**L2 遥测快照**（卡 9）/ prot_elm / prot_set）、COV 比对（遥信变位 +
* （**L2 遥测快照**（104 改读快照）/ prot_elm / prot_set）、COV 比对（遥信变位 +
* 遥测死区 2 点确认 + 品质变化）。点表口径见 iec104_pts.h 文件头与
* 设计文档 §3。
* 线程约定：init/bind 建服务前；其余仅 104 服务任务上下文（快照非原子）。
* 创建日期：2026-10-12（B4）
* 修改记录：
* 2026-10-25 DTU 项目组 卡 6（「数据可信」）：YC 死区由拟定码值域重定为
* 2026-10-25 DTU 项目组 下游常数按工程量重定（「数据可信」）：YC 死区由拟定码值域重定为
* 二次值工程量域（额定 0.5 % 规则），判据依据见
* k_yc 表头注释；数值随卡 9 迁运行参数，本表将退化为
* k_yc 表头注释；数值随 104 改读快照迁运行参数，本表将退化为
* ROM 默认载体。
* 2026-10-25 DTU 项目组 卡 9/卡 11（「数据可信」，道D）：YC 板端源改读
* 2026-10-25 DTU 项目组 104 改读快照与频率点绑定（「数据可信」，道D）：YC 板端源改读
* L2 遥测快照（App/algo/meas.h，meas_get 无锁双区）；
* 削顶五路由快照品质 CLIPPED 驱动线上 IV（不再绑死 -1，
* V0.2 消除双转换器无共同采样触发后零改动自动启用）；0x401d 绑频率源（卡 11）；
* V0.2 消除双转换器无共同采样触发后零改动自动启用）；0x401d 绑频率源（频率点绑定）；
* 死区改运行时副本 + set/get 入口；COV 遥测腿 = 死区
* 连续 2 点确认（板端按快照 seq 去重）+ 品质翻转即报。
* 单测 = test/host/iec104 TC-IEC104-025~028。
* 卡 10 2026-10-25 DTU 项目组 死区真源收编 App/algo/run_par.c（本层 s_yc_db
* 运行参数段 2026-10-25 DTU 项目组 死区真源收编 App/algo/run_par.c（本层 s_yc_db
* 副本删除，set/get 转转发壳，壳保留清确认计数语义）；
* 定值读写路由 = run_par 表先、prot_set 后（0x8020~
* 0x8058 运行参数段 C_RD/C_SE，系数覆盖直通 adc_cal）。
@@ -36,36 +36,36 @@
#include <string.h>
#include "iec104_asdu.h" /* QDS/DIQ 品质位常量 */
#include "meas.h" /* 板端源：遥测 = L2 遥测快照（卡 9；品质域位同源） */
#include "run_par.h" /* 卡 10：死区真源 + 运行参数段 104 读写路由 */
#include "meas.h" /* 板端源：遥测 = L2 遥测快照（104 改读快照；品质域位同源） */
#include "run_par.h" /* 运行参数段：死区真源 + 104 读写路由 */
#include "prot_elm.h" /* 板端源：遥信 = 元件状态 */
#include "prot_set.h" /* 板端源：定值 + 闭锁 */
#include "sys_log.h" /* task-10：遥控记录（SYSLOG_YK）/ 操作记录（SYSLOG_OPER） */
#include "adc_input.h" /* adc_semantic_t（phasor 实例按语义绑定） */
/* ---------------- YC 表（§1.5 点号 4011+；死区列 = ROM 默认值） ------------ */
/* 源类型（「数据可信」卡 11：YC 表加 src 类型区分相量/频率） */
/* 源类型（「数据可信」频率点绑定：YC 表加 src 类型区分相量/频率） */
#define PTS_SRC_MEAS 0u /* L2 快照槽 sem（电气量，yc/qds 直读） */
#define PTS_SRC_FREQ 1u /* 快照频率（freq_valid 门 → IV） */
typedef struct {
uint32_t ioa;
int8_t sem; /* 快照 yc 槽 = 语义通道（-1 = 非测量量点，当前仅频率） */
float db_default; /* 死区工厂默认（生效真源 = run_par [run_par] 段，卡 10） */
float db_default; /* 死区工厂默认（生效真源 = run_par [run_par] 段 = 运行参数段真源） */
uint8_t src; /* PTS_SRC_* 源类型 */
} pts_yc_def_t;
/* 死区规则 = 额定二次值的 0.5 %（「数据可信」§2.3 表第 2 行建议规则，卡 6 采纳；
/* 死区规则 = 额定二次值的 0.5 %（「数据可信」§2.3 表第 2 行建议规则，随下游常数按工程量重定采纳；
* 额定基准 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 运行参数段可调）。自卡 9 起本表**只作工厂默认载体**：生效死区 =
* App/algo/run_par.c 的 [run_par] 引擎副本（卡 10 真源收编，本层不再存副本）；削顶五路不再 sem=-1 绑死，而是绑快照槽、由品质 CLIPPED
* 运行参数段可调）。自 104 改读快照起本表**只作工厂默认载体**：生效死区 =
* App/algo/run_par.c 的 [run_par] 引擎副本（运行参数段真源收编，本层不再存副本）；削顶五路不再 sem=-1 绑死，而是绑快照槽、由品质 CLIPPED
* 驱动线上 IV——V0.2 削顶消失后点位零改动自动启用（docs/任务规划/
* 数据可信.md §10 的「双转换器无共同采样触发」行）。
* ⚠ 过渡期（eng=0 引脚电压域，卡 12 标定前）：上送值本身非二次值，死区
* ⚠ 过渡期（eng=0 引脚电压域，两点标定完成前）：上送值本身非二次值，死区
* 数字按本域偏保守（迟报不漏报）；标定落地后复核（「数据可信」§2.3 表
* 第 2 行）。判定 = 死区连续 2 点确认（卡 9），见 iec104_pts.h COV 说明。 */
* 第 2 行）。判定 = 死区连续 2 点确认（104 改读快照），见 iec104_pts.h COV 说明。 */
static const pts_yc_def_t k_yc[] = {
{ 0x4011u, (int8_t)ADC_SEM_UA, 0.5f, PTS_SRC_MEAS }, /* 1Ua：0.5 % × 100 V */
{ 0x4012u, (int8_t)ADC_SEM_UB, 0.5f, PTS_SRC_MEAS }, /* 1Ub：削顶 → 品质驱动 IV */
@@ -75,12 +75,12 @@ static const pts_yc_def_t k_yc[] = {
{ 0x4016u, (int8_t)ADC_SEM_IB, 0.005f, PTS_SRC_MEAS }, /* 1Ib：削顶 → 品质驱动 IV */
{ 0x4017u, (int8_t)ADC_SEM_IC, 0.005f, PTS_SRC_MEAS }, /* 1Ic：同上 */
{ 0x4018u, (int8_t)ADC_SEM_IN, 0.005f, PTS_SRC_MEAS }, /* 1I0：同上 */
{ 0x401Du, -1, 0.5f, PTS_SRC_FREQ }, /* 1f：卡 11 绑频率源，
{ 0x401Du, -1, 0.5f, PTS_SRC_FREQ }, /* 1f：频率点绑定——绑频率源，
* freq_valid=0 → IV */
};
#define YC_N ((uint8_t)(sizeof(k_yc) / sizeof(k_yc[0])))
/* ===== 遥测 COV 运行时状态（卡 9；仅 iec104Task 上下文访问，无并发） =====
/* ===== 遥测 COV 运行时状态（104 改读快照；仅 iec104Task 上下文访问，无并发） =====
* 判据链：新测量点 → |v − 上次上送值| > 死区？→ 连续 2 点确认 → 置变化位。
* 基准 = **上次上送值**（非上次读值——否则慢漂移永不出死区，参考系统同款）；
* 品质（线上 qds）翻转 = 事件：不参与 2 点计数、当拍直报。 */
@@ -124,7 +124,7 @@ static uint8_t s_yx_snap_ok;
/*
* 函数功能：初始化点表模块（死区装 ROM 默认、清 COV/快照状态、恢复默认源）
* 限定条件：内核启动前或 104 服务启动前，调一次
* 函数说明：卡 9 起不再扫 phasor 实例（数据源 = 快照，槽位 = 语义通道，编译期
* 函数说明：104 改读快照起不再扫 phasor 实例（数据源 = 快照，槽位 = 语义通道，编译期
* 直接可定）；重复调用 = 全状态复位（单测 reset 依赖此语义）。
*/
void iec104_pts_init(void) {
@@ -172,7 +172,7 @@ uint32_t iec104_pts_yc_ioa(uint8_t idx) {
}
/*
* 函数功能：品质域位映射（uint16 meas 域 → uint8 线上 QDS，卡 9）
* 函数功能：品质域位映射（uint16 meas 域 → uint8 线上 QDS，104 改读快照）
* 入口参数：q16 - 源侧品质（低字节与线上同值；高字节为 MEAS_QDS_CLIPPED 域内位）
* 返 回 值：线上 QDS 字节 uint8_t
* 函数说明：CLIPPED（硬件削顶，104 无对应位）映射为 IV——「削顶通道 104 恒
@@ -195,7 +195,7 @@ static uint8_t s_q_map(uint16_t q16) {
* 返 回 值：0 有效；-1 IV（含 CLIPPED 映射）；-2 NT（未就绪） int
* 函数说明：ex 源在场 → 品质由源给（板端 = 快照槽位透传）；否则退 legacy
* yc_read，品质从返回值推导（-1→IV / -2→NT / 0→无位）——旧注入源
* 行为与卡 9 前**完全一致**（单测假源零改动）。判定顺序 IV > NT：
* 行为与 104 改读快照前**完全一致**（单测假源零改动）。判定顺序 IV > NT：
* 开机首帧 qds=IV|NT 按无效处理（NT 只留给纯暂态）。任何无效 →
* 信息体清零（线上口径：主站只信品质）。
*/
@@ -245,14 +245,14 @@ int iec104_pts_yc_read(uint8_t idx, float *v, uint8_t *qds) {
}
/*
* 函数功能：写死区（卡 9 API 壳，转发 run_par 真源 + 清本层确认计数）
* 函数功能：写死区（104 改读快照的 API 壳，转发 run_par 真源 + 清本层确认计数）
* 入口参数：idx - YC 表下标 db - 工程量绝对死区（≥0，分档上限见 run_par）
* 返 回 值：0 成功；-1 越界/负值/NaN/越程（run_par 副本不动） int
* 限定条件：**iec104Task 上下文**（run_par 副本写 = 引擎对齐 int32 单字，
* 104 执行段之外调用需自行避免与 104 写并发）
* 函数说明：成功时清零该点待确认计数——跨死区档位不保留半截确认序列；
* 不隐式重建基线（上送基准延续，新死区即刻生效）。落盘由 run_par
* 脏标志 + SYS_EVT_RUN_PAR_SAVE 走 defaultTask（卡 10 持久化链）。
* 脏标志 + SYS_EVT_RUN_PAR_SAVE 走 defaultTask（运行参数段持久化链）。
*/
int iec104_pts_yc_set_deadband(uint8_t idx, float db) {
if (idx >= YC_N) {
@@ -348,7 +348,7 @@ void iec104_pts_cov_check(iec104_pts_cov_t *cov) {
s_yx_snap_ok = 1u;
}
/* YC（卡 9）：测点推进 = 板端源按快照换帧（100 ms poll vs 200 ms 快照，
/* YC（104 改读快照）：测点推进 = 板端源按快照换帧（100 ms poll vs 200 ms 快照，
* 不去重则同一帧计两次 → "连续 2 点确认"退化成"连续 2 次轮询"，单帧
* 噪声即可被确认，抗噪语义失效）；注入源 = 每次调用一测点。
* 判定 = 死区连续 2 点确认 + 品质翻转直报（口径全文 → iec104_pts.h）。 */
@@ -383,7 +383,7 @@ void iec104_pts_cov_check(iec104_pts_cov_t *cov) {
continue;
}
if (q != s_yc_repq[i]) {
/* 品质翻转 = 事件直报（含 0x401d 的 IV 进出，卡 11） */
/* 品质翻转 = 事件直报（含 0x401d 的 IV 进出，频率点绑定） */
local.yc_changed |= (uint16_t)(1u << i);
s_yc_repq[i] = q;
s_yc_cnf[i] = 0u;
@@ -458,15 +458,15 @@ int iec104_pts_set_write(uint32_t addr, float v, uint8_t select) {
/* ============================ 板端默认源 ================================= */
/*
* 函数功能：板端默认源 - 遥测 = L2 遥测快照直读（「数据可信」卡 9/卡 11）
* 函数功能：板端默认源 - 遥测 = L2 遥测快照直读（「数据可信」104 改读快照与频率点绑定）
* 入口参数：idx - YC 表下标 out/qds - 值 + uint16 域品质（MEAS_QDS_*）
* 返 回 值：0 / -1 越界或频率未新鲜（IV）/ -2 快照从未发布（NT） int
* 限定条件：iec104Task 上下文（meas_get 为双区无锁读，App/algo/meas.h）
* 函数说明：**不做任何本地判断**——电气路值/品质整体透传快照槽（削顶路快照
* 已置 CLIPPED，s_q_map 映上线 IV；开机首帧 IV|NT 由 s_yc_point 按
* IV 处理），"新不新、能不能信"全在发布侧一处决定（卡 8 设计意图，
* IV 处理），"新不新、能不能信"全在发布侧一处决定（遥测快照发布的设计意图，
* 两处判断必打架）。频率路（PTS_SRC_FREQ）：snap.freq_valid==0 →
* IV（卡 11 DoD 原句）；有效时值 = snap.freq_hz，与 freq_get() 同源。
* IV（频率点绑定 DoD 原句）；有效时值 = snap.freq_hz，与 freq_get() 同源。
*/
static int s_src_yc_read_ex(uint8_t idx, float *out, uint16_t *qds) {
meas_snap_t snap;
@@ -633,7 +633,7 @@ static int s_src_set_read(uint32_t addr, float *out) {
return -1;
}
if (run_par_104_read(addr, out) == 0) {
return 0; /* 运行参数段命中（卡 10） */
return 0; /* 运行参数段命中 */
}
for (i = 0u; i < (uint32_t)PS_ID_COUNT; i++) {
if ((g_prot_set_meta[i].comm_addr != 0u)
App/protocol/iec104/iec104_pts.h
+8 -8
View File
@@ -6,7 +6,7 @@
* （asdu+pts+link）可离线跑（分层约束：协议解析与硬件 I/O 分离）。
* 点表口径（docs/算法/继电保护功能复现规划.md §1.5，验收 = 省电科院点表）：
* - YC：IOA 0x4011~0x4018 + 0x401d（频率），短浮点、系数 1；数据源 =
* L2 遥测快照（App/algo/meas.h，「数据可信」卡 9/11）：电气 8 路绑快照槽，
* L2 遥测快照（App/algo/meas.h，「数据可信」104 改读快照与频率点绑定）：电气 8 路绑快照槽，
* 有效性由快照品质驱动——V0.1 削顶路（docs/算法/继电保护功能复现规划.md
* §1.6）快照置 CLIPPED → 本层映射为线上 IV（V0.2 后自动启用，绑定零
* 改动，见 docs/任务规划/数据可信.md §10「双转换器无共同采样触发」行）；0x401d 绑频率源，
@@ -25,11 +25,11 @@
* 线程约定：init/bind 内核启动前或建服务前；cov_check/read 仅 104 服务任务上下文。
* 创建日期：2026-10-12（B4）
* 修改记录：
* 2026-10-25 DTU 项目组 卡 9/卡 11（「数据可信」，道D）：YC 数据源 = L2 遥测
* 2026-10-25 DTU 项目组 104 改读快照与频率点绑定（「数据可信」，道D）：YC 数据源 = L2 遥测
* 快照（削顶路由品质驱动 IV）；死区改运行时副本 +
* set/get 入口；COV 遥测腿 = 死区 2 点确认（seq 去重）
* + 品质变化即报；0x401d 绑频率源（freq_valid → IV）。
* 2026-10-25 DTU 项目组 卡 10：死区真源迁 run_par（[run_par] cfg 段 +
* 2026-10-25 DTU 项目组 运行参数段：死区真源迁 run_par（[run_par] cfg 段 +
* 0x8020~0x8058 读写映射；本层 set/get 为转发壳）。
*/
#ifndef IEC104_PTS_H
@@ -52,7 +52,7 @@ typedef struct {
int (*set_read)(uint32_t addr, float *out);
/* 定值写：select=1 预置校验（范围）/ 0 执行写入。返回 0 / -1 越界或未知 */
int (*set_write)(uint32_t addr, float v, uint8_t select);
/* 遥测读（带品质，卡 9 追加于表尾——旧源 NULL = 走 yc_read 退路，品质由
/* 遥测读（带品质，104 改读快照时追加于表尾——旧源 NULL = 走 yc_read 退路，品质由
* 返回值推导：-1 → IV、-2 → NT、0 → 无位，行为与旧源完全一致）。
* qds = uint16 域位（App/algo/meas.h MEAS_QDS_*：低字节 = 线上 QDS 同值，
* 高字节 CLIPPED 由本层映射线上 IV）；返回 0 / -1 IV / -2 NT */
@@ -83,11 +83,11 @@ uint32_t iec104_pts_yc_ioa(uint8_t idx);
/* 读 YC：v 有效值（无效时为 0）；qds 输出线上品质位（IV/NT/OV，CLIPPED 已映射
* 为 IV）。返回 0/无效-1（NT 亦无效，品质位区分） */
int iec104_pts_yc_read(uint8_t idx, float *v, uint8_t *qds);
/* 死区写（卡 9 API；卡 10 起 = 转发 App/algo/run_par.c 真源 + 清本层确认计数）：
/* 死区写（104 改读快照 API；运行参数段起 = 转发 App/algo/run_par.c 真源 + 清本层确认计数）：
* db = 工程量绝对值 ≥0（电压 50 V / 电流 1 A / 频率 5 Hz 分档上限）；越界/负值/
* NaN → -1 且真源不动；成功时清零该点待确认计数（跨档位不残留半截确认——此壳
* 行为有单测钉住）。仅 104 服务任务上下文调用。落盘 = run_par 脏 → 事件 →
* defaultTask（卡 10 持久化链，docs/子系统设计/IEC104上行设计说明.md §3.4）。 */
* defaultTask（运行参数段持久化链，docs/子系统设计/IEC104上行设计说明.md §3.4）。 */
int iec104_pts_yc_set_deadband(uint8_t idx, float db);
/* 读当前生效死区（越界 idx 返 0） */
float iec104_pts_yc_deadband(uint8_t idx);
@@ -104,12 +104,12 @@ void iec104_pts_yx_read(uint8_t idx, uint8_t *out);
* 函数功能：读全表并与上次比对（遥信变位 + 遥测死区 2 点确认 + 品质变化），
* 输出变化集
* 入口参数：cov - 输出（可为 NULL = 只刷快照不取变化）
* 函数说明：遥测判据（「数据可信」卡 9，对标参考系统 CalfYcMea 死区 2 点确认，
* 函数说明：遥测判据（「数据可信」104 改读快照，对标参考系统 CalfYcMea 死区 2 点确认，
* 短板评测口径）：**连续 2 个新测量点** |v - 上次上送值| > 死区才置变化位
* （单点尖峰不确认——噪声回摆即撤销候选）；品质位（线上 qds）相对上次
* 上送值翻转 → 当拍直接置位（不等 2 点，有效性变化必须即时可见，
* 含 0x401d 的 IV 进出）。死区 = 运行时副本（ROM 默认 = 点表列，
* iec104_pts_yc_set_deadband() 覆盖——卡 10 运行参数段的接线点）。
* iec104_pts_yc_set_deadband() 覆盖——运行参数段的接线点）。
* 测量点定义：板端默认源 = **快照换帧**（meas seq 前进；100 ms poll 对
* 200 ms 快照，同一帧重复比对会计数两次 → seq 去重是确认语义成立的
* 前提）；注入源（单测假源）= 每次调用一测点。首次读到有效值只建基线
App/task/adc_task.c
+14 -14
View File
@@ -85,21 +85,21 @@
* 者；该入口同时不再打日志——它落在本任务静态最坏链上，
* 每条 DBG_* 约 216 B 栈，而这一行毫无诊断价值（本任务
* 存活由首帧日志与 TASK_WD_ADC 心跳证明）
* v3.1 2026-10-25 DTU 项目组 L1.5 折算 + 采样通道自检 贴轨观测（「数据可信」卡 2，道A）：
* v3.1 2026-10-25 DTU 项目组 L1.5 折算 + 采样通道自检 贴轨观测（「数据可信」标定折算落地，道A）：
* frame[s] 由 (float)code 改 adc_cal_apply()——工程量 =
* (code+b)×k，现口径 = ADC 引脚电压 V（eng=0，卡 1 冻结的
* (code+b)×k，现口径 = ADC 引脚电压 V（eng=0，量程口径冻结的
* ROM 系数，docs/硬件平台/ADC通道映射说明.md §7.1）；同拍
* 经 adc_health_rail_watch() 逐通道贴轨观察（采样通道自检 残余，
* 门限 adc_cal_rail_ths，码值域与标定正交），锁存边沿 →
* DBG_ERROR + 每开机一次 SYSLOG；心跳增 cal: 行（mV 定点
* + valid/clipped 位图 + rail 锁存），台架注入口径见该行判读
* v3.2 2026-10-25 DTU 项目组 L2 遥测快照发布（「数据可信」卡 8，道D，M5）：新模块
* v3.2 2026-10-25 DTU 项目组 L2 遥测快照发布（「数据可信」这一项，道D，M5）：新模块
* App/algo/meas.c——本任务为唯一发布者，新帧拍内
* freq_run() 之后按 200 ms **tick 经过**分频调
* meas_tick()（全仓调用点 = 1，评审判据）；品质注入源 =
* adc_cal_flags() 削顶位图，频率 = 同拍 freq 读数；心跳新增
* meas: 行（seq/v/ua·un·ia_mv/f/fv），读数比对类判据待台架实测
* v3.3 2026-10-27 DTU 项目组 卡 0 台架读出口：心跳新增 adc: 行——连续输出 9 路
* v3.3 2026-10-27 DTU 项目组 已知电压注入验证台架读出口：心跳新增 adc: 行——连续输出 9 路
* **原始码值**（与 first: 行同序同格式）。动因 = 注入验证
* 原本只能靠"改电压 + 复位 + 抓一次 first:"，8 个通道 × 3 个
* 注入点要复位二十余次；改为每 10 s 一行后可全程免复位。
@@ -116,8 +116,8 @@
#include "phasor.h" /* L2 相量层：phasor_run()/phasor_get()（全周傅氏） */
#include "freq.h" /* L2 派生量：freq_run()/freq_get()（测频，B8） */
#include "adc_health.h" /* 采样有效性校验（静默/丢帧/单调性/错误增量/贴轨） */
#include "adc_cal.h" /* L1.5：通道标定折算（「数据可信」卡 2；flags 供 cal 心跳行） */
#include "meas.h" /* L2 发布侧：遥测快照 meas_tick()（「数据可信」卡 8，道D） */
#include "adc_cal.h" /* L1.5：通道标定折算（「数据可信」标定折算落地；flags 供 cal 心跳行） */
#include "meas.h" /* L2 发布侧：遥测快照 meas_tick()（「数据可信」遥测快照发布，道D） */
#include "tpafe5160.h"
#include "task_watchdog.h"
#include "console_log.h"
@@ -152,7 +152,7 @@ static uint32_t s_health_logged;
static uint32_t s_rail_edge_latched;
static uint8_t s_rail_syslogged;
/* 遥测快照发布闸门（「数据可信」卡 8）：上次发布拍时基。分频用 **tick 经过**
/* 遥测快照发布闸门（「数据可信」这一项）：上次发布拍时基。分频用 **tick 经过**
* 对比 MEAS_PERIOD_MS，非拍计数——idle/skip 拍会把拍计数口径拉得超过名义
* 200 ms（与 v2.6 修"重复采样污染 DFT 窗"同族误差，勿"优化"成拍计数） */
static uint32_t s_meas_ms;
@@ -374,9 +374,9 @@ void adc_task_func(void *arg) {
all_ok = 0u;
break;
}
/* L1.5 折算（「数据可信」卡 2，§4.1 模型）：工程量 = (code + b) × k。
* 现口径 = **ADC 引脚电压 V**（eng=0，卡 1 冻结的 ROM 系数，见
* docs/硬件平台/ADC通道映射说明.md §7.1）；卡 0b/卡 12 写入标定
/* L1.5 折算（「数据可信」标定折算落地，§4.1 模型）：工程量 = (code + b) × k。
* 现口径 = **ADC 引脚电压 V**（eng=0，量程口径冻结的 ROM 系数，见
* docs/硬件平台/ADC通道映射说明.md §7.1）；端子变比确认与两点标定写入标定
* 系数（adc_cal_flags() 出 VALID）后才按二次值消费。TEMP 透传码值
* 不折算（决策 5）。*/
frame[s] = adc_cal_apply((adc_semantic_t)s, code);
@@ -398,7 +398,7 @@ void adc_task_func(void *arg) {
* 切换，freq 读的就是本拍相量（1 ms 同上下文，无竞态） */
freq_run();
/* L2 遥测快照发布（「数据可信」卡 8，道D，M5）：200 ms tick 经过分频。
/* L2 遥测快照发布（「数据可信」这一项，道D，M5）：200 ms tick 经过分频。
* 唯一发布者 = 本任务（全仓 meas_tick 调用点数 = 1 为评审判据，
* 「数据可信」§8 风险表"快照双写"行）；只在**压环成功的真新帧拍**发布
* ——idle/skip 拍压环未推进，发布 = 重复旧窗。品质注入唯一源 =
@@ -527,7 +527,7 @@ void adc_task_func(void *arg) {
log_phasors("hb");
/* 全 9 路**原始码值**（「数据可信」卡 0 注入验证的唯一连续读出口）：
/* 全 9 路**原始码值**（「数据可信」已知电压注入验证的唯一连续读出口）：
* 与 first: 行同序同格式（UA/UB/UC/UN/IA/IB/IC/IN/T），台架
* "改电压 → 读一行"即可对表，不必为每个注入点反复复位去抓只在开机
* 出现一次的 first: 行。两处的通道顺序是同一份约定，改一处必须同步另一处。
@@ -554,9 +554,9 @@ void adc_task_func(void *arg) {
/* L1.5/采样通道自检 台架观测面（×1000 mV 定点，MicroLIB 无 %f）：
* ua/un/ia_mv = 三路 TPAFE 引脚电压毫伏（未标定域，**不是**
* 二次值；卡 12 注入验证的读数落点，偏差判据 ≤2 %）
* 二次值；两点标定注入验证的读数落点，偏差判据 ≤2 %）
* vl = VALID 位图（默认构建应恒 0x00——未标定即未标定，
* 卡 5 的闭锁判据在 protect 侧同源消费这个位）
* 未标定即闭锁的判据在 protect 侧同源消费这个位）
* cl = CLIPPED 位图（V0.1 应恒 0xE6 = UB/UC/IB/IC/IN）
* rail/edge = 贴轨锁存/历史边沿位图（注入饱和电平后应起）*/
{
App/task/default_task.c
+2 -2
View File
@@ -38,7 +38,7 @@
#include "nand_ftl.h"
#include "net_cfg.h"
#include "cfg_file.h"
#include "run_par.h" /* 运行参数段落盘（卡 10，配置引擎属主 = 本任务） */
#include "run_par.h" /* 运行参数段落盘（「数据可信」这一项，配置引擎属主 = 本任务） */
#include "prot_set_store.h"
#include "prot_set.h" /* task-10：prot_set_dirty_peek（区分"无待写"与"真落盘"） */
#include "iec104_comm.h" /* 道G task-9：[comm] 段落盘（脏位轮询同款，通讯设置页） */
@@ -242,7 +242,7 @@ void default_task_func(void *argument) {
if ((prot_set_dirty_peek() != 0u) && (prot_set_store_save() == 0)) {
syslog_post(SYSLOG_OPER, "settings saved");
}
/* 运行参数段落盘（卡 10）：同款脏语义；save = 引擎整档外科写
/* 运行参数段落盘（「数据可信」这一项）：同款脏语义；save = 引擎整档外科写
* （[run_par] 9 键 + 被 adc_cal_set 联动改写的 [adc_cal] 两段一趟落） */
(void)run_par_store_save();
/* [comm] 段落盘（道G task-9 通讯设置页）：同款脏位、每轮无条件，
App/task/iec104_serv.c
+2 -2
View File
@@ -23,7 +23,7 @@
#include "iec104_pts.h"
#include "net_socket.h"
#include "prot_set.h" /* 定值脏标志 peek（B7 落盘通知） */
#include "run_par.h" /* 运行参数脏 peek（卡 10 落盘通知，同款语义） */
#include "run_par.h" /* 运行参数脏 peek（运行参数段落盘通知，同款语义） */
#include "sys_clock.h"
#include "sys_log.h" /* task-19：对时成功落一条操作记录（SYSLOG_OPER） */
#include "sys_events.h"
@@ -432,7 +432,7 @@ void iec104_serv_task(void *argument) {
(void)osEventFlagsSet(sys_evtHandle, SYS_EVT_PROT_SET_SAVE);
}
/* 运行参数整定（C_SE 0x8020~0x8058 段）→ 通知属主落盘 config.ini
* （卡 10；peek 非消费 = 写盘失败天然重试，与上块 B7 语义完全同款） */
* （运行参数段；peek 非消费 = 写盘失败天然重试，与上块 B7 语义完全同款） */
if ((run_par_dirty_peek() != 0u) && (sys_evtHandle != NULL)) {
(void)osEventFlagsSet(sys_evtHandle, SYS_EVT_RUN_PAR_SAVE);
}
App/task/protect_task.c
+5 -5
View File
@@ -10,7 +10,7 @@
* ③ prot_elm_run()（phasor rms → 判据步进）+ 动作位图边沿日志；
* ④ 全局软压板 PS_GLOBAL_EN（104 YK12 两段式投退，B7）：退出 =
* 复位元件 + 停判据（与采样闭锁同构，独立边沿日志）；
* ⑤ 未标定闭锁（「数据可信」卡 5，M4 唯一新增行为变更）：UA/UN/IA
* ⑤ 未标定即闭锁（「数据可信」，M4 唯一新增行为变更）：UA/UN/IA
* 的 adc_cal VALID 位未全置位 → 工程量还只是 ADC 引脚电压
* （eng=0），拿去比二次值定值必然错判 → 复位元件 + 本拍不 eval。
* 默认构建（未标定）恒闭锁是**期望行为**：边沿用 DBG_INFO 而非
@@ -33,7 +33,7 @@
* adc_health 的 stall 位依赖 adcTask 每拍跑 check()，
* 节拍源一停本任务就再没有任何人判"数据新不新"，
* 而相量冻在最后一帧上还会被本任务继续用于判据
* v1.2 2026-10-25 DTU 项目组 卡 5：新增第⑤路「未标定闭锁」（adc_cal_flags
* v1.2 2026-10-25 DTU 项目组 未标定即闭锁：新增第⑤路「未标定闭锁」（adc_cal_flags
* VALID 口径，docs/任务规划/数据可信.md §4.3）：
* 采样恢复分支内、巡检/压板之前判；边沿 INFO 对
* + SOE_T_CAL_BLOCK/RESUME（不用 [ERR]：未标定是
@@ -56,7 +56,7 @@
#include "adc_input.h" /* adc_input_stm32_seq()：DMA 完成计数（中断侧写） */
#include "adc_health.h"
#include "adc_cal.h" /* 卡 5：adc_cal_prot_blocked() = 未标定闭锁判定单点（道F task-16） */
#include "adc_cal.h" /* 未标定即闭锁：adc_cal_prot_blocked() = 未标定闭锁判定单点（道F task-16） */
#include "console_log.h" /* dbg_console_writer_ready()：启动锚点行门控（B6） */
#include "prot_elm.h"
#include "prot_set.h"
@@ -88,7 +88,7 @@ static uint32_t s_prev_active; /* 上拍动作位图（边沿日志用） */
static uint32_t s_prev_pick; /* 上拍启动位图（「保护启动」记录边沿用，task-10） */
static uint8_t s_prev_hf_lock; /* 上拍采样闭锁态（边沿日志用） */
static uint8_t s_prev_plate_out; /* 上拍全局软压板退出态（边沿日志用，B7） */
static uint8_t s_prev_cal_lock; /* 上拍未标定闭锁态（边沿日志用，卡 5） */
static uint8_t s_prev_cal_lock; /* 上拍未标定闭锁态（边沿日志用，未标定即闭锁） */
/*
* 函数功能：动作位图变化沿日志 + SOE 投递（逐变化元件）
@@ -237,7 +237,7 @@ void protect_task(void *argument) {
SOE_ELM_NONE, 0u);
s_prev_hf_lock = 0u;
}
/* 卡 5：未标定闭锁——夹在「采样可信」与「巡检/压板」之间：
/* 未标定即闭锁——夹在「采样可信」与「巡检/压板」之间：
* eng=0 域（引脚电压）拿去比二次值定值必然错判（UV 尤甚），
* 标定 VALID 未全置位前整条判据链停走（「数据可信」§4.3 决策 1） */
/* 判定本体在 adc_cal_prot_blocked()（标定层单点，道F task-16）：本任务
App/util/boot_stats.h
+1 -1
View File
@@ -9,7 +9,7 @@
* 作者：道G log-maint-writer
* 创建日期：2026-10-27
* 修改记录：
* v1.0 2026-10-27 道G 创建（task-12「运行报告计数器」的数据面；UI 页面归 task-13）
* v1.0 2026-10-27 道G 创建（task-12「运行报告计数器」的数据面；UI 页面归 task-13 → 2026-10-28 已落地 ui_page_runreport.c）
*
* ┌── 四个数的分类台账（页面文案必须逐项挂类别，"不得含糊"是 UI 补齐清单的原文判据）──┐
* │ 上电次数 = **掉电保持**：本模块，落 RTC 用户 SRAM；口径见下面 BOOT_STATS_SEQ_* 一段 │