企业官网建设流程全解析

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 / (71+1) = 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是输入定时器的时钟频率。ARR+1是因为ARR寄存器存储的是周期值，计数器从0计数到ARR，总共是ARR+1个计数值。

2.2 PWM的本质：比较输出

PWM（脉冲宽度调制）并不是定时器的一个独立模式，而是其“输出比较”功能的一种特定应用。定时器除了计数，还配备了多个捕获/比较通道。每个通道都关联着一个捕获/比较寄存器（CCR）。

PWM产生的过程是这样的：

1. 定时器计数器（CNT）在时钟驱动下，周而复始地在0到ARR之间循环计数。
2. 我们为某个通道（比如通道1）设定一个比较值，写入CCR1寄存器。
3. 硬件会实时将CNT的值与CCR1的值进行比较。
4. 根据我们设定的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，总共有ARR+1个“步长”。如果你设置ARR=999，CCR=500，那么占空比是500/1000=50%，而不是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图形化配置步骤

1. 引脚与定时器基础配置：
   • 在Pinout视图下，找到PA8，将其功能设置为TIM1_CH1。
   • 在左侧导航栏找到TIM1，进入配置。
   • Clock Source：选择Internal Clock（内部时钟）。
   • Parameter Settings标签页：
     • Prescaler (PSC - 16 bits value)：这里填71。计算逻辑：为了得到1MHz的计数器时钟，72MHz / (71+1) = 1MHz。
     • Counter Mode：选择Up（向上计数）。
     • Counter Period (AutoReload Register - 16 bits value)：这里填999。计算逻辑：PWM频率 = 1MHz / (999+1) = 1000Hz = 1kHz。
     • Internal Clock Division (CKD)：保持默认No Division。
     • auto-reload preload：建议使能（Enable）。这会让对ARR的修改在下一个更新事件时才生效，防止在运行中修改ARR导致产生毛刺或错误的PWM周期。
2. PWM通道详细配置：
   • 下方找到Channel1，选择PWM Generation CH1。
   • 会弹出通道配置窗口：
     • Mode：选择PWM Mode 1。
     • Pulse (16 bits value)：这是初始的CCR值，决定初始占空比。占空比 = Pulse / (ARR+1)。我们要50%占空比，ARR是999，所以Pulse = 500。
     • Output Compare preload：务必使能（Enable）。这会让对CCR（即Pulse）的修改在下一个更新事件时才生效，这是平滑改变占空比、避免输出异常的关键。
     • CH Polarity：选择High。这意味着“有效电平”为高电平。如果你希望空闲状态（占空比0%）时引脚为高电平，PWM波是低脉冲，则应选择Low。
   • 点击OK。
3. 生成代码：
   • 在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/1000=75%)

  由于我们使能了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为例）：

1. 在CubeMX中，除了使能TIM1_CH1，还要使能TIM1_CH1N。
2. 在TIM1的配置中，Break and Dead-Time（断路和死区时间）配置单元会被激活。
3. 使能Break Function（断路功能），通常选择BRK_INPUT。断路功能是安全特性，当外部故障信号触发时，强制关闭所有输出。
4. 配置Dead Time（死区时间）。死区时间以定时器时钟周期为单位。HAL库提供了计算函数__HAL_TIM_CALC_DEADTIME，可以根据系统时钟和所需死区时间（单位纳秒）计算出要写入寄存器的值。例如，需要500ns的死区时间，定时器时钟为72MHz：

   uint32_t deadtime = __HAL_TIM_CALC_DEADTIME(72000000, 500, TIM_DEADTIME_APB_CLK_DIV2); // 然后将deadtime赋值给 htim1.Init.DeadTime 或相应的结构体成员。

5. 生成的代码中，死区时间配置会体现在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操作：
  1. 配置TIM2：在Parameter Settings->Trigger Output (TRGO) Parameters->Master/Slave Mode选择Enable，Trigger Event Selection选择Update Event。
  2. 配置TIM3：在Slave Mode选择Trigger Mode，Trigger Source选择ITR1（具体连接关系需查数据手册，ITR1可能对应TIM2）。
• 效果：TIM3的计数器将由TIM2的更新事件来复位或启动，从而实现两个定时器的PWM输出在相位上完全同步。

4.3 使用DMA自动更新PWM占空比序列

对于需要生成复杂PWM波形（如正弦波SPWM、特定梯度亮度变化）的应用，不断在中断中修改CCR值会消耗大量CPU资源且可能不够精确。此时，DMA是绝佳选择。

实现原理：将存储了CCR值序列的数组（位于内存中）的地址，配置为DMA传输的源地址。将定时器CCR寄存器的地址，配置为DMA传输的目标地址。当定时器的更新事件发生时，自动触发一次DMA传输，将下一个CCR值从内存搬运到CCR寄存器，从而实现占空比的自动、无CPU干预的更新。

配置关键步骤：

