企业官网建设流程全解析

如果你正在学习 STM32，或者已经用了一段时间，但每次遇到定时器和 PWM 配置，还是得翻手册、查例程，甚至对着 CubeMX 的选项发懵——这篇文章就是为你准备的。

很多教程会告诉你“TIM 是定时器，PWM 是脉宽调制”，然后直接甩出一堆寄存器截图和代码。这没错，但你可能依然不知道：为什么我的 PWM 输出没反应？为什么占空比调了没变化？为什么用高级定时器控制电机时，互补输出和死区时间到底该怎么配？这些问题，恰恰是新手从“知道”到“会用”之间最大的鸿沟。

本文基于一次真实的战队电控培训内容，将深入拆解 STM32 的 TIM（定时器）模块与 PWM（脉宽调制）应用。我们不止讲概念，更聚焦于解决实际开发中的典型问题。你将彻底理解：

1. STM32 定时器的种类与核心应用场景。
2. PWM 生成的完整原理与关键参数（频率、占空比、分辨率）。
3. 如何从零开始，使用 CubeMX 和 HAL 库配置一个可用的 PWM 输出通道。
4. 高级应用：如何用 PWM 精准控制舵机、直流电机，并实现呼吸灯效果。
5. 那些手册里不常提，但调试时一定会遇到的“坑”与解决方案。

无论你是刚接触 STM32 的 25 级新生，还是想巩固 PWM 应用的老手，这篇文章都将提供一条清晰、可落地的实践路径。让我们跳过泛泛而谈，直接切入核心。

1. 为什么 TIM 和 PWM 是 STM32 嵌入式开发的基石？

在嵌入式开发中，有两类需求几乎无处不在：计时和控制。你需要精确地延时 10 毫秒去读取传感器，需要以 1kHz 的频率周期性执行某个任务，需要生成一个信号去控制电机的转速或舵机的角度。这些，都是 TIM（定时器）和 PWM（脉宽调制）的舞台。

STM32 的定时器模块功能强大且种类繁多，常让初学者望而生畏。简单来说，你可以这样理解它们的分工：

• 基本定时器 (TIM6, TIM7)：就像最简单的秒表，只能向上计数，主要用于产生基本的时基，例如为 DAC 提供触发信号或作简单的延时。
• 通用定时器 (TIM2-TIM5, TIM9-TIM14等)：这是你的“瑞士军刀”。除了基本的定时，它们核心的功能就是输入捕获（测量脉冲宽度或频率）和输出比较（生成 PWM 波、驱动单脉冲等）。我们控制舵机、电机、生成呼吸灯，主要靠它。
• 高级定时器 (TIM1, TIM8等)：在通用定时器基础上，增加了互补输出、死区插入、刹车功能等。这是为电机控制（特别是三相无刷电机）和数字电源应用量身定做的，可以安全地驱动 H 桥电路。

而 PWM，则是定时器“输出比较”功能最经典的应用。它通过快速开关（高低电平切换），用数字信号模拟出“模拟量”的效果。占空比（高电平时间占整个周期的比例）的不同，对应着不同的平均电压，从而实现对设备（如电机亮度、速度、舵机位置）的连续控制。

所以，学习 TIM 和 PWM，本质上是在学习如何让 STM32 这颗大脑，拥有精准的“时间感知”和“控制执行”能力。这是你从点亮 LED 迈向智能控制（如平衡车、机械臂、无人机）的必经之路。

2. STM32 定时器 (TIM) 核心概念详解

要玩转 PWM，必须先理解定时器是如何工作的。我们抛开复杂的寄存器，用“时钟”和“计数器”的模型来理解。

2.1 定时器的基本工作原理：一个精密的“计数器”

想象一个水桶（计数器），上方有一个水龙头（时钟源）。时钟源每来一个脉冲（滴下一滴水），计数器就加 1。当水桶装满（计数器计到某个设定值），它就会溢出，并产生一个“溢出”事件（比如触发一个中断），然后水桶清空，重新开始接水。

在 STM32 中：

• 时钟源：可以是系统内部时钟 (APBx)，也可以是外部引脚输入的时钟。
• 计数器：一个 16 位或 32 位的寄存器，负责计数。它可以向上计数、向下计数或中央对齐（先向上后向下）。
• 自动重装载寄存器 (ARR)：这就是“水桶”的容量。计数器计到 ARR 值后，就会发生溢出/更新事件。
• 预分频器 (PSC)：它位于时钟源和计数器之间。如果 PSC 设置为 9，那么时钟源每来 10 个脉冲，计数器才加 1。这相当于把水流调慢，用于降低计数频率，从而获得更长的定时周期。

