wandering1
1fe163ba7b
- prot_set：新增 PS_GLOBAL_EN（枚举尾追加）；值区双缓冲 + 单字交换， prot_set_set_sealed 原子写+封存；selfcheck 改 seqlock 式复核 （提交撞见 = 本轮跳过）→ 收口 B5 登记的 µs 级误锁窗口 - 持久化：新增 App/cfg/prot_set_store.c/h，/prot_set.bin blob （magic+版本+计数+值区+sum32 正/反码对，144 B）走 cfg_store_write_atomic； uvprojx 注册 + 模拟器豁免点名（check_registration 同步） - 写路径：C_SE/YK12 执行段置脏 → iec104Task 投递 SYS_EVT_PROT_SET_SAVE （事件位 bit7）→ defaultTask（配置引擎属主）落盘，写失败脏回置 = 天然 重试；装载 = STORAGE_READY 屏障前整表原子 parse（损坏保出厂默认 + 自检留痕 prot set corrupt；文件缺失 = 首启静默） - YK12 转真：两段式（选择段校验 DPC / 执行段 set_sealed），protectTask 下一拍读退出态 → 复位元件 + 停判据（global plate OUT/IN 边沿日志）； 本地定值项 comm_addr=0 显式不可寻址（防 IOA=0 误命中首个本地项） - 单测：prot_set 63 断言（+33：软压板/原子写/脏握手/blob 往返/损坏拒绝/ 伪造自洽越界对抗样本）、iec104 94 断言（+7：YK12 两段转真/置脏/本地项 C_RD EVI） - 文档：IEC104 设计说明 §3.3/§3.4/§7、保护规划 §3.5 L5-1/§7 P4/变更记录、 App/algo 与 App/cfg README、W1 任务卡 B7→🟦（台架腿 🔴 待窗口，随 B6 同窗） - 验证：@build 0 错 0 警（Code=205500，ZI +280 = 双缓冲+blob 缓冲）； ci_local 全绿（L0 27 钩子 + L0.5 13 套件 826 断言）；ram_baseline 台账 受管区与内存快照已同步；19 个改动文件无 BOM / LF / 零乱码
31 lines
1.9 KiB
Markdown
31 lines
1.9 KiB
Markdown
# App/cfg/ — 配置引擎
|
||
|
||
> **`/config.ini` 配置引擎**：分层解析、持久化（原子写）。
|
||
> 属主 = **defaultTask**（单任务收敛，静态态）；其它任务不得直接触碰。
|
||
|
||
## 文件一览
|
||
|
||
| 文件 | 作用 |
|
||
|---|---|
|
||
| `cfg_file.c/h` | **配置引擎核心**：解析 / 查询 / 保存 / 2s 周期 `cfg_file_poll` |
|
||
| `cfg_file_store.h` | **存储后端抽象接口**（MCU=FreeRTOS 堆 / 模拟器=宿主堆，共享核心零分配符号） |
|
||
| `cfg_file_store_mcu.c` | **MCU 端后端实现**：`/config.ini`（临时名由目标路径同目录推导 + `f_rename` 原子写） |
|
||
| `prot_set_store.c/h` | **保护定值持久化胶水（B7）**：`/prot_set.bin` blob 读写（blob 格式/校验/原子装载在 `App/algo/prot_set.c` 纯逻辑层）；装载 = storage bring-up（屏障前），落盘 = defaultTask 消费 `SYS_EVT_PROT_SET_SAVE` |
|
||
|
||
## 设计要点
|
||
|
||
- **单任务收敛**：`cfg_file` 为静态态，只有 defaultTask 操作；UI 保存请求经
|
||
`SYS_EVT_CFG_SAVE` 事件唤醒 defaultTask 执行（netTask/uiTask 不得直接调用）；
|
||
定值落盘同构——iec104Task 只置事件位（`SYS_EVT_PROT_SET_SAVE`），不碰文件系统
|
||
- **零分配共享核心**：核心逻辑不含任何分配符号，动态内存收进平台后端
|
||
（`cfg_store_alloc/free`：MCU→`pvPortMalloc`，模拟器→宿主堆）
|
||
- **原子写**：写 `/config.TMP` 后 `f_rename` 替换，避免掉电损坏
|
||
- **旧档迁移已删除（2026-10-10）**：旧格式 `/cfg/netcfg.bin` 不再读取——存在则被忽略（不读、
|
||
不删、不迁移），配置回落工厂默认；`net_cfg_legacy.c/h` 与 `cfg_store_legacy_path()` 已移除
|
||
- **自研代码禁用 C 库堆分配**：MicroLIB 堆仅 512B（`malloc` 必返回 NULL）
|
||
|
||
## 相关文档
|
||
|
||
- `docs/子系统设计/配置文件设计说明.md` — 完整设计（分层/解析/持久化）
|
||
- `docs/子系统设计/网络配置说明.md` — 网络段
|