1. PWM技术原理与工程本质

PWM（Pulse Width Modulation，脉宽调制）不是一种“玄学配置”，而是一套可量化、可推导、可复现的数字控制方法论。在嵌入式系统中，它本质上是 用数字信号模拟模拟量输出 的核心手段——通过高速开关动作，在时间维度上对能量进行精确切片分配。这种技术绕开了D/A转换器的成本与精度限制，直接利用MCU通用IO的开关特性，实现对LED亮度、电机转速、舵机角度、加热功率等物理量的连续调节。

理解PWM，必须剥离“方波”表象，直击其数学内核： 它是一个周期性分段函数，由固定周期T、可变高电平时间t_on、可变低电平时间t_off构成，且满足T = t_on + t_off 。所有应用逻辑——无论是呼吸灯的明暗渐变，还是舵机的精准定位——都源于对t_on/T这一比值的动态操控。这个比值，就是占空比（Duty Cycle），通常以百分比形式表示。当占空比为0%时，输出恒为低电平；100%时，输出恒为高电平；50%时，则呈现标准方波。关键在于， 占空比是唯一需要被软件实时调控的参数，其余所有寄存器配置，都是为精确生成该占空比服务的底层支撑 。

在STM32平台上，PWM并非某个外设的独立功能，而是 高级定时器（如TIM1、TIM8）或通用定时器（如TIM2-TIM5）的一种工作模式 。其硬件实现依赖于两个核心机制： 自动重装载（Auto-Reload）与比较匹配（Compare Match） 。这决定了PWM绝非简单的“设置一个占空比数值”即可完成，而是一场围绕时钟源、计数器、比较寄存器三者精密协同的工程实践。任何脱离时钟树与计数逻辑的PWM配置，都是空中楼阁。

2. STM32定时器PWM硬件架构解析

STM32的PWM输出能力根植于其定时器的计数器结构。以最典型的向上计数模式（Up-counting Mode）为例，其工作流程可拆解为四个不可分割的环节：

2.1 时钟源与预分频（Prescaler）

定时器的计数脉冲来源于APB总线时钟（APB1或APB2）。以常见的STM32F103C8T6为例，其系统主频为72MHz，APB1总线（连接TIM2-TIM4）默认为36MHz，APB2总线（连接TIM1、TIM8）为72MHz。但计数器并不直接使用此高频时钟，而是通过一个16位预分频寄存器（PSC）对其进行整数分频。PSC的值决定分频系数为(PSC + 1)。例如，若PSC=719，则分频系数为720，输入到计数器的时钟频率即为72MHz / 720 = 100kHz。 PSC的选择是工程权衡的结果：过小则计数频率过高，导致重装载值（ARR）过大，代码可读性差且易溢出；过大则计数频率过低，限制了PWM的最高频率 。

2.2 自动重装载（Auto-Reload Register, ARR）

ARR是一个16位寄存器，定义了计数器的“满值”。在向上计数模式下，计数器从0开始递增，当计数值（CNT）等于ARR时，产生更新事件（Update Event），CNT被清零并重新开始计数。因此， ARR直接决定了PWM信号的周期T 。若计数器时钟频率为f_clk_cnt，则理论周期T = (ARR + 1) / f_clk_cnt。此处的“+1”是关键，因为计数是从0到ARR共(ARR + 1)个状态。例如，ARR=1999，f_clk_cnt=100kHz，则T = 2000 / 100000 = 20ms，对应50Hz频率。

2.3 比较寄存器（Capture/Compare Register, CCRx）

每个PWM通道（CH1-CH4）都配有一个独立的比较寄存器（CCRx）。在计数过程中，硬件持续将CNT与CCRx的值进行比较。当CNT等于CCRx时，触发比较匹配事件，此时定时器的输出极性发生翻转（如从高变低）。 CCRx的值直接决定了高电平时间t_on 。在标准的PWM模式1（向上计数，OCxM=0x6）下，当CNT < CCRx时，输出为有效电平（如高）；当CNT >= CCRx时，输出为无效电平（如低）。因此，t_on = CCRx / f_clk_cnt，而占空比D = t_on / T = CCRx / ARR。

2.4 输出比较模式（Output Compare Mode）

