1. 项目概述：为什么需要高级定时器的互补PWM？

在电机驱动、数字电源、逆变器这些硬核的电力电子领域里，PWM（脉冲宽度调制）信号是控制功率开关器件（如MOSFET、IGBT）的“指挥棒”。普通的单路PWM足以控制一个简单的LED亮度或者一个直流电机的速度，但当我们面对需要“推”和“拉”协同工作的场景时，比如H桥电路驱动直流电机正反转，或者半桥、全桥拓扑的开关电源，单路PWM就力不从心了。

这时候，互补PWM（Complementary PWM）就登场了。它的核心思想是生成两路信号：一路主输出（比如CH1），另一路是它的“镜像”互补输出（比如CH1N）。这两路信号在逻辑上通常是反相的，并且中间会插入一个精心设计的“死区时间”（Dead Time）。为什么需要死区时间？想象一下H桥的上管和下管，如果控制它们的信号在切换瞬间有那么一丁点的重叠，就会导致电源正负极直接短路，瞬间产生巨大的电流，烧毁功率管。死区时间就是在信号切换的“空白期”，确保一个管子完全关断后，另一个管子才缓缓开启，从而杜绝直通短路这个“毁灭性”的事故。

STM32的TIM1和TIM8属于高级控制定时器，正是为这类高端应用而生。相较于通用定时器，它们原生集成了互补输出通道、可编程死区时间生成器、刹车（Break）输入等关键外设，硬件层面直接支持，无需软件模拟，不仅可靠性极高，还能解放CPU资源。很多朋友在初次使用STM32CubeMX配置TIM1输出互补PWM时，可能会遇到没有波形、波形不对、死区不生效等问题。这篇内容，我就结合自己多次在电机驱动项目上的实战经验，从CubeMX配置到代码调试，把每个环节的细节和容易踩的“坑”都捋清楚，目标是让你配置一次就能成功输出稳定可靠的互补PWM。

2. 核心概念与硬件连接解析

在动手配置之前，我们必须先吃透几个核心概念，并理清硬件上的连接关系。这能帮你从根本上理解每一步配置的意义，而不是机械地“下一步”。

2.1 高级定时器TIM1的互补输出通道

以常见的STM32F103系列为例，TIM1的通道分布如下：

• CH1 / CH1N: 通道1及其互补输出，通常对应引脚PA8 / PA7（重映射后可能变化）。
• CH2 / CH2N: 通道2及其互补输出，通常对应引脚PA9 / PB0。
• CH3 / CH3N: 通道3及其互补输出，通常对应引脚PA10 / PB1。
• CH4: 通道4，没有互补输出，通常对应引脚PA11。

这里有一个关键点：CHx和CHxN是成对出现的，它们共享同一个定时器通道的比较/捕获寄存器。也就是说，当你设置CH1的占空比为50%时，CH1N的占空比逻辑上就是互补的（考虑死区时间后）。你无法独立设置CH1和CH1N的占空比，它们是一个整体的两面。

2.2 死区时间：理论与计算

死区时间是互补PWM的灵魂。STM32高级定时器的死区时间生成器（Dead-Time Generator, DTG）非常灵活，其计算公式稍微有点复杂，但CubeMX帮我们做了可视化。

死区时间T_dt的基本计算公式是：T_dt = (DTG[7:5] * T_dts) + DTG[4:0] * T_tg其中：

• T_dts是死区时间采样时钟周期，由定时器时钟CK_INT和死区时钟分频器CKD[1:0]决定。
• T_tg是系统时钟周期t_{CK_INT}。

在实际使用中，我们更关心的是需要设置多长的死区时间（通常以纳秒ns为单位），然后让CubeMX或我们自己去反推寄存器值。死区时间的长短取决于：

1. 功率器件的开关特性：MOSFET或IGBT的导通延迟t_d(on)和关断延迟t_d(off)。数据手册会给出。
2. 驱动电路的传播延迟：驱动芯片（如IR2104, IR2184）本身也有延迟。
3. 安全裕量：在上述理论值上增加一定的余量，通常为20%-50%。

一个经验公式是：所需死区时间 ≈ 功率管关断延迟 - 功率管导通延迟 + 驱动电路延迟差 + 安全裕量。对于常见的低压MOSFET和标准驱动芯片，死区时间通常在200ns到1us之间。在CubeMX配置时，我们直接输入纳秒数即可，软件会自动计算。

2.3 输出极性、刹车与刹车输入

