wandering1/STM32F4-Base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects 1 Releases Wiki Activity

feat(ui-data): ui_data 三通道快照 + ui_data_feed 装配 + SOE 显示名映射

Browse Source 
按 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（中文只进注释）。
This commit is contained in:
Wanderingss
2026-10-25 09:56:22 +08:00
parent 8cbc7bc6b6
commit 201d713226
16 changed files with 2118 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files
simulator/CMakeLists.txt
+12 -1
View File
@@ -58,6 +58,7 @@ include_directories(
# 2026-10-02 测试目录重构后头文件移入 test/board/）
${PROJECT_ROOT}/App/cfg # cfg_file.h / cfg_file_store.h（通用配置文件引擎，双端共享核心）
${PROJECT_ROOT}/App/log # sys_log.h（运行/自检记录引擎，双端共享核心）
${PROJECT_ROOT}/App/algo # prot_set.h（定值模型纯算法，双端共享核心；见 ALGO_SOURCES）
${PROJECT_ROOT}/Drivers/BSP # dbg_log.h（使用 simulator 的 dbg_cfg.h 配置）
${SDL2_DIR}/include # SDL2 头文件
)
@@ -100,6 +101,8 @@ set(UI_SOURCES
${UI_DIR}/ui_w_editor.c
${UI_DIR}/ui_w_setlist.c
${UI_DIR}/ui_page_action.c
${UI_DIR}/ui_data.c # 数据快照存侧（道E task-14；写侧 App/app/ui_data_feed.c 不进模拟器，见 scripts/check_registration.py）
${UI_DIR}/ui_w_soe.c # SOE 记录组件（道E task-14；reader 注入点待绑定，未绑定按空态渲染）
)
# 运行/自检记录引擎（双端共享核心 + 平台存储后端；MCU 端编 sys_log_mcu.c，见 Keil 工程）
@@ -115,6 +118,14 @@ set(NETCFG_SOURCES
sim/cfg_file_store_sim.c
)
# 保护定值模型（App/algo/prot_set.c 零平台依赖，双端共享核心）。
# 模拟器只需要"出厂默认定值"来发布 UI 快照帧（main.c 的 sim_publish_data_frames），
# 不在这里复制一份 40 项数字——抄表就等于造第二真相（同 scripts/check_font_charset.py
# "单一规则源"的同一治理口径）。
set(ALGO_SOURCES
${PROJECT_ROOT}/App/algo/prot_set.c
)
# 网络后端（net_* 核心 API 的 Winsock 实现 + UI 推流平台后端；MCU 端另编 net_socket.c 与 _mcu 后端）
set(NET_SOURCES
sim/net_socket_sim.c
@@ -124,7 +135,7 @@ set(NET_SOURCES
#=============================================================================
# 构建可执行文件
#=============================================================================
add_executable(lvgl_sim WIN32 ${SIM_SOURCES} ${UI_SOURCES} ${NETCFG_SOURCES} ${SYSLOG_SOURCES} ${NET_SOURCES})
add_executable(lvgl_sim WIN32 ${SIM_SOURCES} ${UI_SOURCES} ${NETCFG_SOURCES} ${SYSLOG_SOURCES} ${NET_SOURCES} ${ALGO_SOURCES})
target_compile_definitions(lvgl_sim PRIVATE
LV_CONF_INCLUDE_SIMPLE # 让 lvgl.h 找到 lv_conf.h
simulator/main.c
+97
View File
@@ -69,6 +69,8 @@
#include "cfg_file_store.h"
#include "sys_log.h"
#include "ui_w_records.h" /* task-6 记录 reader 注入点（镜像 App/task/ui_task.c 的绑定） */
#include "ui_data.h" /* task-14 快照存侧：模拟器在此直接发布固定帧（装配器不进模拟器） */
#include "prot_set.h" /* task-14 定值出厂默认（App/algo 纯算法，双端可编，见 simulator/CMakeLists） */
/* 屏幕尺寸（与 MCU 端一致） */
#define SIM_SCREEN_W 160
@@ -171,6 +173,95 @@ static int sim_rec_get(uint8_t log_id, uint32_t idx, char *ts, uint32_t ts_len,
static const ui_rec_reader_t s_rec_reader = { sim_rec_count, sim_rec_get };
/*
* 函数功能：发布固定数据帧（镜像 App/app/ui_data_feed.c 的装配结果）
* 入口参数：无
* 返回值：无
* 限定条件：ui_menu_init 之前调用（无头与窗口两个初始化点共用，先于建页）
* 函数说明：模拟器不链接装配器（无硬件数据源；真值还会让像素参考天天变），
* 这里发布一帧**固定合成值**，页面数据来源因此可注入——像素回归不再
* 依赖真实硬件（UI_数据供给设计说明.md §9.2）。要点三条：
* 1. eng 固定 = UI_DATA_ENG_PIN，与真机未标定态同口径（数据可信.md
* §2.6 承诺边界 = 引脚电压），页面据此显示"未标定"；
* 2. build_date 用固定串而**不是** __DATE__——否则跨天重建会把装置
* 信息页的黄金参考刷掉（黄金参考是判据本身，不得随手刷）；
* 3. 定值取 prot_set 出厂默认（App/algo/prot_set.c 是纯算法，双端可编），
* 不手抄 40 个数字——抄一次就是一份会漂移的第二真相
*/
static void sim_publish_data_frames(void) {
ui_data_rt_t rt;
ui_data_par_t par;
ui_data_info_t info;
uint8_t i;
ui_data_init();
(void)memset(&rt, 0, sizeof(rt));
rt.valid = 1u;
rt.eng = UI_DATA_ENG_PIN;
rt.tick_ms = 0u;
/* 遥测下标 = adc_semantic_t 语义序（UA/UB/UC/UN/IA/IB/IC/IN/TEMP）。
* 模拟器不 include adc_input.h，故这里用语义序注释对照，不写符号名 */
rt.yc[0].val = 0.8123f; /* UA 基波（引脚电压域） */
rt.yc[0].qds = 0u;
rt.yc[1].val = 0.0f; /* UB：V0.1 硬件削顶无采样源 */
rt.yc[1].qds = UI_DATA_Q_IV | UI_DATA_Q_OV;
rt.yc[2].qds = UI_DATA_Q_IV | UI_DATA_Q_OV; /* UC 同上 */
rt.yc[3].val = 0.0054f; /* UN 零序电压基波 */
rt.yc[3].qds = 0u;
rt.yc[4].val = 0.0456f; /* IA 基波 */
rt.yc[4].qds = 0u;
rt.yc[5].qds = UI_DATA_Q_IV | UI_DATA_Q_OV; /* IB */
rt.yc[6].qds = UI_DATA_Q_IV | UI_DATA_Q_OV; /* IC */
rt.yc[7].qds = UI_DATA_Q_IV | UI_DATA_Q_OV; /* IN */
rt.yc[8].val = 2048.0f; /* TEMP：码值（不参与线性标定） */
rt.yc[8].qds = UI_DATA_Q_RAW;
/* 相量实例槽（序 = phasor k_inst[]：IA-F1/UA-F1/UN-F1/IA-F2/IA-F5） */
rt.ph_n = 5u;
rt.ph[0].val = 0.0456f;
rt.ph[1].val = 0.8123f;
rt.ph[2].val = 0.0054f;
rt.ph[3].val = 0.0017f; /* IA 二次谐波（涌流制动监视量） */
rt.ph[4].val = 0.0008f; /* IA 五次谐波（选线用） */
for (i = 0u; (i < UI_DATA_PH_MAX) && (i < rt.ph_n); i++) {
rt.ph[i].qds = 0u;
}
for (; i < UI_DATA_PH_MAX; i++) {
rt.ph[i].qds = UI_DATA_Q_IV; /* 未发布的槽：无效，页面显示 "--" */
}
rt.yx_bits = 0u; /* 固定帧无动作态 */
rt.yx_valid = 0x4043C000ULL; /* YX15~18/23/31 有效位图 */
rt.freq_valid = 0u; /* eng=0 期间幅值门恒失效 → 无新鲜读数 */
rt.freq_hz = 0.0f;
rt.clock_ok = 1u;
(void)snprintf(rt.clock, sizeof(rt.clock), "%s", "2026-10-25 08:00:00");
(void)ui_data_publish_rt(&rt);
(void)memset(&par, 0, sizeof(par));
(void)prot_set_init(); /* 出厂默认 + 封存（幂等） */
par.valid = 1u;
par.checksum = prot_set_checksum();
par.locked = prot_set_locked();
par.bad_mask = 0u; /* 装载成功：无越界项 */
for (i = 0u; i < UI_DATA_SET_N; i++) {
par.q10[i] = prot_set_get((prot_set_id_t)i);
}
(void)ui_data_publish_par(&par);
(void)memset(&info, 0, sizeof(info));
info.valid = 1u;
info.uptime_s = 0u;
info.port_104 = 2404u; /* App/task/iec104_serv.h 的 IEC104_SERV_PORT */
info.port_disp = (uint16_t)UI_NET_SINK_PORT; /* 同源常量（BSP 头，模拟器可见） */
(void)snprintf(info.model, sizeof(info.model), "%s", "F30");
(void)snprintf(info.sw_ver, sizeof(info.sw_ver), "%s", "SV0.010");
(void)snprintf(info.hw_ver, sizeof(info.hw_ver), "%s", "HW0.010");
(void)snprintf(info.build_date, sizeof(info.build_date), "%s", "Oct 25 2026");
(void)snprintf(info.sw_sum, sizeof(info.sw_sum), "%s", "--");
(void)snprintf(info.ftp_user, sizeof(info.ftp_user), "%s", "admin");
(void)ui_data_publish_info(&info);
}
/*
* 函数功能：无窗口离屏渲染（可注入键序列）并导出末帧像素
* 入口参数：keys - 键序列（u=上 d=下 l=左 r=右 e=确认 s=返回；空 = 不注键） const char *
@@ -212,6 +303,9 @@ static int run_headless(const char * keys, const char * path, int standby) {
/* task-6 记录 reader 注入（镜像 ui_task.c：先于 ui_menu_init，两端同形） */
ui_w_records_bind(&s_rec_reader);
/* task-14 数据快照：镜像 ui_task.c 的 ui_data_init + 首帧发布（先于建页，
* 页面任何时刻打开都拿得到帧，不必等装配节拍） */
sim_publish_data_frames();
if (ui_menu_init() != 0) {
return 1;
@@ -607,6 +701,9 @@ int main(int argc, char **argv) {
/* 构建菜单 UI（与 MCU 端共用 ui_menu.c） */
/* task-6 记录 reader 注入（镜像 ui_task.c：先于 ui_menu_init，两端同形） */
ui_w_records_bind(&s_rec_reader);
/* task-14 数据快照：镜像 ui_task.c 的 ui_data_init + 首帧发布（先于建页，
* 页面任何时刻打开都拿得到帧，不必等装配节拍） */
sim_publish_data_frames();
if (ui_menu_init() != 0) {
fprintf(stderr, "ui_menu_init failed\n");