1. 从“开关”到“呼吸灯”：PWM到底是什么？

如果你玩过单片机，尤其是STM32，那PWM这个词你肯定不陌生。它几乎是所有涉及到“控制”的项目里，出场率最高的技术之一。从让一个LED灯实现呼吸效果，到驱动一个电机平稳调速，再到控制舵机精准转动，背后都离不开PWM。但很多朋友，尤其是刚入门的朋友，对PWM的理解可能还停留在“一个能调占空比的方波”这个层面。今天，我就结合自己这些年用STM32折腾各种项目的经验，把PWM从原理到应用，再到STM32里的具体实现和那些容易踩的坑，掰开揉碎了讲清楚。

PWM，全称是脉冲宽度调制。这个名字听起来有点唬人，但其实它的核心思想非常直观：用数字信号来模拟模拟量。怎么模拟？就是通过快速开关一个数字信号（比如GPIO引脚输出高电平和低电平），并调整在一个周期内“开”（高电平）的时间比例，来控制最终的平均电压或功率。这个“开”的时间占整个周期的比例，就是我们常说的“占空比”。占空比0%意味着一直关着，输出为0；占空比100%意味着一直开着，输出为满幅电压；占空比50%则是一半时间开，一半时间关，平均电压就是满幅电压的一半。STM32的定时器模块，特别是高级定时器（TIM1/TIM8）和通用定时器（TIM2-TIM5, TIM9-TIM14等），为我们生成PWM提供了强大且灵活的硬件支持，几乎不需要CPU干预，这才是它真正好用的地方。

2. 不只是“调亮度”：PWM的核心参数与工作模式拆解

很多人一提到PWM，第一反应就是调LED亮度。这没错，但这只是PWM最基础、最直观的一个应用。要真正玩转PWM，尤其是用好STM32那功能丰富的定时器，我们必须深入理解它的几个核心参数和工作模式。

2.1 决定PWM“性格”的四大金刚

一个PWM波，主要由四个参数定义，它们共同决定了这个信号能干什么、干得怎么样：

1. 频率：一秒钟内，这个PWM信号完成多少个完整的“开-关”周期。单位是赫兹。比如1kHz的PWM，意味着每秒钟有1000个周期，每个周期时长1毫秒。频率的选择至关重要。对于LED调光，人眼有视觉暂留，通常几十Hz到几百Hz就足够了，频率太低会看到闪烁，频率太高则可能超出LED的响应速度。对于电机驱动，频率需要根据电机电感和驱动电路来定，太低电机会啸叫、抖动，太高则开关损耗增大，常见在几kHz到几十kHz。对于舵机，则是一个固定的50Hz（周期20ms）标准信号。

2. 占空比：这是PWM的灵魂。它指在一个周期内，高电平时间占整个周期时间的百分比。计算公式很简单：占空比 = (高电平时间 / 周期时间) * 100%。在STM32中，我们通过配置一个叫做“比较寄存器”（CCRx）的值来设定占空比。这个值是和“自动重装载寄存器”（ARR）的值相比较的。后面我们会详细讲这个过程。

3. 分辨率：它决定了你能以多精细的步进来调整占空比。分辨率通常由定时器的计数器位数决定。比如一个16位的定时器，它的计数器可以从0计数到65535。那么，在ARR固定为65535的情况下，你的占空比调节精度就是1/65535，约等于0.0015%，这非常精细。但实际上，ARR的值我们会根据频率来设置，分辨率 = 1 / (ARR + 1)。如果ARR设为999，那么分辨率就是0.1%。分辨率越高，控制就越平滑，尤其是在控制精密设备时。

4. 极性：这个参数决定了你定义的“有效电平”是高还是低。比如，你设置占空比为50%，极性为高电平有效，那么输出就是50%的时间高电平，50%的时间低电平。如果你设置极性为低电平有效，那么输出就反过来：50%的时间低电平，50%的时间高电平。这个特性在驱动某些需要低电平使能的电路时非常有用。

2.2 STM32定时器的PWM生成模式：边沿对齐与中心对齐

STM32的定时器主要支持两种PWM模式，理解它们的区别对高级应用（如电机驱动中的互补输出和死区插入）很重要。

边沿对齐模式：这是最常用、最直观的模式。计数器从0开始向上计数到ARR值，然后清零重新开始。在计数过程中，将计数器的值CNT与比较寄存器CCRx的值进行比较。

