docs(cfg): 配置设计档重写为现状版，删除旧二进制档叙述
原「配置文件设计说明.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 均通过。
This commit is contained in:
+3
-3
@@ -18,7 +18,7 @@ simulator/
|
||||
│ ├── sim_port.c / .h # 显示/输入端口（SDL 窗口 + 键盘 + mono 主题），替代 MCU 端 ui_port.c
|
||||
│ ├── net_socket_sim.c # 网络后端：Winsock 实现 net_* BSD API，替代 MCU 端 net_socket.c（CH395F）
|
||||
│ ├── ui_net_sink_backend_sim.c # RemoDispBus 平台 backend：取帧/注键（配合共享 ui_net_sink.c）
|
||||
│ └── cfg_file_store_sim.c # 配置文件存储后端：本地 sim_config.ini（旧档 sim_netcfg.bin 已废弃，不读不删）
|
||||
│ └── cfg_file_store_sim.c # 配置文件存储后端：本地 sim_config.ini
|
||||
├── lv_conf.h # 模拟器专用 LVGL 配置（与 MCU 端 Lib/lv_conf.h 相互独立）
|
||||
├── i1_to_png.py # 截图转 PNG：把 --screenshot 的 I1(1bpp) 原始位图转成 PNG（见 §3.5）
|
||||
├── tests/ # 无头回归脚本 + 本地黄金参考（见 §3.6，流程文档 docs/UI设计/UI_自动化测试流程.md）
|
||||
@@ -47,7 +47,7 @@ simulator/
|
||||
| `sim/sim_port.c` | 创建 SDL 窗口显示设备（`lv_sdl_window_create`）、初始化 **mono 主题**（`lv_theme_mono_init`，1bpp 必需）、创建键盘输入设备并挂默认输入组。**不创建鼠标**（纯键盘导航，与 MCU 端 keypad 一致）。`sim_port_get_screen_mono()` 经 `SDL_RenderReadPixels` 读回屏幕像素转 1bpp，供推流取帧 |
|
||||
| `sim/net_socket_sim.c` | 网络后端：Winsock 实现 `net_*` BSD Socket API（`socket`/`bind`/`listen`/`accept`/`recv`/`send`/`close`），替代 MCU 端 `Drivers/BSP/NET/net_socket.c`（CH395F） |
|
||||
| `sim/ui_net_sink_backend_sim.c` | RemoDispBus 平台 backend：`ui_net_sink_get_lcdmem`→`sim_port_get_screen_mono`、`ui_net_sink_inject_key`→`lv_group_send_data`；配合**共享** `Drivers/BSP/UI/ui_net_sink.c`（协议服务端，双端同一份，TCP 7003） |
|
||||
| `sim/cfg_file_store_sim.c` | 通用配置文件存储后端：本地文件 `sim_config.ini`（`fopen`/`rename` 原子写），替代 MCU 端 `App/cfg/cfg_file_store_mcu.c`（FatFS）；旧档 `sim_netcfg.bin` **已废弃**——不读、不删、不迁移（2026-10-10） |
|
||||
| `sim/cfg_file_store_sim.c` | 通用配置文件存储后端：本地文件 `sim_config.ini`（`fopen`/`rename` 原子写），对应 MCU 端 `App/cfg/cfg_file_store_mcu.c`（FatFS） |
|
||||
| `lv_conf.h` | 模拟器专用 LVGL 配置。与 MCU 端 `Lib/lv_conf.h` 的关键差异见 §3.3 |
|
||||
| `dbg_log.h` | MCU 版 `dbg_log.h` 依赖 `sys_clock.h`（RTC 时间戳），PC 无法编译。此 stub 把 `DBG_INFO/ERROR/DEBUG` 映射到 `printf`；因 `simulator/` 在 include 路径最前，**优先生效**覆盖 MCU 版 |
|
||||
| `build_sim.bat` / `build_sim.ps1` | 一键构建入口：vswhere 探测本机 VS 大版本（16=2019 / 17=2022 / 18=2026，取已装最高）→ 映射 CMake 生成器；`build/` 缓存生成器与本机不符（换机/升级 VS）时自动删除重建（带重试，抗文件锁）。**构建入口一律走它，文档/命令中勿写死生成器版本**；`.bat` 仅负责绕过 PowerShell 执行策略并转交 `.ps1` |
|
||||
@@ -125,7 +125,7 @@ LVGL 场景（同一份 ui_menu.c）
|
||||
2. **CMake + MSVC**：`build_sim.ps1` 按本机 VS 版本自动选生成器（16=2019 / 17=2022 / 18=2026；不同机器版本不同，**勿写死**），`-A x64`；MSVC 下加 `/utf-8` 消除中文注释的 C4819 警告
|
||||
3. **共享 UI 源码**：`ui_menu.c` / `ui_font_cn_12.c` 直接编译 `Drivers/BSP/UI/` 原件，改一处两端同时生效
|
||||
4. **纯键盘导航**：不创建鼠标/触摸设备，与 MCU 端 keypad 操作语义一致（↑↓←→ / Enter / Esc）
|
||||
5. **UI 为主**：不含 CH395F 网络 / NAND 存储 / ADC 等硬件业务；通用配置文件引擎（`cfg_file`）与 `net_cfg` 核心为纯软件，配置加载/保存可在模拟器离线验证（`sim_config.ini`；旧档 `sim_netcfg.bin` 已废弃、不参与）
|
||||
5. **UI 为主**：不含 CH395F 网络 / NAND 存储 / ADC 等硬件业务；通用配置文件引擎（`cfg_file`）与 `net_cfg` 核心为纯软件，配置加载/保存可在模拟器离线验证（`sim_config.ini`）
|
||||
|
||||
---
|
||||
|
||||
|
||||
+2
-2
@@ -37,7 +37,7 @@
|
||||
*
|
||||
* 配置轮询自检模式（无窗口、进程内闭环、退出码 0=PASS / 非0=FAIL）：
|
||||
* lvgl_sim.exe --cfgtest
|
||||
* 验证链：net_cfg_load（只读 INI；旧 NCFG 档迁移已于 2026-10-10 删除）
|
||||
* 验证链：net_cfg_load（只读 INI；旧档迁移已于 2026-10-10 删除）
|
||||
* → poll 建基线 → 伪造外部编辑
|
||||
* （原子写新文档，等价 FTP 上传/文本编辑器）→ poll 两次（4s 沉降）
|
||||
* → 断言 RAM 副本已按新文件重载
|
||||
@@ -1407,7 +1407,7 @@ static int run_cfgtest_scenarios(void) {
|
||||
|
||||
setvbuf(stdout, NULL, _IONBF, 0);
|
||||
|
||||
(void)net_cfg_load(); /* 加载 INI（含 [network] 段注册；旧 NCFG 档不再读取） */
|
||||
(void)net_cfg_load(); /* 加载 INI（含 [network] 段注册；旧档不再读取） */
|
||||
|
||||
cfg_file_poll(); /* 第 1 次 poll：建立变更基线 */
|
||||
|
||||
|
||||
@@ -144,7 +144,7 @@ const char *cfg_store_tmp_path(void) {
|
||||
|
||||
/*
|
||||
* 旧版遗留档 getter（cfg_store_legacy_path）已于 2026-10-10 随旧档迁移
|
||||
* net_cfg_legacy 一并删除：旧格式 sim_netcfg.bin 不再读取
|
||||
* net_cfg_legacy 一并删除：旧格式档不再读取
|
||||
*/
|
||||
|
||||
/*
|
||||
|
||||
@@ -1139,9 +1139,9 @@ def main():
|
||||
|
||||
# 回归一律在空临时目录里跑（原因见 run_sim 的说明）。调用目录里残留的配置档
|
||||
# 不再影响像素，只提示一句，便于手工跑 lvgl_sim 的人排查。
|
||||
# （旧 sim_netcfg.bin 时代的"删除残留"做法已作废：旧档迁移 2026-10-10 删除，
|
||||
# （旧二进制档时代的"删除残留"做法已作废：旧档迁移 2026-10-10 删除，
|
||||
# 且真正会污染结果的是 --cfgtest 留下的 sim_config.ini，删别人的档不合适）
|
||||
for leftover in ("sim_config.ini", "sim_netcfg.bin"):
|
||||
for leftover in ("sim_config.ini", "sim_netcfg.bin"): # 后者为旧档遗留名，仍需清理
|
||||
if (Path.cwd() / leftover).exists():
|
||||
print("[提示] 当前目录存在 %s（本脚本不读它；手工运行 lvgl_sim 时留意，"
|
||||
"--cfgtest 会伪造 4000 B 配置档）" % leftover)
|
||||
|
||||
Reference in New Issue
Block a user