 wandering1
|
f5902bcc21
|
docs(design): 运行/自检记录与 ADC 节拍两篇改为现状设计并去掉档名"说明"
两篇规划期文档改成对当前系统的描述，档名统一去掉"设计说明"的"说明"。
运行与自检记录：
- 旧档重写为现状版（10 节：概览 / 记录布局 / 写入路径 / 读取与呈现 /
事件分类 / 控制台日志 / 双端差异 / 内存 / 异常恢复 / 自测要点），
删掉需求表、调研摘要、模块清单动作列、实施步骤与开放问题。
- 按代码纠正：七类记录齐备（原文只写了两类）、自检描述串换成实际
落盘的 28 条、待机阈值以 ui_tokens.h 为准、记录页已走 ui_w_records
共享组件、容量满只删该文件而非整卷清空。
- 待机屏移出本篇：它不属于日志，归 UI 侧；内容页架构补"待机屏
（覆盖层）"一节，产品需求 FR-LOG-3 拆成单纯的上电/重启分类，
待机显示归口已有的 FR-UI-3。
ADC 采样节拍：
- §4.5 从 45 行压到 24 行，只留规则 / 违反的代价 / 为什么 / 兜底与
档案指针；九路置换实测表、A/B 对照、探针计数等取证归
ADC_Trap_Records.md 的 TRAP-ADC-01（那里已有完整档案）。
- adc1_gap 字段去掉"2026-10-21 起、此前固件为次数"的修订记录式括号。
- app_main.c 的注释改为指向 TRAP-ADC-01 取证、§4.5 设计口径。
引用同步：两个旧档名全仓替换（含代码注释、角色档、归档 id 表），
旧名残留 0；对 ADC 篇的 § 引用逐条复核落在真实章节上。
验证：48 个提交期钩子全通过，check_doc_links --sections-strict 通过。
|
2026-11-15 21:30:07 +08:00 |
|
|
wandering1
|
1166ab1c2e
|
fix(adc): 挂 DMA 前关闭 ADC，消除乒乓缓冲 +2 格相位旋转
问题：ADC1 在 MX_ADC1_Init() 里使能，而 DMA 在 app_main_init() 步骤
4b 才挂载，中间隔着 GD5F 全片 BBT 扫描（数秒）。台架同一次开机内用
无 DMA 单通道逐路取真值、与 DMA 路径对照，得 9/9 完美置换：乒乓缓冲
从 rank 3 开始搬，槽 i 装的是 rank ((i+1) mod 9)+1，整体错开 2 格。
表象是"接地 AIN2、UB 却读到别的通道的值"，极易误判为映射表写错或
注入点标签不对。
修法：新增 adc1_disable()（Src/adc.c 的 USER CODE BEGIN 1），在
app_main_init() 步骤 4b-pre 调用，把 ADC 置为关闭态，使能动作交给
HAL_ADC_Start_DMA() 内部完成（它自己 __HAL_ADC_ENABLE + 等 Tstab
约 20 us，紧接着开 CR2.DMA 并启流），使能与搬运之间不留可观测间隔。
顺序不可调换：本调用必须严格早于 adc_input_init()。
台架验证：在 MX_ADC1_Init() 末尾关闭 4/4 次、在 4b-pre 调本 API
3/3 次，均 UB=0；同开机对照差值 <=4 码（修前 7/7 次 UB=783~786）。
文档：ADC采样节拍设计说明.md 新增 4.5 节（9 行证据表、判据陷阱、
根因与修法）与设计铁律第 8 条。
台账：Flash 261,764 -> 261,928 B（+164，新增函数），RAM 无变化；
CubeMX 存活审计基线重建（adc1-calibration-impl / adc1-dma-link
两项漂移均属本次有意改动，锚点已逐条复核在位）。
|
2026-10-27 20:42:06 +08:00 |
|
|
wandering1
|
9231a3c22c
|
adcTask 事件驱动消费（P1-5 方案 a）+ 补 F4 ADC 上电自校准 + 修正 2 ms 忙等过期表述
P1-5 方案 a（事件驱动消费，Task #32）：
- TIM6 1 kHz ISR 除触发 CONVST 外再调 adc_tick_irq_notify()，置位
ADC_WAKE_FLAG；adcTask 循环尾改 osThreadFlagsWait(osWaitForever)，
删除 ADC_TASK_BEAT_MS 定时轮询
- adcTask 优先级 Normal(24) -> AboveNormal(32)（Src/freertos.c USER CODE 区）
- 补消费者就绪门（规划未预见）：TIM6 在 app_main_init 就启动，比调度器
早约 100 ms，未就绪时 ISR 不得 osThreadFlagsSet
- 实测 6 次上板：idle 由 1~649 降到 0/20000 拍，frames 1000.0 Hz，
seq-frames=7 正是就绪窗口；UI 侧 uip/uiw/uis 无退化
补 STM32F4 ADC 上电自校准（此前项目从未做过）：
- 核查证实裁剪版 HAL 无 HAL_ADCEx_Calibration_Start、裁剪版 CMSIS 头无
ADC_CR2_CAL -> 按 RM0090 13.3.6 在 Src/adc.c 的 USER CODE 区手写
adc1_calibrate()，MX_ADC1_Init() 末尾调用
- 新增 cubemx-survival 审计项 adc1-calibration-call / -impl（清单 21->23）
- 实测校准前后同一拍 STM32 侧 6 路同向偏移 +10~+63 LSB，TPAFE 侧不变
修正两处过期表述（实测反证）：
- 原文 9 通道全超时最坏 = 18 ms 连占 有误：stm32_scan() 在首个超时处即
Stop+return，单拍上界 = 一次超时约 2~3 ms
- adcm 约 2.1 ms 的峰值归因由 ADC 采集改判为每 10 s 一次的心跳日志；
6 次对照 adcp = 122 us（无超时）/ 2209 us（超时 1 次）
- 同步修正 adc_task.c 两处过期注释；新发现超时拍 STM32 侧静默沿用
上一拍值的正确性代价，硬化排序记入 4.4 / 10.4（未实施）
验证：@build 0 错 0 警（Code 256728 -> 256868）；@test 6/6 PASS；
stack_report 7 任务全 PASS（adcTask 832 B / 余 59%）；18 钩子全绿
|
2026-10-10 22:41:19 +08:00 |
|
|
wandering1
|
53bd9af02e
|
对齐 CubeMX 输出：提交第三方与生成文件的文件末尾空行（85 文件，零逻辑变化）
|
2026-10-10 01:05:15 +08:00 |
|
|
wandering1
|
5eed2151de
|
CubeMX 生成 ADC1（9 通道）+ 复原重生成定制，FreeRTOS 加固迁 L1、钩子落 USER CODE 4/5，门禁豁免生成文件空白改写
|
2026-10-10 00:53:20 +08:00 |
|