• 当CNT < CCRx时，输出一种电平（例如高电平，取决于极性）。
• 当CNT >= CCRx时，输出相反的电平（例如低电平）。
• 当CNT计到ARR时，产生更新事件，输出电平根据新的比较值可能发生变化，并开始下一个周期。

这种模式生成的PWM波，其脉冲的前沿（上升沿或下降沿）是固定的，变化的只是后沿。所以叫“边沿对齐”。它的优点是简单，计算方便。

中心对齐模式：计数器先从0向上计数到ARR，然后反过来从ARR向下计数到0，如此循环。同样是比较CNT和CCRx。

• 在向上计数阶段，当CNT < CCRx时，输出一种电平；当CNT >= CCRx时，输出相反电平。
• 在向下计数阶段，当CNT > CCRx时，输出后一种电平；当CNT <= CCRx时，输出前一种电平。

这种模式生成的PWM波，其脉冲的中心是对齐的，两边对称。它最大的优势在于，在电机控制中，可以产生对称的互补PWM，并且能方便地在计数器溢出（ARR）和计数器下溢（0）时插入死区时间，对于H桥驱动至关重要。如果你只是驱动LED或普通舵机，用边沿对齐就够了；但如果涉及到直流无刷电机或步进电机的精细控制，中心对齐模式是必须掌握的。

3. 手把手配置STM32的PWM输出通道

理论说再多，不如动手调一行代码。我们以最常见的STM32F1系列和通用定时器TIM3的通道1（对应引脚可能是PA6，具体查芯片数据手册）为例，配置一个1kHz频率、分辨率1%（即占空比可调范围0-100，步进1%）的PWM输出。这里我使用标准外设库来讲解，思路对于HAL库也是完全相通的。

3.1 硬件与时钟初始化

任何外设使用前，时钟必须开启。定时器挂载在APB1总线下（TIM2, TIM3, TIM4等），GPIO挂载在APB2下。

// 1. 开启时钟 RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM3, ENABLE); // 开启TIM3时钟 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE); // 开启GPIOA时钟 // 2. 配置GPIO为复用推挽输出 GPIO_InitTypeDef GPIO_InitStructure; GPIO_InitStructure.GPIO_Pin = GPIO_Pin_6; // TIM3_CH1 对应 PA6 GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP; // 复用推挽输出 GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOA, &GPIO_InitStructure);

关键点：GPIO必须配置为复用功能模式（GPIO_Mode_AF_PP或GPIO_Mode_AF_OD），而不是普通的推挽输出。因为此时引脚的控制权已经交给了内部的定时器外设，而非CPU。

3.2 定时器基础参数配置：时基单元

这是设定PWM频率和分辨率的核心步骤。

TIM_TimeBaseInitTypeDef TIM_TimeBaseStructure; // 假设系统时钟为72MHz，APB1预分频器为2，所以TIM3的时钟是72MHz uint32_t SystemCoreClock = 72000000; // 计算ARR和PSC的值，目标频率1kHz，分辨率1%（即100级） // 周期 T = 1 / 1000Hz = 0.001s = 1ms // 计数器时钟频率 Fcnt = SystemCoreClock / (PSC + 1) // 一个计数周期的时间 Tcnt = 1 / Fcnt // 总计数次数 = T / Tcnt = Fcnt / Fpwm = (SystemCoreClock/(PSC+1)) / Fpwm // 这个总计数次数就是 ARR + 1 // 为了得到100级分辨率，我们让 ARR = 100 - 1 = 99 // 那么 Fcnt = (ARR + 1) * Fpwm = 100 * 1000 = 100,000 Hz // 所以 PSC = SystemCoreClock / Fcnt - 1 = 72,000,000 / 100,000 - 1 = 720 - 1 = 719 TIM_TimeBaseStructure.TIM_Period = 100 - 1; // ARR值，设定自动重装载值，决定分辨率 TIM_TimeBaseStructure.TIM_Prescaler = 720 - 1; // PSC值，预分频器，和ARR共同决定频率 TIM_TimeBaseStructure.TIM_ClockDivision = TIM_CKD_DIV1; // 时钟分频，通常不改 TIM_TimeBaseStructure.TIM_CounterMode = TIM_CounterMode_Up; // 向上计数模式（边沿对齐） TIM_TimeBaseInit(TIM3, &TIM_TimeBaseStructure);

