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

fix(cfg): 配置热重载吞段缺陷修复 + 两点标定工具链与台架实测落档

Browse Source 
修复运行期改配置被打回出厂值的缺陷：cfg_file_poll() 按段循环复用同一
份读缓冲，而 s_parse() 通过 s_split_line()/s_key_value() 就地改写缓冲
（把换行与等号换成 NUL）。第一个段解析完，缓冲里已没有键值行，后续 7
个段静默保持出厂值；随后 run_par_store_save() 又把这份出厂值写回
config.ini，用户的标定值被永久覆盖。开机路径 cfg_file_load() 只解析一
轮，所以该缺陷长期不可见，只在运行中改配置时发作。

- s_parse() 改为非破坏性：入参 const char *，逐行 memcpy 到栈缓冲
  （CFG_LINE_TEST_MAX + 1）后再交给会破坏缓冲的解析子函数；超长行跳
  过（保存侧已拒绝落盘超长受管键行）。
- 新增 TC-CONFIG-063：同时改两段内容，断言第二个注册段也重载成功、
  含负值 INT 键存活，把「热重载吞段」钉成机器面。

新增两点标定台架工具链（test/host/）：
- cal_two_point.py：整数算术镜像 adc_cal_two_point()，支持单路模式与
  从执行卡 CALDATA 表批量求解（--from-doc），带合法带与零点自检拦截。
- cal_write.py：复用 iec104_master 作库，经 104 定值段写 r 后写 b 并
  读回校验，是所有写入的唯一入口。

adc_task 的 meas: 心跳行精度提到 4 位小数，标定读数需要。

文档：新增《采样数据校正全流程》（端到端导航）与《ADC 两点标定执行
流程》（台架执行卡，含 CALDATA 可填表）；ADC通道映射说明新增 §7.3 台
架实测结果（UA 554.687914、IA 29.634259，出厂默认值保持不变）；配置
文件设计说明新增解析器契约 v1.19；采集与算法层设计说明 §13 系列与
README 索引同步。

台架实测：UA r=554.687914（出厂 1000.0 偏大 1.80 倍，根因是接线分压
使 PT 一次侧只拿到一半电压，实测与参数算定 606.06 只差 8.5%）、IA
r=29.634259（与出厂 29.4118 只差 0.76%，反证链路未算错）。UN 按用户
裁定本轮不标定，保护闭锁（vl=0x11）是预期行为，未伪造 VALID。

