1. STM32定时器体系架构与工程原理

在嵌入式系统开发中，定时器（Timer）绝非简单的“计时工具”，而是贯穿整个系统控制逻辑的核心外设。STM32系列微控制器构建了一套层次分明、功能递进的定时器架构，其设计哲学深刻体现了资源复用、功能解耦与实时性保障的工程思想。理解这套架构，是驾驭中断调度、PWM驱动、信号测量等关键任务的前提。

1.1 三大类定时器的工程定位

STM32的定时器并非同质化模块，而是根据应用场景与复杂度划分为三个明确层级：基本定时器（Basic Timer）、通用定时器（General-purpose Timer）和高级定时器（Advanced-control Timer）。这种划分并非随意，而是由芯片内部总线拓扑、寄存器组设计及配套硬件电路共同决定的工程实践。

• 基本定时器（TIM6/TIM7） ：这是最精简的定时器实现，仅包含一个16位自动重装载计数器（ARR）、一个16位预分频器（PSC）以及一个更新事件（Update Event）触发机制。它没有输入捕获（Input Capture）或输出比较（Output Compare）通道，因此无法直接与GPIO引脚交互产生PWM或测量外部信号。其核心价值在于提供高精度、低开销的纯软件定时服务，常用于系统心跳、任务调度周期基准或RTOS内核滴答源。在资源受限的低端型号中，TIM6/TIM7往往是唯一可用的定时器。

• 通用定时器（TIM2/TIM3/TIM4/TIM5） ：这是应用最广泛的定时器类别，功能完整且灵活。每个通用定时器在基本定时器的基础上，集成了4个独立的输入捕获/输出比较通道（CH1-CH4），并支持多种计数模式（向上、向下、中央对齐）。这使其能同时承担多种角色：作为精确延时源、生成多路相位可控的PWM信号、测量脉冲宽度与周期、编码器正交信号解码，甚至作为简易的DAC波形发生器。其“通用”之名，正源于此一器多用的工程适应性。

• 高级定时器（TIM1/TIM8） ：这是为高可靠性、高动态响应工业控制场景而生的定时器。它在通用定时器所有功能之上，增加了互补PWM输出、可编程死区插入（Dead-time Insertion）、紧急刹车（Break Input）等关键特性。这些特性直指电机驱动、逆变器控制等功率电子领域的核心痛点——防止上下桥臂直通导致的短路炸机。高级定时器的出现，标志着STM32从通用MCU向工业级运动控制器的演进。

必须强调，所有定时器在物理上都是完全独立的硬件单元。TIM2的计数器运行状态、寄存器配置与TIM3互不干涉，它们共享的是同一个APB1或APB2总线时钟源，而非计数逻辑本身。这种设计保证了多任务并发时的确定性与时序隔离，是构建稳定实时系统的基石。

1.2 定时器工作原理：从时钟源到中断事件

定时器的本质是一个受控的数字计数器。其工作流程可抽象为一个闭环： 时钟驱动 → 预分频 → 计数 → 溢出 → 重载 → 事件触发 。理解每一步的工程目的与参数含义，是进行精准配置的关键。

1.2.1 时钟源与预分频器（PSC）：精度与范围的权衡

所有定时器的计数脉冲均源自系统时钟树。以常见的STM32F103为例，其APB1总线（TIM2-TIM7挂载于此）最高可运行于72MHz。若直接将72MHz时钟送入16位计数器，其最大计数值为65535，理论最长定时周期仅为 65535 / 72,000,000 ≈ 0.91ms 。这远不能满足如1秒LED闪烁、100ms通信超时等常见需求。

预分频器（Prescaler）正是解决此矛盾的核心机制。它是一个16位可编程分频器，位于定时器时钟输入与计数器之间。其作用是将高频的总线时钟“降频”为一个较低频率的计数时钟（CK_CNT）。分频系数由寄存器PSC的值决定，实际分频比为 (PSC + 1) 。例如，设置 PSC = 7199 ，则分频比为7200，72MHz时钟被降至 72,000,000 / 7200 = 10kHz ，此时计数器每100μs加1，最大定时周期可达 65535 * 100μs ≈ 6.55s 。

工程要点 ：PSC的设置是精度与范围的权衡。过大的PSC值虽能延长定时周期，但会降低时间分辨率（最小可分辨时间变长）。例如，在10kHz计数时钟下，最小定时单位为100μs；而在1MHz计数时钟下，最小单位仅为1μs。因此，应根据应用所需的最小时间精度，反推PSC的合理取值，再通过ARR寄存器调整最终周期。

