1. 项目概述与核心价值

最近在做一个电机控制相关的项目，需要生成多路相位、占空比和频率都能独立调节的PWM信号。用STM32的单个定时器输出多路同频PWM是基础操作，但一旦涉及到多路信号之间要有精确的、可任意设定的相位差，事情就变得有趣起来。比如，在一些特殊的电源拓扑、多相电机驱动或者需要特定时序的通信模拟中，这种需求很常见。我一开始想着用多个定时器主从同步的方式应该能搞定，但在CubeMX里实际配置时，发现关于相位调节的细节，官方手册和很多教程都讲得比较模糊，需要自己摸索和验证。经过一番折腾，终于实现了基于STM32CubeMX和HAL库，利用主从定时器配置，输出频率、占空比以及任意相位可调的PWM。这不仅仅是配置几个参数，更是对STM32定时器高级控制模式的一次深度理解。如果你也在为如何让两路PWM信号精确错开某个角度（比如90度或120度）而头疼，这篇记录或许能给你提供一个清晰的思路和可复现的步骤。

2. 核心思路与方案选型

2.1 为什么需要主从定时器？

单个高级控制定时器（如TIM1, TIM8）可以输出多达6路互补PWM，但它们通常共享同一个计数器和预分频器，因此输出的所有通道PWM频率必然相同，占空比可以独立设置，但相位关系是固定的。对于TIM1，通道1/2/3和通道1N/2N/3N之间可以设置死区，但同组通道（如CH1和CH2）之间的相位差通常是0度或180度（中心对齐模式下的互补关系），无法实现一个任意值，比如让CH2滞后CH1 30度。

要实现任意相位差，核心思想是：让两个定时器以相同的频率运行，但让它们的计数器在启动时有一个初始的偏移量，这个偏移量就对应了相位差。同时，为了保证它们长期运行的同步性（避免因时钟微小差异累积导致相位漂移），需要让一个定时器（主定时器）去同步另一个定时器（从定时器）。这就是STM32定时器的主从模式（Master-Slave Mode）的用武之地。

2.2 主从定时器同步原理剖析

STM32的定时器同步功能非常灵活。我们计划采用的方案是：

1. 主定时器（Master）： 负责产生基准时钟和触发信号。我们将其配置为PWM输出模式，但它输出的PWM信号可能不作为最终驱动，而是主要利用其更新事件（UEV）作为触发输出（TRGO）。
2. 从定时器（Slave）： 负责产生最终需要的、具有特定相位的PWM信号。它被配置为“从模式”，其启动、复位甚至时钟，都可以受主定时器的触发信号控制。

关键机制在于从定时器的**触发源（Trigger Source）和从模式（Slave Mode）**选择。

• 触发源： 我们选择主定时器的更新事件（Update Event）作为触发源。这意味着主定时器每次计数器溢出或产生更新时，都会发送一个触发信号。
• 从模式： 这里我们选择“门控模式（Gated Mode）”或“触发模式（Trigger Mode）”。但为了实现相位偏移，更常用且有效的是“复位模式（Reset Mode）”。当从定时器配置为复位模式，且触发源选择为主定时器的更新事件时，一旦从定时器接收到触发信号，它的计数器就会立刻复位到0（或初始化值），然后重新开始计数。

听起来相位差还是0？别急，这里有一个至关重要的寄存器：从定时器的 TIMx->SMCR 寄存器中的 TRGI 触发输入极性选择位（位性 TP）和从定时器的计数器初始值。我们可以设置从定时器在接收到触发信号时，不是简单地复位，而是在触发信号到来时，将自己的计数器装载为一个非零的值。但这个操作不是直接配置的，需要通过另一种思路实现：利用从定时器的“单脉冲模式（One Pulse Mode）”结合主从同步，或者更直接地，在从定时器使能后、主定时器启动前，手动给从定时器的计数器（CNT）写入一个初始值。这个初始值，就决定了相位差。

