STM32Cube 工程把启动文件、CMSIS、芯片头文件、HAL/LL、板级支持和应用组织在一起。学习工程时应能指出这些部分分别负责什么，知道生成代码来自哪些配置，并能根据手册解释关键寄存器。

本页以 STM32F401RE 和 STM32CubeF4 v1.28.1 作为阅读目标，不要求已经拥有开发板。其他 STM32 系列的时钟、引脚复用、DMA、缓存和安全特性可能不同，不能直接照搬。

HAL、LL 与寄存器怎样分工

HAL 提供状态、句柄、回调和较高层接口，适合多数常规业务。LL 更接近寄存器，便于控制路径和时序，但需要自己处理更多状态。直接访问寄存器适合确有必要的关键路径，代价是可移植性和维护负担。

同一外设混用 HAL 与直接寄存器写入时，要确认 HAL 内部状态仍然正确。不要让 HAL 认为 DMA 尚未启动，而另一段代码已经启动了它。先选择明确的所有权，再考虑优化。

从时钟树推导定时器周期

对向上计数、每次溢出产生更新事件的普通定时器：

fupdate = fTIM / ((PSC + 1) × (ARR + 1))

假设已经核对 TIM2 输入为 84 MHz，PSC=83、ARR=999，则计数频率 1 MHz，更新频率 1 kHz。PSC 和 ARR 都是寄存器值，实际除数要加一。

在 F401 常见配置中，APB 分频器不为 1 时相关定时器时钟可能是对应 PCLK 的两倍；必须按具体芯片时钟树核对。CPU 主频、PCLK 与定时器输入频率不是同一个量。中心对齐、重复计数器和外部时钟模式还会改变事件关系。

下载 定时器分频计算器，执行 python timer.py。脚本搜索能精确产生 1 kHz 的 16 位分频组合，核对 PSC=83/ARR=999 和边界检查。它运行于主机，只验证整数分频关系。

迁移到板上的步骤

安装 STM32CubeIDE 及其匹配的 Arm GNU 工具链，记录 IDE、编译器、CubeMX 和固件包版本。用板级选择或明确芯片型号建立工程，核对外部晶振是否实际存在，再配置系统时钟、GPIO、TIM2 内部时钟与更新中断。保留 .ioc、链接脚本和编译参数，不只保存 main.c。

在 Cube 生成的初始化完成后启动定时器。下面片段依赖生成工程中的 htim2 与相应 HAL 模块，不能单独编译：

if (HAL_TIM_Base_Start_IT(&htim2) != HAL_OK) {
    Error_Handler();
}

void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) {
    if (htim->Instance == TIM2) {
        HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5);
    }
}

前提是 PA5 已配置成合适的推挽输出，且板上连接允许该操作。每 1 ms 翻转一次，完整方波周期为 2 ms，即 500 Hz。把中断频率和输出方波频率混为一谈，是常见的测量解释错误。

本页 C 片段未在厂商工具链编译或上板；已执行的是 Python 分频计算。上板后用计时器输出比较做基准，比较 ISR 翻转 GPIO 的抖动，在不同优化等级和中断负载下记录结果。

练习：设定目标 997 Hz，计算最接近的 PSC/ARR、实际频率与 ppm 误差；再解释晶振误差为何会叠加到整数分频误差。遇到周期刚好偏一倍，按时钟树、计数模式、翻转频率三层检查。

面试自查：为什么软件延时不适合精确采样？HAL 回调能否放耗时日志？PSC/ARR 的更新为何可能需要预装载和更新事件？什么时候值得把 HAL 换成 LL？

参考：STM32CubeF4 v1.28.1 工程说明、ST AN4776 定时器应用、F401RE Nucleo 官方资料。