计算过程解析：这里我详细展示了计算过程。TIM_Prescaler（PSC）是对定时器时钟源进行分频，得到计数器实际递增的时钟Fcnt。TIM_Period（ARR）是计数器从0数到的最大值。PWM频率Fpwm = Fcnt / (ARR + 1)。我们首先根据所需分辨率确定ARR（分辨率=1/(ARR+1)），然后反推PSC。这是一个非常重要的设计思路。

3.3 PWM输出通道配置：比较与捕获单元

定时器的基础架子搭好了，现在要配置具体的输出通道，让它按照我们的要求输出高低电平。

TIM_OCInitTypeDef TIM_OCInitStructure; // 配置PWM模式 TIM_OCInitStructure.TIM_OCMode = TIM_OCMode_PWM1; // 选择PWM模式1 TIM_OCInitStructure.TIM_OutputState = TIM_OutputState_Enable; // 使能输出 TIM_OCInitStructure.TIM_OCPolarity = TIM_OCPolarity_High; // 输出极性：高电平有效 TIM_OCInitStructure.TIM_Pulse = 0; // 初始的脉冲宽度（比较值CCR1），即初始占空比 TIM_OC1Init(TIM3, &TIM_OCInitStructure); // 初始化通道1 TIM_OC1PreloadConfig(TIM3, TIM_OCPreload_Enable); // 使能CCR1的预装载寄存器

模式选择详解：TIM_OCMode_PWM1和PWM2的区别在于有效电平的定义。

• PWM模式1：在向上计数时，当CNT < CCRx，通道输出为有效电平（极性参数决定高或低）；当CNT >= CCRx，输出为无效电平。向下计数时则相反。
• PWM模式2：逻辑与模式1完全相反。 对于边沿对齐的向上计数，我们通常用PWM模式1，高电平有效，这样设置CCRx的值就是高电平的计数时间，非常直观。

预装载功能：TIM_OCPreload_Enable非常关键。它允许我们在当前PWM周期运行的同时，去修改CCRx的值，但这个新值不会立即生效，而是先写入一个“影子寄存器”，等到下一个周期开始（更新事件发生时）才真正生效。这避免了在一个PWM周期中间改变占空比可能导致的脉冲撕裂或毛刺。务必使能它。

3.4 启动定时器与动态调整占空比

所有配置完成后，启动定时器，并给出动态修改占空比的函数。

// 使能定时器的预装载寄存器（ARR生效也需要） TIM_ARRPreloadConfig(TIM3, ENABLE); // 启动定时器计数器 TIM_Cmd(TIM3, ENABLE); // 对于高级定时器（TIM1/TIM8）的PWM输出，还需要额外开启主输出使能 // TIM_CtrlPWMOutputs(TIM1, ENABLE); // 动态修改占空比的函数 void PWM_SetDutyCycle(TIM_TypeDef* TIMx, uint16_t channel, uint8_t duty) { // duty范围假设为0-100 uint16_t ccrValue = (TIM_GetAutoreload(TIMx) + 1) * duty / 100; switch(channel) { case 1: TIM_SetCompare1(TIMx, ccrValue); break; case 2: TIM_SetCompare2(TIMx, ccrValue); break; case 3: TIM_SetCompare3(TIMx, ccrValue); break; case 4: TIM_SetCompare4(TIMx, ccrValue); break; default: break; } } // 调用示例：设置TIM3通道1占空比为50% // PWM_SetDutyCycle(TIM3, 1, 50);

注意：TIM_SetComparex函数修改的就是CCRx寄存器的值。由于我们使能了预装载，这个新值会在下一个PWM周期生效，保证了输出的稳定性。

4. 超越基础：STM32 PWM的高级玩法与实战坑点

当你掌握了基本的PWM输出后，STM32定时器更强大的功能才刚拉开帷幕。这些高级功能能将你的项目从“能跑”提升到“跑得稳、跑得精”。

4.1 互补输出与死区时间插入：电机驱动的核心

驱动一个直流无刷电机或步进电机，经常需要使用H桥电路。H桥的上下桥臂不能同时导通，否则会短路。这就需要互补的PWM信号来控制上下管，并且必须在互补信号切换时插入一段两个管子都关闭的“死区时间”。

STM32的高级定时器（TIM1/TIM8）直接硬件支持这个功能。你可以配置一个通道（如CH1）输出PWM，然后使能它的互补通道（CH1N）自动输出反相的信号。同时，可以设置一个死区时间寄存器，硬件会自动在原始信号和互补信号的边沿处插入一段可控的延迟，确保安全。

