1. 从“嘀嗒”声到PWM：一个工程师的直觉理解

如果你玩过单片机，或者拆过任何带电机、呼吸灯的小玩意儿，大概率听说过PWM。全称是“脉冲宽度调制”，听起来挺唬人，但它的核心思想，其实和我们小时候用手电筒模拟摩斯电码，或者用开关水龙头控制水流大小，本质上是一回事。在STM32这类微控制器里，PWM是驱动电机、调节LED亮度、控制舵机角度的基石。但很多朋友在配置寄存器，看着一堆ARR、PSC、CCR数值时，会有点发懵：我填的这些数，到底是怎么决定最终输出波形那个“嘀嗒”声的快慢（频率）和长短（占空比）的？

网上的教程往往直接给公式：频率 = 时钟 / ((ARR+1)*(PSC+1))。背下来也能用，但一旦遇到波形不对、频率不准、电机啸叫这些问题，如果只知其然不知其所以然，排查起来就非常痛苦。我自己在早期做智能车和机械臂项目时，就因为没彻底搞懂这里的计算逻辑，调一个舵机频率调了一下午，最后发现是时钟源配置错了。所以，今天我们不只讲公式，更要把STM32产生PWM的整个“流水线”拆开，看看时钟是怎么一步步被“裁剪”成我们需要的方波的。理解了这条流水线，任何相关的问题，你都能自己推导出答案。

2. 拆解PWM发生器：一条精密的“脉冲裁剪流水线”

你可以把STM32内部产生PWM的定时器模块，想象成一条高度自动化的脉冲裁剪生产线。这条生产线的目标是生产出一种标准产品：周期和占空比都可精确设定的方波脉冲。它的原材料是稳定的“时钟脉冲”，而生产线的各个环节由几个关键寄存器控制。

2.1 原材料：时钟源的选择与分配

一切始于时钟。STM32的定时器不能无中生有，它需要一个节拍器。这个节拍器就是时钟源。常见的有：

• 内部时钟（CK_INT）：通常来自系统时钟（SYSCLK），比如72MHz（STM32F1系列常见）。这是最常用的源，稳定且方便。
• 外部时钟：从特定引脚输入时钟脉冲，用于特殊同步场合。

这里第一个容易踩的坑就来了：你以为系统时钟是72MHz，定时器就用上了72MHz吗？不一定。以STM32F1为例，APB1总线上的定时器（如TIM2, TIM3, TIM4）的时钟，在APB1预分频器不为1时，会自动倍频。如果APB1预分频器设为2，APB1时钟是36MHz，但挂载在它上面的定时器时钟会是72MHz。这个细节在CubeMX配置时钟树时至关重要，很多频率对不上的问题，根源就在这里。

实操心得：使用CubeMX或直接读代码配置时钟后，务必通过读取RCC->CFGR寄存器或使用SystemCoreClock变量，再次确认最终到达定时器的实际时钟频率是多少。这是所有计算的绝对基准，基准错了，后面全错。

2.2 第一道工序：预分频器（PSC）的粗加工

原材料时钟频率通常很高（几十MHz），直接用来计数的话，计数器会累加得飞快，导致周期分辨率极低（频率很高）。因此，我们需要第一道工序来降低节奏，这就是预分频器（Prescaler, PSC）。

PSC是一个分频器。如果PSC寄存器设置为N，那么每N+1个输入时钟脉冲，才会产生1个脉冲给下一道工序（计数器）。例如，时钟源72MHz，PSC=71，则分频后的时钟频率 = 72MHz / (71+1) = 1MHz。这里“+1”是因为计数器从0开始计数，这是一个关键点。

为什么是N+1？可以这样理解：PSC本身也是一个计数器。它从0开始，对输入时钟计数，计到N时，产生一个溢出信号（给计数器CNT），然后自己归零重新开始。所以它计数的周期是N+1个时钟周期。这个过程，就是把高频率的“原材料”进行“降速粗加工”，得到我们想要的“基础节奏”。

2.3 第二道工序：自动重装载寄存器（ARR）定长度

经过PSC降速后的脉冲，驱动着核心的计数器（CNT）向上或向下计数。计数器不能无限累加，它的计数范围由自动重装载寄存器（Auto-Reload Register, ARR）决定。

计数器CNT会从0开始，每个脉冲加1（向上计数模式），一直累加到ARR的值，然后产生一个更新事件（Update Event），并且CNT清零，重新开始下一轮计数。这一个从0到ARR，再归零的完整过程，所花费的时间，就是输出PWM波形的整个周期。

