就绪屏障与配置引擎重构，新增串口助手、V0.0网表分析报告及芯片手册，同步更新文档

Drivers/BSP/NETCFG/net_cfg.h

@@ -1,11 +1,12 @@
 /*
  * 模块名称：Network Configuration (NET CFG)
  * 模块功能：网络参数配置（IP/掩码/网关/MAC）——双端共享核心：RAM 配置副本 +
- *           工厂默认 + 加载/保存编排 + 实际 MAC 影子；存储经 cfg_file 通用
- *           配置文件引擎（INI [network] 段：ip/mask/gw/mac；MCU = NAND 上
- *           /config.ini，模拟器 = sim_config.ini）；MAC 全零哨兵 = 不覆盖芯片
- *           内置 MAC；保存后下次上电生效（每次上电 netTask 在 net_init 前
- *           加载）或 poll 4s 沉降后生效
+ *           工厂默认 + 加载/保存编排 + 实际 MAC 影子 + 跨任务保存请求交接；
+ *           存储经 cfg_file 通用配置文件引擎（INI [network] 段：ip/mask/gw/mac；
+ *           MCU = NAND 上 /config.ini，模拟器 = sim_config.ini）；MAC 全零哨兵
+ *           = 不覆盖芯片内置 MAC。cfg_file 引擎为静态单任务设计，调用收敛于
+ *           单一属主任务（MCU = defaultTask：就绪屏障前加载 / 保存执行 / 2s
+ *           poll；模拟器 = 主循环）；UI 保存只投递请求，netTask 只读 RAM 副本
  * 函数说明：旧版 NCFG 二进制格式（magic+ver+CRC-16+18B 字段）归 net_cfg_legacy，
  *           首启一次性迁移进通用配置文件
  * 适用平台：STM32F407ZGTx / PC 模拟器（两端共用）
@@ -14,6 +15,8 @@
  * 修改记录：
  *     v1.0  2026-09-10  王建锋  创建初始版本
  *     v1.1  2026-09-14  王建锋  存储迁移至 cfg_file 引擎（INI [network] 段）
+ *     v1.2  2026-09-15  王建锋  保存改跨任务交接（request/state/run + 通知回调）；
+ *                               引擎属主明确为 defaultTask（P1-3 竞态修复）
  */
 
 #ifndef NET_CFG_H
