docs(ui): UI_数据供给设计改为现状设计并去「说明」,引用与注释全仓校准
- 改名走 rename_ref.py:22 文件 55 处路径引用随迁;764 行规划态 重写为 584 行现状设计,删落地步骤/验收判据两章与全部历史注 - 新增 §6.4:维护动作/遥测整定/通讯参数/录波回放四条常驻注入 通道写成现状表;§7.4 SOE 改「已绑定」现状 - ui_data.h 注释修正:rt 帧 212 B→216 B 两处(uint64 位图使整帧 按 8 对齐,单测 021g 钉 216);录波注入「通道六」改「通道七」 (与通讯参数撞号) - 既有断链债清 4 处:屏板链路旧 §9.1/§9.2 ×3、覆盖率口径 §4.5→§4.4、登记簿标注已删除;check_doc_links 外部名单加 IEC 60870 - 并发会话的 UI_时间响应分析.md 及其四篇修订不在本笔:README 行级拆分只暂存数据供给摘要行 验证:keil-build 0 错误 0 警告;pre_commit --all-files 全过; check_doc_links --all 237 篇零问题;ui_data 主机单测 303/303。
This commit is contained in:
@@ -1,7 +1,7 @@
|
||||
/*
|
||||
* 模块名称:UI 数据组装器(ui_data_feed)
|
||||
* 模块功能:App → UI 数据通道的写侧——按节拍从采集/标定/相量/测频/保护/协议/墙钟
|
||||
* 各模块取数,组装成 docs/UI设计/UI_数据供给设计说明.md §4 契约的三帧
|
||||
* 各模块取数,组装成 docs/UI设计/UI_数据供给设计.md §4 契约的三帧
|
||||
* (实时量 rt / 参数 par / 装置信息 info),经 Drivers/BSP/UI/ui_data.h
|
||||
* 的发布 API 推给 UI 层;本模块是快照的**唯一填充者**,不含任何布局、
|
||||
* 格式化与 LVGL 调用(显示规格全在页面行表,同文档 §8)
|
||||
@@ -95,7 +95,7 @@
|
||||
/* 私有宏定义区 */
|
||||
|
||||
/* 实时帧与信息帧发布节拍(ms);参数帧只在定值校验和变化时发布
|
||||
* (节拍依据 docs/UI设计/UI_数据供给设计说明.md §5.2) */
|
||||
* (节拍依据 docs/UI设计/UI_数据供给设计.md §5.2) */
|
||||
#define FEED_RT_PERIOD_MS 200u
|
||||
|
||||
/* 遥信位号:**与 App/protocol/iec104/iec104_pts.c 板端源的位图同源**(该文件把
|
||||
@@ -134,7 +134,7 @@
|
||||
/* 编译期一致性守卫(ARMCC C99 无 _Static_assert,用项目惯用的数组宽度法,
|
||||
* 先例 App/cfg/cfg_file.c 与 Drivers/BSP/UI/ui_menu_tab.h):
|
||||
* 快照下标空间与各 App 枚举一旦漂移,编译即失败,不留到运行期
|
||||
* (契约 docs/UI设计/UI_数据供给设计说明.md §9.4 第 1/2 条) */
|
||||
* (契约 docs/UI设计/UI_数据供给设计.md §9.4 第 1/2 条) */
|
||||
typedef char feed_chk_yc_n_t[(UI_DATA_YC_N == (uint32_t)ADC_SEM_COUNT) ? 1 : -1];
|
||||
typedef char feed_chk_set_n_t[(UI_DATA_SET_N == (uint32_t)PS_ID_COUNT) ? 1 : -1];
|
||||
/* 写路径注入表的 id 形参是 uint8_t(BSP 侧不透明编号宽度,位图只有 64 位):
|
||||
@@ -822,7 +822,7 @@ static uint8_t s_comm_bound; /* 道G task-9 通讯参数表懒绑门(同款
|
||||
* 限定条件:uiTask 上下文(读侧;写者 = iec104Task 的 set_sealed 与装载路径,
|
||||
* 读到的永远是"值区与封存一致"的完整快照)
|
||||
* 函数说明:只搬 Q10 原值不换算小数位——换算属表现层
|
||||
* (docs/UI设计/UI_数据供给设计说明.md §8)
|
||||
* (docs/UI设计/UI_数据供给设计.md §8)
|
||||
*/
|
||||
static void feed_fill_par(ui_data_par_t *p_snap, uint32_t sum) {
|
||||
uint8_t i;
|
||||
|
||||
@@ -1,17 +1,17 @@
|
||||
/*
|
||||
* 模块名称:UI 数据组装器(ui_data_feed)
|
||||
* 模块功能:App → UI 数据通道的"写侧"——按节拍从采集/算法/保护/协议/时钟各模块
|
||||
* 取数,组装成 docs/UI设计/UI_数据供给设计说明.md §4 契约的三帧
|
||||
* 取数,组装成 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)。
|
||||
* 上下文串行 → 无锁(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;模拟器豁免登记在
|
||||
* 见 docs/UI设计/UI_数据供给设计.md §9.2;模拟器豁免登记在
|
||||
* scripts/check_registration.py 的 SIM_EXEMPT)
|
||||
* 作者:王建锋
|
||||
* 创建日期:2026-10-25
|
||||
@@ -39,7 +39,7 @@ extern "C" {
|
||||
* (Drivers/BSP/UI/ui_data.h 写路径节)
|
||||
* 函数说明:本函数每轮代价 = 一次 tick 差值比较 + 一次校验和比较 + 一次
|
||||
* ui_data_param_drain()(队列空时只是一次计数判断);真正的取数与组装
|
||||
* 只在到期时发生(docs/UI设计/UI_数据供给设计说明.md §5.2)。
|
||||
* 只在到期时发生(docs/UI设计/UI_数据供给设计.md §5.2)。
|
||||
* ⚠ drain 排在取校验和**之前**:本轮写入的定值要在本轮就被"校验和变化
|
||||
* 才发"那道门看见,页面才能在同一帧里同时显示 OK 与新值
|
||||
* 内部零阻塞、零堆分配、零日志(日志每条约 90 B Flash + 216 B 栈,
|
||||
|
||||
+1
-1
@@ -178,7 +178,7 @@ static int ui_task_rec_get(uint8_t log_id, uint32_t idx, char *ts, uint32_t ts_l
|
||||
* sys_clock / prot_elm / sys_log 是分层方向的反例(layer-deps 拦),更关键的是
|
||||
* **模拟器根本不链 sys_clock**(simulator/dbg_log.h:4「模拟器无 sys_clock/RTC」)——
|
||||
* 页面里用一次就是"MCU 编得过、模拟器链接期爆"。写动作一律走 ui_data_maint_ops_t,
|
||||
* 两端各给实现(口径 docs/UI设计/UI_数据供给设计说明.md §6.2/§7.2)。
|
||||
* 两端各给实现(口径 docs/UI设计/UI_数据供给设计.md §6.2/§7.2)。
|
||||
*
|
||||
* uiTask 阻塞上界(IWDG 800ms 窗、本任务在 required_mask 内):本通道里只有
|
||||
* 时钟设置会碰硬件——sys_clock_set_unix 内含 1 次 SD2506 写,再叠加本适配层刻意
|
||||
|
||||
Reference in New Issue
Block a user