• 输出极性（Polarity）：这决定了PWM有效电平是高电平还是低电平。对于常见的“高电平有效”的驱动芯片（即高电平时打开上管/下管），我们通常将PWM模式设置为“PWM mode 1”，输出极性设置为“高电平有效”。但有些驱动电路或应用场景可能需要低电平有效，这里必须根据你的硬件电路来设置，否则电机可能不转甚至短路。
• 刹车功能（Break）：这是高级定时器的安全卫士。当刹车输入引脚（通常是特定的GPIO，如PB12）被触发（通常为低电平），定时器会立即停止PWM输出，并将所有输出通道强制到一个预设的安全状态（比如全部输出无效电平，通常是低电平）。这在过流、过压保护等紧急情况下至关重要。刹车后需要软件干预才能重新启动。
• 刹车输入极性：设置什么电平触发刹车。

注意：在调试初期，如果你没有使用刹车功能，务必在CubeMX中禁用刹车输入（Break Input Disable），或者将其极性设置为“不触发”的状态（如高电平不刹车）。一个悬空或意外被拉低的刹车引脚会导致PWM永远无法输出，这是新手常踩的一个大坑。

3. STM32CubeMX 详细配置流程

理论清晰后，我们进入实战。假设我们需要在STM32F103C8T6上，使用TIM1的CH1和CH1N（PA8, PA7）输出一对带死区的互补PWM，驱动一个H桥。

3.1 时钟与引脚配置

1. 系统时钟（SYS）：在SYS标签页，将Debug设置为Serial Wire，方便后续调试。
2. 时钟树（Clock Configuration）：这是关键一步。TIM1的时钟来源于APB2总线。确保APB2的时钟（APB2 peripheral clocks）是你期望的频率（例如72MHz）。TIM1的计数器时钟CK_CNT会在此基础上再进行分频。一个高的定时器时钟能提供更精细的PWM分辨率和更精确的死区时间。
3. 引脚分配（Pinout & Configuration）：
   • 找到TIM1。
   • 将Channel 1设置为PWM Generation CH1。你会看到PA8被自动标记为TIM1_CH1。
   • 此时，互补通道CH1N可能不会自动出现。你需要手动找到PA7引脚，点击它，在弹出菜单中选择TIM1_CH1N。
   • 检查引脚颜色是否都变成了绿色（表示已分配）。如果CH1N的引脚显示为灰色或黄色，可能是与其他功能冲突，需要解决冲突。

3.2 TIM1参数化配置

点击左侧TIM1进入详细配置。

1. 时钟源（Clock Source）：选择Internal Clock。
2. 参数设置（Parameter Settings）：
   • 预分频器（Prescaler）：决定定时器时钟CK_CNT的频率。CK_CNT = APB2时钟 / (Prescaler + 1)。例如，APB2=72MHz，想要CK_CNT=72MHz，则Prescaler=0；想要CK_CNT=1MHz，则Prescaler=71。
   • 计数模式（Counter Mode）：对于电机驱动和电源，中心对齐模式（Center Aligned）是最常用的。这种模式下，计数器先向上计数到自动重载值（ARR），然后向下计数到0。产生的PWM波形关于中心对称，其优点是能显著降低谐波分量，在电机驱动中可以减少转矩脉动和噪音。选择Center Aligned mode 1/2/3均可，通常选Center Aligned mode 1。
   • 自动重载值（Counter Period）：这是ARR寄存器的值。PWM的频率由它和预分频器共同决定。PWM频率计算公式：Fpwm = CK_CNT / ((ARR + 1) * 重复计数因子)。
     • 对于边沿对齐模式：Fpwm = CK_CNT / (ARR + 1)
     • 对于中心对齐模式：Fpwm = CK_CNT / (2 * (ARR + 1))（因为计数器要上下跑一个来回） 例如，CK_CNT=72MHz，想要Fpwm=20kHz，在中心对齐模式下：ARR = (CK_CNT / (2 * Fpwm)) - 1 = (72,000,000 / (2 * 20,000)) - 1 = 1799。
   • 重复计数器（Repetition Counter）：高级定时器特有。设置一个值RCR，定时器更新事件（UEV）每发生RCR+1次，才会产生一次真正的更新中断或DMA请求。这可以用于降低中断频率，或者实现更复杂的PWM模式（如单脉冲模式）。在普通连续PWM输出时，通常设置为0。
   • 自动重载预装载（Auto-Reload Preload）：务必启用（Enable）。这可以确保你对ARR或CCR（占空比）寄存器的修改，只在下一个更新事件时才生效，避免在PWM周期中间修改导致波形出现毛刺或断裂。