STM32定时器提供了多种输出比较模式，用于生成不同特性的PWM波形。对于基础应用，最常用的是：
- PWM模式1（OCxM = 0x6） ：向上计数时，CNT < CCRx，输出为高；CNT >= CCRx，输出为低。这是生成标准正向PWM的首选。
- PWM模式2（OCxM = 0x7） ：向上计数时，CNT < CCRx，输出为低；CNT >= CCRx，输出为高。生成反向PWM。

选择何种模式，取决于外部电路设计（如LED是共阳还是共阴接法）以及个人编码习惯。模式一旦选定，在整个项目生命周期内应保持一致，避免因极性混淆导致硬件误动作。

3. PWM核心参数的工程计算方法论

将理论公式转化为可执行的代码配置，是PWM工程落地的核心挑战。其本质是求解一个二元一次方程组，其中已知量是目标频率f_pwm和目标占空比D，未知量是PSC和ARR（CCRx由D和ARR共同决定）。以下是经过千百次项目验证的、最高效可靠的计算流程：

3.1 频率计算：从目标到寄存器

目标频率f_pwm与寄存器的关系为：
f_pwm = f_ck_psc / (PSC + 1) / (ARR + 1)
其中， f_ck_psc 是定时器的输入时钟频率（即APBx总线频率）。

工程实践口诀：“先定PSC，再算ARR” 。PSC不应随意选取，而应以简化ARR计算、提升代码可维护性为目标。最优策略是让 (PSC + 1) 成为 f_ck_psc 的一个约数，从而使 f_ck_psc / (PSC + 1) 得到一个规整的整数。以f_ck_psc = 72MHz为例：
- 若目标f_pwm = 50Hz，则 f_ck_psc / f_pwm = 72,000,000 / 50 = 1,440,000 。
- 我们希望 (PSC + 1) * (ARR + 1) = 1,440,000 。
- 将1,440,000分解质因数： 1,440,000 = 2^8 * 3^2 * 5^4 。
- 从中挑选一个接近1000的因子作为 (PSC + 1) ，例如720（ 2^4 * 3^2 * 5 ），则 PSC = 719 。
- 此时， (ARR + 1) = 1,440,000 / 720 = 2000 ，故 ARR = 1999 。

此方案下，ARR=1999，是一个直观、易记、不易出错的值。若强行将PSC设为0，则ARR=1,439,999，不仅难以书写，更在调试时极易因笔误引入致命错误。 在嵌入式开发中，“可读性即可靠性”，一个优雅的寄存器配置，其价值远超节省几个CPU周期 。

3.2 占空比计算：从需求到寄存器

占空比D与寄存器的关系为：
D = CCRx / ARR

此公式简洁有力，但需警惕一个常见误区： D是小数（0.0 ~ 1.0），而非百分比（0% ~ 100%） 。许多初学者将50%直接代入公式，导致CCRx = 50 * ARR，结果远超寄存器范围而溢出。

正确做法是：将所需占空比百分比除以100，得到小数D，再乘以ARR。例如，要求占空比为5%，则D = 0.05，CCRx = 0.05 * 1999 ≈ 99.95，取整为100。由于CCRx为整数，实际占空比为100/1999 ≈ 5.0025%，其误差在绝大多数应用中可忽略不计。

3.3 舵机控制实战：从规格书到代码

以最常见的SG90舵机为例，其控制协议规定：周期T=20ms（f_pwm=50Hz），高电平时间t_on在1.0ms至2.0ms之间对应0°至180°。这是一个典型的PWM应用，完美诠释了参数计算的全流程。

第一步：确定基础频率配置
- 目标：T = 20ms → f_pwm = 50Hz。
- 如前计算，选用PSC=719, ARR=1999。此时，计数器时钟f_clk_cnt = 72MHz / 720 = 100kHz，每个计数周期为10μs。
- 验证：T = (1999 + 1) * 10μs = 20,000μs = 20ms。✅

第二步：映射角度到CCRx
- t_on = 1.0ms = 1000μs → 需要计数值 = 1000μs / 10μs = 100 → CCRx = 100。
- t_on = 1.5ms = 1500μs → CCRx = 150.
- t_on = 2.0ms = 2000μs → CCRx = 200.