@@ -42,8 +45,9 @@ typedef struct {
  * 函数功能：从存储加载网络配置到 RAM 副本
  * 入口参数：无
  * 返回值：恒 0（RAM 恒有效：文件缺失/损坏回退工厂默认）  int
- * 限定条件：MCU 端应在存储就绪（SYS_EVT_STORAGE_READY）后调用；
- *          未就绪时文件读失败，自动回退工厂默认（不阻塞网络启动）
+ * 限定条件：由配置引擎属主任务调用（MCU = defaultTask，置位
+ *          SYS_EVT_STORAGE_READY 前；模拟器 = 主循环启动期）；文件读失败
+ *          自动回退工厂默认（不阻塞网络启动）
  * 函数说明： 1. 注册 [network] 段（幂等）
  *           2. 文件缺失 → 先迁旧档 NCFG（有效 → 旧值物化进新文件），否则
  *              生成出厂模板
@@ -56,10 +60,10 @@ int net_cfg_load(void);
  * 函数功能：保存当前 RAM 配置到存储（Flash 持久化）
  * 入口参数：无
  * 返回值：0 - 成功；-1 - 写失败  int
- * 限定条件：MCU 端应在存储就绪后调用
+ * 限定条件：仅配置引擎属主任务上下文调用（MCU = defaultTask；模拟器 = 主循环）；
+ *          跨任务保存请用 net_cfg_save_request 投递
  * 函数说明：经 cfg_file 引擎写盘（外科手术式保存：保留注释/未知内容，
- *          临时文件 + 原子改名）；下次上电（netTask 在 net_init 前加载）
- *          或 poll 4s 沉降后生效
+ *          临时文件 + 原子改名）；属主任务执行，成功后触发"立即应用"
  */
 int net_cfg_save(void);
 
@@ -87,11 +91,73 @@ void net_cfg_set_apply_cb(net_cfg_apply_cb_t cb);
  * 入口参数：无
  * 返回值：无
  * 限定条件：无（未注册回调时空操作）
- * 函数说明：UI"网口设置"页保存行写盘成功后调用；真正生效由平台回调完成
- *          （MCU：netTask 重建网络，无需重启）
+ * 函数说明：保存写盘成功后由属主任务调用（MCU：defaultTask）；真正生效
+ *          由平台回调完成（MCU：netTask 重建网络，无需重启）
  */
 void net_cfg_request_apply(void);
 
+/*
+ * 保存请求交接状态（UI 保存行显示）
+ *   IDLE - 尚无保存（显示 ENTER）
+ *   WAIT - 保存进行中：请求已投递未执行 / 属主任务写盘中（显示 WAIT）
+ *   OK   - 最近一次保存成功（显示 OK）
+ *   FAIL - 最近一次保存失败（显示 ERR）
+ */
+#define NET_CFG_SAVE_ST_IDLE   0u
+#define NET_CFG_SAVE_ST_WAIT   1u
+#define NET_CFG_SAVE_ST_OK     2u
+#define NET_CFG_SAVE_ST_FAIL   3u
+
+/*
+ * 函数功能：投递"保存网络配置"请求（跨任务交接的投递端）
+ * 入口参数：无
+ * 返回值：恒 0  int
+ * 限定条件：任意任务上下文（UI 保存行）；新值须已落 RAM 副本（net_cfg_set）
+ * 函数说明：只置"待保存"标志 + 经平台回调唤醒属主任务（MCU：置
+ *          SYS_EVT_CFG_SAVE 事件）；写盘与"立即应用"由属主任务执行
+ *          （net_cfg_save_run），UI 不直接触碰配置文件引擎
+ */
+int net_cfg_save_request(void);
+
+/*
+ * 函数功能：取保存请求交接状态（供 UI 保存行显示）
+ * 入口参数：无
+ * 返回值：NET_CFG_SAVE_ST_IDLE / _WAIT / _OK / _FAIL  int
+ * 限定条件：任意任务上下文（单字节读取，无撕裂）
+ */
+int net_cfg_save_state(void);
+
+/*
+ * 函数功能：执行待处理的保存请求（配置文件引擎属主任务）
+ * 入口参数：无
+ * 返回值：0 - 无待处理请求或保存成功；-1 - 写盘失败  int
+ * 限定条件：仅配置引擎属主任务上下文（MCU = defaultTask；模拟器 = 主循环）
+ * 函数说明：有待处理请求 → 先清标志（写盘期间的新请求重位置位，下轮再
+ *          执行，不丢失）→ net_cfg_save() 写盘 → 成功置 OK 并触发"立即
+ *          应用"（netTask 重建网络）；失败置 FAIL（不触发应用，网络保持
+ *          原配置）
+ */
+int net_cfg_save_run(void);
+
+/*
+ * "保存请求"通知回调类型：平台挂钩（可选）
+ * 入口参数：无
+ * 返回值：无
+ * 函数说明：MCU 端由 defaultTask 注册——置 SYS_EVT_CFG_SAVE 事件立即唤醒
+ *          属主任务执行写盘；模拟器单线程无需唤醒，不注册（空操作）。
+ *          经回调而非直接调用，避免 NETCFG（驱动层）反向依赖 App 层。
+ */
+typedef void (*net_cfg_save_req_cb_t)(void);
+
+/*
+ * 函数功能：注册"保存请求"通知回调
+ * 入口参数：cb - 回调函数（NULL = 注销）  net_cfg_save_req_cb_t
+ * 返回值：无
+ * 限定条件：应用启动早期注册一次即可
+ * 函数说明：见 net_cfg_save_req_cb_t
+ */
+void net_cfg_set_save_req_cb(net_cfg_save_req_cb_t cb);
+
 /*
  * 函数功能：取 RAM 配置副本（只读指针）
  * 入口参数：无