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/NET/lftpd/lftpd_inet.c
+12 -5
View File
@@ -133,9 +133,12 @@ int lftpd_inet_write_string(int socket, const char *message)
while (length > 0) {
int write_len = net_send(socket, p, length, 0);
if (write_len < 0) {
DBG_ERROR("write error");
return write_len;
/* write_len == 0：发送超时且零进展（对端未消费数据）；不判为致命则
* length 永不减少，将在此空转（任务死锁）。返回错误交会话层拆除
* 连接（lftpd.c handle_control_channel 的 cleanup 路径）。 */
if (write_len <= 0) {
DBG_ERROR("write error, ret=%d", write_len);
return -1;
}
p += write_len;
length -= write_len;
@@ -151,8 +154,12 @@ int lftpd_inet_write(int socket, const void *buf, int len)
while (remaining > 0) {
int n = net_send(socket, p, remaining, 0);
if (n < 0) {
return n;
/* n == 0：发送超时且零进展（对端停滞/断链），判为致命：否则 remaining
* 永不减少 → 死循环。调用方（lftpd.c send_file）收到 < 0 后终止传输
* 并向上报 450 错误，会话保持可用。 */
if (n <= 0) {
DBG_ERROR("write error, ret=%d", n);
return -1;
}
p += n;
remaining -= n;
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 配置副本（只读指针）
* 入口参数：无
Drivers/BSP/UI/ui_page_net_cfg.c
+30 -20
View File
@@ -3,19 +3,24 @@
* 模块功能：网口设置叶子节点的内容页数据 + 行为——5 行地址列表（IP 地址/子网
* 掩码/默认网关/MAC 地址 + 保存行，5 行每页共 1 页）；
* 行槽顶 = 24+14i、选中白带 x=2..156 高 13、名 x=4 / 值 x=54；
* 值取自 net_cfg RAM 副本（netTask 上电自 Flash 加载并回写实际 MAC）；
* 值取自 net_cfg RAM 副本（defaultTask 上电自 Flash 加载；
* netTask 回写实际 MAC 影子）；
* 编辑模式：ENTER 进选中地址行（字节光标 = 活动字节，反显标记），
* ↑↓调字节 0..255（环绕、值列实时刷新）、←→移字节光标（首↔末环绕）、
* ENTER 确认退出编辑；
* 权限：edit_capable=1——查看密码 → 只读（编辑/保存键无效），
* 修改密码 → 可编辑；保存行 ENTER → net_cfg_save() 写盘 +
* net_cfg_request_apply() 通知 netTask 立即重建网络（无需重启）；
* 修改密码 → 可编辑；保存行 ENTER → 投递保存请求
* （net_cfg_save_request；属主任务 defaultTask 写盘并立即应用
* 重建网络，无需重启）；保存行值随交接状态显示
* ENTER/WAIT/OK/ERR；
* 向框架 ui_content_page 提供页面描述符（零 LVGL 对象）
* 适用平台：STM32F407ZGTx / PC 模拟器（两端共用）
* 作者：王建锋
* 创建日期：2026-09-10
* 修改记录：
* v1.0 2026-09-10 王建锋 创建初始版本
* v1.1 2026-09-15 王建锋 保存改异步交接：投递请求 → 属主任务写盘/应用；
* 保存行随交接状态显示 ENTER/WAIT/OK/ERR
*/
/* 头文件包含区 */
@@ -46,10 +51,9 @@
/* 静态变量定义区 */
/* 页面运行态（每次开页经 init_cb 重置；约 3 B） */
/* 页面运行态（每次开页经 init_cb 重置；约 2 B） */
static uint8_t s_editing; /* 1 = 编辑中（被编辑行 = 当前选中行） */
static uint8_t s_cursor; /* 编辑模式活动字节（IP/掩码/网关 0..3，MAC 0..5） */
static uint8_t s_saved; /* 保存行值：0 = "ENTER"，1 = "OK"，2 = "ERR" */
/* 函数定义区 */
@@ -117,7 +121,8 @@ static void nc_fmt_value(uint16_t row, char *p_buf) {
* 返回值：无
* 限定条件：页面打开（框架绘制链内逐行调用）
* 函数说明：地址行值取 net_cfg RAM 副本（MAC 全零时显示芯片实际 MAC 影子）；
* 保存行值随 s_saved 态显示 ENTER/OK/ERR
* 保存行值随保存交接状态（net_cfg_save_state）显示
* ENTER/WAIT/OK/ERR
*/
static void nc_refresh(uint16_t row, char *name, char *value) {
const net_cfg_t *cfg = net_cfg_get();
@@ -144,12 +149,19 @@ static void nc_refresh(uint16_t row, char *name, char *value) {
break;
case 4u:
(void)memcpy(name, "保存", sizeof("保存"));
if (s_saved == 0u) {
(void)memcpy(value, "ENTER", sizeof("ENTER"));
} else if (s_saved == 1u) {
(void)memcpy(value, "OK", sizeof("OK"));
} else {
(void)memcpy(value, "ERR", sizeof("ERR"));
switch (net_cfg_save_state()) {
case NET_CFG_SAVE_ST_WAIT:
(void)memcpy(value, "WAIT", sizeof("WAIT"));
break;
case NET_CFG_SAVE_ST_OK:
(void)memcpy(value, "OK", sizeof("OK"));
break;
case NET_CFG_SAVE_ST_FAIL:
(void)memcpy(value, "ERR", sizeof("ERR"));
break;
default:
(void)memcpy(value, "ENTER", sizeof("ENTER"));
break;
}
break;
default:
@@ -163,7 +175,7 @@ static void nc_refresh(uint16_t row, char *name, char *value) {
* delta - 调整方向（>0 = +1，<0 = -1） int8_t
* 返回值：无
* 限定条件：编辑模式（s_cursor 有效）
* 函数说明：只改 RAM 副本；写盘须显式经保存行 net_cfg_save
* 函数说明：只改 RAM 副本；写盘须显式经保存行投递 net_cfg_save_request
*/
static void nc_adjust_octet(uint16_t row, int8_t delta) {
net_cfg_t cfg = *net_cfg_get();
@@ -260,8 +272,10 @@ static void nc_draw_cb(lv_layer_t *layer, const lv_area_t *clip) {
* （值已实时落 RAM 副本）；ESC 恒关页（框架保证，未保存调整留在
* RAM，下次开页重显、不写盘、重启失效）
* 2. 正常模式：ENTER 地址行 → 进编辑模式（需可编辑权限）；ENTER
* 保存行 → net_cfg_save（需可编辑权限）；↑↓ 落框架移选、
* ← 落框架关页；只读态 ENTER 一律忽略
* 保存行 → 投递保存请求 net_cfg_save_request（需可编辑权限；
* 写盘与"立即应用"由属主任务 defaultTask 执行，保存行随交接
* 状态显示 WAIT/OK/ERR）；↑↓ 落框架移选、← 落框架关页；
* 只读态 ENTER 一律忽略
*/
static bool nc_key_cb(lv_key_t key) {
uint16_t sel = ui_content_page_selected_row();
@@ -309,10 +323,7 @@ static bool nc_key_cb(lv_key_t key) {
return true;
}
if (sel == NC_SAVE_ROW) {
s_saved = (net_cfg_save() == 0) ? 1u : 2u;
if (s_saved == 1u) {
net_cfg_request_apply(); /* 立即应用：通知 netTask 重建网络（无需重启） */
}
(void)net_cfg_save_request(); /* 投递保存请求：属主任务写盘并立即应用 */
ui_content_page_invalidate();
return true;
}
@@ -332,7 +343,6 @@ static bool nc_key_cb(lv_key_t key) {
static void nc_init_cb(void) {
s_editing = 0u;
s_cursor = 0u;
s_saved = 0u;
}
/*