通用配置文件 P1–P3：设计文档、FS 并发 A+ 定案、FatFs 墙钟接入、cfg_file 双端引擎与 net_cfg 集成（旧档 NCFG 首启迁移）

2026-09-14 02:15:49 +08:00
parent cf2597f998
commit 97661415ca
29 changed files with 3076 additions and 359 deletions
@@ -0,0 +1,35 @@
+/*
+ * 模块名称：net_cfg_legacy
+ * 模块功能：旧版 NCFG 二进制配置一次性迁移到通用配置文件（net_cfg 旧磁盘格式
+ *          的拥有者：magic 'NCFG' + ver + CRC-16/MODBUS + 18B 字段）
+ * 适用平台：STM32F407ZGTx / PC 模拟器（两端共用；平台路径经 cfg_file_store 后端）
+ * 作者：王建锋
+ * 创建日期：2026-09-14
+ * 修改记录：
+ *     v1.0  2026-09-14  王建锋  创建初始版本（P3：net_cfg 引擎化，旧格式代码迁入）
+ */
+
+#ifndef NET_CFG_LEGACY_H
+#define NET_CFG_LEGACY_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/*
+ * 函数功能：旧 NCFG 二进制配置（28B）一次性迁移到通用配置文件
+ * 入口参数：无
+ * 返回值：0 - 迁移成功，或无旧文件/新文件已存在（正常）；
+ *         -1 - 迁移失败（新文件未生成）  int
+ * 限定条件：调用方须已注册 [network] 段（net_cfg_load 内部完成）
+ * 函数说明：新文件已存在 → 跳过（已迁移过）；旧文件有效 → 填网络配置 RAM
+ *          副本 → 经引擎生成新文件（带旧值）→ 删旧文件；旧文件缺失/无效 →
+ *          不动旧文件（留人工检查），新文件按工厂默认生成
+ */
+int net_cfg_legacy_migrate(void);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* NET_CFG_LEGACY_H */