b7a3e18dca
- 改名走 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。
55 lines
2.9 KiB
C
55 lines
2.9 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 */
|