1.2.2 自动重装载寄存器（ARR）与计数器（CNT）：周期的定义者

计数器（CNT）是一个16位向上/向下/中央对齐计数器，其当前值实时反映已流逝的计数时钟周期数。自动重装载寄存器（ARR）则定义了计数器的“边界”。当CNT的值达到ARR时，即发生一次“溢出”（Overflow），计数器硬件逻辑会立即执行两项操作：
1. 将CNT寄存器清零（向上计数模式）或置为ARR（向下计数模式）。
2. 触发一个“更新事件”（Update Event）。

这个更新事件是定时器功能的中枢。它不仅是定时中断的源头，也是所有影子寄存器（Shadow Register）内容同步到工作寄存器的时刻。例如，当用户在代码中修改了ARR的值，该新值并不会立刻生效，而是被写入一个“影子寄存器”。只有当下一个更新事件发生时，影子寄存器的内容才会被原子地复制到实际参与计数的ARR工作寄存器中。这种“双缓冲”机制确保了计数过程的绝对连续性与稳定性，避免了因软件修改寄存器而导致的计数错误或中断丢失。这也是为什么在需要动态改变PWM占空比或定时周期时，必须启用ARR的预装载功能（ARPE位）。

1.2.3 更新事件（UEV）与中断：软件响应的入口

更新事件（UEV）是定时器向CPU发出的“我已完成一个周期”的信号。HAL库中， HAL_TIM_PeriodElapsedCallback() 回调函数正是在更新事件触发的中断服务程序（ISR）中被调用的。该回调是绝大多数定时应用的主干逻辑所在，例如：
- 切换LED状态（实现闪烁）。
- 更新数码管显示（驱动动态扫描）。
- 执行PID控制算法的一个采样周期。
- 触发ADC转换开始（T触发）。
- 向FreeRTOS任务发送信号量（通知任务可以执行）。

在HAL库中，使能更新中断的典型流程为：

// 1. 配置定时器句柄（在CubeMX中生成或手动初始化）
TIM_HandleTypeDef htim6;
htim6.Instance = TIM6;
htim6.Init.Prescaler = 7199; // 分频7200，得到10kHz计数时钟
htim6.Init.CounterMode = TIM_COUNTERMODE_UP;
htim6.Init.Period = 9999;    // ARR=9999，计数0->9999共10000次
htim6.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1;
htim6.Init.RepetitionCounter = 0;
HAL_TIM_Base_Init(&htim6);

// 2. 启动定时器并使能更新中断
HAL_TIM_Base_Start_IT(&htim6);

其中， HAL_TIM_Base_Start_IT() 函数内部完成了开启定时器计数（ TIMx->CR1 |= TIM_CR1_CEN ）和使能更新中断（ TIMx->DIER |= TIM_DIER_UIE ）两步操作。此后，每当计数器溢出，CPU便会跳转至 TIM6_DAC_IRQHandler 中断向量，并在其中调用 HAL_TIM_IRQHandler() ，最终执行用户定义的 HAL_TIM_PeriodElapsedCallback() 。

2. 通用定时器的高级功能：输入捕获与输出比较

通用定时器的强大之处，在于其4个独立通道赋予的双向I/O能力。每个通道均可配置为输入捕获（IC）或输出比较（OC）模式，这使得定时器不仅能“发出”精确的时序信号，还能“感知”外部世界的脉冲变化，从而构成一个完整的闭环控制系统。

2.1 输入捕获（Input Capture）：精确测量外部信号

输入捕获是定时器的“耳朵”，用于精确测量外部引脚上电平跳变的时间点。其核心思想是：当检测到指定边沿（上升沿、下降沿或双边沿）时，将当前计数器（CNT）的瞬时值“冻结”并保存到一个专用的捕获寄存器（CCRn）中。通过分析连续两次捕获的CNT值之差，即可计算出信号的周期、脉宽等关键参数。

2.1.1 工作流程与关键寄存器

