wandering1/STM32F4-Base
1
0
Fork 0
Code Issues 30 Pull Requests Actions Packages Projects 2 Releases Wiki Activity

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

Browse Source
This commit is contained in:
Wanderingss
2026-09-15 21:13:20 +08:00
parent 4b5ce72e11
commit 1817fe792f
605 changed files with 54786 additions and 322 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Drivers/BSP/NETCFG/net_cfg.c
+88 -4
View File
@@ -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 配置副本（只读指针）
* 入口参数：无
Drivers/BSP/NETCFG/net_cfg.h
+78 -12
View File
@@ -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 配置副本（只读指针）
* 入口参数：无