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

This commit is contained in:
2026-09-15 21:13:20 +08:00
parent 4b5ce72e11
commit 1817fe792f
605 changed files with 54786 additions and 322 deletions
+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;
}
/*