 wandering1
|
5a9988b557
|
chore(注释): 清掉源码里不可检索的过程编码
清掉的（读者无从解析、且所指文档已不存在）
- 已删任务文档的编号：Task #32、其内部 §5 / §4.3、P1-5、P0-2、P1-4a、
"方案 a"、"Lead 批准 2026-10-12"
- 正文里当代词用的文件版本号："（v2.7 起为 AboveNormal）""已随 v2.0 事件
驱动改造删除""（v2.0：DMA 消费）""见文件头 v1.3 说明"等 → 改写成陈述现状
- 测试与脚本同类：adc_input 桩头"v2.0：DMA 模型"、stub/adc.h 的 v2.0、
check_cubemx_survival.py 段头的"2026-10-10 v2.8"、run_all_suites.py 的"方案 A"
刻意保留
- 可检索登记簿锚点：P-AUDIT 真条目（P0-1/P1-8/P2-1/P2-9/P3-11）、S6/S11、
E-31/E-44、N-18/N-23/N-32、B1/B5/B7/B8、L1-x~L5-x 功能号
- 文件头修改记录块内的 vN.M（规范 V1.0 §2.1/§2.2 要求保留该块；块内编号
在本文件内自洽可读）
顺带纠正注释与代码已经不一致的过时事实
- 仍把 TIM6 写成现行节拍源：Src/main.c 的 include 注释与回调注释、
Src/freertos.c 的 adcTask 块 → 改 TIM3；adc_input.h 修订条目里"ADC1 只认
TIM2/TIM3/TIM8 的 TRGO"不准确 → 换成指向判据（ADC采样节拍设计说明 §3.2）
- App/algo/phasor.c 双区注释称"唯一消费者是 adcTask、为后续保护任务预留"，
实际 protectTask 已跨上下文读（prot_elm_run -> phasor_get）→ 改为"读者跨
adcTask 心跳与 protectTask 判据两个上下文，勿改加锁、勿取消双区"，并同步
修正 docs/算法/采集与算法层设计说明.md 同一句
- adc_tick_irq_notify() 的"拒绝 ISR 内计算"理由仍写"内含 2 ms 忙等"（DMA 化
后已无忙等）→ 换成三条真实理由：任务级共享数据 / 计算量 / 生成区回调
- 裸 §5（指代不明）与"规划 §1.6 / 规划 §4"昵称式 → 写成完整路径紧邻式
字节卫生（Edit 会静默剥 BOM）
- App/task/ui_task.c 与 Drivers/BSP/UI/ui_net_sink.c 被剥掉 BOM 两次，均按
3 字节 EF BB BF 前缀补回并复验；全部 20 个文件 CR=0、U+FFFD=0、无行尾空白
门禁
- @build 0 错误 0 警告，且 Program Size 与清理前逐项相同
（Code=213356 RO=18580 RW=1184 ZI=131480）→ 纯注释改动、中文未被误重编码
- ui-golden 首跑红：新工作树缺被 gitignore 的黄金参考 simulator/tests/ref/
（不入库、只在主工作树生成过）；从主工作树复制该基线后复跑通过 → 注释改动
零像素影响
- 全套 pre-commit 在这 20 个文件上 Passed（coding-standard / cppcheck /
6 个主机单测 / doc-links / task-table / mem-numbers / cubemx-survival /
registration-check / mem-budget / font-charset / ui-golden / id-check）
- id-check 可判定比例 82.71% -> 82.88%（删掉的是"形似 P-AUDIT 但查无定义"的
假锚点），悬空引用 863 -> 854
|
2026-10-21 11:39:53 +08:00 |
|
|
wandering1
|
54d6d2d5d5
|
docs: 删除 Task #32 停摆分析（已结案），可复用结论并入看门狗设计说明 §11
按登记簿"完成即销项"规则删除 docs/问题记录/UI任务看门狗停摆分析.md
（560 行）。结案依据：累计 38 次上板启动 0 复现（原 L2 基线 3/10），
P0/P1-4a/P1-5/P2/方案 A 全部落地，方案 B 已评估决定不做。
并入 docs/子系统设计/看门狗设计说明.md 新增 §11（只留可复用部分）：
- §11.1 三条易误读的判读口径：启动期 MISS start 0x67 是良性 episode；
miss= 是累计不是连续（连续数饱和在 WD_MISS_TOLERANCE=8）；
reset cause 不能区分 IWDG 溢出与台架软件复位
- §11.2 诊断四步：先看掩码缺几位（只缺 1 位 = 定点打击，多位 = 全局
饥饿）→ 逐项量化占空比（实测 10%~13%，否掉"CPU 饱和"直觉）→
用计数速率反证空转（ring 恰好 1000/s）→ 用 [PROF] 指认占用者
- §11.3 三条结构性脆弱点（uiTask 唯一 BelowNormal／心跳曾依赖 netTask
往返／自定截止期不可恢复）+ 两个顺带修掉的正确性缺陷（无新帧仍压环
≈3% 频率失配、失败拍静默沿用旧值）
- §11.4 [PROF]/[PROF2] 全字段语义 + v2.8 实测基线（netp=0 是真实值、
adcm 峰值来自心跳日志、uip 地板 = LVGL 帧周期）与三机理判读口诀
- §11.5 三条教训：门控类优化必须保留低频兜底；门控会顺手消灭暴露路径；
事件驱动要核对节拍源启动时刻 vs 消费者创建时刻
- §11.6 明确不做的四条及理由（提 uiTask 优先级会掩盖真缺陷、net_* 有界
等待版会串回执、推流搬出 uiTask、推流塞进 netTask）
UI 推流门控与方案 B 否决理由收进 RemoDispBus 协议说明 §3（该处原本已有
摘要，改为自洽不再回指）；就绪门控 API 的约束已在 BSD Socket 指南 §10.1。
引用改指 12 处：ui_task.c、task_prof.c/.h、ui_net_sink.c/.h、docs/README、
RemoDispBus、看门狗设计说明 R7 行、ADC 采样节拍设计说明、BSD Socket 指南
×2、项目审查报告 N-10 ×2。
⚠ ui_task.c / ui_net_sink.c / ui_net_sink.h 是带 BOM 文件，Edit 剥掉了
BOM，已按原样补回 3 字节 EF BB BF（未整文件重写）。
验证：check_doc_links --all 通过（127 个文档，无悬空引用）；
@build 0 错 0 警，Code=257660 与删除前一字不差（纯注释改动）。
|
2026-10-11 00:38:50 +08:00 |
|
|
wandering1
|
3b1d0308d8
|
fix(ui): Task #32 P0/P1/P2 — 解耦 UI 心跳、修 adc 压环与截止期、加测量探针
Task #32 UI 看门狗停摆（docs/问题记录/UI任务看门狗停摆分析.md）
P0 adc_task.c（已上板验证）:
- 仅 r==1 才压环+重算；上板印证 ring==frames（修前 ring=frames+idle）
- osDelayUntil 返回值重同步，落后拉回基准，解除永久空转死锁
P1-4a ui_task.c v1.3: task_wd_beat 提到 ui_net_sink_poll 之前
→ 心跳测"UI 活着"而非"netTask 响应"，解开 §4.2 心跳依赖
→ 未上 P1-3（提优先级会掩盖 §4.2/§4.4）；P1-5 暂缓
P2 新增 App/util/task_prof.c/.h: DWT 常开探针，测各任务周期/耗时/
推流往返/ADC 轮询/控制台排空/syslog 落盘/net_poll 最坏值；心跳位图
1→0 边沿裸 UART 直发 [PROF]/[PROF2] 快照；uvprojx 已登记
doc: 分析 doc §7 补良性启动 episode 与复位非诊断项；§8 加处置落地
验证: P0+P1 累计 32 次上板启动 0/32 复现（原 L2 基线 3/10），构建 0/0
|
2026-10-10 19:06:06 +08:00 |
|