相位差计算公式（核心）： 假设定时器自动重装载值为ARR，时钟频率为Fclk，预分频器为PSC，则PWM周期T = (ARR+1)*(PSC+1)/Fclk。 一个计数周期对应的角度是360° / (ARR+1)。 如果我们想让从定时器滞后主定时器PhaseDelay度，那么从定时器计数器需要预设的初始值CNT_Init为：CNT_Init = (PhaseDelay / 360°) * (ARR + 1)例如，ARR=999，需要90度相位差，则CNT_Init = (90/360)*1000 = 250。

我们的方案流程将是：

1. CubeMX配置主定时器产生PWM，并使其更新事件作为TRGO输出。
2. CubeMX配置从定时器为PWM输出模式，并设置为“从模式”，触发源选择主定时器的TRGO，从模式选择“复位模式”。
3. 在代码中，先启动从定时器（HAL_TIM_PWM_Start），但此时因为主定时器未启动，没有触发信号，从定时器计数器不会动（或取决于配置）。
4. 计算并手动设置从定时器的计数器CNT为相位差对应的值。
5. 最后启动主定时器。主定时器开始计数，其第一次更新事件产生时，会发出触发信号给从定时器。从定时器在复位模式下接收到此触发信号，会将计数器复位并重新开始计数。但由于我们预先设置了CNT值，这个“复位并重新开始”的过程，实际上是从我们预设的CNT值开始计数，从而实现了固定的相位滞后。

注意： 步骤3和4的顺序至关重要。必须先让从定时器进入“待命”状态并设置好相位偏移，再由主定时器触发其开始同步运行。如果先启动主定时器，相位关系就固定为0，无法再调整。

3. CubeMX图形化配置详解

我们以STM32F407为例，使用TIM1作为主定时器，TIM8作为从定时器。目标是产生两路频率1kHz，占空比50%，且TIM8通道1输出的PWM滞后TIM1通道1输出PWM 90度的信号。

3.1 主定时器（TIM1）配置

1. 时钟源： 选择内部时钟（Internal Clock）。
2. 参数配置：
   • Prescaler (PSC - 预分频器)： 假设系统时钟为168MHz，我们目标PWM频率为1kHz。先设定ARR为一个方便计算的数，比如999。则所需定时器时钟Ftim = Fpwm * (ARR+1) = 1kHz * 1000 = 1MHz。
   • 预分频系数PSC = Fclk / Ftim - 1 = 168MHz / 1MHz - 1 = 167。在CubeMX中填入167。
   • Counter Period (ARR - 自动重装载值)： 填入999。
   • Counter Mode： 选择向上计数（Up）。
   • auto-reload preload： 建议使能（Enable），这样对ARR的修改会在下次更新事件生效，避免当前周期出现毛刺。
3. PWM输出配置：
   • 在通道选择中，为Channel 1选择PWM Generation CH1。
   • 下方参数设置中：
     • Pulse： 初始占空比，设为500（对应50%，因为ARR=999）。
     • CH Polarity： 根据硬件需求选择高电平有效（High）或低电平有效（Low）。
4. 主从模式配置（关键）：
   • 点击Parameter Settings选项卡旁边的Master/Slave Mode选项卡。
   • Master/Slave Mode： 选择Enable。
   • Trigger Event Selection (TRGO)： 选择Update Event。这意味着TIM1的每次更新事件都会在它的TRGO引脚上产生一个触发信号。这个信号将用于同步从定时器。

3.2 从定时器（TIM8）配置

1. 时钟源： 同样选择内部时钟。
2. 参数配置：
   • Prescaler (PSC)：必须设置成和主定时器TIM1完全相同的值，即167。这是保证两者计数频率一致的基础。
   • Counter Period (ARR)：必须设置成和主定时器TIM1完全相同的值，即999。这是保证两者PWM周期一致的基础。
   • Counter Mode： 向上计数（Up）。
   • auto-reload preload： 使能（Enable）。
3. PWM输出配置：
   • 同样配置Channel 1为PWM Generation CH1。
   • Pulse： 设为500（50%占空比）。
   • CH Polarity： 设置与TIM1一致。
