feat(wave): 故障录波数据面、接线与单通道回放页（软件闭环交付）
数据面（App/algo，纯逻辑，双端编译） - wave_ring：8 路 × 320 点列优先环（1 kHz，预触发 160 + 后触发 160），adcTask 唯一写者；触发/冻结/封存/冷却四态，冻结持续到落盘回执才解冻，滞留 2 s 自弃 兜底——下一次真故障无波可录比丢一段更贵 - wave_store：段头编解码 + 拉模式打包游标 + 自带无表位运算 CRC-16/MODBUS（带 锚点自检）+ 段名与整段长度等式；格式不依赖平台类型宽度 - 段头只存原始码值与封存瞬间生效系数，工程量只当单位标签、不进任何算式 - 三套主机单测（环 113 / 编解码 170 / 触发状态机 110），全部无桩、生产源原样 纳入；新文件补 stddef 是 ARMCC 与主机差异，主机侧照不出这条分叉 - test/host/wave_read.py 是按 §6.2 的独立第二实现（dump/fft/shape/plot），92 条 自洽断言；三份合成段互读双校验全过、哈希钉死，格式面双向闭合 - 三套新单测不加专属钩子，由覆盖率总闸全量真跑（沿用既有裁定） 接线（任务层） - adc_cal：新增生效系数的 32 位定点原值入口（与既有浮点入口共用生效视图）， 段头按最低有效位精确记账，不经浮点回算 - adcTask：每拍压 8 路语义原始码值并推进状态机，封存那一拍同拍交棒封存瞬间事实； 台架定周期自抓走双层编译门，产品镜像里零存在；串口新增一条 wave: 周期行 - defaultTask：卷空闲后一次心跳整段搬完（try 锁 + 256 字节分片 + 一次完整开档到 关档），成败都回执；失败先删半成品再计错，段号只在成功时推进；持锁超 50 ms 补一条告警并记历史峰值（喂狗余量可核） - Lead 复核补第四道并发陷阱：采集任务优先级高于落盘道，搬段中途它可能正好把滞留 超时的本段自弃、甚至封出下一段——数据区校验和是对「实际读到的字节」算的， 半新半旧的段照样自洽，故关档后复检环侧身份判废：删文件、不补账、段号不推进 - Lead 复核抓到触发挂号不是原子操作（旧实现分三个字节写，消费者可在窗口里读到 上一段的触发源与元件号）：已把载荷压进一个字节，越界当场拒且不记任何计数； 段文件字节布局零改动，三份合成段哈希逐字节不变 - protectTask：保护启动上升沿同点请求录波，一拍一次、元件号取最低位；判据本体 零改动 人机（160×160 单色屏） - 菜单树节点 26「手动录波」绑页面 + 记录查询组末新增「录波回放」叶，重跑生成器 得 43 节点 / 34 叶 / 30 已绑，页面映射 28 → 30 - 回放页一屏一路、触发点前后各一周波共 40 点、每点 3 像素阶梯线（只用水平与 垂直两种线段——单色屏斜线会被阈值裁掉）；零点虚线、触发光标、窗口峰值、 单位徽标与形状受限徽标；空态与坏段各一句显式文案，绝不用半截波形冒充数据 - ui_data 新增录波注入通道（六件操作表、三态返回）；执行侧胶水带段头缓存、 手动请求后连缓存一起作废、逐点走全仓唯一的码值换算入口 - 模拟器接真实环与编解码合成两段（含坏段与空态旗标），6 张新黄金参考，既有 60 张逐字节零漂移未用更新模式；字库 218 → 224 字 / 319 字形 - 两份图形配置里图表组件仍为关；零堆分配；页面池水位不变 - 回放读路径的 uiTask 阻塞上界按实码写清：一次渲染 = 段表刷新 + 未缓存段头最坏 22 次小读；已验段只剩一次开窗读 + 40 点解码；无实测数不编，实测归台架、 仪器用已在跑的单轮工作耗时探针，不新加埋点 台账与文档 - 内存台账：录波环与落盘/回放静态逐条入册，三档对照 81,536 → 88,296 → 89,936 字节（62.2% → 68.6%），累计 +8,400；预估 5.9 KB 与实测 +6,760 的差额点名； 散列文件头注释同步；任务栈表核对后无需抬栈；体积趋势行与同码凭证由权威构建 重打（0 错误 0 警告，四项体积与上一轮相同——本轮改动只有注释与声明位置） - 设计说明：§5 补第四条并发陷阱；§6.3 定字段口径（两份独立实现的共同依据）； §7 回填实测；§9 周期行写实；§10 台架判据改两段式且不比绝对相位；§12 补读路径 风险行；抬头状态改成「代码面已交付、未做完的只有板级那一轮」 - 卡片：软件闭环一栏列证据；台架三条按用户裁定保持未完成，不做虚假销项 - 口径同步：数据可信、UI 补齐、页面补齐规划、产品需求、采集短板评测、任务规划 索引与两份 README；陈旧现状句清扫 16 处（带日期戳的历史取数行一律不动） - 门禁说明：nested-comment 记仓库根探测必须兼容 linked worktree 的 gitdir 文件 形态（修前该钩子在任务树里恒报环境错、静默不可用）；coding-standard 记 「函数头注释超过 24 行就把函数功能挤出回看窗口」这条机制与本次现场 - 覆盖率基线登记两个新覆盖模块（套件 41 → 44 套）；环单测重打后该文件有效行 227 → 226、覆盖行 226 → 225，比率仍 99.6%，是分母变小不是覆盖率回退 为什么是单一提交：文档链接、双端注册、生成器幂等（菜单与字库）、内存数字与 体积事实源、编号门禁这五道整仓门禁要求代码、页面、菜单树、字库、文档与台账 同处一个提交才自洽，按数据面/接线/人机/台账拆成四笔必然红其中至少四道 编号门禁新增行 14 处命中已按语义改写：魔数常量按字符命名、段名样例改由格式串 生成、频谱表头改 f / 2x / 5x 并加一行图例；改写后自洽断言 92 条仍全过
This commit is contained in:
@@ -924,6 +924,111 @@ int ui_data_comm_set(uint8_t a_idx, uint32_t a_val);
|
||||
*/
|
||||
uint8_t ui_data_comm_pending(void);
|
||||
|
||||
/* ── 通道六：故障录波（wave）────────────────────────────────────────────────
|
||||
* 页面零 App include、零存储触点：录波执行侧（触发投递 / 段索引 / 段头字段 /
|
||||
* 窗口码值与峰值 mV）全部经本注入表进来，真实现见 App/task/ui_task.c 的
|
||||
* s_wave_ops；PC 模拟器绑同一形状的假件（simulator/main.c）。取数口径的
|
||||
* 唯一真源是 docs/子系统设计/故障录波设计说明.md §6.3（定点 mV 换算走
|
||||
* wave_store_code_to_milli，eng 只做徽标、绝不进算式）。
|
||||
*/
|
||||
|
||||
/* 录波通道数（与段头 ch_count 恒等：电气八路，温度不入波） */
|
||||
#define UI_WAVE_CH_CNT 8u
|
||||
/* 回放显示窗口点数（两周波；口径推导与设计 §4.2 的触发点位置钉在一起，
|
||||
* 窗起点与虚线光标由执行侧与页面各按同一定义实现，页面侧写死 */
|
||||
#define UI_WAVE_WIN_PTS 40u
|
||||
|
||||
/* 通道查询返回态：段存在且可用 */
|
||||
#define UI_WAVE_OK 0
|
||||
/* 无段（目录扫空 / 卷忙跳过 / 执行侧未注入，页面显示「无录波段」） */
|
||||
#define UI_WAVE_NONE 1
|
||||
/* 有段但不可读（长度不符 / 版本不符 / 任一段 CRC 不符，页面显示
|
||||
* 「该段不可读」——两种态都必须显式说，画直线等于伪造证据（设计 §8.1） */
|
||||
#define UI_WAVE_BAD 2
|
||||
|
||||
/*
|
||||
* 录波执行侧注入表（六件齐全；ui_data_wave_bind 拒绝残表）
|
||||
* 返回值约定：除 manual_req 外，各件返回 UI_WAVE_OK / NONE / BAD 三态；
|
||||
* seg_win 的出参仅在返 UI_WAVE_OK 时可读（通道五同一条出参契约）。
|
||||
*/
|
||||
typedef struct {
|
||||
/* 投一次手动录波请求。返回值：0 - 已受理；非零 - 拒收（含未落段通道
|
||||
* 不可用），页面据此走确认链的 ERR 支 */
|
||||
int (*manual_req)(void);
|
||||
/* 取盘上数值最大的段号（回放页开屏落点；左右键从此起环游）。
|
||||
* 回绕后本序不保证时间最新，页顶段号即自证；时间序要靠段头
|
||||
* frame_seq/t0，代价是 100 次开文件，本波不做（lead 裁定 2026-10-29） */
|
||||
int (*seg_first)(uint8_t *a_idx);
|
||||
/* 取比 a_cur 更早一段的段号（到最早端后环回数值最大端） */
|
||||
int (*seg_prev)(uint8_t a_cur, uint8_t *a_out);
|
||||
/* 取比 a_cur 更新一段的段号（到最大端后环回数值最小端） */
|
||||
int (*seg_next)(uint8_t a_cur, uint8_t *a_out);
|
||||
/* 读段头并做完整性判定（头 CRC 与数据 CRC 都在执行侧验完）。
|
||||
* 出参：eng - 单位口径（UI_DATA_ENG_* 同值域）；trig - 触发源
|
||||
* （段头 trig_src 原值：手动/保护/定时）；clip - 形状受限通道位图
|
||||
* （段头 clip 字节，位号 = 通道号） */
|
||||
int (*seg_head)(uint8_t a_idx, uint8_t *a_eng, uint8_t *a_trig,
|
||||
uint8_t *a_clip);
|
||||
/* 读当前显示窗口的码值（已并入 b_codes 偏移）与窗口峰值。
|
||||
* 出参：a_codes - UI_WAVE_WIN_PTS 个码值；a_peak_milli - 窗口内
|
||||
* 绝对值最大的那一点折算的 mV（定点，执行侧经 code_to_milli 算好，
|
||||
* 页面不重复换算式——§6.3 的单一口径条款；b_codes 由 code_to_milli
|
||||
* 内部加，与 a_codes 里已并的偏移同一把尺：谁被显示谁被度量） */
|
||||
int (*seg_win)(uint8_t a_idx, uint8_t a_ch, int16_t *a_codes,
|
||||
int32_t *a_peak_milli);
|
||||
} ui_data_wave_ops_t;
|
||||
|
||||
/*
|
||||
* 函数功能：注入录波执行侧函数表（启动期一次；形状对齐 ui_data_comm_bind）
|
||||
* 入口参数：ops - 函数表（六件都不得为 NULL）；NULL = 撤销注入（宿主测试用）
|
||||
* 返回值：0 - 已注入/已撤销；-1 - 残表（存量不动） int
|
||||
* 限定条件：uiTask 启动期、先于 ui_menu_init()
|
||||
*/
|
||||
int ui_data_wave_bind(const ui_data_wave_ops_t *a_ops);
|
||||
|
||||
/*
|
||||
* 函数功能：投一次手动录波请求（录波触发页唯一写出口）
|
||||
* 返回值：0 - 已受理；-1 - 未注入或拒收（未注入与拒收同码，同通道五） int
|
||||
*/
|
||||
int ui_data_wave_manual_req(void);
|
||||
|
||||
/*
|
||||
* 函数功能：取数值最大段号（排序口径见 ui_data.c 同名胶水注释：回绕后本序
|
||||
* 不保证时间最新，页顶段号即自证；真时间序要逐段读 frame_seq/t0，
|
||||
* 代价 100 次开文件，本波不做）
|
||||
* 入口参数：a_idx - 出参，段号（仅返 OK 时可读）
|
||||
* 返回值：UI_WAVE_OK / UI_WAVE_NONE / UI_WAVE_BAD（未注入按 NONE 渲染空态，不崩） int
|
||||
*/
|
||||
int ui_data_wave_seg_first(uint8_t *a_idx);
|
||||
|
||||
/*
|
||||
* 函数功能：取 a_cur 的更早一段段号（环形回绕）
|
||||
* 入口参数：a_cur - 当前段号；a_out - 出参（仅返 OK 时可读）
|
||||
* 返回值：UI_WAVE_OK / UI_WAVE_NONE / UI_WAVE_BAD int
|
||||
*/
|
||||
int ui_data_wave_seg_prev(uint8_t a_cur, uint8_t *a_out);
|
||||
|
||||
/*
|
||||
* 函数功能：取 a_cur 的更新一段段号（环形回绕，方向与 prev 相反）
|
||||
* 入口参数：a_cur - 当前段号；a_out - 出参（仅返 OK 时可读）
|
||||
* 返回值：UI_WAVE_OK / UI_WAVE_NONE / UI_WAVE_BAD int
|
||||
*/
|
||||
int ui_data_wave_seg_next(uint8_t a_cur, uint8_t *a_out);
|
||||
|
||||
/*
|
||||
* 函数功能：读段头（含执行侧 CRC 完整性判定）——出参仅返 OK 时可读
|
||||
* 返回值：UI_WAVE_OK / NONE / BAD（未注入按 NONE） int
|
||||
*/
|
||||
int ui_data_wave_seg_head(uint8_t a_idx, uint8_t *a_eng, uint8_t *a_trig,
|
||||
uint8_t *a_clip);
|
||||
|
||||
/*
|
||||
* 函数功能：读显示窗口码值与峰值 mV——出参仅返 OK 时可读
|
||||
* 返回值：UI_WAVE_OK / NONE / BAD（未注入按 NONE） int
|
||||
*/
|
||||
int ui_data_wave_seg_win(uint8_t a_idx, uint8_t a_ch, int16_t *a_codes,
|
||||
int32_t *a_peak_milli);
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
#endif
|
||||
|
||||
Reference in New Issue
Block a user