一个典型的输入捕获流程如下：
1. 配置通道 ：选择一个GPIO引脚（如TIM2_CH1对应PA0），将其复用功能配置为定时器输入（AF mode），并设置为上拉/下拉以确保电平稳定。
2. 配置触发边沿 ：通过 CCER 寄存器设置捕获极性（ CC1P / CC1NP ），例如 CC1P=0 表示捕获上升沿。
3. 使能捕获中断 ：在 DIER 寄存器中使能对应的捕获中断（ CC1IE ）。
4. 启动捕获 ：通过 CCMR1 寄存器将通道1配置为输入模式（ CC1S=01 ），并使能捕获（ CC1E=1 ）。
5. 中断处理 ：当指定边沿到来，CNT值被锁存至 CCR1 ，同时触发捕获中断。在中断服务程序中，读取 CCR1 即可获得该事件发生时的计数器快照。

2.1.2 实际应用：PWM信号参数解析

一个经典的应用是解析一个未知的PWM信号。假设我们有一个频率未知的PWM波，目标是测量其高电平时间（Ton）和低电平时间（Toff）。

• 第一次捕获（上升沿） ：记录CNT值为 cnt_rise1 。
• 第二次捕获（下降沿） ：记录CNT值为 cnt_fall 。则高电平时间 Ton = (cnt_fall - cnt_rise1) * T_cnt ，其中 T_cnt 是计数时钟周期。
• 第三次捕获（下一个上升沿） ：记录CNT值为 cnt_rise2 。则低电平时间 Toff = (cnt_rise2 - cnt_fall) * T_cnt ，周期 T = (cnt_rise2 - cnt_rise1) * T_cnt 。

工程难点与解决方案 ：上述计算在CNT未溢出时成立。但若信号周期很长，CNT可能在两次捕获间溢出多次。此时，简单的减法会得到错误结果（如 0x0001 - 0xFFFF = 2 ，实际应为 65538 ）。正确做法是利用溢出中断（UIE）维护一个全局溢出计数器 overflow_count ，并在每次捕获时，将 overflow_count << 16 | CCRn 组合成一个32位时间戳。或者，采用更优雅的无符号整数运算技巧： delta = (uint32_t)CCRn_new - (uint32_t)CCRn_old ，利用C语言中无符号数的模运算特性，自动处理溢出。

2.2 输出比较（Output Compare）与PWM：精确生成时序信号

输出比较是定时器的“嘴巴”，用于在指定的CNT值时刻，自动翻转或设置一个GPIO引脚的电平。当CNT值与比较寄存器（CCRn）的值相等时，定时器硬件会根据预设的输出模式（如强制高、强制低、翻转、PWM模式1/2）来改变对应通道的输出电平。这是生成PWM（脉宽调制）信号的基础。

2.2.1 PWM模式详解：频率与占空比的解耦控制

PWM信号有两个核心参数： 频率 （Period）和 占空比 （Duty Cycle）。在通用定时器中，这两个参数被完美地解耦到两个独立的寄存器中：
- 频率由ARR决定 ：如前所述，ARR定义了计数器的上限，因此 PWM_Frequency = Timer_Clock_Frequency / ((PSC + 1) * (ARR + 1)) 。改变ARR即可在不改变占空比的前提下，整体缩放PWM波形的周期。
- 占空比由CCRn决定 ：在PWM模式1下，当 CNT < CCRn 时，输出为有效电平（如高电平）；当 CNT >= CCRn 时，输出为无效电平（如低电平）。因此，占空比 Duty = CCRn / (ARR + 1) 。改变CCRn即可在不改变频率的前提下，独立调节高电平的持续时间。

2.2.2 PWM模式1与模式2：极性选择的艺术

两种PWM模式的区别在于比较逻辑的“不等号方向”：
- PWM模式1 ： CNT < CCRn → 输出有效电平； CNT >= CCRn → 输出无效电平。
- PWM模式2 ： CNT > CCRn → 输出有效电平； CNT <= CCRn → 输出无效电平。

这本质上是通过 CCMRx 寄存器中的 OCxM 位和 CCER 寄存器中的 CCxP 位（输出极性）组合实现的。例如，若希望在 CNT < CCRn 时输出低电平，只需将通道配置为PWM模式1，并将 CCxP 置1（反相输出）。这种灵活性允许开发者无需更改硬件连接，即可适配不同极性的驱动电路（如N-MOSFET驱动需高电平导通，而某些光耦隔离电路可能要求低电平有效）。

2.2.3 实践：驱动无源蜂鸣器