注意：此处ARR=1999，最大CCRx为1999，对应t_on=1999 10μs=19.99ms，完全覆盖舵机需求。若CCRx被设为2000，则会等于ARR，导致输出恒为高电平，舵机失控。 工程实践中，务必确保CCRx < ARR，为安全裕度留出空间 *。

第三步：代码实现的关键点
- 在HAL库中， __HAL_TIM_SET_COMPARE(&htimx, TIM_CHANNEL_x, CCRx) 是动态修改占空比的API，必须在定时器启动后调用。
- 修改CCRx后，无需重启定时器，新占空比将在下一个计数周期生效，实现真正的“无扰切换”。
- 对于多路舵机，可为每路分配独立的CCRx寄存器（如CCRx1, CCRx2），通过单次 HAL_TIM_PWM_Start() 启动全部通道，极大简化了同步控制逻辑。

4. HAL库PWM配置的完整工程实践

基于STM32CubeMX与HAL库的配置，是当前工业界最主流、最稳健的开发范式。其优势在于将底层寄存器操作封装为清晰的API，同时保留了对硬件的完全掌控力。以下是以STM32F103C8T6驱动一个LED（接在PA0，对应TIM2_CH1）生成呼吸灯效果的完整配置指南。

4.1 CubeMX图形化配置

1. 时钟树配置（RCC） ：将HSE（外部晶振）设为8MHz，通过PLL倍频至72MHz。确认APB1总线（TIM2所在）频率为36MHz。
2. 定时器配置（TIM2） ：
   - Mode: PWM Generation CH1
   - Prescaler (PSC): 3599 （此处采用另一种常用方案：f_ck_psc=36MHz, PSC+1=3600 → f_clk_cnt=10kHz）
   - Counter Period (ARR): 999 （T = (999+1)/10000 = 0.1s = 100ms，适合呼吸灯缓慢变化）
   - Clock Division: No Division
   - Repetition Counter: 0 （不启用重复计数）
3. GPIO配置（PA0） ：Mode设为Alternate Function Push-Pull，Speed为High，Pull-up/Pull-down为No Pull-up and No Pull-down。
4. 生成代码 ：勾选“Generate peripheral initialization as a pair of ‘.c/.h’ files per peripheral”，点击“GENERATE CODE”。

4.2 核心初始化代码分析

生成的 MX_TIM2_Init() 函数，其精髓在于对 htim2 句柄的填充：

htim2.Instance = TIM2;
htim2.Init.Prescaler = 3599;          // PSC寄存器值
htim2.Init.CounterMode = TIM_COUNTERMODE_UP; // 向上计数
htim2.Init.Period = 999;              // ARR寄存器值
htim2.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1;
htim2.Init.RepetitionCounter = 0;
htim2.Init.AutoReloadPreload = TIM_AUTORELOAD_PRELOAD_DISABLE;
if (HAL_TIM_PWM_Init(&htim2) != HAL_OK)
{
    Error_Handler();
}

HAL_TIM_PWM_Init() 内部会将这些参数写入TIM2的PSC、ARR等寄存器，并完成中断向量表的注册（如果使能了更新中断）。 AutoReloadPreload 设为DISABLE意味着ARR值可随时修改，但修改后需等待下一个更新事件才生效；设为ENABLE则可在任意时刻写入，新值在下一个更新事件时自动载入，更适合需要严格同步的场合。

4.3 PWM通道启动与占空比控制

启动PWM输出仅需两行代码：

// 配置通道1为PWM模式
sConfigOC.OCMode = TIM_OCMODE_PWM1;
sConfigOC.Pulse = 500; // 初始占空比：500/999 ≈ 50%
sConfigOC.OCPolarity = TIM_OCPOLARITY_HIGH;
sConfigOC.OCFastMode = TIM_OCFAST_DISABLE;
if (HAL_TIM_PWM_ConfigChannel(&htim2, &sConfigOC, TIM_CHANNEL_1) != HAL_OK)
{
    Error_Handler();
}

// 启动通道1的PWM输出
HAL_TIM_PWM_Start(&htim2, TIM_CHANNEL_1);

sConfigOC.Pulse 即为CCRx的初始值。此后，只需调用 __HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_1, new_pulse_value) 即可在运行时动态改变亮度。呼吸灯效果的实现，便是通过一个主循环或定时器中断，让 new_pulse_value 在0到999之间按正弦或三角函数规律平滑变化。

