wandering1/STM32F4-Base
1
0
Fork 0
Code Issues 29 Pull Requests 1 Actions Packages Projects 2 Releases Wiki Activity
Files
dea75914f5196454d12e315cfb9ea65fc82329b0
STM32F4-Base/Drivers/BSP/UI/ui_w_setview.h
T
wandering1 45393be3d5 feat(ui-pages): 参数定值控制字软压板四个查看页接 par 快照 
四个空叶子（参数定值 → 查看 → 参数/定值/控制字/软压板）接上 par 通道。页面薄、模型厚：
新建 Drivers/BSP/UI/ui_w_setview.{c,h} 收四张视图表 + Q10 换算 + 越界反显，四个页面各是
一份实例 + 四个跳板钩子；渲染与分页复用批 1 的 ui_w_setlist（查看态 commit=NULL：无保存行、
无编辑通路，§3.2.6 查看列口径）。

行表三项口径全部有真源，一项都不在这份文件里拟定
- id = App/algo/prot_set.h 的枚举序。BSP 不 include App 头（分层门禁），所以行表里是裸数字
  + 行尾注枚举名——这份对不上就没人能在 BSP 侧编译期发现，于是从外面钉：见下面的新脚本
- min/max = App/algo/prot_set.c 的 g_prot_set_meta Q10 上下限按该行小数位换算的结果。整定页
  下一批复用同一批表，界内界外一处一份，不会出现「查看看着合法、整定说越界」两套边界
- 显示名/小数位/单位 = docs/UI设计/页面扩充详细方案.md §3.2.2~§3.2.5 四张表

一处偏离文档（不是静默偏离，写进三处：代码注释 / 文档落地注 / 本正文）
- 四个返回系数按 2 位小数显示，文档写 3 位。理由是量值真实性不是排版：Q10 存不下 0.95
  （0.95×1024 截成 972 → 真存 0.94921875），按 3 位显示就多打一位根本不存在的数字；整定单
  上写 0.95 的人看到屏上 0.949 会怀疑装置、甚至反复重输（重输还是 0.949）。2 位才是这份存储
  在自身可分辨精度上的正确读数——文档的 3 位来自「把 Q10 当成十进制存储」这个误会
- 单位挂在值串尾（10.00A / 500ms）而不是塞进显示名：值列只有数字会让 60000 既是 ms 又是 A。
  为此给 ui_w_setlist_row_t 加了 unit 字段（该结构此前无任何消费者，扩展零成本）；只挂在
  非编辑态——编辑中是逐位输入串，挂单位会让位光标算错列宽。A/V/ms/Hz 全 ASCII 不占字库

新增可重跑核验：tools/setview_check/check_setview_limits.py
- 从外面把三件事钉住：四张表的 id 恰好覆盖 0..39 各一次；数值行 min/max 等于 meta 上下限的
  换算；kind 与 meta.is_ctl 一致、dec 查表与行表小数位一致、单位只允许 ASCII。改 meta 不改
  行表就红。当前输出：行表 40 行 / dec 40 项 / meta 40 项 -> OK
- 写这个脚本时自己踩的两个坑也留在脚本注释里：① 正则用 \w+ 吃不下带引号的单位，会让整行
  **静默跳过**（少检一行比检查错更难发现）→ 改 \S+ 并加「行数必须等于 40」硬闸；② 脚本要
  打印中文，Windows 控制台按 CP936 写 stdout 会崩在半路（崩在半路 = 一条都没检查）→ 开头
  把 stdout/stderr 锁到 UTF-8

两个只有画面才会暴露的错（都不是静态检查抓到的，都记进了注释）
- ui_data_par() 的通道是 0=成功 / -1=尚无首帧，我按 bool 反义用了：真机与模拟器上都会「永远
  读不到」，整页值列恒 --，而页面看起来完全正常、编译与钩子全绿。看像素图才发现满屏横杠
- 肉眼把 CT 一次额定读成 1000A，字形匹配器证明值列只有 4 个字符位（命中 x=101/107/113/119）：
  实际是 100A。断言因此按匹配器能证明的写。顺带一个自洽佐证：PT 10000/100 V 配 CT 100/5 A
  正是 10 kV 馈线终端的变比；控制字页默认值天然两两一组（Ⅰ/Ⅱ 段跳闸、Ⅲ 与过负荷段告警），
  行表若整体错位就不可能复现这个组合——这条已进像素断言，成为 id 对齐的机械证据