定时周期计算公式（对于向上计数模式）：定时时间 = (ARR + 1) * (PSC + 1) / 定时器时钟频率例如，定时器时钟为 72MHz，PSC=71，ARR=999，则定时时间 = (999+1)*(71+1)/72,000,000 = 0.001秒 = 1ms。这个公式是配置定时器的核心。

2.2 关键功能模式：输出比较与输入捕获

• 输出比较 (Output Compare)：这是生成 PWM 的基础。定时器中有多个“比较寄存器”（如 CCR1, CCR2）。计数器不断计数，并与这些 CCR 寄存器比较。当计数值等于 CCR 值时，就可以根据设定的模式（如电平翻转、强制输出等）来改变对应输出引脚的电平。通过不断重复这个过程（计数器从0到ARR循环），并合理设置 CCR 的值，就能产生固定频率、可变占空比的 PWM 波。
• 输入捕获 (Input Capture)：与输出比较相反。当特定的引脚上有电平跳变（如上升沿）时，定时器会瞬间“捕获”当前计数器的值，并保存到捕获寄存器中。通过计算两次捕获值之差，就能精确测量脉冲的宽度或信号的频率。这是测量编码器、红外遥控信号等的关键。

理解这两种模式，你就掌握了定时器对外交互的两种主要方式：主动输出和被动测量。

3. PWM（脉宽调制）原理与关键参数

PWM 不是 STM32 独有的，它是一种通用的控制技术。其核心思想是：用数字信号（只有 0 和 1）来模拟一个介于 0 和 1 之间的模拟量。

3.1 PWM 是如何工作的？

假设一个周期为 10ms 的方波：

• 如果 10ms 内全是高电平（占空比 100%），那么平均电压就是 3.3V（假设高电平为3.3V）。
• 如果 5ms 高电平，5ms 低电平（占空比 50%），那么平均电压就是 1.65V。
• 如果 1ms 高电平，9ms 低电平（占空比 10%），那么平均电压就是 0.33V。

对于 LED，平均电压低则亮度暗；对于直流电机，平均电压低则转速慢；对于舵机，脉冲宽度（高电平时间）直接对应其旋转角度。STM32 的定时器，就是那个能极其精确地控制“高电平时间”的机器。

3.2 PWM 的三要素与计算

配置 PWM 时，你必须明确三个参数，它们相互关联：

1. 频率 (Frequency)：PWM 波每秒完成的周期数，单位 Hz。频率 = 定时器时钟频率 / ((PSC + 1) * (ARR + 1))。
   • LED 呼吸灯：频率通常为 100Hz - 1kHz。太低会闪烁，太高可能超出 LED 响应速度，且增加 CPU 负担。
   • 舵机控制：标准频率为 50Hz（周期 20ms）。这是舵机协议规定的。
   • 电机控制：频率范围很宽，从几千 Hz 到几十 kHz。频率越高，电机运行越平稳（电流纹波小），但开关损耗也会增加。
2. 占空比 (Duty Cycle)：高电平时间占整个周期的百分比。占空比 = CCRx / (ARR + 1) * 100%。CCRx 就是输出比较寄存器 x 的值。通过动态修改 CCRx，就能实时改变占空比。
3. 分辨率 (Resolution)：占空比可调节的最小步进。分辨率 = 1 / (ARR + 1)。例如，ARR 设置为 999，那么 CCRx 可以从 0 调到 999，共 1000 个等级，分辨率就是 0.1%。ARR 值越大，分辨率越高，但能实现的最高频率也越低（因为计数器要数更多下）。你需要根据控制精度和频率要求来权衡。

4. 环境准备与 CubeMX 工程创建

我们以 STM32F103C8T6（蓝色 Pill 开发板）为例，使用 STM32CubeMX 进行图形化配置，配合 Keil MDK-ARM 进行开发。

前置条件：

• 操作系统：Windows 10/11, macOS 或 Linux。
• 软件：
  • STM32CubeMX（用于配置引脚和生成代码）。
  • Keil uVision MDK-ARM 或 STM32CubeIDE（用于编写和编译代码）。本文以 Keil 为例。
  • 对应开发板的串口驱动（如 CH340）。
