wandering1
007f6a0e2f
原「配置文件设计说明.md」是 2026-09 的规划文档（P1~P8 实施计划、D1~D15 决策表、差距调研、模块清单动作列、已终结的开放问题），与现在跑的系统 已有明显出入。改写成只描述当前状态的「配置文件设计.md」。 新文档 9 节：概览 / 文件格式（路径与容量、语法、出厂模板原文、值类型）/ 运行时机制（上电加载、外科手术式保存、2s 轮询与沉降、视图一致性守卫、 写者归属）/ 段与键表（8 段全满、注册顺序、接入新段模板、段回调）/ 接口（引擎 API、平台后端）/ 内存占用（编译期钉死的 9217B 暂存）/ 异常与恢复 / 双端差异 / 已知限制。 顺带修正一处事实错误：旧文档称 FTP STOR 是「写 .TMP 再 rename 原子更新」， 实际 lftpd receive_file 是原地覆写，已按代码现状改写。 旧二进制档（NCFG）的叙述按裁定从全仓移除：文档只描述当前状态，不再 交代旧版本兼容性。删掉网络配置说明 §3.2 整节（后续小节重排为 3.2~3.5）， 并清理 README / 架构总览 / 产品需求 / 部署环境等 11 处同类叙述。 同步： - 8 段注册、FTP 原地覆写、2s FAT mtime 粒度等数据更新进配置分层架构图， 重跑后与生成器逐字节一致，check_generated_fresh 里这条存量基线下架 - 全仓 24 处引用改用新文档名，旧节号逐条映射到新节号 - 文档规范 §7.1 变更记录例外名单 4 篇减为 3 篇（该档实际无变更记录表） 验证：48 个提交期钩子全通过；Keil 构建 0 错误 0 警告； check_doc_links / check_mermaid / check_generated_fresh 均通过。
29 lines
1.7 KiB
Markdown
29 lines
1.7 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` | **保护定值持久化胶水**：`/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` 替换，避免掉电损坏
|
||
- **自研代码禁用 C 库堆分配**：MicroLIB 堆仅 512B（`malloc` 必返回 NULL）
|
||
|
||
## 相关文档
|
||
|
||
- `docs/子系统设计/配置文件设计.md` — 完整设计（分层/解析/持久化）
|
||
- `docs/子系统设计/网络配置说明.md` — 网络段
|