// 以TIM1通道1和互补通道1N为例（HAL库风格示意） TIM_OC_InitTypeDef sConfigOC; TIM_BreakDeadTimeConfigTypeDef sBreakDeadTimeConfig; // 配置主通道PWM sConfigOC.OCMode = TIM_OCMODE_PWM1; sConfigOC.Pulse = 500; // 初始CCR值 sConfigOC.OCPolarity = TIM_OCPOLARITY_HIGH; sConfigOC.OCNPolarity = TIM_OCNPOLARITY_HIGH; // 互补通道极性 sConfigOC.OCFastMode = TIM_OCFAST_DISABLE; sConfigOC.OCIdleState = TIM_OCIDLESTATE_RESET; sConfigOC.OCNIdleState = TIM_OCNIDLESTATE_RESET; HAL_TIM_PWM_ConfigChannel(&htim1, &sConfigOC, TIM_CHANNEL_1); // 配置死区时间 sBreakDeadTimeConfig.OffStateRunMode = TIM_OSSR_DISABLE; sBreakDeadTimeConfig.OffStateIDLEMode = TIM_OSSI_DISABLE; sBreakDeadTimeConfig.LockLevel = TIM_LOCKLEVEL_OFF; sBreakDeadTimeConfig.DeadTime = 72; // 死区时间值，具体计算依赖时钟 sBreakDeadTimeConfig.BreakState = TIM_BREAK_ENABLE; sBreakDeadTimeConfig.BreakPolarity = TIM_BREAKPOLARITY_HIGH; sBreakDeadTimeConfig.AutomaticOutput = TIM_AUTOMATICOUTPUT_ENABLE; HAL_TIMEx_ConfigBreakDeadTime(&htim1, &sBreakDeadTimeConfig); // 最后启动PWM输出，并特别使能互补通道 HAL_TIM_PWM_Start(&htim1, TIM_CHANNEL_1); HAL_TIMEx_PWMN_Start(&htim1, TIM_CHANNEL_1); // 启动互补通道

死区时间计算：死区时间寄存器的值（DeadTime，简称DTG）需要根据系统时钟来计算，具体公式在参考手册里有详细表格。它通常等于DTG[7:0]所代表的时间步进。设置太小可能无法避免桥臂直通，设置太大会降低有效输出电压，需要根据你的MOSFET/IGBT的开关特性来权衡。

4.2 刹车功能：紧急情况下的保护伞

在电机驱动中，如果发生过流、过热等故障，必须立即关闭PWM输出，让电机刹车。高级定时器的刹车输入（Break Input）就是干这个的。你可以将一个外部信号（比如来自比较器的过流信号）连接到定时器的刹车引脚（BKIN）。一旦刹车信号有效，定时器会立即将所有输出通道强制到一个预设的安全状态（通常全部拉低或拉高），并且这个动作优先级最高，软件都无法干预，确保了保护的实时性。上述代码中的BreakState和BreakPolarity就是用来配置这个功能的。

4.3 主从模式与触发同步：多定时器协同作战

在一些复杂应用中，可能需要多个定时器同步工作。例如，用一个定时器产生PWM波，用另一个定时器在PWM的特定时刻（如每个周期的开始）触发一次ADC采样。STM32的定时器支持主从模式。你可以配置一个定时器（主）在更新事件时输出一个触发信号（TRGO），然后配置另一个定时器（从）接收这个触发信号作为自己的启动、复位或时钟源。

// 配置TIM2为主模式，更新事件时触发输出 TIM_SelectOutputTrigger(TIM2, TIM_TRGOSource_Update); // 配置TIM3为从模式，使用ITR1（对应TIM2）作为触发输入 TIM_SelectInputTrigger(TIM3, TIM_TS_ITR1); TIM_SelectSlaveMode(TIM3, TIM_SlaveMode_Trigger);

这样，当你启动TIM2时，TIM3也会被同步启动，并且它们的计数器相位可以保持严格同步，对于需要多个精确同步信号的应用至关重要。

4.4 DMA搬运：实现复杂PWM波形序列

如果你想产生一个不是固定占空比，而是按照特定序列变化的PWM波形（比如模拟一个正弦波，或者复杂的步进电机细分驱动曲线），不断用CPU去修改CCR值会占用大量资源。此时，DMA就派上用场了。你可以将一段存储了所有CCR值序列的数组放在内存中，然后配置DMA，在定时器的更新事件（或CCR的匹配事件）发生时，自动将下一个数据从内存搬运到定时器的CCR寄存器中。这样，CPU只需要初始化一次，就能产生一段非常复杂的PWM波形。