• 硬件：STM32F103C8T6 核心板或最小系统板，USB 数据线，LED 和限流电阻（或直接使用板载 LED），杜邦线若干。

第一步：创建 CubeMX 工程

1. 打开 STM32CubeMX，点击New Project。
2. 在Part Number搜索框中输入STM32F103C8，选择STM32F103C8Tx，点击Start Project。
3. 系统会打开芯片的引脚配置视图。

5. 使用 CubeMX 配置定时器生成 PWM

我们的目标是使用 TIM3 的通道 1 (CH1) 在 PA6 引脚上输出一个 1kHz，初始占空比为 50% 的 PWM 波，用于控制一个 LED 实现呼吸灯效果。

5.1 时钟树配置

定时器的精度源于时钟。首先配置系统时钟。

1. 在Pinout & Configuration标签页，切换到RCC分类。将High Speed Clock (HSE)设置为Crystal/Ceramic Resonator（如果你的板子有外部 8MHz 晶振）。对于很多最小系统板，使用内部 RC 振荡器 (HSI) 也可以，但精度稍差。
2. 切换到Clock Configuration标签页。这是一个关键步骤。我们需要将系统时钟配置到最高性能（对于 F103，通常是 72MHz）。
   • 将HCLK输入 72，然后按回车。
   • CubeMX 会自动计算并配置 PLL 倍频系数。通常，它会将 8MHz 的 HSE 通过 PLL 9 倍频到 72MHz，然后作为系统时钟 SYSCLK。
   • 注意观察APB1 Timer clocks和APB2 Timer clocks。定时器挂在不同的 APB 总线上。TIM3 挂在 APB1 上。当 APB1 预分频系数不为 1 时，定时器时钟会是 APB1 时钟的 2 倍。确保这里显示为 72MHz（如果 APB1 是 36MHz，则定时器时钟为 72MHz）。这是定时器能跑多快的根源。

5.2 定时器参数配置

1. 回到Pinout & Configuration标签页，在左侧分类中找到Timers，展开并选择TIM3。
2. 将Clock Source设置为Internal Clock（使用内部时钟源）。
3. 在下方Channel1下拉菜单中选择PWM Generation CH1。此时，右侧芯片图中 PA6 引脚会被自动标记为TIM3_CH1（绿色）。
4. 切换到Parameter Settings子标签页，开始配置核心参数：
   • Prescaler (PSC - 预分频器)：设置为71。因为我们的目标是 1kHz PWM，且定时器时钟为 72MHz。计算过程：先确定 ARR。假设我们想要 1kHz，则周期 T=1/1000=0.001s。根据公式T = (ARR+1)*(PSC+1)/Fclk。我们先设定一个目标分辨率，比如希望占空比有 1000 级调节（ARR=999），则PSC = (Fclk * T)/(ARR+1) - 1 = (72,000,000 * 0.001)/1000 - 1 = 72 - 1 = 71。
   • Counter Mode (计数模式)：选择Up（向上计数）。这是最常用的 PWM 模式。
   • Counter Period (ARR - 自动重装载值)：设置为999。如上计算，这决定了 PWM 的分辨率（1/1000 = 0.1%）。
   • Internal Clock Division (CKD)：保持默认No Division。
   • auto-reload preload (自动重装载预装载)：建议使能Enable。这可以防止在修改 ARR 时产生毛刺，确保在下一个更新事件时才生效。
5. 继续向下，找到PWM Generation Channel 1的配置：
   • Mode：保持PWM mode 1。在此模式下，当计数器小于 CCR1 时，输出有效电平（高电平）；大于等于时，输出无效电平。
   • Pulse (CCR1 - 捕获/比较寄存器1)：设置为500。初始占空比 = 500 / (999+1) = 50%。
   • Output compare preload (输出比较预装载)：使能Enable。与 ARR 预装载类似，确保 CCR1 的修改平滑生效。
   • CH Polarity (通道极性)：保持High。这意味着有效电平为高。如果你希望默认输出低电平，PWM 有效时才拉高，可以选择Low。

5.3 GPIO 与工程生成

1. 你可以点击 PA6 引脚，查看其 GPIO 配置，通常 CubeMX 会自动配置为复用推挽输出 (Alternate Function Push Pull)，无需手动修改。
2. 转到Project Manager标签页。
   • 设置Project Name和Project Location。
   • Toolchain / IDE选择MDK-ARM V5。
   • 在Code Generator部分，务必勾选Generate peripheral initialization as a pair of ‘.c/.h’ files per peripheral，这会让代码结构更清晰。
