1. 项目概述从定时器到PWM的工程实践在嵌入式开发特别是基于STM32这类MCU的项目里定时器和PWM输出可以说是工程师的“左右手”。无论是驱动一个舵机精准转动还是控制电机的转速亦或是实现呼吸灯效果背后都离不开这两项技术的支撑。我接触过不少刚上手HAL库的朋友面对CubeMX里那一堆眼花缭乱的定时器配置选项常常感到无从下手调出来的PWM要么没波形要么频率不对要么占空比控制不灵。这其实很正常因为定时器本身就是一个功能强大且复杂的模块而HAL库在提供便利性的同时也封装了许多底层细节如果不理解其运作机制就容易踩坑。这篇文章我就结合自己这些年用HAL库在STM32上折腾定时器输出PWM的实际经验从一个工程实践者的角度把这块内容掰开揉碎了讲清楚。我们不只讲“怎么配”更要讲清楚“为什么这么配”以及配置时那些容易忽略的“坑点”。目标很明确让你看完之后能独立、自信地配置出任意你想要的PWM信号并且知道出了问题该从哪里入手排查。无论是STM32F1、F4还是H7系列其核心思想都是相通的我们会以最常见的通用定时器如TIM2, TIM3, TIM4为例进行说明。2. 定时器与PWM核心原理拆解在动手配置之前我们必须先在心里建立起清晰的模型。很多人配置失败根源在于对几个核心概念和它们之间的关系模糊不清。2.1 定时器是如何“计时”的你可以把STM32的一个定时器想象成一个带有自动重载功能的向上/向下计数器。它最核心的部件有三个时钟源、计数器寄存器CNT和自动重载寄存器ARR。时钟源这是计数器的“心跳”。通常来源于系统主频经过预分频器后。比如你的系统时钟是72MHz这就是计数器可能跑到的最高速度。预分频器PSC它位于时钟源和计数器之间作用是对时钟源进行分频。如果PSC设置为71注意实际分频系数 PSC 1那么输入计数器的实际时钟频率就是 72MHz / (711) 1MHz。这个寄存器决定了计数器累加的“快慢”。计数器CNT这是一个16位或32位的寄存器它会根据输入时钟的频率每个时钟周期加1向上计数或减1向下计数。自动重载寄存器ARR这是计数器的“终点”。当计数器CNT的值达到ARR设定的值时向上计数模式或者在向下计数模式下减到0时会产生一个“更新事件”Update Event并且计数器会被自动重置到初始值通常是0然后开始新一轮的计数。这个“从0到ARR再归零”的周期就是定时器的一个完整计时周期。定时器频率与周期的计算 定时器的溢出频率即更新事件频率公式为F_update F_input / (PSC 1) / (ARR 1)。 定时器的溢出周期即更新事件周期为T_update 1 / F_update。 这里F_input是输入定时器的时钟频率。ARR1是因为ARR寄存器存储的是周期值计数器从0计数到ARR总共是ARR1个计数值。2.2 PWM的本质比较输出PWM脉冲宽度调制并不是定时器的一个独立模式而是其“输出比较”功能的一种特定应用。定时器除了计数还配备了多个捕获/比较通道。每个通道都关联着一个捕获/比较寄存器CCR。PWM产生的过程是这样的定时器计数器CNT在时钟驱动下周而复始地在0到ARR之间循环计数。我们为某个通道比如通道1设定一个比较值写入CCR1寄存器。硬件会实时将CNT的值与CCR1的值进行比较。根据我们设定的PWM模式输出引脚比如PA8的电平会在CNT与CCR值满足特定关系时发生翻转。最常用的两种PWM模式是PWM模式1在向上计数时当CNT CCR通道输出有效电平通常为高电平当CNT ≥ CCR输出无效电平。向下计数时则相反。PWM模式2与模式1逻辑相反。通过改变CCR的值就能改变一个PWM周期内有效电平所占的时间比例也就是占空比。而改变ARR的值则会改变整个PWM波的周期或频率。注意这里有一个关键点ARR决定了PWM的频率CCR决定了占空比。但占空比的计算是Duty Cycle CCR / (ARR 1) * 100%。因为计数是从0到ARR总共有ARR1个“步长”。如果你设置ARR999CCR500那么占空比是500/100050%而不是500/999。2.3 HAL库的抽象层利弊分析HAL库通过HAL_TIM_PWM_Init(),HAL_TIM_PWM_ConfigChannel()等函数将上述硬件寄存器的操作封装起来。好处是代码移植性高在不同STM32系列间切换相对容易且CubeMX可以图形化生成初始化代码。但弊端是它隐藏了细节。例如在配置时你需要通过一个TIM_OC_InitTypeDef结构体来设置PWM模式、脉冲值即CCR、输出极性等而不直接操作CCR寄存器。理解这个结构体每个成员的意义是正确配置的关键。3. 基于CubeMX与HAL库的PWM配置实战理论说得再多不如动手配置一遍。我们以在STM32F103C8T6的PA8引脚TIM1_CH1上产生一个1kHz、占空比50%的PWM波为例。假设系统时钟为72MHz。3.1 CubeMX图形化配置步骤引脚与定时器基础配置在Pinout视图下找到PA8将其功能设置为TIM1_CH1。在左侧导航栏找到TIM1进入配置。Clock Source选择Internal Clock内部时钟。Parameter Settings标签页Prescaler (PSC - 16 bits value)这里填71。计算逻辑为了得到1MHz的计数器时钟72MHz / (711) 1MHz。Counter Mode选择Up向上计数。Counter Period (AutoReload Register - 16 bits value)这里填999。计算逻辑PWM频率 1MHz / (9991) 1000Hz 1kHz。Internal Clock Division (CKD)保持默认No Division。auto-reload preload建议使能Enable。这会让对ARR的修改在下一个更新事件时才生效防止在运行中修改ARR导致产生毛刺或错误的PWM周期。PWM通道详细配置下方找到Channel1选择PWM Generation CH1。会弹出通道配置窗口Mode选择PWM Mode 1。Pulse (16 bits value)这是初始的CCR值决定初始占空比。占空比 Pulse / (ARR1)。我们要50%占空比ARR是999所以Pulse 500。Output Compare preload务必使能Enable。这会让对CCR即Pulse的修改在下一个更新事件时才生效这是平滑改变占空比、避免输出异常的关键。CH Polarity选择High。这意味着“有效电平”为高电平。如果你希望空闲状态占空比0%时引脚为高电平PWM波是低脉冲则应选择Low。点击OK。生成代码在Project Manager设置好工程路径和IDE如MDK-ARM。点击GENERATE CODE。3.2 生成的代码分析与关键函数解读CubeMX会生成tim.c和tim.h。我们重点关注tim.c中的初始化函数。// tim.c 中的初始化片段 static void MX_TIM1_Init(void) { TIM_ClockConfigTypeDef sClockSourceConfig {0}; TIM_MasterConfigTypeDef sMasterConfig {0}; TIM_OC_InitTypeDef sConfigOC {0}; htim1.Instance TIM1; htim1.Init.Prescaler 71; htim1.Init.CounterMode TIM_COUNTERMODE_UP; htim1.Init.Period 999; // ARR htim1.Init.ClockDivision TIM_CLOCKDIVISION_DIV1; htim1.Init.RepetitionCounter 0; htim1.Init.AutoReloadPreload TIM_AUTORELOAD_PRELOAD_ENABLE; if (HAL_TIM_Base_Init(htim1) ! HAL_OK) { Error_Handler(); } sClockSourceConfig.ClockSource TIM_CLOCKSOURCE_INTERNAL; if (HAL_TIM_ConfigClockSource(htim1, sClockSourceConfig) ! HAL_OK) { Error_Handler(); } if (HAL_TIM_PWM_Init(htim1) ! HAL_OK) { Error_Handler(); } sMasterConfig.MasterOutputTrigger TIM_TRGO_RESET; sMasterConfig.MasterSlaveMode TIM_MASTERSLAVEMODE_DISABLE; if (HAL_TIMEx_MasterConfigSynchronization(htim1, sMasterConfig) ! HAL_OK) { Error_Handler(); } sConfigOC.OCMode TIM_OCMODE_PWM1; // PWM模式1 sConfigOC.Pulse 500; // 初始CCR值 sConfigOC.OCPolarity TIM_OCPOLARITY_HIGH; // 输出极性高 sConfigOC.OCNPolarity TIM_OCNPOLARITY_HIGH; sConfigOC.OCFastMode TIM_OCFAST_DISABLE; sConfigOC.OCIdleState TIM_OCIDLESTATE_RESET; sConfigOC.OCNIdleState TIM_OCNIDLESTATE_RESET; // 关键配置输出比较预装载使能 sConfigOC.OCPreload TIM_OCPRELOAD_ENABLE; if (HAL_TIM_PWM_ConfigChannel(htim1, sConfigOC, TIM_CHANNEL_1) ! HAL_OK) { Error_Handler(); } // 使能定时器通道输出的预装载寄存器ARR和CCR __HAL_TIM_ENABLE_OCxPRELOAD(htim1, TIM_CHANNEL_1); // 主输出使能对于高级定时器TIM1/TIM8很重要 HAL_TIMEx_MasterConfigSynchronization(htim1, sMasterConfig); }关键点解析htim1.Init.AutoReloadPreload TIM_AUTORELOAD_PRELOAD_ENABLE;和sConfigOC.OCPreload TIM_OCPRELOAD_ENABLE;这两行是保证PWM输出稳定的“安全锁”。务必使能。对于高级定时器TIM1, TIM8在启动PWM输出前有时需要额外调用__HAL_TIM_MOE_ENABLE(htim1);来使能主输出否则引脚可能没有输出。但CubeMX生成的代码通常通过sMasterConfig或后续的HAL_TIM_PWM_Start处理了这一点。3.3 主程序中的启动与动态控制初始化完成后在main函数的初始化部分后你需要启动PWM输出。// 在main.c的/* USER CODE BEGIN 2 */ 部分 HAL_TIM_PWM_Start(htim1, TIM_CHANNEL_1);这行代码会启动定时器的计数器并开启通道1的输出。动态修改PWM占空比和频率 这是项目中最常见的需求比如调节电机速度、LED亮度。修改占空比修改CCR使用__HAL_TIM_SET_COMPARE()宏或直接写寄存器。推荐使用宏因为它考虑了预装载机制。// 将TIM1通道1的占空比改为75% __HAL_TIM_SET_COMPARE(htim1, TIM_CHANNEL_1, 750); // CCR 750 (占空比 750/100075%)由于我们使能了OCPreload这个新CCR值会在下一个PWM周期生效变化是平滑的。修改频率修改ARR通过__HAL_TIM_SET_AUTORELOAD()宏。注意改变ARR会同时影响PWM频率和占空比基准。修改后通常需要按比例调整CCR以维持原有占空比。uint32_t new_arr 1999; // 目标ARR频率将变为 1MHz / 2000 500Hz uint32_t old_ccr __HAL_TIM_GET_COMPARE(htim1, TIM_CHANNEL_1); uint32_t old_arr __HAL_TIM_GET_AUTORELOAD(htim1); // 按比例计算新的CCR以保持占空比不变 uint32_t new_ccr (old_ccr * new_arr) / old_arr; __HAL_TIM_SET_AUTORELOAD(htim1, new_arr); __HAL_TIM_SET_COMPARE(htim1, TIM_CHANNEL_1, new_ccr);4. 深度配置技巧与高级应用场景掌握了基础配置我们可以看看一些更实际、更复杂的应用场景和对应的配置技巧。4.1 互补输出与死区插入在电机驱动如H桥电路或某些电源应用中需要一对互补的PWM信号CH和CHN并且为了防止上下桥臂同时导通造成短路必须在两个互补信号之间插入一段同时为低电平的“死区时间”。配置要点以TIM1_CH1和CH1N为例在CubeMX中除了使能TIM1_CH1还要使能TIM1_CH1N。在TIM1的配置中Break and Dead-Time断路和死区时间配置单元会被激活。使能Break Function断路功能通常选择BRK_INPUT。断路功能是安全特性当外部故障信号触发时强制关闭所有输出。配置Dead Time死区时间。死区时间以定时器时钟周期为单位。HAL库提供了计算函数__HAL_TIM_CALC_DEADTIME可以根据系统时钟和所需死区时间单位纳秒计算出要写入寄存器的值。例如需要500ns的死区时间定时器时钟为72MHzuint32_t deadtime __HAL_TIM_CALC_DEADTIME(72000000, 500, TIM_DEADTIME_APB_CLK_DIV2); // 然后将deadtime赋值给 htim1.Init.DeadTime 或相应的结构体成员。生成的代码中死区时间配置会体现在TIM_BDTRInitTypeDef结构体中。启动时需要使用HAL_TIMEx_PWMN_Start(htim1, TIM_CHANNEL_1);来启动互补通道。4.2 多通道同步与主从模式有时需要多个PWM通道完全同步启动或者让一个定时器作为另一个定时器的时钟源。这就需要用到定时器的主从模式。需求场景TIM2和TIM3需要输出完全同步的PWM波。配置思路将TIM2配置为主模式Master使其更新事件UEV产生一个触发输出TRGO。然后将TIM3配置为从模式Slave将其触发输入TI连接到TIM2的TRGO并设置为“触发模式”作为时钟源。CubeMX操作配置TIM2在Parameter Settings-Trigger Output (TRGO) Parameters-Master/Slave Mode选择EnableTrigger Event Selection选择Update Event。配置TIM3在Slave Mode选择Trigger ModeTrigger Source选择ITR1具体连接关系需查数据手册ITR1可能对应TIM2。效果TIM3的计数器将由TIM2的更新事件来复位或启动从而实现两个定时器的PWM输出在相位上完全同步。4.3 使用DMA自动更新PWM占空比序列对于需要生成复杂PWM波形如正弦波SPWM、特定梯度亮度变化的应用不断在中断中修改CCR值会消耗大量CPU资源且可能不够精确。此时DMA是绝佳选择。实现原理将存储了CCR值序列的数组位于内存中的地址配置为DMA传输的源地址。将定时器CCR寄存器的地址配置为DMA传输的目标地址。当定时器的更新事件发生时自动触发一次DMA传输将下一个CCR值从内存搬运到CCR寄存器从而实现占空比的自动、无CPU干预的更新。配置关键步骤在CubeMX中使能TIM1的更新事件DMA请求。添加一个DMA通道方向为Memory to Peripheral外设地址设为(uint32_t)htim1.Instance-CCR1内存地址设为你的数组地址数据宽度为半字或字取决于CCR寄存器宽度。模式选择Circular循环模式这样传输完整个数组后会从头开始。在代码中启动PWM后使用HAL_TIM_DMABurst_WriteStart()或配置DMA后使用HAL_TIM_PWM_Start_DMA()来启动定时器和DMA。5. 调试与问题排查实录即使配置看起来正确没有PWM波形输出也是家常便饭。下面是我总结的排查清单按照从简到繁的顺序进行。5.1 基础检查清单时钟树检查这是最根本的一步。在CubeMX的Clock Configuration标签页确认你使用的定时器如APB2 Timer clocks的时钟是否已使能且频率是否符合你的计算预期。如果定时器时钟是0一切都白搭。GPIO模式检查虽然CubeMX设置了复用功能但最好在生成的MX_GPIO_Init函数里确认一下对应引脚的初始化模式是否正确应为复用推挽输出GPIO_MODE_AF_PP。启动函数调用确认你调用了HAL_TIM_PWM_Start()。我见过不止一个朋友初始化代码完美但忘了调用启动函数对着示波器发呆半天。高级定时器的MOEMain Output Enable对于TIM1/TIM8务必确认主输出已使能。除了CubeMX的配置有时需要在HAL_TIM_PWM_Start()之后手动调用__HAL_TIM_MOE_ENABLE(htim1);。一个简单的判断方法是检查TIM1-BDTR寄存器的MOE位是否为1。引脚冲突检查该引脚是否被其他外设如调试用的SWD/JTAG占用。例如PA13/PA14/PA15默认是SWD调试口如果要用作普通GPIO或外设功能需要在CubeMX的System Core-SYS里将Debug改为Serial Wire并禁用相应的引脚调试功能。5.2 示波器/逻辑分析仪诊断如果基础检查都通过了还是没波形就该上仪器了。现象完全没信号引脚一直是高电平或低电平。排查检查输出极性OCPolarity是否设反。你设的是高有效但可能电路需要的是低有效脉冲。排查检查CCR值。如果CCR设为0占空比就是0%输出恒为无效电平。如果CCR设为大于等于ARR1占空比就是100%输出恒为有效电平。现象有波形但频率不对。计算用公式F_pwm F_tim_clk / ((PSC1)*(ARR1))重新核算。F_tim_clk不一定是系统主频它来自APB总线如果APB预分频器不为1定时器时钟可能会被倍频详见参考手册的时钟树图。最稳妥的方法是在代码中打印或调试查看HAL_RCC_GetPCLK1Freq()或HAL_RCC_GetPCLK2Freq()的返回值。检查ARR和PSC的值是否在16位寄存器的允许范围内0-65535。现象占空比不对或不可调。检查修改CCR的函数是否生效。在调试模式下观察TIMx-CCR1寄存器的值是否随着你的函数调用而改变。检查预装载使能。如果OCPreload或AutoReloadPreload没有使能你写入的新CCR或ARR值会立即生效可能导致当前周期波形异常出现窄脉冲或毛刺。使能预装载是生产稳定PWM的必备操作。5.3 进阶问题中断与DMA的坑问题使用PWM中断如更新中断时程序跑飞或响应异常。排查中断优先级配置是否合理是否发生了中断嵌套导致栈溢出PWM更新中断频率是否过高比如1MHz的更新中断导致CPU大部分时间都在处理中断主程序无法运行建议非必要不使用PWM中断。如果只是为了在PWM周期开始时做点什么可以考虑使用DMA传输完成中断或者使用另一个低频率的定时器。问题DMA传输PWM数据数组波形错乱。排查DMA传输的数据宽度字节、半字、字是否与CCR寄存器宽度匹配STM32F1的CCR是16位应使用半字传输。排查内存数组的地址是否对齐有些DMA控制器要求半字传输的地址是2字节对齐字传输是4字节对齐。排查DMA传输的“次数”Data Length设置是否正确它指的是传输数据项的个数而不是字节数。比如你有100个uint16_t的CCR值数组数据宽度为半字传输次数应设为100。6. 不同应用场景下的配置要点不同的负载对PWM的要求不同配置侧重点也不同。6.1 驱动LED呼吸灯特点频率要求不高几十Hz到几kHz即可低于100Hz人眼会感到闪烁。重点在于平滑地改变占空比。技巧可以使用一个基本定时器如TIM6/TIM7产生一个频率固定的中断如1ms在中断里用一个变量线性地增减CCR值即可实现呼吸效果。注意CCR的变化步进要小变化周期要长才能有平滑的视觉效果。务必使能预装载否则占空比变化时可能会看到LED闪烁。6.2 驱动舵机特点频率固定为50Hz周期20ms对脉冲宽度高电平时间精度要求高通常在0.5ms到2.5ms之间对应-90°到90°。配置计算定时器时钟假设为72MHz。目标频率50Hz周期 T20ms 0.02s。先确定ARR为了获得较高的角度分辨率我们希望计数器跑满一个PWM周期有尽可能多的计数值。可以令 PSC7199则计数器时钟 72MHz / (71991) 10kHz。此时一个计数的周期是0.1ms。ARR 0.02s / 0.1ms - 1 200 - 1 199。那么0.5ms-90°对应的CCR 0.5ms / 0.1ms 5。2.5ms90°对应的CCR 25。中位1.5ms对应CCR 15。要点舵机对脉冲宽度很敏感ARR和PSC的计算要精确避免累积误差。PWM模式应设置为PWM Mode 1极性为High。6.3 驱动直流电机通过H桥或驱动芯片特点频率是关键参数。频率太低如几十Hz电机会听到啸叫声频率太高开关损耗会增大且可能超过驱动芯片的能力。常见的频率范围在5kHz到20kHz之间。配置根据选择的频率反算PSC和ARR。例如要产生10kHz的PWM定时器时钟72MHz。可以设PSC71得1MHz计数器时钟ARR99得10kHz频率。高级需求如果使用H桥需要配置互补输出和死区时间具体如4.1节所述。死区时间必须根据你所使用的MOSFET或驱动芯片的开启/关断时间来谨慎设置通常需要查阅器件手册并通过实验微调。6.4 生成SPWM或SVPWM特点这是电机矢量控制FOC和逆变器的核心。需要实时、高速地改变PWM的占空比以拟合正弦波或其它复杂波形。实现方式必须使用DMA。预先计算好一个正弦表数组数组中存放的是每个PWM周期对应的CCR值。然后通过DMA在定时器更新事件的触发下自动将这个表循环搬运到CCR寄存器。配置核心定时器配置为中央对齐模式Center Aligned Mode有时效果更好可以减少谐波。精确计算PWM载波频率即定时器频率和正弦波频率调制波频率之间的关系这决定了每个正弦波周期由多少个PWM点构成即DMA数组的长度。DMA配置为循环模式内存递增外设地址固定为CCR寄存器地址。如果需要实时改变正弦波频率调速可以动态调整DMA传输的触发频率即改变定时器ARR或者使用更高级的双缓冲DMA在后台计算下一组波形数据。
STM32 HAL库定时器PWM配置全解析：从原理到实战应用
1. 项目概述从定时器到PWM的工程实践在嵌入式开发特别是基于STM32这类MCU的项目里定时器和PWM输出可以说是工程师的“左右手”。无论是驱动一个舵机精准转动还是控制电机的转速亦或是实现呼吸灯效果背后都离不开这两项技术的支撑。我接触过不少刚上手HAL库的朋友面对CubeMX里那一堆眼花缭乱的定时器配置选项常常感到无从下手调出来的PWM要么没波形要么频率不对要么占空比控制不灵。这其实很正常因为定时器本身就是一个功能强大且复杂的模块而HAL库在提供便利性的同时也封装了许多底层细节如果不理解其运作机制就容易踩坑。这篇文章我就结合自己这些年用HAL库在STM32上折腾定时器输出PWM的实际经验从一个工程实践者的角度把这块内容掰开揉碎了讲清楚。我们不只讲“怎么配”更要讲清楚“为什么这么配”以及配置时那些容易忽略的“坑点”。目标很明确让你看完之后能独立、自信地配置出任意你想要的PWM信号并且知道出了问题该从哪里入手排查。无论是STM32F1、F4还是H7系列其核心思想都是相通的我们会以最常见的通用定时器如TIM2, TIM3, TIM4为例进行说明。2. 定时器与PWM核心原理拆解在动手配置之前我们必须先在心里建立起清晰的模型。很多人配置失败根源在于对几个核心概念和它们之间的关系模糊不清。2.1 定时器是如何“计时”的你可以把STM32的一个定时器想象成一个带有自动重载功能的向上/向下计数器。它最核心的部件有三个时钟源、计数器寄存器CNT和自动重载寄存器ARR。时钟源这是计数器的“心跳”。通常来源于系统主频经过预分频器后。比如你的系统时钟是72MHz这就是计数器可能跑到的最高速度。预分频器PSC它位于时钟源和计数器之间作用是对时钟源进行分频。如果PSC设置为71注意实际分频系数 PSC 1那么输入计数器的实际时钟频率就是 72MHz / (711) 1MHz。这个寄存器决定了计数器累加的“快慢”。计数器CNT这是一个16位或32位的寄存器它会根据输入时钟的频率每个时钟周期加1向上计数或减1向下计数。自动重载寄存器ARR这是计数器的“终点”。当计数器CNT的值达到ARR设定的值时向上计数模式或者在向下计数模式下减到0时会产生一个“更新事件”Update Event并且计数器会被自动重置到初始值通常是0然后开始新一轮的计数。这个“从0到ARR再归零”的周期就是定时器的一个完整计时周期。定时器频率与周期的计算 定时器的溢出频率即更新事件频率公式为F_update F_input / (PSC 1) / (ARR 1)。 定时器的溢出周期即更新事件周期为T_update 1 / F_update。 这里F_input是输入定时器的时钟频率。ARR1是因为ARR寄存器存储的是周期值计数器从0计数到ARR总共是ARR1个计数值。2.2 PWM的本质比较输出PWM脉冲宽度调制并不是定时器的一个独立模式而是其“输出比较”功能的一种特定应用。定时器除了计数还配备了多个捕获/比较通道。每个通道都关联着一个捕获/比较寄存器CCR。PWM产生的过程是这样的定时器计数器CNT在时钟驱动下周而复始地在0到ARR之间循环计数。我们为某个通道比如通道1设定一个比较值写入CCR1寄存器。硬件会实时将CNT的值与CCR1的值进行比较。根据我们设定的PWM模式输出引脚比如PA8的电平会在CNT与CCR值满足特定关系时发生翻转。最常用的两种PWM模式是PWM模式1在向上计数时当CNT CCR通道输出有效电平通常为高电平当CNT ≥ CCR输出无效电平。向下计数时则相反。PWM模式2与模式1逻辑相反。通过改变CCR的值就能改变一个PWM周期内有效电平所占的时间比例也就是占空比。而改变ARR的值则会改变整个PWM波的周期或频率。注意这里有一个关键点ARR决定了PWM的频率CCR决定了占空比。但占空比的计算是Duty Cycle CCR / (ARR 1) * 100%。因为计数是从0到ARR总共有ARR1个“步长”。如果你设置ARR999CCR500那么占空比是500/100050%而不是500/999。2.3 HAL库的抽象层利弊分析HAL库通过HAL_TIM_PWM_Init(),HAL_TIM_PWM_ConfigChannel()等函数将上述硬件寄存器的操作封装起来。好处是代码移植性高在不同STM32系列间切换相对容易且CubeMX可以图形化生成初始化代码。但弊端是它隐藏了细节。例如在配置时你需要通过一个TIM_OC_InitTypeDef结构体来设置PWM模式、脉冲值即CCR、输出极性等而不直接操作CCR寄存器。理解这个结构体每个成员的意义是正确配置的关键。3. 基于CubeMX与HAL库的PWM配置实战理论说得再多不如动手配置一遍。我们以在STM32F103C8T6的PA8引脚TIM1_CH1上产生一个1kHz、占空比50%的PWM波为例。假设系统时钟为72MHz。3.1 CubeMX图形化配置步骤引脚与定时器基础配置在Pinout视图下找到PA8将其功能设置为TIM1_CH1。在左侧导航栏找到TIM1进入配置。Clock Source选择Internal Clock内部时钟。Parameter Settings标签页Prescaler (PSC - 16 bits value)这里填71。计算逻辑为了得到1MHz的计数器时钟72MHz / (711) 1MHz。Counter Mode选择Up向上计数。Counter Period (AutoReload Register - 16 bits value)这里填999。计算逻辑PWM频率 1MHz / (9991) 1000Hz 1kHz。Internal Clock Division (CKD)保持默认No Division。auto-reload preload建议使能Enable。这会让对ARR的修改在下一个更新事件时才生效防止在运行中修改ARR导致产生毛刺或错误的PWM周期。PWM通道详细配置下方找到Channel1选择PWM Generation CH1。会弹出通道配置窗口Mode选择PWM Mode 1。Pulse (16 bits value)这是初始的CCR值决定初始占空比。占空比 Pulse / (ARR1)。我们要50%占空比ARR是999所以Pulse 500。Output Compare preload务必使能Enable。这会让对CCR即Pulse的修改在下一个更新事件时才生效这是平滑改变占空比、避免输出异常的关键。CH Polarity选择High。这意味着“有效电平”为高电平。如果你希望空闲状态占空比0%时引脚为高电平PWM波是低脉冲则应选择Low。点击OK。生成代码在Project Manager设置好工程路径和IDE如MDK-ARM。点击GENERATE CODE。3.2 生成的代码分析与关键函数解读CubeMX会生成tim.c和tim.h。我们重点关注tim.c中的初始化函数。// tim.c 中的初始化片段 static void MX_TIM1_Init(void) { TIM_ClockConfigTypeDef sClockSourceConfig {0}; TIM_MasterConfigTypeDef sMasterConfig {0}; TIM_OC_InitTypeDef sConfigOC {0}; htim1.Instance TIM1; htim1.Init.Prescaler 71; htim1.Init.CounterMode TIM_COUNTERMODE_UP; htim1.Init.Period 999; // ARR htim1.Init.ClockDivision TIM_CLOCKDIVISION_DIV1; htim1.Init.RepetitionCounter 0; htim1.Init.AutoReloadPreload TIM_AUTORELOAD_PRELOAD_ENABLE; if (HAL_TIM_Base_Init(htim1) ! HAL_OK) { Error_Handler(); } sClockSourceConfig.ClockSource TIM_CLOCKSOURCE_INTERNAL; if (HAL_TIM_ConfigClockSource(htim1, sClockSourceConfig) ! HAL_OK) { Error_Handler(); } if (HAL_TIM_PWM_Init(htim1) ! HAL_OK) { Error_Handler(); } sMasterConfig.MasterOutputTrigger TIM_TRGO_RESET; sMasterConfig.MasterSlaveMode TIM_MASTERSLAVEMODE_DISABLE; if (HAL_TIMEx_MasterConfigSynchronization(htim1, sMasterConfig) ! HAL_OK) { Error_Handler(); } sConfigOC.OCMode TIM_OCMODE_PWM1; // PWM模式1 sConfigOC.Pulse 500; // 初始CCR值 sConfigOC.OCPolarity TIM_OCPOLARITY_HIGH; // 输出极性高 sConfigOC.OCNPolarity TIM_OCNPOLARITY_HIGH; sConfigOC.OCFastMode TIM_OCFAST_DISABLE; sConfigOC.OCIdleState TIM_OCIDLESTATE_RESET; sConfigOC.OCNIdleState TIM_OCNIDLESTATE_RESET; // 关键配置输出比较预装载使能 sConfigOC.OCPreload TIM_OCPRELOAD_ENABLE; if (HAL_TIM_PWM_ConfigChannel(htim1, sConfigOC, TIM_CHANNEL_1) ! HAL_OK) { Error_Handler(); } // 使能定时器通道输出的预装载寄存器ARR和CCR __HAL_TIM_ENABLE_OCxPRELOAD(htim1, TIM_CHANNEL_1); // 主输出使能对于高级定时器TIM1/TIM8很重要 HAL_TIMEx_MasterConfigSynchronization(htim1, sMasterConfig); }关键点解析htim1.Init.AutoReloadPreload TIM_AUTORELOAD_PRELOAD_ENABLE;和sConfigOC.OCPreload TIM_OCPRELOAD_ENABLE;这两行是保证PWM输出稳定的“安全锁”。务必使能。对于高级定时器TIM1, TIM8在启动PWM输出前有时需要额外调用__HAL_TIM_MOE_ENABLE(htim1);来使能主输出否则引脚可能没有输出。但CubeMX生成的代码通常通过sMasterConfig或后续的HAL_TIM_PWM_Start处理了这一点。3.3 主程序中的启动与动态控制初始化完成后在main函数的初始化部分后你需要启动PWM输出。// 在main.c的/* USER CODE BEGIN 2 */ 部分 HAL_TIM_PWM_Start(htim1, TIM_CHANNEL_1);这行代码会启动定时器的计数器并开启通道1的输出。动态修改PWM占空比和频率 这是项目中最常见的需求比如调节电机速度、LED亮度。修改占空比修改CCR使用__HAL_TIM_SET_COMPARE()宏或直接写寄存器。推荐使用宏因为它考虑了预装载机制。// 将TIM1通道1的占空比改为75% __HAL_TIM_SET_COMPARE(htim1, TIM_CHANNEL_1, 750); // CCR 750 (占空比 750/100075%)由于我们使能了OCPreload这个新CCR值会在下一个PWM周期生效变化是平滑的。修改频率修改ARR通过__HAL_TIM_SET_AUTORELOAD()宏。注意改变ARR会同时影响PWM频率和占空比基准。修改后通常需要按比例调整CCR以维持原有占空比。uint32_t new_arr 1999; // 目标ARR频率将变为 1MHz / 2000 500Hz uint32_t old_ccr __HAL_TIM_GET_COMPARE(htim1, TIM_CHANNEL_1); uint32_t old_arr __HAL_TIM_GET_AUTORELOAD(htim1); // 按比例计算新的CCR以保持占空比不变 uint32_t new_ccr (old_ccr * new_arr) / old_arr; __HAL_TIM_SET_AUTORELOAD(htim1, new_arr); __HAL_TIM_SET_COMPARE(htim1, TIM_CHANNEL_1, new_ccr);4. 深度配置技巧与高级应用场景掌握了基础配置我们可以看看一些更实际、更复杂的应用场景和对应的配置技巧。4.1 互补输出与死区插入在电机驱动如H桥电路或某些电源应用中需要一对互补的PWM信号CH和CHN并且为了防止上下桥臂同时导通造成短路必须在两个互补信号之间插入一段同时为低电平的“死区时间”。配置要点以TIM1_CH1和CH1N为例在CubeMX中除了使能TIM1_CH1还要使能TIM1_CH1N。在TIM1的配置中Break and Dead-Time断路和死区时间配置单元会被激活。使能Break Function断路功能通常选择BRK_INPUT。断路功能是安全特性当外部故障信号触发时强制关闭所有输出。配置Dead Time死区时间。死区时间以定时器时钟周期为单位。HAL库提供了计算函数__HAL_TIM_CALC_DEADTIME可以根据系统时钟和所需死区时间单位纳秒计算出要写入寄存器的值。例如需要500ns的死区时间定时器时钟为72MHzuint32_t deadtime __HAL_TIM_CALC_DEADTIME(72000000, 500, TIM_DEADTIME_APB_CLK_DIV2); // 然后将deadtime赋值给 htim1.Init.DeadTime 或相应的结构体成员。生成的代码中死区时间配置会体现在TIM_BDTRInitTypeDef结构体中。启动时需要使用HAL_TIMEx_PWMN_Start(htim1, TIM_CHANNEL_1);来启动互补通道。4.2 多通道同步与主从模式有时需要多个PWM通道完全同步启动或者让一个定时器作为另一个定时器的时钟源。这就需要用到定时器的主从模式。需求场景TIM2和TIM3需要输出完全同步的PWM波。配置思路将TIM2配置为主模式Master使其更新事件UEV产生一个触发输出TRGO。然后将TIM3配置为从模式Slave将其触发输入TI连接到TIM2的TRGO并设置为“触发模式”作为时钟源。CubeMX操作配置TIM2在Parameter Settings-Trigger Output (TRGO) Parameters-Master/Slave Mode选择EnableTrigger Event Selection选择Update Event。配置TIM3在Slave Mode选择Trigger ModeTrigger Source选择ITR1具体连接关系需查数据手册ITR1可能对应TIM2。效果TIM3的计数器将由TIM2的更新事件来复位或启动从而实现两个定时器的PWM输出在相位上完全同步。4.3 使用DMA自动更新PWM占空比序列对于需要生成复杂PWM波形如正弦波SPWM、特定梯度亮度变化的应用不断在中断中修改CCR值会消耗大量CPU资源且可能不够精确。此时DMA是绝佳选择。实现原理将存储了CCR值序列的数组位于内存中的地址配置为DMA传输的源地址。将定时器CCR寄存器的地址配置为DMA传输的目标地址。当定时器的更新事件发生时自动触发一次DMA传输将下一个CCR值从内存搬运到CCR寄存器从而实现占空比的自动、无CPU干预的更新。配置关键步骤在CubeMX中使能TIM1的更新事件DMA请求。添加一个DMA通道方向为Memory to Peripheral外设地址设为(uint32_t)htim1.Instance-CCR1内存地址设为你的数组地址数据宽度为半字或字取决于CCR寄存器宽度。模式选择Circular循环模式这样传输完整个数组后会从头开始。在代码中启动PWM后使用HAL_TIM_DMABurst_WriteStart()或配置DMA后使用HAL_TIM_PWM_Start_DMA()来启动定时器和DMA。5. 调试与问题排查实录即使配置看起来正确没有PWM波形输出也是家常便饭。下面是我总结的排查清单按照从简到繁的顺序进行。5.1 基础检查清单时钟树检查这是最根本的一步。在CubeMX的Clock Configuration标签页确认你使用的定时器如APB2 Timer clocks的时钟是否已使能且频率是否符合你的计算预期。如果定时器时钟是0一切都白搭。GPIO模式检查虽然CubeMX设置了复用功能但最好在生成的MX_GPIO_Init函数里确认一下对应引脚的初始化模式是否正确应为复用推挽输出GPIO_MODE_AF_PP。启动函数调用确认你调用了HAL_TIM_PWM_Start()。我见过不止一个朋友初始化代码完美但忘了调用启动函数对着示波器发呆半天。高级定时器的MOEMain Output Enable对于TIM1/TIM8务必确认主输出已使能。除了CubeMX的配置有时需要在HAL_TIM_PWM_Start()之后手动调用__HAL_TIM_MOE_ENABLE(htim1);。一个简单的判断方法是检查TIM1-BDTR寄存器的MOE位是否为1。引脚冲突检查该引脚是否被其他外设如调试用的SWD/JTAG占用。例如PA13/PA14/PA15默认是SWD调试口如果要用作普通GPIO或外设功能需要在CubeMX的System Core-SYS里将Debug改为Serial Wire并禁用相应的引脚调试功能。5.2 示波器/逻辑分析仪诊断如果基础检查都通过了还是没波形就该上仪器了。现象完全没信号引脚一直是高电平或低电平。排查检查输出极性OCPolarity是否设反。你设的是高有效但可能电路需要的是低有效脉冲。排查检查CCR值。如果CCR设为0占空比就是0%输出恒为无效电平。如果CCR设为大于等于ARR1占空比就是100%输出恒为有效电平。现象有波形但频率不对。计算用公式F_pwm F_tim_clk / ((PSC1)*(ARR1))重新核算。F_tim_clk不一定是系统主频它来自APB总线如果APB预分频器不为1定时器时钟可能会被倍频详见参考手册的时钟树图。最稳妥的方法是在代码中打印或调试查看HAL_RCC_GetPCLK1Freq()或HAL_RCC_GetPCLK2Freq()的返回值。检查ARR和PSC的值是否在16位寄存器的允许范围内0-65535。现象占空比不对或不可调。检查修改CCR的函数是否生效。在调试模式下观察TIMx-CCR1寄存器的值是否随着你的函数调用而改变。检查预装载使能。如果OCPreload或AutoReloadPreload没有使能你写入的新CCR或ARR值会立即生效可能导致当前周期波形异常出现窄脉冲或毛刺。使能预装载是生产稳定PWM的必备操作。5.3 进阶问题中断与DMA的坑问题使用PWM中断如更新中断时程序跑飞或响应异常。排查中断优先级配置是否合理是否发生了中断嵌套导致栈溢出PWM更新中断频率是否过高比如1MHz的更新中断导致CPU大部分时间都在处理中断主程序无法运行建议非必要不使用PWM中断。如果只是为了在PWM周期开始时做点什么可以考虑使用DMA传输完成中断或者使用另一个低频率的定时器。问题DMA传输PWM数据数组波形错乱。排查DMA传输的数据宽度字节、半字、字是否与CCR寄存器宽度匹配STM32F1的CCR是16位应使用半字传输。排查内存数组的地址是否对齐有些DMA控制器要求半字传输的地址是2字节对齐字传输是4字节对齐。排查DMA传输的“次数”Data Length设置是否正确它指的是传输数据项的个数而不是字节数。比如你有100个uint16_t的CCR值数组数据宽度为半字传输次数应设为100。6. 不同应用场景下的配置要点不同的负载对PWM的要求不同配置侧重点也不同。6.1 驱动LED呼吸灯特点频率要求不高几十Hz到几kHz即可低于100Hz人眼会感到闪烁。重点在于平滑地改变占空比。技巧可以使用一个基本定时器如TIM6/TIM7产生一个频率固定的中断如1ms在中断里用一个变量线性地增减CCR值即可实现呼吸效果。注意CCR的变化步进要小变化周期要长才能有平滑的视觉效果。务必使能预装载否则占空比变化时可能会看到LED闪烁。6.2 驱动舵机特点频率固定为50Hz周期20ms对脉冲宽度高电平时间精度要求高通常在0.5ms到2.5ms之间对应-90°到90°。配置计算定时器时钟假设为72MHz。目标频率50Hz周期 T20ms 0.02s。先确定ARR为了获得较高的角度分辨率我们希望计数器跑满一个PWM周期有尽可能多的计数值。可以令 PSC7199则计数器时钟 72MHz / (71991) 10kHz。此时一个计数的周期是0.1ms。ARR 0.02s / 0.1ms - 1 200 - 1 199。那么0.5ms-90°对应的CCR 0.5ms / 0.1ms 5。2.5ms90°对应的CCR 25。中位1.5ms对应CCR 15。要点舵机对脉冲宽度很敏感ARR和PSC的计算要精确避免累积误差。PWM模式应设置为PWM Mode 1极性为High。6.3 驱动直流电机通过H桥或驱动芯片特点频率是关键参数。频率太低如几十Hz电机会听到啸叫声频率太高开关损耗会增大且可能超过驱动芯片的能力。常见的频率范围在5kHz到20kHz之间。配置根据选择的频率反算PSC和ARR。例如要产生10kHz的PWM定时器时钟72MHz。可以设PSC71得1MHz计数器时钟ARR99得10kHz频率。高级需求如果使用H桥需要配置互补输出和死区时间具体如4.1节所述。死区时间必须根据你所使用的MOSFET或驱动芯片的开启/关断时间来谨慎设置通常需要查阅器件手册并通过实验微调。6.4 生成SPWM或SVPWM特点这是电机矢量控制FOC和逆变器的核心。需要实时、高速地改变PWM的占空比以拟合正弦波或其它复杂波形。实现方式必须使用DMA。预先计算好一个正弦表数组数组中存放的是每个PWM周期对应的CCR值。然后通过DMA在定时器更新事件的触发下自动将这个表循环搬运到CCR寄存器。配置核心定时器配置为中央对齐模式Center Aligned Mode有时效果更好可以减少谐波。精确计算PWM载波频率即定时器频率和正弦波频率调制波频率之间的关系这决定了每个正弦波周期由多少个PWM点构成即DMA数组的长度。DMA配置为循环模式内存递增外设地址固定为CCR寄存器地址。如果需要实时改变正弦波频率调速可以动态调整DMA传输的触发频率即改变定时器ARR或者使用更高级的双缓冲DMA在后台计算下一组波形数据。