4. 从模式配置（最关键的一步）：
   • 进入Master/Slave Mode选项卡。
   • Slave Mode： 选择Combined Reset + Trigger Mode或Reset Mode。不同型号/版本的CubeMX选项可能略有不同，其本质都是“复位模式”（Reset Mode）。当触发信号到来时，从定时器的计数器会被复位。
   • Trigger Source： 选择ITR0。这里的ITRx需要查数据手册的定时器内部触发连接表。对于STM32F4，TIM1的TRGO连接到内部触发线路ITR0，可供TIM8使用。这个映射关系是芯片硬件固定的，务必查证。例如，在F4系列中，TIM1是连接到ITR0，TIM2连接到ITR1，等等。
   • 一旦选择了正确的ITRx，下面的Slave Mode选项通常会自动变为Reset Mode。

3.3 GPIO与时钟树检查

• GPIO： 分别为TIM1_CH1和TIM8_CH1配置对应的引脚为复用推挽输出模式，并根据硬件设计决定是否使能内部上拉/下拉。
• 时钟树： 确保TIM1和TIM8的时钟源（APB2 timer clocks）频率一致，都是168MHz。这是PWM频率计算准确的前提。

4. 代码实现与相位调节逻辑

CubeMX生成代码后，我们需要在main.c的用户代码区添加关键操作。

4.1 启动顺序与相位设置代码

/* 用户变量定义 */ uint16_t phase_delay_degrees = 90; // 期望的相位延迟，单位：度 uint32_t calculated_cnt_init; // 计算出的计数器初始值 /* 在定时器初始化完成之后，启动PWM之前添加 */ /* 1. 计算相位差对应的计数器初始值 */ // 注意：ARR是16位寄存器，我们设置的是999，但计算时要用 (ARR+1) calculated_cnt_init = (uint32_t)((float)phase_delay_degrees / 360.0f * (__HAL_TIM_GET_AUTORELOAD(&htim8) + 1)); // 确保值在有效范围内 if(calculated_cnt_init > __HAL_TIM_GET_AUTORELOAD(&htim8)) { calculated_cnt_init = __HAL_TIM_GET_AUTORELOAD(&htim8); } /* 2. 先启动从定时器（TIM8）的PWM输出，但此时计数器因无触发而暂停或未同步 */ HAL_TIM_PWM_Start(&htim8, TIM_CHANNEL_1); /* 3. 手动设置从定时器的计数器值为相位偏移量 */ __HAL_TIM_SET_COUNTER(&htim8, calculated_cnt_init); /* 4. 最后启动主定时器（TIM1）*/ HAL_TIM_PWM_Start(&htim8, TIM_CHANNEL_1);

代码逻辑解读：

1. 计算相位值： 根据公式将角度转换为计数器值。使用__HAL_TIM_GET_AUTORELOAD宏获取实际的ARR值，保证代码通用性。
2. 先启从机： 调用HAL_TIM_PWM_Start启动TIM8。对于配置为复位从模式的定时器，在接收到有效的触发信号前，其计数器可能不开始计数（取决于具体型号和模式），或者独立运行但即将被复位。这一步是让从定时器进入工作状态，等待触发。
3. 设置相位：__HAL_TIM_SET_COUNTER是HAL库提供的宏，用于直接写入计数器的值。这一步是实现任意相位调节的核心。我们强行将TIM8的计数器设置到“半路”上。
4. 后启主机： 最后启动TIM1。TIM1开始从0计数，当它计数到ARR（999）产生第一次更新事件时，TRGO信号发出。TIM8接收到这个复位触发信号，但其计数器当前值是calculated_cnt_init（例如250），触发信号会将其复位。由于是向上计数，复位到0后，TIM8从0开始计数。此时，TIM1已经计数到了1000并回绕到0（产生了更新事件），接着从0开始它的第二个周期。而TIM8则从0开始它的第一个完整周期。因此，TIM8的波形相比TIM1，滞后了250个计数时钟，即90度。

实操心得： 一定要在启动主定时器之前设置从定时器的CNT值。如果在启动之后设置，可能会因为触发信号的随机性导致相位设置不稳定或失效。这个顺序是铁律。

4.2 动态调节占空比与频率

基于上述架构，动态调节变得简单：

