wandering1
1166ab1c2e
问题：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 两项漂移均属本次有意改动，锚点已逐条复核在位）。
Src/ — CubeMX 生成的源文件
⚠️ 本目录文件由 STM32CubeMX 生成（
.ioc重生成会覆盖），不是自研代码。 但允许在USER CODE BEGIN/END标记区之间写自定义代码。
文件一览
| 文件 | 生成 | 作用 |
|---|---|---|
main.c |
CubeMX | 程序入口：HAL_Init → SystemClock_Config → 外设初始化 → app_main_init → osKernelStart |
freertos.c |
CubeMX | FreeRTOS 任务创建（MX_FREERTOS_Init）+ 任务栈/优先级定义 |
gpio.c / dma.c / spi.c / i2c.c / usart.c |
CubeMX | 各外设 MX_xxx_Init |
stm32f4xx_hal_msp.c |
CubeMX | HAL 外设底层初始化（时钟使能、NVIC、引脚复用） |
stm32f4xx_hal_timebase_tim.c |
自研覆盖 | HAL 时基改用 TIM7（非 SysTick），tick = 1ms |
stm32f4xx_it.c |
CubeMX | 中断服务函数（ISR） |
system_stm32f4xx.c |
CMSIS | 系统时钟初始化（SystemInit） |
⚠️ 修改约定（铁律）
- 自定义代码只写
USER CODE BEGIN xxx/USER CODE END xxx标记区之间—— 标记区外的内容在 CubeMX 重新生成时会被无条件覆盖丢失 - 本目录被 pre-commit 的 C 代码规范检查排除（因是生成代码，风格不受控）
Drivers/BSP/才是纯手工代码区；应用逻辑放App/
关键点
- HAL 时基 = TIM7，不是 SysTick；FreeRTOS 用 SysTick 之外的方式，tick = 1ms
- NVIC 4 位优先级分组；外设中断优先级 ≥ 5（0~4 预留给 FreeRTOS）
- 时钟：HSE 8MHz → PLL M=4/N=168/P=2 → 168MHz
相关文档
- 架构全景：
docs/架构设计/项目架构总览.md - 启动顺序：
docs/架构设计/项目启动顺序管理.md - 任务表（唯一事实源 =
freertos.c）：根README.md