所以，ARR决定了PWM波形周期的“长度单位”有多少个。结合PSC提供的“单位时间”，就能算出整个周期的时间。

2.4 最终成型：捕获/比较寄存器（CCR）定占空比

有了周期，我们还需要在周期内定义一个“高点平”的时间，这就是占空比。这个工作由捕获/比较寄存器（Capture/Compare Register, CCR）来完成。

在PWM模式下，我们会设定一个比较模式。当计数器CNT的值小于CCR时，输出一种电平（通常为高电平）；当CNT的值大于等于CCR且小于等于ARR时，输出另一种电平（低电平）。如此循环往复。

因此，CCR的值直接决定了高电平的持续时间，占空比 = CCR / (ARR + 1)。注意，这里又是ARR+1，因为计数范围是0到ARR，总共是ARR+1个计数点。

3. 核心公式推导：从寄存器值到频率与占空比

现在，我们把整条流水线串起来，推导出那个经典的公式。

1. 定时器时钟频率：F_TIM（单位：Hz）
2. 预分频器值：PSC（寄存器写入值）
3. 分频后驱动计数器的时钟频率：F_CNT = F_TIM / (PSC + 1)（单位：Hz）
4. 计数器计数一次的时间：T_CNT = 1 / F_CNT = (PSC + 1) / F_TIM（单位：秒）
5. 自动重装载值：ARR（寄存器写入值）
6. 一个完整的PWM周期需要计数的次数：ARR + 1次（从0数到ARR）
7. PWM波形的周期（T_pwm）：T_pwm = T_CNT * (ARR + 1) = (PSC + 1) * (ARR + 1) / F_TIM（单位：秒）
8. PWM波形的频率（F_pwm）：F_pwm = 1 / T_pwm = F_TIM / ((PSC + 1) * (ARR + 1))（单位：Hz）

占空比（Duty Cycle）计算：

• 高电平时间：T_high = T_CNT * CCR = (PSC + 1) * CCR / F_TIM
• 占空比：Duty = T_high / T_pwm = CCR / (ARR + 1)

这就是所有计算的根源。请务必理解每一步的物理意义，而不是死记硬背F_pwm = F_TIM / ((PSC+1)*(ARR+1))。

4. 实战配置：以STM32F103输出1kHz、50%占空比PWM为例

理论说完了，我们来个实际例子。目标：用STM32F103C8T6的TIM3通道1（PA6引脚），输出一个1kHz频率、占空比50%的PWM方波。假设系统时钟为72MHz，且TIM3挂在APB1总线上，APB1预分频器为2（此时TIM3时钟为72MHz）。

步骤1：确定已知量

• F_TIM = 72,000,000 Hz
• F_pwm = 1,000 Hz
• Duty = 50%

步骤2：公式变形与参数选择我们有公式：F_pwm = F_TIM / ((PSC+1) * (ARR+1))所以(PSC+1) * (ARR+1) = F_TIM / F_pwm = 72,000,000 / 1,000 = 72,000

这里PSC和ARR都是16位寄存器（最大值65535），它们的乘积需要等于72000。我们需要找一个合理的组合。

• ARR决定了PWM的分辨率。ARR越大，CCR可以设置的值就越多，占空比调节就越精细。例如，如果ARR=999，那么占空比分辨率是1/1000=0.1%。如果ARR=71，分辨率就只有约1.4%。
• 对于1kHz，我们通常希望有较高的分辨率。我们让ARR+1 = 1000，这样占空比分辨率就是0.1%。那么：
  • ARR = 999
  • PSC+1 = 72,000 / 1000 = 72
  • PSC = 71

步骤3：计算CCR占空比50%，所以CCR = Duty * (ARR + 1) = 0.5 * 1000 = 500。

步骤4：代码配置（以标准库为例）