• 调节占空比： 直接使用__HAL_TIM_SET_COMPARE(&htim1, TIM_CHANNEL_1, new_pulse)和__HAL_TIM_SET_COMPARE(&htim8, TIM_CHANNEL_1, new_pulse)即可分别调节两路PWM的占空比。它们是独立调节的。
• 调节频率： 需要同时改变主、从两个定时器的ARR和PSC值，以保持相位关系的正确性。重要：修改ARR/PSC时，最好先停止主定时器输出，修改并等待更新完成后，再重新按照“先启从机->设相位->后启主机”的顺序启动。

  // 示例：动态改变频率 uint32_t new_arr = 1999; // 新ARR值 uint16_t new_psc = 83; // 新PSC值 (假设新频率计算得出) // 停止主定时器 HAL_TIM_PWM_Stop(&htim1, TIM_CHANNEL_1); // 更新主定时器周期和预分频 __HAL_TIM_SET_AUTORELOAD(&htim1, new_arr); __HAL_TIM_SET_PRESCALER(&htim1, new_psc); // 更新从定时器周期和预分频（必须一致！） __HAL_TIM_SET_AUTORELOAD(&htim8, new_arr); __HAL_TIM_SET_PRESCALER(&htim8, new_psc); // 重新计算新频率下的相位偏移计数器值 calculated_cnt_init = (uint32_t)((float)phase_delay_degrees / 360.0f * (new_arr + 1)); // 重新按照正确顺序启动 __HAL_TIM_SET_COUNTER(&htim8, calculated_cnt_init); // 先设相位 HAL_TIM_PWM_Start(&htim8, TIM_CHANNEL_1); // 再启从机 HAL_TIM_PWM_Start(&htim1, TIM_CHANNEL_1); // 最后启主机

• 动态调节相位： 原理同设置相位。你可以在任何时候通过__HAL_TIM_SET_COUNTER(&htim8, new_phase_cnt)来修改TIM8的计数器初始值。但要注意，这个修改最好在从定时器计数器被触发复位后、下一个计数周期开始前的短暂窗口内进行，以避免产生毛刺或不完整的PWM脉冲。一个更稳健的方法是在调节相位时，短暂关闭从定时器输出，修改CNT值，再重新使能。

5. 常见问题排查与调试技巧

在实际操作中，你可能会遇到以下问题：

5.1 问题1： 两路PWM完全没有相位差，或者相位差不是设定值。

• 可能原因1： 主从定时器内部触发连接（ITRx）选错。
  • 排查： 仔细查阅你所使用的STM32型号的参考手册（Reference Manual）中的“定时器内部触发连接”表格。TIM1的TRGO不一定连接到你选择的ITRx上。这是最容易出错的地方。
  • 解决： 在CubeMX的从定时器Trigger Source中选择正确的ITRx。
• 可能原因2： 启动顺序错误。
  • 排查： 检查代码是否严格遵循了“启动从定时器PWM -> 设置从定时器CNT -> 启动主定时器PWM”的顺序。
  • 解决： 调整代码顺序。
• 可能原因3： 从模式选择错误。
  • 排查： 确保从定时器的Slave Mode是Reset Mode（复位模式）。如果选成Gated Mode（门控模式），从定时器的计数会受触发信号电平控制，行为不同。
  • 解决： 在CubeMX中重新配置。
• 可能原因4： ARR或PSC值不一致。
  • 排查： 检查主、从定时器的Prescaler和Counter Period是否完全一致。即使差1，长期运行后也会导致相位漂移或频率差异。
  • 解决： 在CubeMX和代码中确保两者完全同步。

5.2 问题2： PWM输出有毛刺或异常脉冲。

• 可能原因1： 在计数器运行时修改了ARR/CNT等寄存器。
  • 排查： 动态调节参数时，是否在定时器运行时直接写入？
  • 解决： 对于ARR、PSC的修改，务必在定时器停止（或确保在更新事件发生时）进行。HAL库的__HAL_TIM_SET_AUTORELOAD等宏在auto-reload preload使能时是安全的，但最稳妥的方式还是先停止定时器再修改。对于CNT的修改（调节相位），风险较高，建议在关闭输出或确保在安全时刻（如更新事件后）进行。
