通用配置文件 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
@@ -31,11 +31,11 @@
 #define FF_USE_TRIM       0
 #define FF_FS_TINY        0
 #define FF_FS_EXFAT       0
-#define FF_FS_NORTC       1
+#define FF_FS_NORTC       0
 #define FF_NORTC_MON      1
 #define FF_NORTC_MDAY     1
 #define FF_NORTC_YEAR     2026
 #define FF_FS_NOFSINFO    0
 #define FF_FS_LOCK        0
-#define FF_FS_REENTRANT   0
+#define FF_FS_REENTRANT   1
 #define FF_FS_TIMEOUT     1000
@@ -0,0 +1,98 @@
+/*
+ * 模块名称：FatFs OS 依赖层 (ffsystem)
+ * 模块功能：FF_FS_REENTRANT 卷互斥钩子 + get_fattime 时间钩子（直引用系统墙钟）
+ * 适用平台：STM32F407ZGTx（MCU 端；模拟器端不编译 FatFS）
+ * 作者：王建锋
+ * 创建日期：2026-09-13
+ * 修改记录：
+ *     v1.0  2026-09-13  王建锋  初始版本：osMutex 卷锁（1s 超时）
+ *     v1.1  2026-09-13  王建锋  get_fattime 采用运行时间伪时（零 I2C 流量、无 RTC 依赖）
+ *     v1.2  2026-09-13  王建锋  get_fattime 移入独立适配文件 App/ff_time.c（与调试日志墙钟同源）；本文件仅留互斥钩子
+ *     v1.3  2026-09-13  王建锋  get_fattime 回归本文件并改为时间提供回调（App 启动时注册墙钟，
+ *                              本文件不引用 App 头文件，保持分层单向）
+ *     v1.4  2026-09-13  王建锋  get_fattime 改为直引用 sys_clock 墙钟（去掉回调注册机制；
+ *                              sys_clock 归 ④中间件层（App/util/），层内引用，无反向依赖）
+ */
+
+#include "ff.h"
+#include "cmsis_os2.h"
+#include "sys_clock.h"  /* 墙钟：层内中间件引用（sys_clock 归 ④中间件层，App/util/） */
+
+#if (!FF_FS_NORTC)
+
+/*
+ * 函数名称：FatFs 时间钩子 (get_fattime) —— 提供当前时间的 FAT 时间格式
+ * 入口参数：无
+ * 返 回 值：FAT 时间 ((year-1980)<<25 | month<<21 | day<<16 | hour<<11 | minute<<5 | second/2)；
+ *          墙钟无效时返回固定值（FF_NORTC 约定：2026-01-01 00:00:00）
+ * 限定条件：sys_clock_init() 已调用（App 启动时，早于 osKernelStart）
+ * 函数说明：1. 时间源 = 系统墙钟（与调试日志时间戳同源：开机 RTC 基准 + tick 推进，运行期零 I2C）
+ *           2. 文件 mtime 与日志时间戳一致；ff.h 声明，ff.c 在目录项创建 /
+ *              写后关文件 / f_mkfs 时调用
+ *           3. 本文件为 FatFs 指定的 OS 胶水文件——FatFs 与平台间的
+ *              唯一耦合点（互斥 + 时间）
+ */
+DWORD get_fattime(void)
+{
+    sd2506_time_t t;
+
+    if (sys_clock_get_time(&t) != 0 || t.year < 1980u) {
+        return (((DWORD)(FF_NORTC_YEAR - 1980u) << 25) |
+                ((DWORD)FF_NORTC_MON << 21) |
+                ((DWORD)FF_NORTC_MDAY << 16));
+    }
+
+    return ((DWORD)(t.year - 1980u) << 25)
+         | ((DWORD)t.month << 21)
+         | ((DWORD)t.day << 16)
+         | ((DWORD)t.hour << 11)
+         | ((DWORD)t.minute << 5)
+         | (DWORD)(t.second / 2u);
+}
+
+#endif /* !FF_FS_NORTC */
+
+#if FF_FS_REENTRANT
+
+/*
+ * FatFs 可重入同步对象：[0] = 系统锁，[1..FF_VOLUMES] = 卷锁
+ * 首次 f_mount 时创建；获取超时（FF_FS_TIMEOUT）时对应 f_* 返回 FR_TIMEOUT
+ * （优雅失败，由调用方下节拍重试，无死锁）
+ */
+static osMutexId_t s_fs_mutex[FF_VOLUMES + 1u];
+
+int ff_mutex_create(int vol)
+{
+    static const osMutexAttr_t s_attr = { "ffs", 0u, NULL, 0u };
+
+    if (s_fs_mutex[vol] != NULL) {
+        return 1;
+    }
+    s_fs_mutex[vol] = osMutexNew(&s_attr);
+    return (s_fs_mutex[vol] != NULL) ? 1 : 0;
+}
+
+void ff_mutex_delete(int vol)
+{
+    if (s_fs_mutex[vol] != NULL) {
+        (void)osMutexDelete(s_fs_mutex[vol]);
+        s_fs_mutex[vol] = NULL;
+    }
+}
+
+int ff_mutex_take(int vol)
+{
+    if (s_fs_mutex[vol] == NULL) {
+        return 1;  /* 锁对象未创建 = 无并发，视为已取得 */
+    }
+    return (osMutexAcquire(s_fs_mutex[vol], FF_FS_TIMEOUT) == osOK) ? 1 : 0;
+}
+
+void ff_mutex_give(int vol)
+{
+    if (s_fs_mutex[vol] != NULL) {
+        (void)osMutexRelease(s_fs_mutex[vol]);
+    }
+}
+
+#endif /* FF_FS_REENTRANT */