增加网络配置界面

2026-09-10 11:36:33 +08:00
parent 020278d4e3
commit 8e1fd3b2b8
44 changed files with 2488 additions and 332 deletions
@@ -0,0 +1,46 @@
+/*
+ * 模块名称：Network Configuration Store (存储后端接口)
+ * 模块功能：net_cfg 加载/保存的磁盘读写抽象——每平台一份实现（互斥编译）：
+ *           MCU = NAND 上 FatFS 文件 /cfg/netcfg.bin（net_cfg_store_mcu.c）；
+ *           模拟器 = 工作目录本地文件 sim_netcfg.bin（net_cfg_store_sim.c）
+ * 适用平台：STM32F407ZGTx / PC 模拟器（接口共用；两端各编一份实现）
+ * 作者：王建锋
+ * 创建日期：2026-09-10
+ * 修改记录：
+ *     v1.0  2026-09-10  王建锋  创建初始版本
+ */
+
+#ifndef NET_CFG_STORE_H
+#define NET_CFG_STORE_H
+
+#include <stdint.h>
+
+#include <stddef.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/*
+ * 函数功能：读取配置文件
+ * 入口参数：p_buf - 接收缓冲（不可为 NULL）  uint8_t *
+ *           len   - 文件长度（须与磁盘格式一致，net_cfg.c 的 net_cfg_blob_t）  size_t
+ * 返回值：0 - 成功；-1 - 文件缺失/读失败  int
+ * 限定条件：后端存储可用（MCU：FatFS 已挂载；未挂载时实现直接返回 -1 即可）
+ */
+int net_cfg_store_read(uint8_t *p_buf, size_t len);
+
+/*
+ * 函数功能：写配置文件（不存在则创建，存在则覆盖）
+ * 入口参数：p_buf - 待写数据（不可为 NULL）  const uint8_t *
+ *           len   - 数据长度（须与磁盘格式一致）  size_t
+ * 返回值：0 - 成功；-1 - 写失败  int
+ * 限定条件：后端存储可用
+ */
+int net_cfg_store_write(const uint8_t *p_buf, size_t len);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* NET_CFG_STORE_H */