wandering1
ae09c5737a
任务规划目录从 5 个文件收敛到 3 个：只留导航（README）、待办（登记簿）、 暂缓专项（暂缓-RS485）。 删除的两个文件都不再有现行读者： - UI补齐.md 执行清单 2026-10-28 清空、上板判据 2026-11-06 台架轮已复核； 叶数口径迁 docs/UI设计/菜单页面设计.md §3.9，三条内容页硬规矩迁 docs/UI设计/内容页架构.md §7.1，两条未闭环待办迁登记簿 §7/§8。 - 数据可信.md 不是完成记录，而是被约 130 处代码头注释引用的设计约束， 因此按内容分三处落位后删除，不整篇丢弃。 数据可信内容的新归属（旧节号 → 新家）： - §2/§4 设计口径 → docs/算法/采集与算法层设计说明.md 新增 §13（13 小节）， §7 前置决策表 → §13.12 已定案的前置决策。 - §3 台阶与波次退出判据 → docs/硬件平台/ADC通道映射说明.md 新增 §9。 - §5 任务卡 → docs/任务规划/登记簿.md §7（拆成变比确认 / 两点标定两行）。 引用改写 34 文件 77 处路径引用 + 14 文件 24 处昵称引用 + 双重节号 35 处， 覆盖代码头注释、测试、生成器与文档；归档区历史路径改纯文本提及。 四个 SVG 生成器文案同步并重跑，产物随脚本同批提交。 同批处理两件事： - 9 个 UTF-16 LE 证据文件转 UTF-8。end-of-file-fixer 按字节判末尾换行， UTF-16 的换行是 0A 00、末字节 00，钩子会追加裸 0x0a 使文件变奇数长度， 8 个已实际损坏。转码后逐文件比对 HEAD 原文验证正文零丢失。 - 修回 App/cfg/cfg_file.c 被剥掉的 UTF-8 BOM（补 3 字节，未整文件重写）。 验证：/keil-build 0 错误 0 警告（Code=255160）；check_doc_links --all --sections-strict 221 篇全通过、无法判定 0；pre-commit 全量全 Passed。
279 lines
11 KiB
C
279 lines
11 KiB
C
/*
|
||
* 模块名称：UI Page Comm (通讯设置内容页)
|
||
* 模块功能：通讯参数 → 通讯设置 叶子（#P 受密码保护）的内容页——两行数值表
|
||
* （公共地址 CA / 监听端口）+ 保存行；本文件零 App include：行现状
|
||
* （值/合法带）经 ui_data.h 通道六注入表现取，写与落盘确认全走
|
||
* ui_w_setlist 组件 + 本页自带的 60 行胶水（写记账/落盘锁存——
|
||
* ui_w_ytview 是 [run_par] 档专用形态（float 域 + 徽标），两档语义
|
||
* 不同不硬并）
|
||
* 两态一页：123 修改权限 → 可编辑（编辑器 + 保存行）；000 查看权限 → 只读
|
||
* （attach 内不绑 commit → 无保存行，key_cb 整页交回框架——死区页
|
||
* 同一条分派纪律）
|
||
* 生效语义（屏上必须诚实的地方）：保存行 OK 只证明 **落盘完成**，不证明
|
||
* "已在新值上运行"——端口 = 下一次重 bind 监听生效（拆链/网络代次
|
||
* 重建自然到位，不必整机重启），公共地址 = **改后重启生效**
|
||
* （iec104Task 启动时取一次 getter；docs/子系统设计/
|
||
* IEC104上行设计说明.md §8）。页面上不加"立即生效"字样，也不为
|
||
* ca 画第二枚徽标——生效时刻的完整口径归上面那份设计说明。
|
||
* 徽标说明：本页不画"未标定"类徽标（与两点标定无关，稀释真告警——死区页
|
||
* 同条纪律）
|
||
* 适用平台：STM32F407ZGTx / PC 模拟器（共用源码）
|
||
* 作者：DTU 项目组
|
||
* 创建日期：2026-10-27
|
||
* 修改记录：
|
||
* v1.0 2026-10-27 DTU 项目组 创建（道G task-9；验收口径 = 本页须
|
||
* 「重启即生效 + 104 侧读回真值 + 段数键数上限核对」，
|
||
* 台架判据见 docs/任务规划/登记簿.md §7「通讯设置页真机判据」与
|
||
* IEC104上行设计说明.md §8）
|
||
*/
|
||
/* 头文件包含区 */
|
||
#include <string.h>
|
||
|
||
#include "ui_page_comm.h"
|
||
|
||
#include "ui_data.h" /* 通道六：行现状/写入口/脏位（本层唯一的数与守卫的来源） */
|
||
#include "ui_tokens.h"
|
||
#include "ui_w_setlist.h"
|
||
|
||
/* 私有宏定义区 */
|
||
|
||
/* 保存行显示态（值与 ui_w_ytview 的 YT_ST_* 同序同义，胶水面独立一份） */
|
||
#define CM_ST_ENTER 0u /* 空闲：保存行显示 ENTER */
|
||
#define CM_ST_WAIT 1u /* 按过保存、脏位仍在：WAIT */
|
||
#define CM_ST_OK 2u /* 脏位归零（或按时无脏）：OK，锁存不回退 */
|
||
#define CM_ST_ERR 3u /* 最近一次写被执行侧拒：粘滞 ERR */
|
||
#define CM_BAD_ALL 0x03u /* 两行反显位图全掩码 */
|
||
|
||
/* 静态变量定义区 */
|
||
|
||
/* 行表在 RAM 现建（合法带唯一出口在执行侧，本文件零范围字面量——通道六
|
||
* 表注第①条；行名是本机界面文案归本页，行序即 UI_DATA_COMM_ROW_* 下标） */
|
||
static const char *const k_comm_name[UI_DATA_COMM_ROW_N] = {
|
||
"公共地址",
|
||
"监听端口"
|
||
};
|
||
static ui_w_setlist_row_t s_rows[UI_DATA_COMM_ROW_N];
|
||
static uint8_t s_n; /* 实际建出行数（半表纪律：读失败即停） */
|
||
static uint8_t s_st; /* 保存行显示态 CM_ST_* */
|
||
static uint8_t s_badmap; /* 写被拒行反显位图（bit0=CA bit1=PORT） */
|
||
|
||
/* 本页定值表实例（组件状态独占一份，勿跨页共用） */
|
||
static ui_w_setlist_t s_sl;
|
||
|
||
/* 函数定义区 */
|
||
|
||
/*
|
||
* 函数功能：写结果记账（成功/被拒共一个入口——死区页 yt_note_write 同款）
|
||
* 入口参数：a_id - 行下标 uint8_t；a_rc - 注入口返回值 int
|
||
* 返回值：无
|
||
* 限定条件：set 回调链内（uiTask 按键）
|
||
* 函数说明：拒绝 → 该行反显 + 粘滞 ERR；成功 → 只清这一行反显 + 作废上一次
|
||
* 保存结果（改过任何一位，上一轮的 OK/ERR 都不该再挂屏）
|
||
*/
|
||
static void cm_note_write(uint8_t a_id, int a_rc) {
|
||
if (a_rc != 0) {
|
||
s_badmap = (uint8_t)(s_badmap | (uint8_t)(1u << a_id));
|
||
s_st = CM_ST_ERR;
|
||
} else {
|
||
s_badmap = (uint8_t)(s_badmap & (uint8_t)~(1u << a_id));
|
||
s_st = CM_ST_ENTER;
|
||
}
|
||
}
|
||
|
||
/*
|
||
* 函数功能：保存行按键（值早在逐行 ENTER 时写入副本并置脏；这里只是落盘
|
||
* 确认的起点）
|
||
* 入口参数：无
|
||
* 返回值：无
|
||
* 限定条件：可编辑态、保存行 ENTER；uiTask 按键链
|
||
* 函数说明：先清反显再评估；脏位仍在 → WAIT 锁存观察，无脏 → 直接 OK。
|
||
* 真机落盘 = defaultTask 每轮无条件 iec104_comm_store_save()，
|
||
* WAIT 窗口 ≤50 ms；模拟器假件刻意不自动清脏（由无头 pump 清），
|
||
* 否则 WAIT 态永远不会被像素回归覆盖（道F 裁定④同一条理由）
|
||
*/
|
||
static void cm_commit(void) {
|
||
s_badmap = 0u;
|
||
s_st = (ui_data_comm_pending() != 0u) ? CM_ST_WAIT : CM_ST_OK;
|
||
}
|
||
|
||
/*
|
||
* 函数功能：保存行值列回读（WAIT → OK 边沿在此收尾）
|
||
* 入口参数：无
|
||
* 返回值：组件态枚举 ui_w_setlist_st_t
|
||
* 限定条件：绘制链内
|
||
* 函数说明：锁存 = 只前进不回退（"我这次动作的结果"与"档位此刻的状态"分开；
|
||
* 通道六里 ca/port 没有 104 侧自动写者，比通道五更干净，但锁存
|
||
* 纪律不做两套）
|
||
*/
|
||
static ui_w_setlist_st_t cm_state(void) {
|
||
if ((s_st == CM_ST_WAIT) && (ui_data_comm_pending() == 0u)) {
|
||
s_st = CM_ST_OK;
|
||
}
|
||
switch (s_st) {
|
||
case CM_ST_WAIT:
|
||
return UI_W_SETLIST_ST_WAIT;
|
||
case CM_ST_OK:
|
||
return UI_W_SETLIST_ST_OK;
|
||
case CM_ST_ERR:
|
||
return UI_W_SETLIST_ST_FAIL;
|
||
default:
|
||
return UI_W_SETLIST_ST_IDLE;
|
||
}
|
||
}
|
||
|
||
/* 函数功能：某行是否需越界反显（写被拒的账挂在这行值上） 返回值：反显 bool */
|
||
static bool cm_bad(uint16_t a_row) {
|
||
if (a_row >= 8u) {
|
||
return false;
|
||
}
|
||
return ((s_badmap >> a_row) & 0x1u) != 0u;
|
||
}
|
||
|
||
/*
|
||
* 函数功能：读某行当前值（int32 定点通道，decimals 恒 0 = u16 域直达）
|
||
* 入口参数：a_id - 行下标 uint8_t
|
||
* 返回值：当前值 int32_t
|
||
* 函数说明：读失败回 0 不回旧缓存——组件零缓存，0 是唯一诚实的退化值
|
||
* （ui_data 通道五同口径）
|
||
*/
|
||
static int32_t cm_get(uint8_t a_id) {
|
||
ui_data_comm_row_t r;
|
||
|
||
if ((a_id >= s_n) || (ui_data_comm_row(a_id, &r) != 0)) {
|
||
return 0;
|
||
}
|
||
return (int32_t)r.val;
|
||
}
|
||
|
||
/*
|
||
* 函数功能：写某行（经通道六 → iec104_comm_*_set；守卫与置脏在带内执行侧）
|
||
* 入口参数：a_id - 行下标 uint8_t；a_val - 编辑器提交的整数 int32_t
|
||
* 返回值：无（结果经 cm_note_write 记账）
|
||
* 限定条件：set 回调链内
|
||
* 函数说明：负数（编辑器理论不产）原样送 setter 拒掉，本页不做第二次守卫
|
||
* ——合法带唯一出口在 iec104_comm.h，抄一份就是第二真源
|
||
*/
|
||
static void cm_write(uint8_t a_id, int32_t a_val) {
|
||
if (a_id >= s_n) {
|
||
return;
|
||
}
|
||
cm_note_write(a_id, ui_data_comm_set(a_id, (uint32_t)a_val));
|
||
}
|
||
|
||
/*
|
||
* 函数功能：开页建表 + 绑视图（接 init_cb）
|
||
* 入口参数：无
|
||
* 返回值：无
|
||
* 限定条件：框架开页链内（本次进入权限已装载——先装权限再调 init_cb 的
|
||
* 时序依据见 ui_page_view_param.c 同位置注释）
|
||
* 函数说明：两行逐行现取（lo/hi/值全现给）；读到第 i 行失败停在 i 行——
|
||
* 半张表比空表危险的反面论证同 ui_w_ytview.yt_fill；未注入 =
|
||
* 0 行空表页，一个像素都不画假数据
|
||
*/
|
||
static void pg_init(void) {
|
||
uint8_t i;
|
||
|
||
s_st = CM_ST_ENTER;
|
||
s_badmap = 0u;
|
||
s_n = 0u;
|
||
for (i = 0u; i < (uint8_t)UI_DATA_COMM_ROW_N; i++) {
|
||
ui_data_comm_row_t r;
|
||
|
||
if (ui_data_comm_row(i, &r) != 0) {
|
||
break;
|
||
}
|
||
s_rows[i].name = k_comm_name[i];
|
||
s_rows[i].id = i;
|
||
s_rows[i].kind = UI_W_SETLIST_KIND_NUM;
|
||
s_rows[i].decimals = 0u;
|
||
s_rows[i].min = (int32_t)r.lo;
|
||
s_rows[i].max = (int32_t)r.hi;
|
||
s_rows[i].opts = NULL;
|
||
s_rows[i].unit = NULL; /* CA 与端口都不是物理量，不挂单位 */
|
||
s_n++;
|
||
}
|
||
(void)memset(&s_sl, 0, sizeof(s_sl));
|
||
s_sl.rows = s_rows;
|
||
s_sl.count = s_n;
|
||
s_sl.get = cm_get;
|
||
s_sl.set = cm_write;
|
||
s_sl.bad = cm_bad;
|
||
if (ui_content_page_is_editable() != false) {
|
||
s_sl.commit = cm_commit;
|
||
s_sl.state = cm_state;
|
||
}
|
||
ui_w_setlist_reset(&s_sl);
|
||
}
|
||
|
||
/*
|
||
* 函数功能：总行数（数据行实给 + 可编辑态才有保存行；接 count_cb）
|
||
* 入口参数：无
|
||
* 返回值：总行数 uint16_t
|
||
* 限定条件：框架绘制/翻页链内
|
||
*/
|
||
static uint16_t pg_count(void) {
|
||
return ui_w_setlist_count(&s_sl);
|
||
}
|
||
|
||
/*
|
||
* 函数功能：逐行取数（行现状在组件与注入表里现取，本层无缓存）
|
||
* 入口参数：a_row / a_name / a_value - 契约见 ui_content_page.h
|
||
* 返回值：无
|
||
* 限定条件：框架绘制链内
|
||
*/
|
||
static void pg_refresh(uint16_t a_row, char *a_name, char *a_value) {
|
||
ui_w_setlist_refresh(&s_sl, a_row, a_name, a_value);
|
||
}
|
||
|
||
/*
|
||
* 函数功能：自绘层（编辑光标反显 + 写被拒行反显）
|
||
* 入口参数：a_layer / a_clip - 契约见 ui_content_page.h
|
||
* 返回值：无
|
||
* 限定条件：框架绘制链内，内置区块画完之后
|
||
*/
|
||
static void pg_draw(lv_layer_t *a_layer, const lv_area_t *a_clip) {
|
||
ui_w_setlist_draw(&s_sl, a_layer, a_clip);
|
||
}
|
||
|
||
/*
|
||
* 函数功能：按键转发（接 key_cb）
|
||
* 入口参数：a_key - LVGL 键值 lv_key_t
|
||
* 返回值：true - 本页已消费；false - 交回框架（↑↓ 移选、← 关页）
|
||
* 限定条件：描述符 edit_capable=1 + key_intercept=1（编辑中 ←→ 移数字光标，
|
||
* 必须先给页面——整定四页同款实证）
|
||
* 函数说明：第一条门 = 只读进入（未绑 commit）整页交回框架，与"本页没有
|
||
* key_cb"逐字等价（黄金只读态为证）
|
||
*/
|
||
static bool pg_key(lv_key_t a_key) {
|
||
if (s_sl.commit == NULL) {
|
||
return false;
|
||
}
|
||
return (ui_w_setlist_key(&s_sl, a_key) != 0u);
|
||
}
|
||
|
||
/*
|
||
* 页面描述符（外部链接：生成物 ui_page_registry.c 按菜单树 #page=comm 绑定引用）
|
||
* 列表页骨架 + 可编辑 + ← 拦截；row_count 给静态上限（2 数据行 + 保存行 = 3），
|
||
* 运行时以注入表现报为准；band_h>0 选中反显（死区页同款几何令牌）
|
||
*/
|
||
const content_page_def_t ui_page_comm_desc = {
|
||
.id = "comm",
|
||
.title = "通讯设置",
|
||
.selectable = 1u,
|
||
.edit_capable = 1u,
|
||
.key_intercept = 1u,
|
||
.top_y = UI_LIST_TOP,
|
||
.pitch = UI_ROW_PITCH,
|
||
.band_h = UI_ROW_BAND_H,
|
||
.text_dy = 0,
|
||
.left_x = UI_LIST_LEFT_X,
|
||
.right_x = UI_LIST_RIGHT_X,
|
||
.rows_per_page = UI_LIST_ROWS,
|
||
.row_count = 3u,
|
||
.init_cb = pg_init,
|
||
.count_cb = pg_count,
|
||
.refresh = pg_refresh,
|
||
.draw_cb = pg_draw,
|
||
.key_cb = pg_key,
|
||
};
|