当前位置：首页 > news >正文

STM32通用定时器PWM输出实战：从电机控速到LED调光（附完整代码）

news 2026/3/27 6:09:33

STM32通用定时器PWM输出实战：从电机控速到LED调光（附完整代码）

如果你刚开始接触STM32，可能会觉得定时器是个复杂的外设，尤其是看到那些密密麻麻的寄存器。但我想告诉你，一旦你掌握了通用定时器的PWM输出，你会发现它简直是嵌入式项目里的“瑞士军刀”。无论是驱动一个小电机让它平稳转动，还是调节LED灯带实现呼吸灯效果，甚至是为舵机提供精准的控制信号，PWM都是那个幕后功臣。这篇文章，我不想仅仅给你一堆代码和公式，而是想带你从实际项目的角度出发，看看如何把STM32的通用定时器用活，解决你手头真实的问题。我们会以常见的STM32F103系列为例，但其中的思路和方法，对于其他STM32家族成员也同样适用。准备好了吗？让我们从最根本的原理开始，一步步搭建起可用的PWM驱动框架。

1. 理解PWM：不仅仅是方波

很多人一提到PWM，脑子里就是一张高低电平交替的方波图。这没错，但PWM的精髓远不止于此。它的全称是脉冲宽度调制，关键在于“宽度调制”这四个字。在一个周期固定的方波信号里，高电平持续的时间占比是可以变化的，这个占比就是我们常说的占空比。

注意：占空比通常用百分比表示，比如50%的占空比意味着一个周期内，高电平和低电平的时间各占一半。

为什么调节占空比就能控制电机速度或LED亮度呢？这涉及到“惯性系统”的概念。无论是电机的线圈，还是我们的眼睛，都无法对极高频率的开关变化做出瞬时响应。它们感知到的是一个“平均效果”。例如，对于一个LED，当PWM频率足够高（比如1kHz以上）时，人眼就看不到闪烁了，只能感受到其平均亮度。占空比越高，平均电压越高，LED就越亮。

对于STM32的通用定时器，生成PWM的核心机制叫做输出比较。定时器内部有一个计数器（CNT）在不停地循环累加（从0到ARR值），同时，你设置了一个比较值（CCR）。硬件会实时比较CNT和CCR的大小，并根据你设定的“输出比较模式”来决定输出引脚的电平。当CNT < CCR时输出一种电平，CNT ≥ CCR时输出另一种电平，如此循环，PWM波形就产生了。

这里直接关系到三个核心寄存器：

PSC（预分频器）：用来对定时器的时钟源进行分频，以此调整计数器的计数节奏。
ARR（自动重装载寄存器）：决定了计数器的周期，CNT从0数到ARR后归零（或向下计数）。
CCR（捕获/比较寄存器）：这就是我们用来设定比较值的寄存器，直接控制PWM的脉宽。

它们共同决定了输出PWM波形的关键参数，我们可以用下面这个表格来清晰地总结：

参数	计算公式	说明
PWM频率	`Fpwm = Ftim_ck / [(PSC+1) * (ARR+1)]`	`Ftim_ck`是定时器时钟频率。频率决定了信号变化的快慢。
PWM占空比	`Duty = CCR / (ARR+1)`	这里假设CCR值在0到ARR之间。占空比决定了有效电平的占比。
PWM分辨率	`Reso = 1 / (ARR+1)`	分辨率代表了占空比可调节的最小步进。ARR越大，分辨率越高，控制越精细。

举个例子，如果定时器时钟是72MHz，我们设置PSC=71，ARR=999，那么：

定时器计数时钟 = 72MHz / (71+1) = 1MHz
PWM频率 = 1MHz / (999+1) = 1kHz
此时，如果我们设置CCR=300，占空比就是 300/1000 = 30%。

理解了这些，你就知道如何通过调整这三个值来得到你想要的波形了。接下来，我们进入实战环节。

2. 硬件连接与工程初始化

在写代码之前，我们得先确定硬件怎么连。假设我们使用STM32F103C8T6（也就是常见的“蓝色药丸”核心板），我们的目标是使用TIM2的通道1（CH1）输出PWM。查阅数据手册可知，TIM2_CH1默认复用在PA0引脚上。

场景一：驱动一个LED最简单的场景，我们将一个LED的正极通过一个限流电阻（如220Ω）连接到PA0，负极接地。这样，当PA0输出高电平时LED亮，通过调节PWM占空比就能调节亮度。

场景二：驱动直流电机（通过电机驱动模块）直接连接单片机引脚到电机是带不动的，我们需要一个电机驱动模块，比如L298N或TB6612。此时，PA0引脚连接到驱动模块的“使能”或“PWM输入”引脚，通过PWM控制电机的平均供电电压，从而实现调速。

确定了硬件连接，我们在STM32CubeIDE（或其他你喜欢的IDE）中创建一个新工程。选择正确的芯片型号，在图形化配置界面中，我们需要进行以下关键配置：

