wandering1
9231a3c22c
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 钩子全绿
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