无源蜂鸣器是一个典型的音调发生器，其发声频率由施加在其两端的方波信号频率决定。要播放音符“Do”，需生成约261.6Hz的方波。假设系统时钟为72MHz，经PSC分频后得到1MHz计数时钟（ PSC=71 ），则ARR应为 (1,000,000 / 261.6) - 1 ≈ 3821 。为获得清晰音色，通常使用50%占空比的方波，故 CCR1 = ARR / 2 = 1911 。

在HAL库中，配置与启动PWM的代码极为简洁：

// 配置TIM3_CH2 (PB5) 为PWM输出
TIM_OC_InitTypeDef sConfigOC = {0};
sConfigOC.OCMode = TIM_OCMODE_PWM1;     // PWM模式1
sConfigOC.Pulse = 1911;                  // 占空比50%
sConfigOC.OCPolarity = TIM_OCPOLARITY_HIGH;
sConfigOC.OCFastMode = TIM_OCFAST_DISABLE;
HAL_TIM_PWM_ConfigChannel(&htim3, &sConfigOC, TIM_CHANNEL_2);

// 启动PWM输出
HAL_TIM_PWM_Start(&htim3, TIM_CHANNEL_2);

一旦启动，TIM3_CH2引脚便自动、不间断地输出261.6Hz的方波，蜂鸣器随之发出“Do”的声音。播放一首乐曲，只需按乐谱节奏，在适当时间点动态修改 htim3.Instance->CCR2 的值即可。

3. 高级定时器核心特性：死区与刹车的安全机制

在驱动大功率电机、逆变器等设备时，单纯的PWM输出存在致命风险。高级定时器（TIM1/TIM8）所集成的死区插入（Dead-time Insertion）与刹车（Break）功能，正是为应对这一工业级挑战而生的安全屏障。

3.1 死区（Dead-time）：防止桥臂直通的硬件保险

H桥驱动电路是电机控制的基石。其核心在于四只功率开关管（Q1-Q4）的精确时序配合。理想状态下，上桥臂（Q1/Q2）与下桥臂（Q3/Q4）必须严格互补导通：Q1与Q3导通时电机正转，Q2与Q4导通时电机反转。然而，现实中开关管存在开通/关断延迟（t_on/t_off），且不同器件、不同温度下的延迟存在差异。若控制信号切换时，上桥臂尚未完全关断而下桥臂已提前导通，将形成电源（Vcc）到地（GND）的直接短路路径，瞬间产生巨大电流，轻则烧毁MOSFET，重则炸毁整个驱动板。

死区就是为规避此风险而引入的“安全时间间隔”。其原理是在上桥臂关断指令发出后，强制延迟一段预设时间（Dead-time），再发出下桥臂的导通指令；反之亦然。这段延迟时间，必须大于所有开关管的最大关断延迟与最大开通延迟之和，以确保任何时候都不会出现上下桥臂同时导通。

在STM32高级定时器中，死区由 BDTR （Break and Dead-time Register）寄存器中的 DTG[7:0] 字段精确控制。该字段并非直接表示纳秒数，而是一个编码值，通过查表或公式可计算出实际死区时间。例如， DTG=0x00 可能对应1个CK_CNT周期， DTG=0x7F 则对应数百个周期。这种硬件级的死区插入，无需CPU干预，响应速度达纳秒级，是软件延时无法比拟的。

3.2 刹车（Break）：故障状态下的紧急停机

刹车功能是系统的“急停按钮”。当检测到过流、过温、欠压等严重故障时，系统必须在最短时间内切断所有功率输出，将驱动器置于一个预定义的安全状态，以保护人身与设备安全。

高级定时器的刹车输入（BKIN）是一个专用的外部引脚。当BKIN引脚被拉低（或拉高，取决于 BKP 位配置），定时器会立即执行以下动作：
1. 强制关闭所有输出通道 ：所有PWM输出被硬件强制置为无效电平（由 AOE 和 MOE 位控制）。
2. 进入刹车状态 ：定时器停止计数，进入一种特殊的“刹车锁定”模式。
3. 执行安全动作 ：通过 BDTR 寄存器中的 OSSR （Off-State Selection for Run mode）和 OSSI （Off-State Selection for Idle mode）位，可精细定义在刹车状态下，各通道输出的电平。例如，可将所有通道配置为高阻态（Hi-Z），或强制为低电平，或强制为高电平，以确保H桥处于绝对安全的“全关断”状态。

