【产出】 > 用 STM32 定时器输出 PWM:会用 PSC、ARR 算出任意频率,用 CCR 设置占空比,在运行中调亮度、调舵机角度,并知道定时器时钟频率要怎么查。
【版本】 > 定时器使用步骤依据 ST 官方 STM32F4 HAL 驱动源码(stm32f4xx_hal_tim.c)的使用说明;频率公式是 STM32 通用定时器的标准计数关系,各系列一致。
一、HAL 官方给出的步骤
ST 驱动源码里写的定时器用法:
- 在
HAL_TIM_PWM_MspInit()里初始化底层资源:用__HAL_RCC_TIMx_CLK_ENABLE()打开定时器时钟;打开对应 GPIO 时钟,把引脚配成复用功能。 - 用
HAL_TIM_PWM_Init()和HAL_TIM_PWM_ConfigChannel()配置 PWM。 - 用
HAL_TIM_PWM_Start()启动输出(也有_IT、_DMA版本)。
官方还提醒:要用外部时钟源时(默认是 APB 总线上的内部时钟),用 HAL_TIM_ConfigClockSource() 配置,必须在调用任何启动函数之前完成。
在 CubeMX 里:选中定时器 → Channel1 选 PWM Generation CH1,对应引脚会自动变成复用功能,参数在 Parameter Settings 里填。
二、三个关键参数
| 参数 | CubeMX 里的名字 | 作用 |
|---|---|---|
| PSC | Prescaler | 预分频,定时器时钟 ÷ (PSC + 1) 得到计数频率 |
| ARR | Counter Period | 自动重装值,计数器从 0 数到 ARR 为一个周期 |
| CCR | Pulse | 比较值,计数器小于 CCR 时输出有效电平(PWM 模式 1) |
PWM 频率 = 定时器时钟 ÷ ((PSC + 1) × (ARR + 1))
占空比 = CCR ÷ (ARR + 1)
三、例子
定时器时钟 84 MHz(例如 STM32F411 的 APB1 定时器):
1 kHz、用于 LED 调光:
- PSC = 83 → 计数频率 84 MHz ÷ 84 = 1 MHz
- ARR = 999 → 1 MHz ÷ 1000 = 1 kHz
- CCR 取 0–1000,对应占空比 0%–100%
50 Hz、用于舵机:
- PSC = 83 → 1 MHz,每计一个数是 1 µs
- ARR = 19999 → 20 ms 周期,50 Hz
- CCR = 1000 / 1500 / 2000,即高电平 1 / 1.5 / 2 ms,对应舵机的一端、中位、另一端
【提示】 > 把计数频率凑成 1 MHz 这样的整数,CCR 的数值就直接等于微秒数,算起来最省事。ARR 越大,占空比可调的级数越多(分辨率越高);但 ARR 不能超过定时器位数,16 位定时器最大 65535。
四、定时器时钟到底是多少
这是最容易算错的地方。定时器时钟不一定等于 APB 总线时钟:当 APB 预分频系数不为 1 时,定时器时钟是 APB 时钟的 2 倍。
直接看 CubeMX 的 Clock Configuration 页最省事,里面单独列出了 "APB1 Timer clocks" 和 "APB2 Timer clocks"。还要查数据手册,确认你用的定时器挂在 APB1 还是 APB2 上。
五、代码
/* USER CODE BEGIN 2 */
HAL_TIM_PWM_Start(&htim2, TIM_CHANNEL_1);
/* USER CODE END 2 */
/* 运行中改占空比:直接写比较寄存器,立即生效 */
__HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_1, 250); /* 25% */
/* 运行中改频率:改 ARR,同时按比例改 CCR */
__HAL_TIM_SET_AUTORELOAD(&htim2, 499); /* 2 kHz */
__HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_1, 250); /* 仍是 50% */
呼吸灯:
while (1)
{
for (uint16_t d = 0; d < 1000; d += 5) {
__HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_1, d);
HAL_Delay(5);
}
for (uint16_t d = 1000; d > 0; d -= 5) {
__HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_1, d);
HAL_Delay(5);
}
}
【注意】 > 运行中修改 ARR 时,要在 CubeMX 里把 auto-reload preload 设为 Enable。这样新的 ARR 值会在下一个周期开始时才生效,不会因为改小的 ARR 已经小于当前计数值,导致计数器一直数到 65535 才回绕,输出出现一个很长的异常脉冲。
六、常见问题
| 现象 | 原因与处理 |
|---|---|
| 引脚没有波形 | 没调用 HAL_TIM_PWM_Start();或者引脚不是这个定时器通道的复用引脚 |
| 频率是计算值的 2 倍或一半 | 定时器时钟算错,按第四节到 Clock Configuration 页核对 |
| 高级定时器(TIM1、TIM8)没输出 | 高级定时器还需要打开主输出 MOE,HAL 的 PWM_Start 会处理;用到互补通道时改用 HAL_TIMEx_PWMN_Start() |
| 舵机抖动 | 舵机供电不足;舵机电源和 STM32 要共地 |
【注意】 > 舵机、电机不能由 STM32 的引脚或板载 3.3 V 供电,要用独立电源,并与 STM32 共地。GPIO 只负责输出 PWM 信号。
参考资料
- ST 官方 STM32F4 HAL 驱动源码(stm32f4xx_hal_tim.c):https://github.com/STMicroelectronics/stm32f4xx-hal-driver
评价 (0)