feat(UI/采集/104): 通讯设置页 + 开机账本 + adc_cal 可诊断化——三车道同树一次构建入库
三条道在同一棵树上交付，故合并成**一次权威构建**（@build 0 错 0 警，Code=235236 RO=26308 RW=1572
ZI=136924）后同笔入库；台账已按该构建回填（`ram_baseline.py --update` + `--write`、`chec
k_mem_numbers.py
--write`），凭证与实际 .map 同源。归属如下：
· **通讯设置页**（道G task-9）：新增 `Drivers/BSP/UI/ui_page_comm.{c,h}`（通道六注入，与死
区页同骨架同纪
律），`#page=comm` 绑定使 bound **21 → 22**、内容页黄金 **47 → 53**（旧 47 页字节零变化，
新增六态含
WAIT/OK 两张）；`iec104_comm` 脏位 + store_save（**无事件位**）挂 defaultTask 同点位
轮询；`port_104` 由
宏改走 getter、`IEC104_SERV_PORT` 删除；字体 +听/监（185 字全覆）。**实机链已闭环**：FTP 外改
[comm]
的 ca/port → 复位 → 串口出现 `section 'comm' (2 keys)` 与 `i104: listening o
n 9004` → 还原 2404，全程无
FAIL ⇒「重启即生效 + 端口真值」不是推断是实测。上限核对 6/8 段、2/16 键，超限现象由 TC-CONFIG-056/057
钉死（注册 -1 + `comm init: FAIL` 锚 + getter 回 ROM），**不抬宏**。
· **开机账本**（道F task-12）：新增 `App/util/boot_stats.{c,h}`——上电次数落 SD2506 用户
SRAM（magic +
小端计数 + 版本 + 异或校验），一次上电 = 1 读 + ≤1 写，**零 NAND、零卷锁、零配置段**；四态互斥
UNKNOWN / FRESH / CONTINUED / RESTARTED（BLF=1 才算电池域掉过电），**读失败绝不回写**；
文案口径「自 RTC
电池周期起」，**禁写终身次数**。复位原因优先级链从 `app_main.c` 的 if-else 收进一份真源（串口与屏幕同
源）；104 四个只增不清计数 + `iec104_serv_get_stats()` 留在 serv、未塞进 link（会被 open
/close 洗掉）。
运行时长按用户裁定 = **只报本次开机以来**，零新增代码。新套件 `test/host/boot_stats` 21/21，五处注入
**全部有牙**（含「漂一字节被校验和挡下而不是报 256 倍错账」）。
· **adc_cal 可诊断化**（道E task-43）：三个 volatile 计数 + `adc_cal_get_stats()`
/ `adc_cal_note_persisted()`
（水位**盖写非自增**，因为一次 save 覆盖整档，数 save 会留假未落盘）；「差额 × 脏位」三态语义唯一落在
`adc_cal.h`，其中「差额 > 0 且脏位恒 0」= 绕过语义 setter 的静默丢失；TC-ADCCAL-019~023。
三条**必须留档的自纠**（都是执行道自己报的，我不替他们润色）：
① stdint 那条断链是**宿主套件抓到、通讯道先修**，采集道承认自己是重复添加者并删掉自己那份；
② 「exit 2 不是证据，断言变红才是」——采集道第一版反证注入了未声明标识符导致编译错，差点当成功；
③ 套件汇总行原写 `s_total/s_total`，失败时会打印「21/21 PASSED (failed=1)」这种自相矛盾的行，已改。
另修：`check_registration.py` 的 `SIM_EXEMPT` 加一行豁免 `App/util/boot_stats.c
`（依赖 I2C 与 RCC 位掩码，
MCU 专属；核过 `sys_clock.c`/`sha256.c` 同形态先例），注册反向校验 exit 1 → 0。发号 TC-IEC1
04-034、
TC-UIDATA-029 已实抬游标（`TC-IEC104-033→034`、`TC-UIDATA-026→029`）。
门禁：id-check --strict 与 plain 均 rc=0、doc-links --all rc=0、注册校验 0、cppche
ck / coding-standard /
bom-drift 0；iec104 179/179、ui_data 295/295、boot_stats 21/21、adc_cal 11
7/117、run_par 67/67；菜单 8 状态
池 5368 不变、内容页 53/53。**已知遗留**：内容页数 47 → 53 的全仓文本同步尚未做（另卡跟踪），本笔只保
证代码与黄金一致；面板注键真机那一腿缺 CLI，交台架道补。
This commit is contained in:
@@ -0,0 +1,278 @@
|
||||
/*
|
||||
* 模块名称：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；判据 = docs/任务规划/
|
||||
* UI补齐.md §2 第 1 行「重启即生效 + 104 侧读回
|
||||
* 真值 + 段数键数上限核对」，台架判据见该卡与
|
||||
* 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,
|
||||
};
|
||||
Reference in New Issue
Block a user