工程意义 ：刹车功能将故障响应从毫秒级（软件中断+判断+执行）压缩至微秒级（纯硬件响应）。它与死区功能协同，构成了电机驱动系统安全性的双重保险。在编写电机控制固件时，必须将刹车信号接入可靠的硬件保护电路（如运放比较器监测电流采样电阻电压），而非依赖软件轮询，这是工业产品可靠性的基本要求。

4. 基于HAL库的定时器实战项目

理论终须落地。本节将通过三个循序渐进的实验，将前述原理转化为可运行的工程代码，覆盖从基础定时到复杂信号分析的完整技能链。

4.1 实验一：基本定时器驱动数码管动态扫描

目标 ：使用TIM6产生200ms定时中断，每200ms更新一次数码管显示的数字（0-9循环）。

工程分析 ：
- 时钟源 ：APB1总线时钟72MHz。
- 预分频 ：为获得1ms基准，需将72MHz分频为1kHz。 PSC = (72,000,000 / 1,000) - 1 = 71999 。
- 自动重装载 ：200ms = 200 * 1ms，故 ARR = 200 - 1 = 199 。
- 注意 ：由于16位寄存器最大值为65535， PSC=71999 与 ARR=199 的组合完全可行，无需进一步分频。

关键代码 ：

// 在main.c中定义全局变量
static uint8_t digit_number = 0;

// 定时器溢出中断回调
void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim)
{
    if (htim->Instance == TIM6) {
        // 熄灭所有数码管位选
        HAL_GPIO_WritePin(GPIOC, GPIO_PIN_0|GPIO_PIN_1|GPIO_PIN_2|GPIO_PIN_3, GPIO_PIN_SET);
        // 显示当前数字
        display_digit(digit_number);
        // 更新数字，0-9循环
        digit_number = (digit_number + 1) % 10;
    }
}

// 在main()中初始化并启动
TIM6->PSC = 71999;
TIM6->ARR = 199;
TIM6->EGR = TIM_EGR_UG; // 重新初始化计数器
TIM6->CR1 |= TIM_CR1_CEN; // 启动计数
__HAL_TIM_ENABLE_IT(&htim6, TIM_IT_UPDATE); // 使能更新中断

4.2 实验二：通用定时器PWM驱动无源蜂鸣器

目标 ：使用TIM3_CH2（PB5）输出可变频率的PWM，演奏音符“Do”。

工程分析 ：
- 引脚映射 ：查阅原理图，确认PB5是否为TIM3_CH2。若否，需选择其他兼容引脚（如PA6为TIM3_CH1）。
- 时钟配置 ：保持APB1为72MHz，设置PSC使计数时钟为1MHz（ PSC = 71 ）。
- 频率计算 ：“Do”音约为261.6Hz，故 ARR = (1,000,000 / 261.6) - 1 ≈ 3821 。
- 占空比 ：设为50%， CCR2 = ARR / 2 = 1911 。

关键代码 ：

// 初始化TIM3为PWM模式
TIM_HandleTypeDef htim3;
TIM_OC_InitTypeDef sConfigOC;

htim3.Instance = TIM3;
htim3.Init.Prescaler = 71;
htim3.Init.CounterMode = TIM_COUNTERMODE_UP;
htim3.Init.Period = 3821;
htim3.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1;
HAL_TIM_PWM_Init(&htim3);

sConfigOC.OCMode = TIM_OCMODE_PWM1;
sConfigOC.Pulse = 1911;
sConfigOC.OCPolarity = TIM_OCPOLARITY_HIGH;
sConfigOC.OCFastMode = TIM_OCFAST_DISABLE;
HAL_TIM_PWM_ConfigChannel(&htim3, &sConfigOC, TIM_CHANNEL_2);

// 启动PWM
HAL_TIM_PWM_Start(&htim3, TIM_CHANNEL_2);

4.3 实验三：输入捕获测量PWM占空比

目标 ：使用TIM3_CH3（PB0）捕获TIM3_CH4（PB1）输出的PWM信号，精确计算其高电平时间（Ton）与低电平时间（Toff）。

工程分析 ：
- 信号环回 ：将PB0（CH3）与PB1（CH4）用杜邦线短接，形成自测回路。
- 捕获配置 ：CH3配置为上升沿捕获，CH4配置为PWM输出（ARR=19999, CCR4=9999，即50%占空比，周期20ms）。
- 双沿捕获逻辑 ：在捕获中断中，通过一个静态标志位 capture_flag 切换捕获边沿（上升沿→下降沿→上升沿…），并计算两次捕获值之差。

关键代码 ：

