增加网络配置界面

2026-09-10 11:36:33 +08:00
parent 020278d4e3
commit 8e1fd3b2b8
44 changed files with 2488 additions and 332 deletions
@@ -0,0 +1,71 @@
+/*
+ * 模块名称：Network Configuration Store (MCU 后端)
+ * 模块功能：net_cfg 存储后端——NAND 上 FatFS 文件 /cfg/netcfg.bin
+ *          （目录 /cfg 首次写入时自动创建；卷由 defaultTask 挂载并广播
+ *          SYS_EVT_STORAGE_READY 后方可读写）
+ * 适用平台：STM32F407ZGTx
+ * 作者：王建锋
+ * 创建日期：2026-09-10
+ * 修改记录：
+ *     v1.0  2026-09-10  王建锋  创建初始版本
+ */
+
+/* 头文件包含区 */
+#include "net_cfg_store.h"
+
+#include "ff.h"
+
+/* 静态变量定义区 */
+
+static const char s_path[] = "/cfg/netcfg.bin";
+
+/* 函数定义区 */
+
+/*
+ * 函数功能：读取配置文件
+ * 入口参数：p_buf - 接收缓冲（不可为 NULL）  uint8_t *
+ *           len   - 文件长度  size_t
+ * 返回值：0 - 成功；-1 - 文件缺失/读失败  int
+ * 限定条件：FatFS 已挂载（未挂载时 f_open 返回 FR_NO_SYSTEM，转 -1）
+ */
+int net_cfg_store_read(uint8_t *p_buf, size_t len) {
+    FIL f;
+    FRESULT fr;
+    UINT br = 0u;
+
+    if (p_buf == NULL) {
+        return -1;
+    }
+    fr = f_open(&f, s_path, FA_READ);
+    if (fr != FR_OK) {
+        return -1;
+    }
+    fr = f_read(&f, p_buf, (UINT)len, &br);
+    (void)f_close(&f);
+    return (fr == FR_OK && br == (UINT)len) ? 0 : -1;
+}
+
+/*
+ * 函数功能：写配置文件（目录不存在则创建；文件覆盖写）
+ * 入口参数：p_buf - 待写数据（不可为 NULL）  const uint8_t *
+ *           len   - 数据长度  size_t
+ * 返回值：0 - 成功；-1 - 写失败  int
+ * 限定条件：FatFS 已挂载
+ */
+int net_cfg_store_write(const uint8_t *p_buf, size_t len) {
+    FIL f;
+    FRESULT fr;
+    UINT bw = 0u;
+
+    if (p_buf == NULL) {
+        return -1;
+    }
+    (void)f_mkdir("/cfg");    /* 目录已存在（FR_EXIST）不影响后续建文件 */
+    fr = f_open(&f, s_path, FA_WRITE | FA_CREATE_ALWAYS);
+    if (fr != FR_OK) {
+        return -1;
+    }
+    fr = f_write(&f, (const void *)p_buf, (UINT)len, &bw);
+    (void)f_close(&f);
+    return (fr == FR_OK && bw == (UINT)len) ? 0 : -1;
+}