无数据时的显示口径
- 参数帧未就位：名字照打、值列打 --（不把 0 当定值显示，也不给整页空白让人以为菜单坏了）
- 越界反显只在 bad_valid=1 时参与：把「没数据」画成「这行有毛病」是假告警，比不画更糟
- Q10 换算不用浮点也不用 64 位除：整数段 + 小数段拆分四舍五入，满位进位（MicroLIB 软浮点与
  __aeabi_ldiv 一进镜像几百字节，模拟器（宿主 CRT）永远照不出这笔代价）

批 1 那个 KEEP_EXTRA 决策在这里第一次兑现
- 本批行表用到的「延时 / 电流 / 压力 / 总 / 配 / 重 / 间 / 未」等字，正是当时成组并入 KEEP_EXTRA
  的 35 个「未知冗余」字里的一批；若当时按 extract 输出重写字符集，这些字形已被洗掉，本批
  上屏就是白框，而 font-charset 只会报「字在清单里没有」——它报不出「字曾被删掉过」
- 本批 font-charset 直接 Passed，未扩字库、未重生成字体

验证
- @build 0 错误 0 警告；模拟器 0 警告；内容页 19 项 PASS（16 页像素 + 四页共 39 条文本断言），
  其余 12 页逐字节不变；菜单 8 状态 PASS；ui-data 83/83、soe 32/32
- 四页出图逐张肉眼确认：值列右缘不越屏（10000V 最宽）、名值不重叠、第 1 页行槽与页脚不撞；
  分页页码正确（定值 18 行 = 3 页、软压板 10 行 = 2 页）
- check_setview_limits.py OK；ui_menu_tab.h 等生成物全部由 gen_menu.py 重生成（手改生成物 = 一定
  会被覆盖，见批 2 那条），uvprojx/CMakeLists 注册由生成器写入，另手工登记 ui_w_setview.c 两处
- 全量钩子 --all-files：见下一行 gate；红项只有同族三条（台账与同码凭证回填归单写者）

体积（相对 b746a1f 台账 217204 / 21504 / 1256 / 132680）
- 实测 Code 221856 / RO 23508 / RW 1300 / ZI 134660
  → Code +4652、RO +2004、RW +44、ZI +1980
- Flash 合计 +6700 B、RAM +2024 B（三批累计）。本批 RO +2120 主要是 40 行行表与名称/单位串，
  ZI +388 是 par 帧缓存（184 B）+ 四个组件实例 + 注册表增量；这是把 40 项真定值上屏的代价，
  不是可省开销

待台架实测：装载真定值后的四页读数（含真机 bad_mask 非 0 时的反显行）、翻页节拍、
PT/CT 变比与 104 上位的定值读回（C_RD）一致性。

gate: only mem-budget/mem-numbers/size-gate pending lead ledger backfill
（同族三条，root cause 一条：台账与同码凭证回填归单写者）
像素基线单独提交（下一笔新增 4 个 shot_v*.bin）：本笔单独 checkout 时 ui-golden 会报缺参考，
属预期拆分；上面的钩子结论取自「本笔 + 下一笔」的合并树。
自查：12 个新增/改动 UI 源文件 BOM 与 HEAD 对齐（本批 edit 又剥掉 4 次，逐次补回）；CR = 0；
U+FFFD = 0；C 字面量纯 ASCII（中文只在带 BOM 文件里）。
2026-10-25 14:44:47 +08:00

