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

Drivers/BSP/NETCFG/net_cfg.c

@@ -10,6 +10,8 @@
  * 修改记录：
  *     v1.0  2026-09-10  王建锋  创建初始版本
  *     v1.1  2026-09-14  王建锋  存储迁移至 cfg_file 引擎（INI）；旧 NCFG 代码移至 net_cfg_legacy
+ *     v1.2  2026-09-15  王建锋  保存改跨任务交接（request/state/run + 通知回调）；
+ *                               引擎属主 = defaultTask（P1-3 竞态修复）
  */
 
 /* 头文件包含区 */
@@ -49,6 +51,9 @@ static net_cfg_t s_cfg = {
 static uint8_t s_active_mac[6];    /* 芯片实际 MAC 影子（netTask 回写） */
 static uint8_t s_active_valid;     /* 影子有效标志（0 = 尚未回写） */
 static net_cfg_apply_cb_t s_apply_cb;   /* "立即应用"平台回调（未注册 = 空操作） */
+static volatile uint8_t s_save_pending; /* 1 = 有待执行保存请求（UI 投递/属主执行） */
+static volatile uint8_t s_save_result;  /* 最近一次保存结果：0 = 无；1 = 成功；2 = 失败 */
+static net_cfg_save_req_cb_t s_save_req_cb;   /* "保存请求"平台通知（未注册 = 空操作） */
 
 /* 工厂默认（引擎注册 p_defaults 指向；与 s_cfg 初值共用宏单一来源） */
 static const net_cfg_t s_defaults = {
@@ -127,7 +132,9 @@ static bool s_mac_is_zero(const uint8_t *p_mac) {
  * 函数功能：从存储加载网络配置到 RAM 副本
  * 入口参数：无
  * 返回值：恒 0（RAM 恒有效：文件缺失/CRC 错回退工厂默认）  int
- * 限定条件：MCU 端应在存储就绪后调用；未就绪时文件读失败自动回退
+ * 限定条件：由配置引擎属主任务调用（MCU = defaultTask，置位
+ *          SYS_EVT_STORAGE_READY 前；模拟器 = 主循环启动期）；文件读失败
+ *          自动回退工厂默认（不阻塞网络启动）
  * 函数说明：见 net_cfg.h 同名函数说明
  */
 int net_cfg_load(void) {
@@ -151,10 +158,9 @@ int net_cfg_load(void) {
  * 函数功能：保存当前 RAM 配置到存储
  * 入口参数：无
  * 返回值：0 - 成功；-1 - 写失败  int
- * 限定条件：MCU 端应在存储就绪后调用
+ * 限定条件：仅配置引擎属主任务上下文调用（MCU = defaultTask；模拟器 = 主循环）
  * 函数说明：经 cfg_file 引擎写盘（外科手术式保存：保留注释/未知内容，
- *          临时文件 + 原子改名）；下次上电（netTask 在 net_init 前加载）
- *          或 poll 4s 沉降后生效
+ *          临时文件 + 原子改名）；跨任务场景请投递 net_cfg_save_request
  */
 int net_cfg_save(void) {
     int r;
@@ -193,6 +199,84 @@ void net_cfg_request_apply(void) {
     }
 }
 
+/*
+ * 函数功能：投递"保存网络配置"请求（跨任务交接的投递端）
+ * 入口参数：无
+ * 返回值：恒 0  int
+ * 限定条件：任意任务上下文（UI 保存行）；新值须已落 RAM 副本
+ * 函数说明：置"待保存"标志后经平台回调唤醒属主任务（MCU：置
+ *          SYS_EVT_CFG_SAVE 事件）；写盘与"立即应用"由属主任务执行
+ *          （net_cfg_save_run），本函数不触碰配置文件引擎
+ */
+int net_cfg_save_request(void) {
+    s_save_pending = 1u;
+
+    if (s_save_req_cb != NULL) {
+        s_save_req_cb();
+    }
+    return 0;
+}
+
+/*
+ * 函数功能：取保存请求交接状态（UI 保存行显示）
+ * 入口参数：无
+ * 返回值：NET_CFG_SAVE_ST_IDLE / _WAIT / _OK / _FAIL  int
+ * 限定条件：任意任务上下文（单字节读取，无撕裂）
+ * 函数说明：见 net_cfg.h 同名函数说明
+ */
+int net_cfg_save_state(void) {
+    if (s_save_pending != 0u) {
+        return (int)NET_CFG_SAVE_ST_WAIT;
+    }
+    if (s_save_result == 1u) {
+        return (int)NET_CFG_SAVE_ST_OK;
+    }
+    if (s_save_result == 2u) {
+        return (int)NET_CFG_SAVE_ST_FAIL;
+    }
+    return (int)NET_CFG_SAVE_ST_IDLE;
+}
+
+/*
+ * 函数功能：执行待处理的保存请求（配置文件引擎属主任务）
+ * 入口参数：无
+ * 返回值：0 - 无待处理请求或保存成功；-1 - 写盘失败  int
+ * 限定条件：仅配置引擎属主任务上下文（MCU = defaultTask；模拟器 = 主循环）
+ * 函数说明：先清"待保存"标志（写盘期间的新请求重位置位，下轮再执行，
+ *          不丢失）；写盘成功 → 置 OK 并触发"立即应用"（netTask 重建
+ *          网络，无需重启）；失败 → 置 FAIL，不触发应用（网络保持）
+ */
+int net_cfg_save_run(void) {
+    int r;
+
+    if (s_save_pending == 0u) {
+        return 0;    /* 无待处理请求（空醒/周期轮询） */
+    }
+    s_save_pending = 0u;
+
+    r = net_cfg_save();
+    if (r == 0) {
+        s_save_result = 1u;
+        net_cfg_request_apply();
+    }
+    else {
+        s_save_result = 2u;
+    }
+    return r;
+}
+
+/*
+ * 函数功能：注册"保存请求"通知回调
+ * 入口参数：cb - 回调函数（NULL = 注销）  net_cfg_save_req_cb_t
+ * 返回值：无
+ * 限定条件：应用启动早期注册一次即可
+ * 函数说明：MCU 端 defaultTask 注册（置 SYS_EVT_CFG_SAVE 事件立即唤醒）；
+ *          模拟器不注册（主循环每轮查状态，无需唤醒）
+ */
+void net_cfg_set_save_req_cb(net_cfg_save_req_cb_t cb) {
+    s_save_req_cb = cb;
+}
+
 /*
  * 函数功能：取 RAM 配置副本（只读指针）
  * 入口参数：无