3. 通道1配置：
   • 在下方找到Channel 1，模式保持PWM Generation CH1。
   • PWM模式（PWM Mode）：选择PWM Mode 1。在这个模式下，当计数器小于比较寄存器（CCR）时，输出有效电平；大于等于时，输出无效电平。PWM Mode 2则逻辑相反。
   • 脉冲（Pulse）：这是初始的CCR值，决定了初始占空比。占空比 =Pulse / (ARR + 1)。可以先设一个中间值，如(ARR+1)/2。
   • 快速模式（Fast Mode）：通常禁用。启用后，在比较匹配时输出会立即改变，而不是等待下一个时钟边沿，可能引入噪声，一般用于特殊场合。
   • CH极性（CH Polarity）：根据你的驱动电路设置。如果驱动芯片是高电平有效，就选High。这是主通道的极性。
   • CH互补极性（CH Complementary Polarity）：设置互补通道CH1N的有效电平。通常与主通道相同。例如，主通道高电平有效，互补通道也设置为高电平有效。这样，在插入死区后，两路信号在有效期间是同相的（都是高），在死区期间都是低（无效）。另一种常见设置是主通道高有效，互补通道低有效，这样两者永远反相，死区插入在跳变沿。具体需结合电路逻辑分析。
   • CH空闲状态（CH Idle State）&CH互补空闲状态（CH Complementary Idle State）：这是刹车发生或定时器被强制停止时，输出引脚所处的电平状态。必须根据安全需求设置！例如，如果你的驱动电路在输入低电平时关闭功率管，那么为了安全，刹车时应将所有输出置为低电平（无效电平）。那么CH Idle State和CH Complementary Idle State都应设置为Low。
   • 死区时间（Dead Time）：点击Dead Time旁边的Settings。选择Dead Time为Enable。在Dead Time输入框里，直接输入你计算好的纳秒数，比如500ns。下面的Lock Level和OSSR/OSSI模式通常保持默认即可。

3.3 生成工程与代码解读

配置完成后，点击Project Manager，设置好工程名称、路径、IDE（如MDK-ARM V5），在Code Generator里选择“为每个外设生成独立的.c/.h文件”，这样代码结构更清晰。

生成代码后，打开工程，重点关注tim.c和main.c。

1. tim.c中的初始化函数：MX_TIM1_Init(void)。这个函数完整地实例化了我们在CubeMX中的所有配置。你可以看到死区时间配置寄存器BDTR被写入了一个计算好的值。不建议直接修改这个函数，因为重新生成代码会覆盖。
2. main.c中的用户代码区：
   • 在定时器初始化后（MX_TIM1_Init()之后），需要手动启动PWM输出。

   /* USER CODE BEGIN 2 */ HAL_TIM_PWM_Start(&htim1, TIM_CHANNEL_1); // 启动通道1主输出 HAL_TIMEx_PWMN_Start(&htim1, TIM_CHANNEL_1); // 启动通道1互补输出 /* USER CODE END 2 */

   • 注意，启动互补输出使用的是HAL_TIMEx_PWMN_Start函数，而不是普通的HAL_TIM_PWM_Start。
   • 修改占空比：在程序的任何地方（如循环中，中断里），你可以通过修改CCR1寄存器来动态改变占空比。

   __HAL_TIM_SET_COMPARE(&htim1, TIM_CHANNEL_1, new_pulse_value); // 或者使用HAL库函数 // TIM1->CCR1 = new_pulse_value; // 直接操作寄存器，速度更快

   由于我们启用了预装载，这个新值会在下一个PWM周期生效，波形平滑。

4. 调试技巧与示波器实测分析

代码写好了，下载到板子，用示波器探头连接到PA8和PA7，却可能看不到预期的波形。别急，我们一步步排查。

4.1 常见问题排查清单

4.2 示波器实测波形解读

当一切正常时，你的示波器上应该看到类似这样的波形（以中心对齐模式为例）：

• CH1（主通道）：一个中心对称的PWM波。
• CH1N（互补通道）：波形与CH1形状相同，但在每个跳变沿（上升沿和下降沿）都与CH1错开了一个固定的时间，这个时间就是死区时间。
• 关键观察点：
  1. 死区位置：在CH1的下降沿到CH1N的上升沿之间，以及CH1N的下降沿到CH1的上升沿之间，应该有一段两者都为低电平（假设低电平无效）的区域。用示波器的光标功能测量这个区域的宽度，应该等于你设置的死区时间（如500ns），允许有一定的时钟精度误差。
  2. 互补关系：在非死区区的有效期内，CH1和CH1N应该是同相的（如果极性都设为高有效）。这意味着在驱动H桥的同一桥臂时，上下管不会同时导通。
  3. 中心对称性：由于选择了中心对齐模式，PWM脉冲应该位于每个周期的中心位置。这对于电机驱动的电流纹波和EMI性能是有利的。

4.3 进阶配置：刹车与中断

如果你的应用需要保护功能，可以配置刹车：