3. 点击右上角的GENERATE CODE，生成 Keil 工程代码。

6. HAL 库代码实现与呼吸灯示例

CubeMX 生成了基础框架，我们只需要在合适的地方添加业务逻辑。

6.1 启动 PWM 输出

在生成的工程中，打开main.c文件。我们需要在定时器初始化之后、主循环之前启动 PWM 输出。

找到/* USER CODE BEGIN 2 */和/* USER CODE END 2 */之间的区域（通常在MX_TIM3_Init()函数调用之后），添加启动代码：

/* USER CODE BEGIN 2 */ // 启动 TIM3 的通道1 PWM 输出 HAL_TIM_PWM_Start(&htim3, TIM_CHANNEL_1); // 你也可以使用更高级的带中断或DMA的启动函数，这里基础输出不需要 /* USER CODE END 2 */

HAL_TIM_PWM_Start函数告诉定时器硬件，开始按照我们配置的参数在指定通道上输出 PWM 波。此时，如果你编译下载程序，用示波器或逻辑分析仪测量 PA6 引脚，应该能看到一个 1kHz，占空比 50% 的方波。

6.2 实现呼吸灯效果

呼吸灯的本质是让 PWM 的占空比平滑地由小变大，再由大变小，循环往复。我们在主循环中修改 CCR1 寄存器的值即可。

在while (1)主循环中，添加以下代码：

/* USER CODE BEGIN WHILE */ uint16_t pwmVal = 0; // 当前 PWM 比较值 uint8_t dir = 1; // 方向，1为递增，0为递减 while (1) { // 根据方向增减 PWM 值 if(dir == 1) { pwmVal++; if(pwmVal >= 1000) { // ARR是999，所以CCR最大为999 dir = 0; } } else { pwmVal--; if(pwmVal == 0) { dir = 1; } } // 更新 TIM3 通道1 的占空比 __HAL_TIM_SET_COMPARE(&htim3, TIM_CHANNEL_1, pwmVal); // 延时，控制呼吸速度 HAL_Delay(5); // 5ms 延时，调整此值改变呼吸快慢 /* USER CODE END WHILE */ /* USER CODE BEGIN 3 */ } /* USER CODE END 3 */

代码解释：

• 我们使用pwmVal变量存储当前的 CCR 值，范围 0-999。
• dir变量控制增减方向。
• __HAL_TIM_SET_COMPARE(&htim3, TIM_CHANNEL_1, pwmVal)是一个宏，它直接向 TIM3->CCR1 寄存器写入新的比较值，从而立即改变 PWM 的占空比（因为使能了预装载，实际是在下一个更新事件生效，过程平滑）。
• HAL_Delay(5)控制每次改变占空比的时间间隔。5ms 改变一次，从 0 到 1000 需要 5 秒，完成一次呼吸周期大约 10 秒。你可以调整这个值来改变呼吸频率。

将程序编译下载到开发板，将 PA6 引脚连接到 LED 阳极（LED 阴极接 GND，记得串联一个约220Ω的限流电阻），即可看到 LED 平滑地渐亮渐暗。

7. 进阶应用：控制舵机与直流电机

7.1 舵机 (Servo) 控制

舵机控制使用的是位置型 PWM。它不关心频率的绝对精度，但对脉冲宽度（高电平时间）要求非常精确。

• 标准周期：20ms (频率 50Hz)。这是绝大多数舵机的标准。
• 脉冲宽度范围：通常为 0.5ms 到 2.5ms，分别对应舵机角度范围（如 0 度到 180 度）。有些舵机范围可能略有不同。

配置要点：

1. 定时器计算：为了精确控制脉冲宽度，我们需要高精度的计时。假设定时器时钟 72MHz，周期 20ms。
   • 如果我们希望脉冲宽度最小调节精度为 1us，那么计数器需要能数 20,000 个 1us (20ms / 1us)。ARR 可以设置为 20000-1 = 19999。
   • 此时，PSC = (72,000,000 * 0.02) / 20000 - 1 = 72 -1 = 71。 (计算过程：PSC = (Fclk * T) / (ARR+1) - 1)
   • 这样配置后，计数器每加 1，代表 1us。那么，0.5ms 的脉冲宽度对应的 CCRx 值就是 500，2.5ms 对应 2500。