4.4 中断与DMA：进阶应用的基石

对于更复杂的场景，如需要在PWM周期结束时执行特定任务（如采集ADC数据），可使能更新中断（Update Interrupt）：

// 在MX_TIM2_Init()中添加
HAL_NVIC_SetPriority(TIM2_IRQn, 0, 0);
HAL_NVIC_EnableIRQ(TIM2_IRQn);

// 在中断服务函数中
void TIM2_IRQHandler(void)
{
    HAL_TIM_IRQHandler(&htim2);
}

// 在回调函数中处理
void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim)
{
    if(htim->Instance == TIM2)
    {
        // 此处执行周期性任务，如：读取传感器、更新显示缓冲区
        // 注意：此函数应在毫秒级内完成，避免阻塞其他中断
    }
}

若需实现多通道同步PWM（如三相电机驱动），则应启用DMA请求（DMA Request），让DMA控制器在每次更新事件时，自动将内存中的新CCRx值搬运到定时器寄存器，彻底解放CPU。

5. 常见陷阱与硬核调试技巧

在无数个深夜调试PWM的实践中，我踩过太多坑。这些经验，比任何理论都来得珍贵。

5.1 “灯不亮”问题的黄金排查链

当烧录代码后LED纹丝不动，不要急于怀疑代码，按此顺序逐一排除：
1. 万用表测电压 ：将万用表调至直流电压档，红表笔接LED阳极（或阴极，视电路而定），黑表笔接地。若电压稳定在3.3V或0V，说明PWM未启动，是软件问题；若电压在0V与3.3V间快速跳变（人眼无法分辨），说明PWM已工作，是硬件或感知问题。
2. 示波器看波形 ：这是终极手段。将探头接地夹接GND，探针接PA0。正常应看到清晰的方波。若无波形，检查CubeMX中GPIO的Alternate Function是否配置正确；若波形频率不对，回头检查PSC和ARR的计算；若波形占空比恒为0%或100%，检查 HAL_TIM_PWM_Start() 是否被调用，以及 __HAL_TIM_SET_COMPARE() 的参数是否越界。
3. 引脚复用冲突 ：STM32的引脚功能高度复用。例如，PA0既是普通IO，也是TIM2_CH1，还是ADC1_IN0。若在CubeMX中不小心启用了ADC，PA0的复用功能会被ADC占用，导致TIM2无法输出。务必在“Pinout View”中，将所有非必要外设的引脚设为“GPIO_Input”或“Not Connected”。

5.2 “占空比失真”的隐秘元凶

有时，你计算出CCRx=500，但实测占空比却是45%。罪魁祸首往往是 GPIO的输出速度（Output Speed）配置不当 。在CubeMX的GPIO配置中，若将PA0的速度设为“Low”，其上升/下降沿时间可能长达数百纳秒。当PWM频率较高（如>10kHz）时，这些边沿时间会显著吞噬高电平时间，造成占空比压缩。解决方案：将速度设为“High”或“Very High”。

5.3 “呼吸不自然”的算法优化

用简单的线性插值（ pulse = min + (max-min)*i/100 ）生成呼吸灯，会感觉“前半段慢，后半段快”。这是因为人眼对光强的感知遵循韦伯-费希纳定律，是近似对数关系。更自然的算法是使用正弦函数：

uint16_t pulse = 500 + 499 * (1 - cos(2 * PI * i / 100)) / 2;

此公式让亮度变化速率在中间最快，两端最慢，完美模拟呼吸的生理节奏。 i 从0到100循环，即可得到一个平滑的呼吸周期。

最后，分享一个血泪教训：在一次电机驱动项目中，我将TIM1的ARR设为0xFFFF（65535），以为能获得最高精度。结果发现电机在低速时剧烈抖动。后来用逻辑分析仪抓取波形才发现，由于ARR过大，计数器在低占空比时（CCRx=1）的高电平时间仅为1个时钟周期，极易受电源噪声干扰而丢失。最终将ARR降至1999，问题迎刃而解。 在嵌入式世界里，“精度”与“鲁棒性”永远是一对需要权衡的矛盾体。选择那个能让系统在最恶劣环境下依然可靠运行的参数，才是工程师的终极智慧 。