wandering1
77779d49d6
UI 面：ui_data 增加深度 4 参数写队列（请求 168 B、队列 .bss 672 B）与状态机 OK/ERR_RANGE/ERR_LOCKED/ERR_BUSY，ui_data_feed 出队后按注入 ops 走「闭锁 → 整批 预检 → 逐项 prot_set_set_sealed」，只提交改动位图；par 帧尾追加 cal_block （口径 = UA/UN/IA 三路 ADC_CAL_F_VALID，与 protect_task 判据同构，不用 rt.eng 反推，V0.1 下 eng 恒 0）、UI_DATA_VER 升到 2。参数/定值/控制字/软压板四叶绑定 内容页（UI_PAGE_MAP_COUNT 12→16，复用四个查看模块，零新增 .c），编辑态按 is_editable 分派，LOCK（写不进去）与「未标定」（仍可改值）两源两通道两词。 记录面：syslog_request_clear/state/apply 三段式删除 API（UI 只发请求，落地在 defaultTask 的 drain 尾部且必须后置，卷锁一律 try，幂等只认 FR_NO_FILE）； 事故/告警/启动/操作/遥控五类各有一个真实写入点，记录类型 = 日志 ID 本身 （一类一个 /log 严格 8.3 文件；64B 定长体没有类型字段位，塞字段会砸掉既有读者）。 为守 protectTask 872 B 静态最坏链另拆 syslog_post_quiet()（无 DBG 的投递核， 丢弃留痕挪到 drain 侧差值补发），syslog_post 对外语义逐字不变。 为什么两道合成一笔而不是各一笔（实测，不是省事）：simulator/main.c 同时消费 两道新增 API（整定 pump 与 logtest 清除用例），按道切文件会让中间提交编不过； RAM 受管快照与体积同码凭证描述的是合并后的 .map，拆开必落在「台账与 .map 不同 码」这条红线上。pre-commit 跑钩子前会 stash 未 staged 部分，这类耦合没法绕。 实测：@build 0 错误 0 警告；Code 228,260 / RO 24,960 / RW 1,440 / ZI 135,976 B； RW_IRAM1 79,992 B = 61.0%、RW_CCM 87.9%（阈值 92%）；九个任务静态最坏链全 PASS， protectTask 872 B / 57% 改前后逐字节不变（记录投递没垫栈）。主机单测 ui_data 82→ 164、sys_log_mcu 106→137、prot_elm 47→60、iec104 141→154、iec104_serv 28→34， 既有断言零删改；48 个钩子 --all-files 全绿；编号门禁可判定 86.34%（基线 86.0%）、 不可判定 1,153 处低于上限 1,166；doc-links 无法判定 0；UI 黄金 18 页扩到 27 页 连跑两次逐字节一致；字库 diff 空。 顺手修掉三处既有缺陷（都是本轮第一个消费者才暴露）：sim_syslog.c 的 s_paths 行宽 16 而 "sim_selftest.log" 正好 16 字符没有 NUL 位（stat/remove 读越过数组尾，此前 靠后面 .rodata 碰巧为 0）；ui_w_setlist 二态行 ENTER 不回绕（控制字与软压板出厂值 全在最后一项，按了像没反应而叠层里已是越界值）；生成物 ui_menu_tab.h 与 gen_menu.py 模板漂移（上一笔改了模板没重跑生成器），现随生成器输出对齐。 未收口（不算完成）：保存后重启值保持与主站 C_RD 读回两条只能上板，台架窗口执行； LOCK 屏显与越界反显的页面侧在模拟器造不出来（模拟器不跑定值自检、无 NAND）， 已由生成侧单测与代码注释点名差距；同类页数与钩子数陈述残留另立待办。
55 lines
3.0 KiB
C
55 lines
3.0 KiB
C
/*
|
||
* 模块名称：UI 数据组装器（ui_data_feed）
|
||
* 模块功能：App → UI 数据通道的"写侧"——按节拍从采集/算法/保护/协议/时钟各模块
|
||
* 取数，组装成 docs/UI设计/UI_数据供给设计说明.md §4 契约的三帧
|
||
* （实时量 rt / 参数 par / 装置信息 info），经 Drivers/BSP/UI/ui_data.h
|
||
* 的发布 API 推给 UI 层；本模块是快照的**唯一填充者**
|
||
* 适用范围：App/app（装配层：可同时 include 两侧头，方向仍是上层依赖下层，
|
||
* scripts/check_layer_deps.py 只拦"Drivers/BSP 目录反向 include App 目录"）
|
||
* 线程约定：uiTask 上下文，主循环每轮调 ui_data_feed_tick() 一次；与页面读写同
|
||
* 上下文串行 → 无锁（docs/UI设计/UI_数据供给设计说明.md §5.1）。
|
||
* ⚠ 不得在 adcTask/protectTask/netTask 里调用本模块
|
||
* 端接法：MCU = App/task/ui_task.c 主循环；PC 模拟器**不链接本文件**（模拟器不跑
|
||
* 固件装配链，快照由 simulator/main.c 直接发布固定帧保证像素回归可复现，
|
||
* 见 docs/UI设计/UI_数据供给设计说明.md §9.2；模拟器豁免登记在
|
||
* scripts/check_registration.py 的 SIM_EXEMPT）
|
||
* 作者：王建锋
|
||
* 创建日期：2026-10-25
|
||
* 修改记录：
|
||
* v1.0 2026-10-25 王建锋 创建（道E task-14）
|
||
* v1.1 2026-10-26 DTU 项目组 道F task-1：tick 兼任定值写路径的落定节拍
|
||
* （契约 §6.2；实现见 .c 的 s_param_ops）
|
||
*/
|
||
|
||
#ifndef UI_DATA_FEED_H
|
||
#define UI_DATA_FEED_H
|
||
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
/*
|
||
* 函数功能：装配节拍入口——先落定一条定值整定请求（写方向），再发布实时帧与
|
||
* 信息帧（满 200 ms 一次）、参数帧（仅校验和变化时）；首轮立即发布
|
||
* （免启动后出现一闪的 "--"）
|
||
* 入口参数：无
|
||
* 返回值：无
|
||
* 限定条件：uiTask 上下文，主循环每轮一次（UI 循环周期 10 ms）；页面"保存"按键
|
||
* 与本页节拍同上下文，故写路径的投递/落定之间不需要任何锁
|
||
* （Drivers/BSP/UI/ui_data.h 写路径节）
|
||
* 函数说明：本函数每轮代价 = 一次 tick 差值比较 + 一次校验和比较 + 一次
|
||
* ui_data_param_drain()（队列空时只是一次计数判断）；真正的取数与组装
|
||
* 只在到期时发生（docs/UI设计/UI_数据供给设计说明.md §5.2）。
|
||
* ⚠ drain 排在取校验和**之前**：本轮写入的定值要在本轮就被"校验和变化
|
||
* 才发"那道门看见，页面才能在同一帧里同时显示 OK 与新值
|
||
* 内部零阻塞、零堆分配、零日志（日志每条约 90 B Flash + 216 B 栈，
|
||
* 200 ms 周期打不起）；整定失败态走屏上通道，不打日志
|
||
*/
|
||
void ui_data_feed_tick(void);
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
|
||
#endif /* UI_DATA_FEED_H */
|