1. 项目概述：从“定时”到“输出”的精准控制
在嵌入式开发里，定时器绝对算得上是核心外设里的“万金油”。很多朋友刚接触STM32的HAL库，可能最先用到的就是定时器中断，每隔固定时间干点事儿，比如闪烁个LED。但定时器的能耐远不止于此，它的“输出比较”模式，才是将精准定时能力转化为实际物理控制信号的关键桥梁。简单来说，输出比较模式让定时器从一个被动的“计时员”，变成了一个主动的“信号发生器”。
这次咱们要聊的，就是基于HAL库的STM32定时器输出比较功能。它能干什么？最典型的应用就是生成PWM（脉冲宽度调制）波形。无论是驱动舵机转到特定角度，控制电机的转速，还是调节LED的亮度，背后都离不开PWM。输出比较模式的核心思想，是让定时器的计数器（CNT）与一个我们预先设定的比较值（CCR）进行“比赛”。当两者匹配时，根据我们设定的规则，硬件会自动翻转指定引脚的输出电平。这个过程完全由硬件完成，不占用CPU资源，精度高且稳定可靠。
如果你正在用STM32做平衡车、无人机、机械臂或者任何需要精密控制的项目，理解并掌握输出比较是绕不开的一步。这篇文章会从HAL库配置的底层逻辑讲起，拆解每个参数的意义，然后手把手带你配置一个可用的PWM输出，最后分享一些调试中“只有踩过坑才知道”的经验。无论你是刚上手HAL库的新手，还是想更深入理解定时器机制的老手，这里都有你想要的干货。
2. 核心原理与模式解析：硬件如何“比较”并“输出”
要玩转输出比较，不能只停留在调用HAL_TIM_PWM_Start这个函数。我们得先搞清楚，硬件到底是怎么工作的。STM32的通用定时器（如TIM2, TIM3, TIM4等）和高级定时器（如TIM1, TIM8）都支持输出比较功能，其核心部件是一个计数器（CNT）、一个自动重装载寄存器（ARR）以及多个捕获/比较寄存器（CCRx）。
2.1 输出比较的核心机制
想象一下一个向上计数的定时器：计数器CNT从0开始，每个时钟周期加1，一直加到我们设定的ARR值，然后清零重新开始，如此循环。这个循环的周期就是定时器的“时基”。
输出比较通道（每个定时器通常有4个独立的通道，对应4个引脚）关联着一个比较寄存器CCRx。我们程序的工作，就是给这个CCRx设定一个值。硬件会实时将CNT的值与CCRx的值进行比较。当两者相等时，就触发了一个“匹配事件”。这个事件本身可以产生中断（如果你开启了的话），但更重要的是，它会根据另一个寄存器——捕获/比较模式寄存器（CCMRx）和捕获/比较使能寄存器（CCER）的配置，自动改变对应输出引脚（比如TIM2_CH1）的电平状态。
这里的关键在于“模式”。输出比较有几种模式，但最常用的是这两种：
- PWM模式1和模式2：这是为生成PWM波形量身定做的模式。它决定了在CNT<CCRx期间和CNT≥CCRx期间，输出引脚分别是高电平还是低电平。通常，我们设置“当CNT<CCRx时输出有效电平（高），CNT≥CCRx时输出无效电平（低）”，这样CCRx的值就直接决定了高电平的宽度，即占空比。
- 翻转模式：每次CNT与CCRx匹配时，输出引脚的电平就翻转一次。这个模式可以用来生成固定频率的方波，或者配合中断做一些更复杂的定时操作。
注意：PWM模式是输出比较的一个特化和最常用的应用。在HAL库中，我们通常直接使用PWM相关的函数，但其底层配置的依然是定时器的输出比较单元。
2.2 关键参数计算与关系
理解以下几个参数的关系，是精准控制输出的基础：
- 定时器时钟（CK_CNT）：驱动计数器CNT跑多快的“心跳”。它来源于系统时钟（如72MHz），经过预分频器（PSC）分频得到。
CK_CNT = 系统时钟 / (PSC + 1)。 - 计数周期（ARR）：计数器CNT从0数到ARR就是一个完整的计时周期。它决定了输出波形的频率（对于PWM）或周期。
- 比较值（CCRx）：我们设定的那个用来和CNT比较的值。它决定了输出波形中有效电平的宽度，即占空比。
对于PWM生成：
- 频率（Fpwm）：
Fpwm = CK_CNT / (ARR + 1)- 例如：系统时钟72MHz，PSC=71，则
CK_CNT = 72M / (71+1) = 1MHz。若ARR=999，则Fpwm = 1M / (999+1) = 1kHz。
- 例如：系统时钟72MHz，PSC=71，则
- 占空比（Duty）：
Duty = CCRx / (ARR + 1) * 100%- 接上例，ARR=999。若CCRx=300，则占空比 = 300 / 1000 = 30%。若CCRx=700，则占空比为70%。
实操心得：在项目初期规划时，先确定你需要的PWM频率。频率太高（如上百kHz）可能受限于硬件和负载，频率太低（如几Hz）可能导致控制不流畅（如电机抖动、LED闪烁）。对于舵机，常用50Hz（周期20ms）；对于电机调速，几kHz到几十kHz比较常见；对于LED调光，几百Hz就足够了，太高可能超出人眼识别范围。确定了目标频率，再反推ARR和PSC的值。通常优先设置PSC得到一个合适的CK_CNT，再计算ARR。
3. HAL库配置详解：从CubeMX到代码生成
理论说再多，不如动手配一遍。我们以STM32F103C8T6的TIM3的通道1（对应PA6引脚）生成一个1kHz、初始占空比50%的PWM为例，讲解完整的配置流程。我会用STM32CubeMX配合代码进行说明，因为这是目前最高效、最不易出错的方式，同时也便于理解HAL库的封装层次。
3.1 CubeMX图形化配置
引脚与定时器基础配置：
- 在
Pinout & Configuration界面，找到TIM3。 - 将
Channel1的模式设置为PWM Generation CH1。此时，CubeMX会自动将PA6（或其他复用引脚，取决于具体型号）配置为复用推挽输出。 - 在左侧的
System Core->RCC中，确保你的系统时钟源（如HSE）已正确配置，并运行在目标频率（如72MHz）。
- 在
参数计算与输入：
- 切换到
Configuration标签页，点击TIM3进入参数配置。 - Prescaler (PSC - 预分频器)： 输入71。计算：目标CK_CNT = 1MHz，系统时钟72MHz，所以 PSC = 72M / 1M - 1 = 71。
- Counter Mode (计数模式)： 选择
Up（向上计数），这是最常用的模式。 - Counter Period (ARR - 自动重装载值)： 输入999。计算：目标PWM频率1kHz，ARR = CK_CNT / Fpwm - 1 = 1M / 1k -1 = 999。
- Internal Clock Division (时钟分频因子)： 保持默认
No Division。 - auto-reload preload (自动重装载预装载)： 建议使能
Enable。这样对ARR的修改会在下一个更新事件生效，防止当前周期波形出现毛刺。 - 下方
PWM Generation Channel 1部分：- Mode (PWM模式)： 选择
PWM mode 1。 - Pulse (CCR1 - 脉冲宽度)： 输入500。这决定了初始占空比 = 500 / (999+1) = 50%。
- Output compare preload (输出比较预装载)：务必使能
Enable。这是关键！它允许我们动态修改CCR1的值（即调节占空比）时，修改操作会先写入一个缓冲寄存器，直到下一个更新事件时才生效到实际的比较寄存器，从而保证PWM波形的完整性和稳定性，避免产生破碎的脉冲。 - Fast Mode (快速模式)： 通常禁用。使能后，匹配时输出会立即改变，可能用于特定需要快速响应的场景，但一般PWM不需要。
- CH Polarity (通道极性)： 选择
High，意味着“有效电平”为高。即当CNT<CCR1时输出高电平。你也可以选择Low，此时逻辑相反。
- Mode (PWM模式)： 选择
- 切换到
生成代码：
- 在
Project Manager标签页设置好工程名、路径、IDE（如MDK-ARM V5）后，点击GENERATE CODE。
- 在
3.2 生成代码结构解析
CubeMX生成的代码为我们做好了所有底层初始化。在main.c中，我们可以看到：
- 在
MX_TIM3_Init()函数里，完成了定时器时基结构和输出比较通道结构的填充与初始化。 - 在
main()函数中，调用了HAL_TIM_PWM_Start(&htim3, TIM_CHANNEL_1)来启动PWM输出。
此时，PA6引脚上应该已经有一个1kHz、50%占空比的PWM波形了。你可以用示波器或者逻辑分析仪查看。
关键结构体与函数说明：
htim3： 这是一个TIM_HandleTypeDef类型的全局句柄，包含了TIM3的所有配置和状态信息。HAL_TIM_PWM_Init(&htim3)： 初始化定时器的PWM模式（在MX_TIM3_Init中被调用）。HAL_TIM_PWM_ConfigChannel(&htim3, &sConfigOC, TIM_CHANNEL_1)： 配置指定通道的PWM参数，如极性、模式、CCR值等。HAL_TIM_PWM_Start(&htim3, TIM_CHANNEL_1)： 启动指定通道的PWM输出。这个函数会启动定时器的计数器。__HAL_TIM_SET_COMPARE(&htim3, TIM_CHANNEL_1, new_ccr_value)： 这是一个非常常用的宏，用于在程序运行中动态修改CCR值，从而改变占空比。例如，想让占空比变为75%，就执行__HAL_TIM_SET_COMPARE(&htim3, TIM_CHANNEL_1, 750)。
提示：
__HAL_TIM_SET_COMPARE宏之所以能安全地动态修改占空比，前提就是在CubeMX中我们使能了“Output compare preload”。否则，直接写入CCR寄存器可能会导致一个正在进行的PWM周期被意外截断。
4. 进阶应用与多通道协调
掌握了单通道PWM，很多基础应用就够用了。但实际项目往往更复杂，比如需要多个通道输出同步的PWM，或者需要更复杂的波形。
4.1 多通道PWM输出
一个定时器的多个通道是共享同一个计数器和ARR值的，这意味着它们输出的PWM频率必然相同，但每个通道的CCRx是独立的，因此占空比可以分别设置。这个特性非常有用：
- 控制多个LED： 用一个定时器控制多个LED的亮度，保证它们的亮度变化节奏（频率）一致。
- 驱动全彩LED： 使用定时器的三个通道分别控制R、G、B的PWM，实现混色。
- 控制多个舵机： 所有舵机使用相同的50Hz控制信号频率，但每个通道的脉宽（CCRx）独立设置，控制不同舵机的角度。
配置方法在CubeMX中很简单，只需将TIMx的其他通道（如Channel2, Channel3, Channel4）也设置为PWM Generation CHx即可。代码中分别启动各个通道：
HAL_TIM_PWM_Start(&htim3, TIM_CHANNEL_1); HAL_TIM_PWM_Start(&htim3, TIM_CHANNEL_2); HAL_TIM_PWM_Start(&htim3, TIM_CHANNEL_3);然后分别使用__HAL_TIM_SET_COMPARE宏来独立控制各通道占空比。
4.2 互补输出与死区插入（高级定时器）
对于电机驱动、全桥电路等应用，经常需要一对互补的PWM信号（如HO和LO），并且为了防止上下桥臂直通，需要在信号切换时插入一个两者都为低电平的“死区时间”。这是高级定时器（TIM1, TIM8）的专属技能。
在CubeMX中配置高级定时器的互补通道时，会有额外的Dead Time配置项。死区时间以定时器时钟周期为单位，可以灵活设置。HAL库提供了HAL_TIMEx_PWMN_Start函数来启动互补通道的输出。硬件会自动生成带死区的互补波形，极大地减轻了CPU负担并提高了可靠性。
实操心得：对于普通的GPIO控制LED或舵机，通用定时器（TIM2-TIM5）绰绰有余。一旦涉及到电机驱动（特别是直流无刷电机的FOC控制）、开关电源等需要互补PWM和死区控制的场景，务必选择高级定时器。在芯片选型时就要把这个需求考虑进去。
4.3 单脉冲输出模式
这个模式是输出比较的另一个巧妙应用。它允许定时器在收到一个内部或外部触发信号后，产生一个宽度精确可控的单脉冲，然后自动停止。这在需要精确延时触发某个动作的场景下非常有用，比如在收到一个传感器信号后，精确延时100us再打开一个激光器。
配置方法：在CubeMX中，将定时器的工作模式从Internal Clock改为One Pulse Mode，并配置好触发源（Trigger Source）。同时，将通道模式设为Output Compare的PWM mode 1或2。此时，ARR值决定了单脉冲的宽度（周期），CCRx决定了脉冲中有效电平的宽度。启动定时器后，它并不会立即运行，而是等待触发信号到来，产生一个脉冲后停止。
5. 调试技巧与常见问题排查
即使配置看起来完美，第一次上手也难免遇到问题。下面是一些典型的“坑”和排查思路。
5.1 常见问题速查表
| 现象 | 可能原因 | 排查步骤与解决方案 |
|---|---|---|
| 完全没有波形输出 | 1. 定时器未启动。 2. 引脚配置错误（未重映射或模式不对）。 3. 该引脚被其他功能占用（如JTAG/SWD）。 | 1. 检查是否调用了HAL_TIM_PWM_Start。2. 在CubeMX中确认引脚已自动配置为 TIMx_CHx，并检查生成的GPIO初始化代码。3. 对于PA13, PA14, PA15, PB3, PB4等引脚，默认是调试端口。需要在CubeMX的 System Core->SYS里将Debug改为Serial Wire或禁用JTAG，才能释放PA15/PB3/PB4用作普通IO。 |
| 波形频率不对 | 1. 系统时钟（HCLK）未正确配置到预期频率。 2. PSC或ARR计算错误。 3. 定时器时钟源选错。 | 1. 在main函数开头调用SystemClock_Config()后，用SystemCoreClock变量或HAL_RCC_GetHCLKFreq()函数打印/查看系统时钟频率。2. 仔细核对频率计算公式： Fpwm = (系统时钟/(PSC+1)) / (ARR+1)。3. 确认CubeMX中定时器的时钟源是 Internal Clock。 |
| 占空比不可调或调节异常 | 1. 未使能“输出比较预装载”（Output compare preload）。 2. 修改CCR的时机不当，导致写入被忽略。 3. 使用的宏或函数错误。 | 1.这是最常见的原因！务必在CubeMX中使能该选项。 2. 确保在修改CCR时没有关闭定时器。动态调节通常在主循环或中断中进行，直接使用 __HAL_TIM_SET_COMPARE宏即可。3. 确认使用的是 __HAL_TIM_SET_COMPARE，而不是__HAL_TIM_SET_AUTORELOAD（后者改的是ARR，影响频率）。 |
| PWM输出使能后，引脚一直为高或一直为低 | 1. 极性（Polarity）设置与预期相反。 2. CCR值设置极端（0或等于ARR）。 3. 引脚外部被强上拉/下拉。 | 1. 检查CubeMX中CH Polarity设置。High表示有效电平为高。如果设置反了，波形会“反相”。2. 如果CCR=0，在PWM模式1下，有效电平时间为0，输出恒为无效电平（若极性为High，则输出恒低）。 3. 检查硬件电路，确保没有外部电阻将引脚固定在高或低。 |
| 多通道中某一通道无输出 | 1. 该特定通道未单独启动。 2. 该通道对应的引脚配置或复用冲突。 | 1. 每个通道都需要单独的HAL_TIM_PWM_Start调用。2. 在CubeMX和原理图上仔细核对该引脚是否确实映射到了当前定时器的这个通道上。有些引脚有多个复用功能。 |
5.2 调试工具与技巧
- 逻辑分析仪是你的好朋友： 一个几十块钱的简易逻辑分析仪，配合上位机软件（如Saleae Logic），可以非常直观地看到PWM的频率、占空比、毛刺等问题，比万用表靠谱得多。
- 活用HAL库的状态与错误句柄： 虽然HAL库的初始化函数通常不会返回明显的错误，但如果硬件连接有问题（如外部时钟失效），相关的错误标志位会被设置在句柄（如
htim3.ErrorCode）中。在调试复杂系统时，可以定期检查这些标志。 - 使用断点观察寄存器： 在调试模式下，可以查看
TIM3->CCR1等寄存器的值，确认你通过宏设置的值是否成功写入。 - 从简单验证开始： 如果不确定配置，可以先配置一个极低频率（如1Hz）和50%占空比的PWM，用LED来观察。如果LED能规律地闪烁，说明基础功能正常，再逐步提高频率到目标值。
踩坑实录：我曾经遇到一个棘手的问题，PWM波形在示波器上看一切正常，但驱动电机时就是有异常噪音。后来用逻辑分析仪放大时间轴细看，发现每几百个周期就会出现一个极窄的“毛刺”脉冲。最终排查发现，是在一个低优先级中断服务函数里调用了__HAL_TIM_SET_COMPARE，而这个中断执行时间偶尔会过长，错过了ARR更新事件后的安全写入窗口，导致CCR值在一个周期中间被更改，产生了那个毛刺。解决方案是：将对CCR的修改操作放到主循环或更高优先级、执行时间有保障的定时器中断中，或者确保在关闭定时器更新中断（__HAL_TIM_DISABLE_IT(&htim3, TIM_IT_UPDATE)）的保护下进行修改。这件事让我深刻理解了“输出比较预装载”这个选项的重要性，以及硬件自动化的边界在哪里。
