 wandering1
|
4332142680
|
feat(ui-pages): 遥信量 33 行固定名表页接实时快照（新增 yx_dp）
批 4 主体（票 task-15；规格 docs/UI设计/页面扩充详细方案.md §3.1.3 方案 A）。V0.1 只有 6 点有
硬件来源，其余 27 点在屏上就是 "--"——这是真实状态，不是页面没做完。
页面与数据
- 33 行固定名表（Flash const）+ 动态分页（8 行/页 = 5 页）。两处命名不照抄文档简写：idx0~3
屏上写「位置1~4」而非「YK1~4 位置」（遥信页出现 YK 前缀会被读成遥控对象，对应关系留在注释）；
idx30 写「保护闭锁」（写侧位号注释的语义即此，用编号反而丢信息）。idx4~13、idx31~32 点表未
定义功能名，如实写点号占位（YX5…、YX32），不编造功能名。
- 值映射次序：先判无效 → 再判单/双点 → 最后看位值。无效位上的位值不代表任何事实，次序颠倒就会
把垃圾位画成「复归」。
- 快照新增 yx_dp 双点位图（+8 B）。不教页面"前 4 点是双点"：单双点是 104 点表事实（YX_DP_N /
iec104_pts_yx_is_dp），抄进表现层就是第二真相——点表把双点段挪位或改起始下标，屏上不报错，
只会用错词形容同一个点。写侧逐点问 is_dp() 拼位图。
- UI_DATA_YX_N(33) 与 iec104_pts_yx_count() 编译期比不了（那个 #define 在协议层 .c 内），故写侧
留一条一次性 DBG_ERROR（约 90 B Flash，只在真漂移时打一次）。名表行数 = UI_DATA_YX_N 由数组
宽度法编译期守卫钉住（ARMCC C99 无 _Static_assert，本仓惯用写法）。
- 补 include 一条实测坑：DBG_ERROR 是宏，漏 include "dbg_log.h" 时 ARMCC 把它当隐式声明函数放过
编译期，错落在链接期（L6218E Undefined symbol DBG_ERROR）——报错点离根因隔了一整个链接步骤，
已在 include 处写明「DBG_TAG 必须在 include 之前」。
一个只有像素文本断言能抓到的截断 bug
- 照抄批 1 的 *_PUT(dst, 源) 宏（长度取 sizeof(源)），但本表源是 const char *const 数组的
**元素（指针）**，sizeof 得 4 → 「故障总」被截成「故」，而 "YX9" 恰好 4 字节看起来完全正常。
编译器 / cppcheck / 编码钩子全不响。定位来自断言：第 2 页「过流Ⅰ段」匹配不到，同一行值列
「复归」却在原位 = 名字被截、值没错位。修法：长度取目标缓冲容量 UI_BUF_STRLEN。同名宏、不同
参数类别（数组 vs 指针），批 1 那处本身是对的，照抄才中招——教训写在宏定义上方。
模拟器与覆盖诚实性
- 固定帧发布 yx_dp = 0x0F，但刻意不把这几位置进 yx_valid：V0.1 无开入硬件，屏上就是 "--"。不用
「让它显示合位/分位」的假数据填满画面，那等于让黄金参考声称本机有开关位置遥信。
- 代价如实登记：合位/分位这条词映射当前**没有任何自动化证据**（像素恒 IV；页面依赖 LVGL 进不了
主机单测）。已写进方案 §3.1.3 落地注与契约落地进度·四，作为开入落地后的台架判据，不假装测过。
测试
- 主机单测 +2 条（TC-UIDATA-009c 双点位图原样透传、不被 valid 掩；009d 点数 33 的独立见证，注明
绊红时要同步改哪四处）→ 85/85。
- 文本断言 +33 条（yx / yxp2 两态，含页码钉住 33/8 = 5 页的分页数学）；两页像素基线单独一笔。
- font-charset 本批零新增字：名表用字全部命中既有 183 字子集——「置/故/障/总/外/部」正属批 1
成组并入 KEEP_EXTRA 的那批字，第二次兑现（当时若按 extract 输出重写字符集，这些字早被洗掉，
上屏是空白，而门禁只会说「字不在清单里」）。
体积（同一棵树、构建前后的实测增量）
- Code 224272→224688（+416）；RO 24040→24640（+600）；RW 1324→1328（+4）；
ZI 134844→135088（+244）→ Flash 约 +1020 B、RAM +248 B。
- RO 增量主要是 33 行名表与名称串，是"把 33 个真点名上屏"的代价，不是可省开销。
跳过的门禁（三条同族，同一根因）：mem-numbers / mem-budget / size-gate（L0c）——台账与体积凭证
回填是 Lead 单写者，本分支不做静默处理，数值见上。
|
2026-10-25 15:33:04 +08:00 |
|
|
wandering1
|
201d713226
|
feat(ui-data): ui_data 三通道快照 + ui_data_feed 装配 + SOE 显示名映射
按 docs/UI设计/UI_数据供给设计说明.md 的 D 方案把 App→UI 数据通道落地：
App 组帧、BSP 存帧、页面只读；UI 侧零 App include，薄包装只在两端适配层。
本笔是纯增层、不接任何页面 → 零像素变化（菜单 8 状态 + 内容页 11 页黄金
参考逐字节不变，simulator/tests/ref 无 diff，未刷基线）。
新增
- Drivers/BSP/UI/ui_data.{c,h}：实时量 rt / 参数 par / 装置信息 info 三通道存储
+ 发布序号盖章 + 只读访问。零 App include、零 LVGL include（分层叶子）；
读写同在 uiTask 上下文串行 → 无锁、无双缓冲、无 seqlock（契约 §5.1）。
- App/app/ui_data_feed.{c,h}：快照唯一填充者。rt/info 每 200 ms 一帧，par 只在
prot_set_checksum() 变化时重发；首轮立即发布，免启动初期闪一下 "--"。
- Drivers/BSP/UI/ui_w_soe.{c,h}：SOE 二进制记录的显示名映射与注入式 reader
契约。未标定闭锁=7 / 标定复归=8 已进表——编号按 App/log/soe_rec.h 与
App/algo/prot_elm.h 现场数过（类型 1..8 + 哨兵 9、元件 0..8、ELM_NONE=0xFF、
FLG_IV=0x80），不采信文档与消息转述。reader 备好但两端未绑定：落盘侧还
没有只读 API（Lead 已裁该 API 归下一工作项），未注入按"无记录"空态渲染。
量纲诚实性（契约 §4.1 同步改成真值口径，不再抄旧码值表述）
- eng 不写"0 = 原始码值"：标定层 ROM 系数是引脚侧 LSB，采样环折算出来的就是
ADC 引脚电压（承诺边界 docs/任务规划/数据可信.md §2.6）；电气 8 路
adc_cal_flags() 的 VALID 全置位才升 eng=1 二次值——整帧共用一个 eng，只要
还有一路是引脚电压就不能贴"二次值"标签，宁可整体保守。
- TEMP 不参与线性标定 → 恒带新增品质位 UI_DATA_Q_RAW=0x20，页面不挂单位。
- UB/UC/IB/IC/IN 无基波相量实例（V0.1 削顶）→ Q_IV|Q_OV；未满一周波 → Q_NT。
- 谐波另开 ph[] 相量实例槽带：yc 的语义通道下标容不下同通道的二次/五次谐波。
接线与双端注册
- App/task/ui_task.c：ui_menu_init 之前 ui_data_init + 首帧发布；主循环每轮
ui_data_feed_tick() 排在 ui_port_step 之前（本轮渲染用本轮刚发布的帧）。
- simulator/main.c：发布固定合成帧（无头与窗口两个初始化点，先于建页）；
定值不手抄 40 个数，改为链入 App/algo/prot_set.c 取出厂默认（抄表等于造
第二真相）；build_date 用固定串而非 __DATE__，否则跨天重建会把装置信息页
黄金参考刷掉，而黄金参考是判据本身。
- 注册：uvprojx 加 3 条（App 组 ui_data_feed.c + UI 组 ui_data.c/ui_w_soe.c）与
simulator/CMakeLists.txt；ui_data_feed.c 不进模拟器 → check_registration.py 的
SIM_EXEMPT 加一行（App/app/app_main.c 先例，已报备）。
主机单测与钩子
- test/host/ui_data：82 断言全绿。钉三类事：快照语义（首帧前读 -1、序号由本层
盖章、三通道互不串台、NULL 防御、init 幂等复位）；跨层不透明下标现场一致
（yc 序 = adc_semantic_t、q10 序 = prot_set_id_t，同一 TU 里 include 两侧头）；
SOE 编号与名字表现场一致（八类事件都有名、采样/标定四个词互不相同、
名长不超列宽、越界回占位）。
- .pre-commit-config.yaml 加 ui-data-unit-test 钩子（第 43 个，Lead 已批自加）。
- scripts/id_registry.json 建族 TC-HOST-UIDATA（属主登记处 = 单测目录，同
TC-HOST-ADCCAL 先例；不建族则新号被编号门禁判"未登记前缀"）。
体积（相对 HEAD 台账 Code 215744 / RO 21396 / RW 1224 / ZI 131984）
- Code +1272 B、RO +108 B（字库 4 字，见上一笔）、RW +24 B、ZI +696 B
→ ER_IROM1 238520 B（22.7%）、RW_IRAM1 76504 B（58.4%，台账 57.8%）。
- .map 逐项：ui_data.o 488 B（Code 184/RW 12/ZI 476）、ui_data_feed.o 221 B
（1034/12/209）；LVGL 池 0 增量；ui_w_soe 未接线不进镜像（.map 无其符号）。
- 台架未跑（本笔零像素、零接线）：首帧时刻、200 ms 刷新、eng 升档与遥信
位图真值全部留"待台架实测"，接线完成后请 Lead 排窗。
遗留与风险（随回报进台账）
- 写路径（契约 §6 的 param_request/state）不落：无消费者就是永不执行的死码，
随整定 4 页一起落；届时须先定"UI 整定 vs iec104Task 写 prot_set"的并发口径
（prot_set_set_sealed 的影子区非重入）。
- 公共地址 CA 未下发：固件里 CA 逐帧从 ASDU 头解析，无集中常量可取。
- 遥信位图与 App/protocol/iec104/iec104_pts.c 板端源是两处镜像（该文件位号
写在函数体内未导出，UI 不得 include 协议头），开入采集落地时应并成单源。
- 版本类字段是本文件内的宏（仓库无产品级版本登记表，值沿用页面既有显示
值）；软件校验位在拿到构建期 CRC 步骤前一律显示 "--"，不抄参考遗留值。
gate: 全量钩子（--all-files）40 项通过；cppcheck/test-cppcheck/coding-standard/
layer-deps（基线仍 3 条）/registration/bsp-err（存量 38 条不变）/font-charset/
id-check（增量无新账）/doc-links/ui-golden/主机单测与覆盖率全绿；唯一红项是
mem-numbers 与 mem-budget——两者只因 Flash/RAM 台账未回填（禁区，归 Lead）。
gate: only mem-budget/mem-numbers pending lead ledger backfill
自查：BOM（Drivers/BSP/UI/* 与 App/task/ui_task.c 保持 EF BB BF，新建 UI 两件
同规范；App/app 与 test/host 无 BOM 与本目录一致）；CR = 0 全 LF；U+FFFD = 0；
字符串字面量纯 ASCII（中文只进注释）。
|
2026-10-25 09:56:22 +08:00 |
|