static uint32_t last_capture = 0;
static uint8_t capture_flag = 0; // 0: 上升沿, 1: 下降沿

void HAL_TIM_IC_CaptureCallback(TIM_HandleTypeDef *htim)
{
    uint32_t current_capture;
    uint32_t delta;

    if (htim->Instance == TIM3 && htim->Channel == HAL_TIM_ACTIVE_CHANNEL_3) {
        current_capture = HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_3);

        if (capture_flag == 0) {
            // 第一次：上升沿，记录起始时间
            last_capture = current_capture;
            capture_flag = 1;
            // 切换为下降沿捕获
            __HAL_TIM_DISABLE_IT(&htim3, TIM_IT_CC3);
            TIM3->CCER &= ~TIM_CCER_CC3P; // 清除CC3P，变为下降沿
            __HAL_TIM_ENABLE_IT(&htim3, TIM_IT_CC3);
        } else {
            // 第二次：下降沿，计算Ton
            delta = (current_capture >= last_capture) ? 
                    (current_capture - last_capture) : 
                    (0x10000 + current_capture - last_capture);
            Ton = delta; // Ton已计算出

            capture_flag = 0;
            // 切换回上升沿捕获
            __HAL_TIM_DISABLE_IT(&htim3, TIM_IT_CC3);
            TIM3->CCER |= TIM_CCER_CC3P; // 设置CC3P，变为上升沿
            __HAL_TIM_ENABLE_IT(&htim3, TIM_IT_CC3);
        }
    }
}

5. 调试技巧与常见陷阱

在实际开发中，定时器相关的Bug往往隐蔽且难以复现。掌握高效的调试方法，能极大提升开发效率。

5.1 使用IDE调试器观测变量

当无法使用串口打印（如未初始化USART）时，现代IDE（如STM32CubeIDE、Keil uVision）的调试器是绝佳工具。在调试模式下：
- Watch窗口 ：可直接添加全局变量（如 Ton , Toff , digit_number ）进行实时监视。右键变量选择“Add to Watch”即可。
- 寄存器视图 ：可查看 TIMx->CNT , TIMx->ARR , TIMx->PSC , TIMx->CCR1 等寄存器的实时值，验证配置是否生效。
- 内存视图 ：可观察特定内存地址，用于调试DMA传输或复杂数据结构。

5.2 常见陷阱与规避策略

• 中断优先级冲突 ：若多个外设（如UART、EXTI）与定时器共享同一中断优先级组，可能导致高优先级中断抢占定时器中断，造成时序偏差。 策略 ：为定时器分配最高优先级（如NVIC_SetPriority(TIM6_DAC_IRQn, 0)），并确保其抢占优先级高于所有其他中断。

• ARR/PSC值计算错误 ：忘记 -1 是新手最常见错误。记住，寄存器值 X 代表计数 0 到 X 共 X+1 个周期。 策略 ：在代码中显式写出计算过程，如 htim6.Init.Period = (uint32_t)((72000000 / 1000) - 1); 。

• HAL库版本Bug ：如字幕中提到的HAL 1.8.0版本在 HAL_TIM_IC_Start_IT() 中存在括号匹配错误。 策略 ：始终关注ST官方发布的HAL库Release Notes，升级到最新稳定版；若无法升级，务必检查生成的底层驱动文件（如 stm32f1xx_hal_tim.c ）中的相关函数。

• GPIO复用配置遗漏 ：使能定时器通道前，必须将对应GPIO配置为复用推挽输出（对于PWM输出）或复用浮空输入（对于输入捕获），并使能该GPIO端口的时钟。 策略 ：在CubeMX中配置后，仔细检查生成的 MX_GPIO_Init() 和 MX_TIMx_Init() 函数，确认 __HAL_RCC_GPIOx_CLK_ENABLE() 和 GPIO_InitStruct.Mode 的设置。

我在实际项目中曾遇到一个棘手问题：使用TIM2_CH1捕获一个20kHz方波时，测得的周期总是比理论值小约10%。排查数小时后发现，是由于在 HAL_TIM_IC_CaptureCallback() 中执行了过多的浮点运算，导致中断处理时间过长，错过了下一个上升沿。最终解决方案是将所有计算移至主循环，在中断中仅做最简数据采集，并用一个标志位通知主循环处理。这再次印证了一个朴素的真理：在实时系统中，中断服务程序（ISR）必须像刀锋一样锐利——只做最必要的事。