1. 在CubeMX中使能TIM1的更新事件DMA请求。
2. 添加一个DMA通道，方向为Memory to Peripheral，外设地址设为(uint32_t)&htim1.Instance->CCR1，内存地址设为你的数组地址，数据宽度为半字或字（取决于CCR寄存器宽度）。
3. 模式选择Circular（循环模式），这样传输完整个数组后会从头开始。
4. 在代码中，启动PWM后，使用HAL_TIM_DMABurst_WriteStart()或配置DMA后使用HAL_TIM_PWM_Start_DMA()来启动定时器和DMA。

5. 调试与问题排查实录

即使配置看起来正确，没有PWM波形输出也是家常便饭。下面是我总结的排查清单，按照从简到繁的顺序进行。

5.1 基础检查清单

1. 时钟树检查：这是最根本的一步。在CubeMX的Clock Configuration标签页，确认你使用的定时器（如APB2 Timer clocks）的时钟是否已使能，且频率是否符合你的计算预期。如果定时器时钟是0，一切都白搭。
2. GPIO模式检查：虽然CubeMX设置了复用功能，但最好在生成的MX_GPIO_Init函数里确认一下，对应引脚的初始化模式是否正确（应为复用推挽输出GPIO_MODE_AF_PP）。
3. 启动函数调用：确认你调用了HAL_TIM_PWM_Start()。我见过不止一个朋友，初始化代码完美，但忘了调用启动函数，对着示波器发呆半天。
4. 高级定时器的MOE（Main Output Enable）：对于TIM1/TIM8，务必确认主输出已使能。除了CubeMX的配置，有时需要在HAL_TIM_PWM_Start()之后，手动调用__HAL_TIM_MOE_ENABLE(&htim1);。一个简单的判断方法是，检查TIM1->BDTR寄存器的MOE位是否为1。
5. 引脚冲突：检查该引脚是否被其他外设（如调试用的SWD/JTAG）占用。例如，PA13/PA14/PA15默认是SWD调试口，如果要用作普通GPIO或外设功能，需要在CubeMX的System Core->SYS里将Debug改为Serial Wire，并禁用相应的引脚调试功能。

5.2 示波器/逻辑分析仪诊断

如果基础检查都通过了，还是没波形，就该上仪器了。

• 现象：完全没信号，引脚一直是高电平或低电平。

  • 排查：检查输出极性（OCPolarity）是否设反。你设的是高有效，但可能电路需要的是低有效脉冲。
  • 排查：检查CCR值。如果CCR设为0，占空比就是0%，输出恒为无效电平。如果CCR设为大于等于ARR+1，占空比就是100%，输出恒为有效电平。

• 现象：有波形，但频率不对。

  • 计算：用公式F_pwm = F_tim_clk / ((PSC+1)*(ARR+1))重新核算。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，周期 T=20ms = 0.02s。
  • 先确定ARR：为了获得较高的角度分辨率，我们希望计数器跑满一个PWM周期有尽可能多的计数值。可以令 PSC=7199，则计数器时钟 = 72MHz / (7199+1) = 10kHz。
  • 此时，一个计数的周期是0.1ms。ARR = 0.02s / 0.1ms - 1 = 200 - 1 = 199。
  • 那么，0.5ms（-90°）对应的CCR = 0.5ms / 0.1ms = 5。2.5ms（+90°）对应的CCR = 25。中位1.5ms对应CCR = 15。
• 要点：舵机对脉冲宽度很敏感，ARR和PSC的计算要精确，避免累积误差。PWM模式应设置为PWM Mode 1，极性为High。

6.3 驱动直流电机（通过H桥或驱动芯片）

• 特点：频率是关键参数。频率太低（如几十Hz），电机会听到啸叫声；频率太高，开关损耗会增大，且可能超过驱动芯片的能力。常见的频率范围在5kHz到20kHz之间。
• 配置：根据选择的频率，反算PSC和ARR。例如，要产生10kHz的PWM，定时器时钟72MHz。可以设PSC=71（得1MHz计数器时钟），ARR=99（得10kHz频率）。
• 高级需求：如果使用H桥，需要配置互补输出和死区时间，具体如4.1节所述。死区时间必须根据你所使用的MOSFET或驱动芯片的开启/关断时间来谨慎设置，通常需要查阅器件手册并通过实验微调。

6.4 生成SPWM或SVPWM

• 特点：这是电机矢量控制（FOC）和逆变器的核心。需要实时、高速地改变PWM的占空比，以拟合正弦波或其它复杂波形。
• 实现方式：必须使用DMA。预先计算好一个正弦表（数组），数组中存放的是每个PWM周期对应的CCR值。然后通过DMA，在定时器更新事件的触发下，自动将这个表循环搬运到CCR寄存器。
• 配置核心：
  1. 定时器配置为中央对齐模式（Center Aligned Mode）有时效果更好，可以减少谐波。
  2. 精确计算PWM载波频率（即定时器频率）和正弦波频率（调制波频率）之间的关系，这决定了每个正弦波周期由多少个PWM点构成（即DMA数组的长度）。
  3. DMA配置为循环模式，内存递增，外设地址固定为CCR寄存器地址。
  4. 如果需要实时改变正弦波频率（调速），可以动态调整DMA传输的触发频率（即改变定时器ARR），或者使用更高级的双缓冲DMA，在后台计算下一组波形数据。