// 1. 开启时钟和GPIO RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE); RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM3, ENABLE); // 2. 初始化GPIO为复用推挽输出 GPIO_InitTypeDef GPIO_InitStructure; GPIO_InitStructure.GPIO_Pin = GPIO_Pin_6; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP; // 复用推挽输出 GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOA, &GPIO_InitStructure); // 3. 初始化定时器时基 TIM_TimeBaseInitTypeDef TIM_TimeBaseStructure; TIM_TimeBaseStructure.TIM_Period = 999; // ARR TIM_TimeBaseStructure.TIM_Prescaler = 71; // PSC TIM_TimeBaseStructure.TIM_ClockDivision = TIM_CKD_DIV1; TIM_TimeBaseStructure.TIM_CounterMode = TIM_CounterMode_Up; // 向上计数模式 TIM_TimeBaseInit(TIM3, &TIM_TimeBaseStructure); // 4. 初始化PWM输出通道 TIM_OCInitTypeDef TIM_OCInitStructure; TIM_OCInitStructure.TIM_OCMode = TIM_OCMode_PWM1; // PWM模式1 TIM_OCInitStructure.TIM_OutputState = TIM_OutputState_Enable; // 使能输出 TIM_OCInitStructure.TIM_Pulse = 500; // CCR，决定初始占空比 TIM_OCInitStructure.TIM_OCPolarity = TIM_OCPolarity_High; // 输出极性：高电平有效 TIM_OC1Init(TIM3, &TIM_OCInitStructure); // 初始化通道1 TIM_OC1PreloadConfig(TIM3, TIM_OCPreload_Enable); // 使能预装载寄存器 // 5. 使能定时器的预装载寄存器（ARR）和计数器 TIM_ARRPreloadConfig(TIM3, ENABLE); TIM_Cmd(TIM3, ENABLE);

使用HAL库或CubeMX配置思路完全一致，填入对应的PSC、ARR、CCR值即可。

5. 那些年我踩过的坑：频率不准、无输出与电机异响

理解了原理和计算，大部分配置都能一次成功。但实际项目环境复杂，下面分享几个典型的坑和排查思路。

5.1 坑一：算出来的频率和示波器测的不一样

这是最常见的问题。可能的原因有：

1. 时钟源实际频率不对：这是头号嫌疑犯。务必用代码或调试器确认F_TIM的真实值。比如你以为是72M，可能因为PLL没锁住、HSE晶振没起振，实际只有8M（HSI）。
2. PSC或ARR的值超出了有效范围：比如16位定时器，你算出的PSC或ARR大于65535，实际赋值时被截断，导致计算错误。
3. 计数模式的影响：我们上述计算基于向上计数模式。如果使用中央对齐模式（向上向下计数），计数器会从0到ARR，再从ARR到0，这样一个完整的PWM周期需要2 * ARR个计数。此时频率公式变为：F_pwm = F_TIM / ((PSC+1) * (ARR * 2))。模式选错，频率直接差一倍。
4. 重复计数器（RCR）的干扰：高级定时器（如TIM1, TIM8）有重复计数器，它可以使更新事件（重置PWM周期）在多次溢出后才发生。如果设置了RCR=N，则实际PWM周期会变为原来的(N+1)倍。

排查流程：

• 第一步：用示波器测量实际频率F_actual。
• 第二步：根据公式反推：(PSC+1)*(ARR+1) = F_TIM / F_actual。
• 第三步：对比你计算出的(PSC+1)*(ARR+1)和反推出的值。如果比值是2的倍数，检查计数模式；如果差得很多，检查时钟源和寄存器赋值。

5.2 坑二：完全没有PWM波形输出

引脚上一片寂静。除了检查代码是否使能了定时器和输出通道，还要关注：

1. GPIO模式错误：必须配置为复用推挽输出（AF_PP），而不是普通的推挽输出。普通输出模式受GPIO输出数据寄存器控制，无法输出定时器产生的波形。
2. 引脚复用功能未映射：有些引脚默认功能不是定时器输出。需要调用GPIO_PinAFConfig函数（对于支持重映射的型号）来将定时器功能映射到特定引脚。在CubeMX中，这个步骤是图形化完成的。
3. 主输出使能（MOE）未开启：对于高级定时器（TIM1/TIM8）的刹车和死区功能，需要设置BDTR寄存器的MOE位为1，否则所有输出被禁止。这是新手用高级定时器时极易忽略的一点。
4. CCR值设置不合理：如果CCR = 0，在PWM模式1下可能输出恒低电平；如果CCR > ARR，则可能输出恒高电平（取决于极性设置）。用示波器看会像没有波形，其实是直流。

5.3 坑三：驱动电机时发出“滋滋”啸叫声

用PWM驱动直流电机或步进电机驱动器时，有时会听到高频啸叫。这通常不是代码逻辑错误，而是PWM频率选在了人耳可听范围（20Hz - 20kHz）内。