同时入库 .dsh/roles 角色定义（原被 .gitignore 挡住）。
This commit is contained in:
Wanderingss
2026-11-13 01:35:58 +08:00
parent 18c087500a
commit 1355dbe1b1
29 changed files with 2470 additions and 201 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/README.md
+4 -1
View File
@@ -112,6 +112,7 @@ docs/
| [`采集与算法层设计说明.md`](算法/采集与算法层设计说明.md) | **`App/algo/` 的现状设计说明**：语义取数与有效性判定、全周傅氏相量采样环/相量/测频、保护判据定值模型与元件框架的契约、关键机制（双区原子切换、乒乓半区、自适应测频窗、定值封存-自检-闭锁）、精度判据 J1~J6 与资源足迹；**§13 = 标定折算**（码值→工程量、三态可用性、未标定即闭锁、遥测快照、六轮动态验证判据、已定案的前置决策） |
| [`继电保护功能复现规划.md`](算法/继电保护功能复现规划.md) | **保护功能复现规划**：把参考系统（CLS100）保护链路映射到本项目（STM32F4）的分层功能/性能/参数清单、平台适配（「双转换器无共同采样触发」等）与分阶段路线图 |
| [`采样有效性校验设计说明.md`](算法/采样有效性校验设计说明.md) | **`App/algo/adc_health.c` 单文件深设计**：四类判据（静默 / 丢帧 / 序号倒退 / 错误计数增量）的判据推导与 100 ms 门限依据、电平-锁存-事件三种位语义与位号对齐、闭锁与看门狗兜底的责任划分、观测盲区、主机侧验证分工与现场判读手册（含三张配图生成器） |
| [`采样数据校正全流程.md`](算法/采样数据校正全流程.md) | **读者入口**：按一帧数据的真实流向，把端子→码值→三维折算（k/b/r）→相量/测频/遥测快照→104·UI·保护·录波串成一条线；含整定落盘、两点标定现状（板上无一键标定、台架手工路径见 `docs/测试说明/专项验证/ADC两点标定执行流程.md`）、三个判定（VALID/CLIPPED/eng 互不派生）；细节归各属主文档 |
---
@@ -156,7 +157,8 @@ docs/
| 文档 | 内容 |
|---|---|
| [`ADC前端注入验证流程.md`](测试说明/专项验证/ADC前端注入验证流程.md) | **ADC 前端与两片转换器的台架注入验证**（已知电压注入验证的执行侧，实测证据 → `docs/硬件平台/ADC通道映射说明.md` §8.1）：注入点清单 / 期望码值表 / 零点·线性·映射·极性·节奏五步（每步自带现场记录表，边做边填）；**不需示波器与信号源**，一块万用表即可 |
| [`ADC前端注入验证流程.md`](测试说明/专项验证/ADC前端注入验证流程.md) | **ADC 前端与两片转换器的台架注入验证**（已知电压注入验证的执行侧，实测证据 → `docs/硬件平台/ADC通道映射说明.md` §8.1）：两轮——直流轮（注入点清单 / 期望码值表 / 零点·线性·映射·极性·节奏五步，每步自带现场记录表，**一块万用表即可**）、交流轮（幅值/波形/相位/测频/削顶/谐波六轮执行卡）；**两点标定轮已独立成篇** → `docs/测试说明/专项验证/ADC两点标定执行流程.md` |
| [`ADC两点标定执行流程.md`](测试说明/专项验证/ADC两点标定执行流程.md) | **UA/UN/IA 两点标定的执行卡**：开工拍板（保护口径 ≤3~5 %、量级 5 V/50 V 与 0.5 A/2 A 安全裁定、继保仪 ≥0.1 级）→ `meas:` 行三点读数填进文档内 `CALDATA` 标记表 → `test/host/cal_two_point.py --from-doc` 批量求解（`cal_two_point.py` 亦支持单路手填）→ `test/host/cal_write.py` 经 104 定值段 0x8050~/0x8048~ 写入置 VALID 自动落盘 → 三路齐解除保护闭锁（解卡时序红线与回写位置都在卡里）；判据属主 `docs/算法/采集与算法层设计说明.md` §13.13 与 `docs/硬件平台/ADC通道映射说明.md` §7.2；**2026-11-12 实跑结果**（UA / IA 已标定、UN 未标 → 保护仍闭锁）登记在 `docs/硬件平台/ADC通道映射说明.md` §7.3 |
| [`启动日志原子性复验流程.md`](测试说明/专项验证/启动日志原子性复验流程.md) | **控制台整行独占 / 崩溃遗言原子性**这类**行级完整性**判据的固定动作与口径（`docs/子系统设计/控制台单写者日志设计说明.md` 的验收侧：那边讲怎么修，这边讲怎么证明修好了、以及为什么"标记全中"不等于"日志没坏"） |
| [`故障录波板级到场轮执行手册.md`](测试说明/专项验证/故障录波板级到场轮执行手册.md) | **录波剩余台架判据的执行手册**（判据属主是 `docs/子系统设计/故障录波设计说明.md` §10，这里只写"人做什么、说哪句话、会看到什么"）：四幕（枚举埋点修复 / 注量对表 / 保护触发对时刻（src=P）含两个用户决定 / bench 自抓占卷）各自标清到场与否，配到场检查清单、现场记录表与收工还原清单 |
| [`链路延迟测试说明.md`](测试说明/专项验证/链路延迟测试说明.md) | 网络链路时延分段定义、判定基线、执行流程 |
@@ -266,6 +268,7 @@ docs/
| [`任务规划/`](任务规划/README.md) | **两个文件**：`README.md` = 全项目推进顺序（唯一权威）；`登记簿.md` = V0.1 硬件缺陷 → V0.2 改版要求。其余待办跟着所属模块走（各文档「已知限制 / 重开条件」节）：采集数据可信度 → `docs/算法/采集与算法层设计说明.md` §13、台阶图 → `docs/硬件平台/ADC通道映射说明.md` §9、RS-485 → `docs/产品需求/产品需求设计文档.md` §5.10 |
| `硬件平台/` | 网表详细分析报告与语义图（V0.0 / V0.1）；**[`ADC通道映射说明.md`](硬件平台/ADC通道映射说明.md)——V0.1 十七路 ADC 语义/网名/通道号权威映射表（固件取数、UI 显示、自检注入以此为准），含 §7 链路四段口径、§8 注入实测记录与 §9 数据可信五级台阶/波次退出判据** |
| `芯片手册/` | 外部芯片数据手册转录（CH395F / GD5F2GQ5UE / SD2506 / TPAFE5160 / RTL8305NBI 等） |
| [`嵌入式采集算法工程师_通用知识体系与行业标准.md`](嵌入式采集算法工程师_通用知识体系与行业标准.md) | **外部知识底座**（不是本仓设计说明）：采样量化理论 / DFT 与测频 / 保护判据 / 定点化 / 标定方法论 / 常见陷阱 / 验证指标 / 教材与标准索引；读它补背景，本仓落地口径仍以 `docs/算法/采集与算法层设计说明.md` 为准 |
| `images/` | 文档技术配图（`.svg` 产物，由 `tools/arch_diagram/`、`tools/refgraph/` 生成） |
---