配置要点：

1. 配置DMA通道，源地址是内存数组，目标地址是TIMx_CCR1（例如）。
2. 设置DMA为循环模式，数据宽度为半字（16位）。
3. 将定时器的更新事件（TIM_Update_DMA）或比较事件（TIM_CC1_DMA）作为DMA请求源。
4. 启动DMA和定时器。

5. 实战中的那些“坑”与调试技巧

理论完美，代码也写了，但一上电，灯不亮、电机不转、波形不对？太正常了。下面分享几个我踩过的坑和调试方法。

坑点一：GPIO模式配置错误这是新手最容易犯的错误。PWM输出必须使用复用推挽输出（GPIO_Mode_AF_PP）。如果你配置成了普通推挽输出（GPIO_Mode_Out_PP），定时器是无法控制这个引脚的。检查一下你的GPIO初始化代码，确保模式正确。另外，有些引脚有多个复用功能，要查清楚你的定时器通道对应的是哪个AF（Alternate Function）编号，在标准库中通过GPIO_PinAFConfig函数来映射。

坑点二：时钟树没理清，频率不对PWM频率完全不对？99%是时钟算错了。STM32的时钟树比较复杂。首先，确认你的系统时钟（SYSCLK）是多少。然后，确认你的定时器挂载在哪个总线（APB1还是APB2）上，该总线的预分频系数是多少。最后，记住一个关键点：如果APBx的预分频系数不是1，那么挂载在该总线上的定时器时钟会是APB时钟的2倍。例如，系统时钟72MHz，APB1预分频设为2，则APB1时钟是36MHz，但TIM2-TIM5的时钟会是72MHz！这个细节手册里有写，但很容易忽略。用示波器测量实际输出频率，反推回去检查你的PSC和ARR计算。

坑点三：占空比调到100%输出也没变化现象是，你调用函数从0调到100，用万用表测引脚电压，发现最高只能到比如3V（假设VDD是3.3V）。这可能是因为你设置的ARR值太小了。比如你ARR设为99，CCR设为99，占空比是100%，但高电平时间对应的计数值是99。如果ARR设得很大，CCR=ARR时高电平时间已经非常接近整个周期，平均电压几乎等于VDD。但如果ARR很小，即使CCR=ARR，在计数器从0到ARR的计数过程中，高电平时间也并非整个周期（在CNT等于ARR的瞬间会发生变化）。对于需要完全关断或完全开启的应用（比如控制一个开关），更可靠的方法是直接通过GPIO输出高低电平，或者使用定时器的“强制输出”功能。

坑点四：高级定时器的PWM输出使能不全对于TIM1和TIM8，在启动计数器（TIM_Cmd）之后，必须额外调用TIM_CtrlPWMOutputs(TIMx, ENABLE)来开启主输出，否则PWM信号不会出现在引脚上。这个函数专门用于使能高级定时器的刹车和死区功能模块的输出，普通定时器没有这个函数。忘了这一步，你会抓狂地发现配置都对，但引脚就是没信号。

调试技巧：用好你的示波器和逻辑分析仪

1. 看波形：这是最直接的。看频率对不对，占空比变化是否平滑，极性是否正确，有没有毛刺。
2. 看更新事件：如果你用了预装载和DMA，可以尝试在定时器更新中断里翻转一个测试引脚，用逻辑分析仪看中断是否按预期频率触发，这能帮你判断定时器的基本计时是否准确。
3. 逐步简化：如果复杂配置不工作，先回到最简配置。用一个定时器，一个通道，固定占空比，边沿对齐模式，先让一个LED以固定亮度亮起来。然后再一步步增加功能：改占空比、改频率、换模式、加死区、用DMA。每加一步，验证一步。

PWM是STM32定时器最经典的应用，它连接了数字世界的精确计时和物理世界的模拟控制。从简单的呼吸灯到复杂的电机矢量控制，底层都离不开对PWM的深刻理解和精准操控。希望这篇长文能帮你把PWM相关的知识点串联起来，下次在项目中用到它时，不再是简单地复制代码，而是能清楚地知道每一行配置的意义，并能根据实际需求灵活调整，游刃有余。