• 可能原因2： 死区时间冲突。
  • 排查： 如果你的PWM用于驱动桥式电路，并配置了死区时间（Dead Time），死区插入可能会影响边沿的精确位置。
  • 解决： 测量不带死区的信号，或者将相位差设置得远大于死区时间。

5.3 问题3： 使用逻辑分析仪或示波器测量，相位差有微小抖动或误差。

• 可能原因1： 系统时钟抖动。
  • 排查： 这是硬件层面的微小误差，通常很小。可以测量多个周期的平均相位差。
  • 解决： 使用更高精度的时钟源（如外部晶振）可以改善。
• 可能原因2： 代码执行时间带来的微小延迟。
  • 排查： 在“设置CNT”和“启动主定时器”两条语句之间，如果有中断发生，可能会引入微秒级的延迟。
  • 解决： 将设置相位和启动的代码段放在临界区（禁用全局中断）中执行，确保时序绝对精确。

  __disable_irq(); // 禁用中断 __HAL_TIM_SET_COUNTER(&htim8, calculated_cnt_init); HAL_TIM_PWM_Start(&htim1, TIM_CHANNEL_1); __enable_irq(); // 启用中断

5.4 调试技巧实录

1. 先验证基础PWM： 不要一开始就配置主从模式。先分别配置TIM1和TIM8为独立的PWM输出，确保两路PWM都能单独正常产生，频率、占空比可调。这是基础，能排除GPIO、时钟、基本定时器配置的错误。
2. 使用CubeMX的“Pinout view”： 在配置从模式触发源ITRx时，可以点击芯片引脚图旁边的“Timers”标签，查看定时器之间的内部连接示意图，有助于理解ITR的连接关系。
3. 善用HAL库状态和错误句柄： 在调试代码时，可以检查htim1.State和htim8.State，确保定时器处于正确的状态（HAL_TIM_STATE_READY,HAL_TIM_STATE_BUSY等）。
4. 示波器是关键： 使用示波器的双通道测量功能，并打开“测量-相位差”功能，直观地验证结果。将触发源设为主PWM通道，观察从PWM通道的延迟。

6. 方案扩展与高级应用思考

实现了基础的主从定时器任意相位PWM后，这个框架可以扩展到更复杂的应用：

1. 多路相位可调PWM： 一个主定时器可以同步多个从定时器。例如，TIM1作为主机，同步TIM8、TIM2、TIM3等。每个从定时器都可以设置不同的CNT初始值，从而实现多路之间具有不同相位差的PWM输出。这在多相电机（如三相、五相）驱动中非常有用。
2. 中心对齐模式下的相位控制： 上述例子是边沿对齐模式（向上计数）。在中心对齐模式（向上向下计数）下，相位计算会稍微复杂一些，因为计数器会先向上再向下。此时，相位偏移的设置和触发复位点的理解需要更仔细的分析，但原理相通。
3. 与DMA结合实现复杂波形序列： 如果需要产生的PWM相位、占空比按复杂规律动态变化，可以将定时器的比较寄存器（CCR）与DMA连接。通过DMA搬运预先计算好的波形表到CCR寄存器，结合主从同步，可以产生任意形状的调制波形。
4. 高精度相位微调： 对于ARR值很大的情况（即定时器分辨率很高），通过设置CNT值可以实现非常精细的相位调节，精度可达360° / (ARR+1)。这对于某些需要精密时序控制的应用（如激光雷达、超声波阵列）至关重要。

踩过几次坑之后，我深刻体会到，STM32定时器的功能强大到超乎想象，很多高级功能都藏在数据手册的细节里。主从模式配合计数器的手动干预，打破了单个定时器输出通道间的相位锁定，为硬件级的精确时序控制打开了新的大门。关键就在于理解“触发-复位-初始值”这个链条，以及严格遵守配置和代码启动的顺序。下次如果你需要让两个PWM信号跳一支精确的“相位差之舞”，不妨试试这个方案。