系统时钟：确保系统时钟正确配置，APB1总线时钟（TIM2挂载在此）通常为72MHz。
调试接口：根据你的下载调试器（ST-Link， J-Link等），正确配置SYS中的Debug模式，比如“Serial Wire”。
引脚配置：
- 找到PA0，将其功能设置为TIM2_CH1。
- 其模式会自动变为“Alternate Function Push Pull”（复用推挽输出），这是输出PWM所必需的。
定时器配置：
- 找到TIM2，将“Clock Source”设置为“Internal Clock”。
- 在“Parameter Settings”中：
  - Prescaler (PSC - 16 bits value)：设置为71。（(71+1)分频）
  - Counter Mode：设置为Up（向上计数）。
  - Counter Period (AutoReload Register - 16 bits value)：设置为999。（ARR=999）
  - auto-reload preload：建议使能（Enable），这样修改ARR值时可以避免当前周期产生毛刺。
- 在下方切换到“PWM Generation CH1”子标签：
  - Mode：选择 “PWM mode 1”。
  - Pulse (16 bits value)：这里就是初始的CCR值，我们先填500（对应50%占空比）。
  - Output compare preload：务必使能（Enable）。这允许你在后台更新CCR（影子寄存器），在下一个周期生效，保证波形稳定。
  - CH Polarity：选择 “High”。这意味着默认输出有效电平为高。

完成这些配置后，生成代码。CubeMX会自动帮你生成时钟、GPIO和定时器的初始化代码。下面是一个它生成的关键初始化函数示例：

/* TIM2 init function */ void MX_TIM2_Init(void) { TIM_ClockConfigTypeDef sClockSourceConfig = {0}; TIM_MasterConfigTypeDef sMasterConfig = {0}; TIM_OC_InitTypeDef sConfigOC = {0}; htim2.Instance = TIM2; htim2.Init.Prescaler = 71; htim2.Init.CounterMode = TIM_COUNTERMODE_UP; htim2.Init.Period = 999; htim2.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1; htim2.Init.AutoReloadPreload = TIM_AUTORELOAD_PRELOAD_ENABLE; if (HAL_TIM_Base_Init(&htim2) != HAL_OK) { Error_Handler(); } sClockSourceConfig.ClockSource = TIM_CLOCKSOURCE_INTERNAL; if (HAL_TIM_ConfigClockSource(&htim2, &sClockSourceConfig) != HAL_OK) { Error_Handler(); } if (HAL_TIM_PWM_Init(&htim2) != HAL_OK) { Error_Handler(); } sMasterConfig.MasterOutputTrigger = TIM_TRGO_RESET; sMasterConfig.MasterSlaveMode = TIM_MASTERSLAVEMODE_DISABLE; if (HAL_TIMEx_MasterConfigSynchronization(&htim2, &sMasterConfig) != HAL_OK) { Error_Handler(); } sConfigOC.OCMode = TIM_OCMODE_PWM1; sConfigOC.Pulse = 500; // 初始CCR值 sConfigOC.OCPolarity = TIM_OCPOLARITY_HIGH; sConfigOC.OCFastMode = TIM_OCFAST_DISABLE; if (HAL_TIM_PWM_ConfigChannel(&htim2, &sConfigOC, TIM_CHANNEL_1) != HAL_OK) { Error_Handler(); } HAL_TIM_MspPostInit(&htim2); }

初始化完成后，在主函数中，我们只需要两行代码就能启动PWM输出：

HAL_TIM_PWM_Start(&htim2, TIM_CHANNEL_1); // 启动PWM输出

现在，用示波器或者逻辑分析仪探头连接到PA0，你应该能看到一个频率1kHz，占空比50%的规整PWM方波了。如果没有仪器，接上LED也能看到它处于半亮状态。

3. 动态调节：让PWM“活”起来

静态输出一个固定占空比的PWM用处有限。真正的威力在于动态调节。在电机控制中，我们需要加速减速；在LED调光中，我们需要实现呼吸灯效果。这就需要我们在程序运行中实时改变CCR的值。

HAL库提供了非常简单的函数来动态设置比较值：

__HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_1, new_ccr_value); // 或者使用更完整的函数形式 TIM2->CCR1 = new_ccr_value; // 直接操作寄存器，速度更快

实战案例1：按键控制LED亮度我们添加两个按键，一个用于增加亮度，一个用于降低亮度。

// 假设按键已初始化，并有对应的读取函数 uint16_t ccr_val = 500; // 初始值 while (1) { if (KEY_UP_PRESSED()) { // 亮度增加 if (ccr_val < 1000) { // 不超过ARR值 ccr_val += 10; __HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_1, ccr_val); } HAL_Delay(50); // 简单防抖 } if (KEY_DOWN_PRESSED()) { // 亮度降低 if (ccr_val > 0) { ccr_val -= 10; __HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_1, ccr_val); } HAL_Delay(50); } // ... 其他任务 }

实战案例2：实现平滑的LED呼吸灯呼吸灯要求占空比平滑地由小变大，再由大变小。直接在循环里粗暴地加减CCR值，效果会很生硬。我们可以利用定时器的溢出中断，在中断里进行更精细的控制。

首先，在CubeMX中使能TIM2的更新中断（Update Interrupt）。然后在代码中：