• 电机线圈和驱动器内部的电感、电容构成了一个谐振系统。当PWM频率落在可听频段，特别是某个谐振点附近时，线圈或磁芯的振动就会被人耳听到。
• 解决方案：将PWM频率提高到20kHz以上（例如25kHz， 30kHz）。这样既避免了噪音，又因为频率远高于电机的机械响应速度，不会影响调速性能。但要注意，提高频率意味着(PSC+1)*(ARR+1)的值要变小，可能会牺牲PWM的分辨率。需要在噪音和分辨率之间做权衡。

6. 进阶话题：高精度频率生成与动态调整

有时候，我们需要非常精确的频率，或者需要运行时动态改变频率和占空比。这里有一些技巧。

6.1 追求极致精度：时钟源与分频策略

标准72MHz晶振的精度可能只有100ppm（万分之一），对于要求极高的场合（如音频采样时钟），这可能不够。可以：

• 使用更高精度的外部晶振（如TCXO，精度可达1ppm）。
• 利用STM32的时钟锁相环（PLL）进行小数分频（部分型号支持），可以产生非整数的分频比，从而得到更精确的频率。

在分频策略上，为了获得最大的分辨率（即ARR尽可能大），我们通常先确定ARR，再反算PSC。但也要注意，PSC和ARR都必须是整数。有时无法得到精确的目标频率，这时可以计算实际误差：误差 = |(F_实际 - F_目标) / F_目标|，选择一个误差可接受的组合。

6.2 运行时动态调整：如何平滑改变

在电机加速、LED呼吸灯等场景，需要动态改变PWM的占空比甚至频率。

• 改变占空比：直接修改CCR寄存器的值即可。为了避免在周期中间修改导致毛刺，可以使用预装载功能。在标准库中，就是调用TIM_OCxPreloadConfig(TIMx, ENABLE)，并在修改后设置TIMx->CCRx寄存器。真正的更新会发生在下一个更新事件（计数器溢出）时，这样切换是同步的、平滑的。
• 改变频率（即改变周期）：这需要同时改变ARR和PSC。但直接修改ARR，如果新的ARR值小于当前计数器值CNT，会立即产生更新事件，导致当前周期被突然截断，产生一个很窄的脉冲，可能损坏设备（如电机驱动器）。安全的做法是：
  1. 在修改前，先停止计数器（TIMx->CR1的CEN位置0）。
  2. 修改PSC和ARR寄存器。
  3. 如果需要，同时按比例修改CCR以保持占空比不变（CCR_new = (CCR_old / ARR_old) * ARR_new）。
  4. 产生一个软件更新事件（TIMx->EGR的UG位置1），让所有影子寄存器立即生效。
  5. 重新使能计数器。 这个过程会丢失一两个PWM周期，但对于大多数应用是可以接受的。更高级的定时器支持“重复计数器”和“影子寄存器”的复杂同步机制，可以实现更平滑的频率切换。

7. 举一反三：从定时器到其他波形生成

理解了PWM的定时器流水线模型，再去理解其他相关功能就很容易了。

• 输入捕获：过程相反。外部信号通过引脚输入，在信号的边沿触发，将当前计数器CNT的值锁存到CCR寄存器中。通过计算两次捕获的差值，就能算出输入信号的周期或脉冲宽度。这就是测频率、测占空比的原理。
• 输出比较：不产生连续的PWM，而是在CNT计数到与CCR匹配时，产生一个单一的动作（如翻转引脚电平、产生中断）。可以用来生成精确的延时，或驱动步进电机的单步脉冲。
• 单脉冲模式（OPM）：可以理解为只输出一个指定宽度脉冲的PWM。在触发信号到来后，开始一个完整的PWM周期（从0到ARR），周期结束后自动停止。非常适合需要精确单次触发的场合。

PWM是嵌入式控制中最基础、最强大的工具之一。从调节一盏LED灯的亮度，到驱动一个四旋翼飞行器的电调，背后都是这套原理。把“时钟源 -> PSC -> CNT & ARR -> CCR & 比较器”这条流水线刻在脑子里，再结合寄存器的具体操作，你就能从“配置寄存器”的层面，真正驾驭定时器，而不是被它牵着鼻子走。下次再遇到PWM相关的问题，别急着搜答案，拿起笔和纸，画一画这条流水线，算一算时钟路径，答案往往自己就浮现出来了。