111 lines
5.4 KiB
C
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/*
* 模块名称：UI 定值查看视图模型（ui_w_setview）
* 模块功能：参数 / 定值 / 控制字 / 软压板**四张视图表**与它们的取数、越界反显——
* 把"40 项定值怎么分组上屏、Q10 怎么换算成带小数位的显示值"收在一处，
* 供四个查看页薄跳板（ui_page_view_*）共用；整定页（下一批）复用同一批表，
* 只是再绑 set/commit/state 三个回调
* 分层：本模块只读 Drivers/BSP/UI/ui_data.h 的参数快照，**不 include 任何 App 头**
* （行表里的 id 是**裸数字** + 注释标注 PS_* 名，因为 prot_set_id_t 属 App 层）
* ——id 与 App/algo/prot_set.h 枚举序的一致性由 test/host/ui_data 的主机单测
* 在两侧头文件同时可见的地方钉住（BSP 侧看不到 App 头，物理上无法自证）
* 值语义：q10[i] = 工程量 × 1024（App/app/ui_data_feed.c 只搬原值不换算，换算属表现层，
* docs/UI设计/UI_数据供给设计说明.md §8），本模块按行表 decimals 换算成
* "工程量 × 10^decimals" 交给 ui_w_setlist（其值通道契约）
* 适用平台：STM32F407ZGTx / PC 模拟器（共用源码）
* 作者：王建锋
* 创建日期：2026-10-25
* 修改记录：
* v1.0 2026-10-25 王建锋 创建（道E task-15 批 3；规格 =
* docs/UI设计/页面扩充详细方案.md §3.2.1~§3.2.3/§3.2.6）
*/
#ifndef UI_W_SETVIEW_H
#define UI_W_SETVIEW_H
#ifdef __cplusplus
extern "C" {
#endif
#include <stdbool.h>
#include <stdint.h>
#include "ui_w_setlist.h"
/* 四个视图编号 */
typedef enum {
UI_W_SETVIEW_PARAM = 0, /* 参数视图 8 行（PT/CT 额定 + 4 个返回系数） */
UI_W_SETVIEW_SET, /* 定值视图 18 行（电流/电压/频率/延时） */
UI_W_SETVIEW_WORD, /* 控制字视图 4 行（*_TRIP：告警/跳闸） */
UI_W_SETVIEW_PLATE, /* 软压板视图 10 行（*_EN + 保护总投：投入/退出） */
UI_W_SETVIEW_VIEWS /* 哨兵 = 视图个数（不是有效视图号） */
} ui_w_setview_t;
/*
* 函数功能：绑定一个查看视图到定值表实例（rows/count/get/bad 一次配齐）
* 入口参数：a_inst - 页面持有的实例（static，一页一份） ui_w_setlist_t *
* a_view - 视图编号 ui_w_setview_t
* 返回值：无
* 限定条件：页面 init_cb 内调用（uiTask 上下文）
* 函数说明：查看视图与整定视图的**唯一**差别就是这里绑不绑 set/commit/state：
* commit=NULL → 组件不画保存行、ENTER 无效（§3.2.6 查看列口径）；
* set 契约写"必填"，故绑一个空实现而不是 NULL——组件在只读态确实不会调它，
* 但把"当前不会调"当成"可以是 NULL"等于把安全性押在下一次重构上
*/
void ui_w_setview_attach(ui_w_setlist_t *a_inst, ui_w_setview_t a_view);
/*
* 函数功能：按发布序号取参数帧快照（页面 refresh 前调用）
* 入口参数：无
* 返回值：无
* 限定条件：uiTask 上下文（页面绘制链内）
* 函数说明：序号没变就不重拷（一帧约 184 B；四个查看页共用这一份缓存——同屏只可能
* 开着一页，缓存互相之间不存在并发读者）
*/
void ui_w_setview_sync(void);
/*
* 函数功能：参数帧是否已就位
* 入口参数：无
* 返回值：1 = 有有效帧可显示；0 = 尚无首帧或读取失败 uint8_t（取 uint8_t 是 BSP 公开
* API 的 err-type 约定，不是错误通道；定义处有完整理由）
* 限定条件：uiTask 上下文；纯查询，无副作用
* 函数说明：页面据此决定值列打 "--" 还是打换算值——**无数据不许打 0**：
* "0.00A" 会被读成"这台装置的定值就是 0"，与"还不知道"是两件事
*/
uint8_t ui_w_setview_ready(void);
/*
* 函数功能：逐行取数（接框架 refresh；内含 ui_w_setview_sync() 与无帧占位）
* 入口参数：a_inst - 已 attach 的实例 ui_w_setlist_t *
* a_row - 全局行下标 uint16_t
* a_name - 名输出缓冲（UI_BUF_STRLEN） char *
* a_value - 值输出缓冲 char *
* 返回值：无
* 限定条件：框架绘制链内调用（uiTask）
* 函数说明：页面**不要**直接调 ui_w_setlist_refresh()——那样会绕过"无帧打 --"
* 这一步，参数帧还没到就把 0 当成定值显示出去
*/
void ui_w_setview_refresh(ui_w_setlist_t *a_inst, uint16_t a_row,
char *a_name, char *a_value);
/*
* 函数功能：取某视图的行表与行数（供主机单测做结构自测；页面正常不需要调用）
* 入口参数：a_view - 视图编号 ui_w_setview_t；a_n - 行数输出（不可为 NULL） uint16_t *
* 返回值：行表首地址；视图号非法或 a_n 为空返回 NULL const ui_w_setlist_row_t *
* 限定条件：只读
*/
const ui_w_setlist_row_t *ui_w_setview_table(ui_w_setview_t a_view, uint16_t *a_n);
/*
* 函数功能：取 id → 显示小数位查表（供主机单测核对行表与查表一致）
* 入口参数：a_n - 表长输出（= UI_DATA_SET_N） uint16_t *
* 返回值：表首地址 const uint8_t *
* 限定条件：只读
*/
const uint8_t *ui_w_setview_dec_table(uint16_t *a_n);
#ifdef __cplusplus
}
#endif
#endif /* UI_W_SETVIEW_H */
Reference in New Issue View Git Blame Copy Permalink