1. 在CubeMX中启用刹车：在TIM1配置的Break and Dead-Time部分，使能Break Input，并设置极性（例如低电平触发刹车Low）。
2. 配置刹车后输出状态：如前所述，设置Idle State为安全电平（如低电平）。
3. 编写刹车中断回调函数：刹车事件可以触发中断。你需要：
   • 在CubeMX的NVIC设置中使能TIM1_BRK_IRQn中断。
   • 在代码中实现刹车中断回调函数HAL_TIM_IC_CaptureCallback（注意，刹车和输入捕获共用此回调，需判断句柄）。

   void HAL_TIM_IC_CaptureCallback(TIM_HandleTypeDef *htim) { if (htim->Instance == TIM1) { // 检查是否是刹车标志位 if (__HAL_TIM_GET_FLAG(htim, TIM_FLAG_BREAK) != RESET) { __HAL_TIM_CLEAR_FLAG(htim, TIM_FLAG_BREAK); // 执行你的保护逻辑，如关闭其他外设，记录错误日志等 // 注意：刹车后PWM已自动停止，输出进入空闲状态 // 需要清除刹车条件并重新初始化/启动定时器才能恢复输出 } } }

   实操心得：刹车中断服务函数里不要做太耗时的操作。通常只是设置一个故障标志位，然后在主循环或更低优先级的中断里进行复杂的故障处理和安全恢复。恢复PWM输出前，务必确认故障源已消除，否则可能再次触发刹车。

5. 从理论到实践：一个完整的电机驱动H桥案例

让我们把上面的所有知识点串联起来，为一个简单的有刷直流电机H桥驱动设计互补PWM。

硬件连接：

• MCU: STM32F103C8T6
• 驱动芯片：IR2104（半桥驱动，需要两片组成全桥，或使用一片驱动一个半桥）。IR2104是高电平有效输入。
• H桥：4个N-MOSFET。
• 连接：TIM1_CH1 (PA8) -> IR2104-1的IN， TIM1_CH1N (PA7) -> IR2104-1的SD（关闭引脚，本例中我们直接驱动IN，SD接高）。另一路半桥可以用TIM1的另一对通道（CH2/CH2N）或另一个定时器。

CubeMX配置要点回顾：

1. 时钟：系统时钟72MHz，APB2 72MHz，TIM1时钟源72MHz。
2. TIM1参数：Prescaler = 0,Counter Mode = Center Aligned 1,Period (ARR) = 1799(对应20kHz PWM频率)，Repetition Counter = 0。
3. 通道1：PWM Mode 1,Pulse = 900(初始50%占空比)，CH Polarity = High,CH Complementary Polarity = High。
4. 死区：Enable, 设置为670ns（根据IR2104和MOSFET的延迟计算并留有余量）。
5. 刹车：本例未使用，Break Input设置为Disable。CH Idle State = Low,CH Complementary Idle State = Low（安全状态）。
6. GPIO：确认PA8和PA7模式为AF_PP，速度可以选High。

核心控制代码：

// main.c 片段 int main(void) { // HAL初始化，时钟配置等由CubeMX生成... MX_TIM1_Init(); // 启动互补PWM HAL_TIM_PWM_Start(&htim1, TIM_CHANNEL_1); HAL_TIMEx_PWMN_Start(&htim1, TIM_CHANNEL_1); // 设置初始占空比为30% __HAL_TIM_SET_COMPARE(&htim1, TIM_CHANNEL_1, (1800 * 30) / 100); // ARR+1=1800 while (1) { // 主循环中可以动态改变占空比来控制电机速度 // 例如，通过ADC读取电位器值，映射到CCR1 // uint16_t adc_val = HAL_ADC_GetValue(&hadc1); // uint16_t new_pulse = (adc_val * 1800) / 4095; // 假设12位ADC // __HAL_TIM_SET_COMPARE(&htim1, TIM_CHANNEL_1, new_pulse); HAL_Delay(10); } }

调试与验证：

1. 不接电机，先用示波器测量PA8和PA7。应看到20kHz、30%占空比、中心对称、带有约670ns死区的两路互补PWM。
2. 确认波形正确后，连接驱动芯片和H桥，但先不接电机，测量H桥上下管栅极的驱动波形，确保死区存在，上下管栅极电压没有重叠。
3. 最后接上电机，通过修改CCR1的值，你应该能听到电机平滑地调速，并且没有异常的啸叫声（死区不足可能导致高频啸叫）。

通过这个完整的流程，你不仅掌握了STM32CubeMX配置TIM1互补PWM的技能，更理解了其背后的硬件原理、安全考量和调试方法。这种配置方式可以直接迁移到无刷直流电机（BLDC）的六步换相控制，或者开关电源的半桥、全桥拓扑中，是电力电子控制的一块基石。在实际项目中，可能还会结合定时器的刹车功能来自做硬件过流保护，或者使用主从定时器联动产生更复杂的PWM序列，但只要你扎实地理解了本文的基础，那些进阶应用都将有迹可循。