// 全局变量 int16_t breath_direction = 1; // 1为渐亮，-1为渐灭 uint16_t breath_ccr = 0; // TIM2中断回调函数（在stm32f1xx_it.c中，或自己重写） void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if (htim->Instance == TIM2) { breath_ccr += breath_direction * 5; // 每次调整步进为5 if (breath_ccr >= 1000) { // 达到最亮 breath_ccr = 1000; breath_direction = -1; } else if (breath_ccr <= 0) { // 达到最暗 breath_ccr = 0; breath_direction = 1; } __HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_1, breath_ccr); } } // 主函数中 HAL_TIM_Base_Start_IT(&htim2); // 启动定时器中断 HAL_TIM_PWM_Start(&htim2, TIM_CHANNEL_1); // 启动PWM输出

这样，LED就会以非常平滑的方式呼吸了。你可以通过调整中断中的步进值和ARR/PSC来改变呼吸的速度和平滑度。

4. 进阶技巧与避坑指南

当你掌握了基础操作后，下面这些技巧和注意事项能帮你解决更复杂的问题，并避免一些常见的“坑”。

4.1 多通道同步输出一个定时器可以同时输出多个PWM通道（例如TIM2有CH1, CH2, CH3, CH4）。它们的频率由ARR和PSC共同决定，是同步的，但占空比由各自的CCR独立控制。这在控制多路LED灯带或者需要严格同步的多路信号时非常有用。在CubeMX中配置好多个通道，然后一起启动即可：

HAL_TIM_PWM_Start(&htim2, TIM_CHANNEL_1); HAL_TIM_PWM_Start(&htim2, TIM_CHANNEL_2); HAL_TIM_PWM_Start(&htim2, TIM_CHANNEL_3);

4.2 频率与分辨率的权衡从公式Fpwm = Fck / [(PSC+1)*(ARR+1)]和分辨率 = 1/(ARR+1)可以看出，PWM频率和分辨率是矛盾的。想要高频率（比如电机控制需要20kHz以上以减少噪音），ARR就必须小，导致分辨率降低（占空比调节阶梯变粗）。反之，想要精细调光（如16位分辨率），ARR就要很大（65535），频率就会很低。你必须根据实际应用场景做出取舍。

LED调光：人眼对低频闪烁敏感，频率最好在100Hz以上，但对分辨率要求高，1kHz频率下ARR=999，分辨率约0.1%，通常足够。
直流电机控速：为了消除可闻噪音，频率通常在15kHz-20kHz以上。假设系统时钟72MHz，要得到20kHz频率，(PSC+1)*(ARR+1) = 72M/20k = 3600。如果我们取PSC=0，那么ARR=3599，分辨率约为0.028%，也足够精细。
舵机控制：舵机要求的是50Hz（周期20ms）左右的低频PWM，但脉宽精度要求高（通常在0.5ms到2.5ms之间变化）。此时频率固定，我们可以设置一个较大的ARR值来获得高精度的脉宽控制。

4.3 引脚重映射与调试端口冲突这是一个非常经典的坑！比如，TIM2_CH1默认在PA0，但你的PA0被其他器件占用了。数据手册告诉你，TIM2_CH1可以重映射到PA15。你兴冲冲地配置了重映射，结果PWM死活出不来。

问题在于：PA15、PB3、PB4等引脚在默认情况下被复用为JTAG调试端口。你必须先解除这些引脚的JTAG功能，将其释放为普通GPIO，才能用于定时器输出。

在CubeMX中，这个配置在System Core->SYS->Debug里。如果你只用SWD调试（ST-Link通常用这个），把Debug设置为“Serial Wire”，CubeMX会自动帮你关闭JTAG，释放PA15、PB3、PB4。然后再去进行定时器引脚的重映射配置。

如果不用CubeMX，用标准库的话，你需要调用这样的函数序列：

// 1. 开启AFIO时钟 RCC_APB2PeriphClockCmd(RCC_APB2Periph_AFIO, ENABLE); // 2. 禁用JTAG，启用SWD（释放PA15, PB3, PB4） GPIO_PinRemapConfig(GPIO_Remap_SWJ_JTAGDisable, ENABLE); // 3. 进行TIM2的部分重映射1（将CH1映射到PA15） GPIO_PinRemapConfig(GPIO_PartialRemap1_TIM2, ENABLE);

4.4 使用DMA自动更新PWM序列对于更复杂的应用，比如播放LED音乐频谱、生成特定形状的调制波形，需要连续、高速地改变CCR值。如果都在中断里完成，会消耗大量CPU资源。这时就该DMA出场了。

你可以配置DMA，将存储有CCR值序列的数组（在内存中），自动地、周期性地搬运到定时器的CCR寄存器中。定时器每更新一次（或比较匹配一次），DMA就搬运下一个数据，完全不需要CPU干预。这在制作高级灯光效果时是必备技能。配置DMA相对复杂，需要在CubeMX中仔细设置DMA通道、传输方向、数据宽度和循环模式。

4.5 测量你的PWM最后，无论代码写得多么漂亮，一定要用示波器或逻辑分析仪实际测量一下输出的波形。检查：