2. 代码实现：生成 50Hz PWM 后，你只需要根据目标角度，线性映射计算出对应的 CCR 值并设置即可。

   // 将角度（0-180度）转换为 CCR 值（500-2500） uint16_t angleToPulse(uint16_t angle) { // 线性映射：angle(0~180) -> pulse(500~2500) return (angle * (2500 - 500) / 180) + 500; } // 在需要设置角度时调用 __HAL_TIM_SET_COMPARE(&htim3, TIM_CHANNEL_1, angleToPulse(90)); // 设置到90度位置

7.2 直流电机调速

直流电机调速使用的是速度型 PWM。改变占空比，就改变了电机的平均供电电压，从而改变转速。

• 频率选择：电机 PWM 频率通常在几百 Hz 到几十 kHz。
  • 频率太低（如几十Hz）：电机会发出刺耳的啸叫声，转动不连续。
  • 频率适中（1kHz-20kHz）：常用范围，人耳听不到噪音，控制效果较好。
  • 频率很高（>20kHz）：开关损耗增加，但对电机运行平稳性有提升。需要根据电机和驱动电路特性选择。
• 驱动电路：STM32 引脚不能直接驱动电机，必须通过电机驱动模块（如 L298N、TB6612、DRV8833 等 H 桥芯片）。PWM 信号连接到驱动模块的“使能”或“输入”引脚来控制速度，另外还需要 GPIO 控制方向。

配置示例（10kHz PWM）：

• 定时器时钟 72MHz。
• 目标频率 10kHz，周期 T=0.0001s = 100us。
• 设定 ARR = 719，则PSC = (72,000,000 * 0.0001) / (719+1) - 1 = 7200 / 720 -1 = 10 -1 = 9。
• 这样，ARR=719, PSC=9。占空比分辨率约为 1/720 ≈ 0.14%。

8. 常见问题与排查思路

在调试 PWM 时，你可能会遇到以下问题。这里提供一个排查清单：

9. 最佳实践与工程建议

掌握了基础操作后，以下建议能帮助你在实际项目中更稳健地使用 PWM：

1. 规划定时器资源：一个 STM32 芯片有多个定时器。在项目初期，就规划好哪个定时器用于 PWM 输出，哪个用于输入捕获，哪个用于基本定时。避免后期资源冲突。高级定时器 (TIM1/TIM8) 留作电机控制等复杂用途。
2. 善用 CubeMX 可视化：CubeMX 的Parameter Settings页面在你修改 PSC 或 ARR 时，会实时计算并显示Estimated counter frequency和Estimated period。这是验证配置的快速方法。
3. 理解“预装载”的重要性：无论是 ARR 还是 CCR，使能预装载 (Enable) 都是好习惯。它允许你在当前周期安全地修改参数，新值只在下一个更新周期生效，避免了输出波形出现断裂或毛刺。
4. 使用 DMA 减轻 CPU 负担：对于需要频繁、精确改变占空比的复杂应用（如生成正弦波、多个通道同步控制），可以配置定时器的 DMA 请求，让 DMA 自动将内存中的波形数据搬运到 CCR 寄存器，无需 CPU 干预。
5. 互补输出与死区时间：当使用高级定时器驱动 H 桥时，互补输出（一对相反的电平信号）和死区时间（防止上下桥臂直通的延迟）是必须的。务必在 CubeMX 中正确配置Break and Dead Time参数，并在硬件上做好隔离保护。
6. 功耗考虑：如果 PWM 输出引脚未连接外部电路，将其设置为模拟输入或输出低电平，以避免不必要的功耗。
7. 调试工具：一个廉价的逻辑分析仪（如 Saleae 克隆版）或带波形显示功能的示波器，对于调试 PWM 频率、占空比、死区时间至关重要，远比点灯和串口打印直观。

从理解定时器的计数逻辑，到配置 CubeMX 生成 PWM，再到用代码动态控制占空比实现呼吸灯和舵机控制，这条路径清晰地展示了 STM32 定时器外设的核心应用方法。关键在于厘清时钟源、PSC、ARR、CCRx 这几个寄存器之间的关系，并理解它们如何共同决定波形的频率、占空比和分辨率。

当你成功让 LED 按照你的意愿呼吸，让舵机精准地转到指定角度时，你已经掌握了嵌入式系统中“时间控制”的一把关键钥匙。下一步，可以尝试结合输入捕获功能测量外部脉冲，使用多个定时器协同工作，或者探索高级定时器在无刷电机 FOC 控制中的应用。建议你收藏本文的配置步骤和排查清单，在后续开发中随时查阅。