简介：基于STM32的三相逆变器工程代码，面向嵌入式开发者和电力电子学习者，完整演示了SPWM调压调频控制策略在三相逆变中的应用，覆盖直流转交流、电机调速等场景的软件实现与调试思路。压缩包共270个文件，约9.49MB，核心代码以c/h源文件为主，配合o/d/crf等编译中间文件、pdf/txt说明文档，以及hex/axf等烧录镜像和工程配置文件，便于直接编译、烧录和验证。资源目前已有2687人学习下载，内容不仅包含驱动库、SPWM生成模块、调压调频控制算法等可复用代码，还附带编译配置、字体与界面资源等补充材料，从工程模板到外设驱动均有清晰组织，适合课程设计、电子设计竞赛及工程预研参考。通过阅读与移植该工程，可快速掌握三相逆变器主控程序设计逻辑，理解固定载波比、同步调制等SPWM策略的实际落地方式。
1. 三相逆变的整体思路拆解
1.1 STM32三相逆变代码到底在做什么
简单说，三相逆变就是把直流电变成三相交流电，而基于STM32做这件事，本质上是靠定时器输出六路PWM信号，驱动六个功率开关管按特定规律通断。这套代码的核心不是“怎样写C语言”，而是“怎样让单片机按电力电子的规律输出正确的脉冲序列”。
我最早接触这个需求时，以为难点在算法，后来踩了一圈坑才明白：真正决定项目成败的，是定时器资源怎么分配、死区时间怎么算、调制方式怎么选这三件事。STM32之所以在逆变器项目里烂大街，是因为它的高级定时器TIM1/TIM8自带互补输出、死区插入和刹车输入，这些硬件特性恰好就是逆变桥驱动信号的标配。用普通定时器硬做也可以，但外部要加死区电路，可靠性差一截，属于吃力不讨好。
1.2 为什么不用专用芯片而非要选STM32
市面上做逆变有专用的SPWM芯片，也有DSP方案，但STM32依然是很多人的首选。原因不复杂：一是便宜，一片F103或F302也就几块钱到十几块钱，量产成本压得住；二是灵活，频率、调制比、保护逻辑全都由代码决定，改一个宏定义就能适应50Hz工频或400Hz中频；三是生态成熟，HAL库和CubeMX把寄存器操作包了一层，做原型验证非常快。
当然代价也有，STM32的FPU和数学库不如DSP强，如果要跑到几十kHz的开关频率且实时算SVPWM扇区，CPU负载会偏高。我的经验是：开关频率在10~20kHz范围，主频72MHz的F103足够跑查表SPWM；超过30kHz或者要加复杂闭环，直接上F302/F334这类带数学加速的型号更稳。
1.3 调制方式选SPWM还是SVPWM
这是代码方案里第一个要拍板的决策。SPWM（正弦脉宽调制）思路最直白：把正弦波的目标值除以三角载波的幅值，得到每一时刻的占空比，查表塞进CCR寄存器即可。SVPWM（空间矢量调制）则从电机控制视角出发，把三相电压合成一个旋转矢量，用八个基本矢量去逼近，直流母线利用率比SPWM高15%左右，谐波也更集中。
对刚上手的人来说，我建议第一版先做SPWM查表法。原因很实际：逻辑简单，容易把时序和死区问题先调通，波形出来以后再去对比SVPWM的差异。SVPWM虽然能效好，但扇区判断、矢量作用时间计算这些代码量直接翻倍，一旦时序没理清，排查起来非常痛苦。
2. 代码核心细节解析
2.1 高级定时器TIM1的PWM配置要点
STM32的三相逆变代码，绝大多数都建立在TIM1或TIM8上。这两个高级定时器有六个输出通道，可以成三组互补输出：CH1/CH1N、CH2/CH2N、CH3/CH3N。每组的两个输出接同一桥臂的上下管，逻辑上绝对不能同时导通，否则就是直通短路。
配置代码的骨架如下：
// 基于STM32 HAL库，TIM1三组互补PWM输出配置核心段 TIM_HandleTypeDef htim1; TIM_OC_InitTypeDef sConfigOC; TIM_BreakDeadTimeConfigTypeDef sBreakDeadTimeConfig; htim1.Instance = TIM1; htim1.Init.Prescaler = 72 - 1; // 72MHz/72 = 1MHz计数频率 htim1.Init.CounterMode = TIM_COUNTERMODE_CENTERALIGNED1; // 中央对齐模式 htim1.Init.Period = 1000 - 1; // 三角载波频率 = 1MHz/1000 = 1kHz htim1.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1; htim1.Init.RepetitionCounter = 0; htim1.Init.AutoReloadPreload = TIM_AUTORELOAD_PRELOAD_ENABLE; HAL_TIM_PWM_Init(&htim1);这里有个新手常忽略的细节：CounterMode用的是中央对齐模式，而不是边沿对齐。原因在于互补PWM需要“对称”的脉冲，中央对齐能保证每个周期的输出脉冲在时间轴上居中，谐波特性更好。边沿对齐虽然也能出波形，但脉宽分布不对称，电机运行时的噪音和振动会更明显。
预分频器和Period的计算公式很简单：载波频率 = 定时器时钟 / (Prescaler + 1) / (Period + 1)。上例里72MHz除以72再除以1000，正好得到1kHz载波。如果你要20kHz载波，直接改Period为49即可（1MHz / 20kHz = 50个计数周期，减1后为49）。
2.2 死区时间计算，这一步出错直接炸管子
死区时间，指的是同一桥臂上下管切换时，刻意插入的一个“同时关断”的小窗口。为什么要这个东西？因为IGBT或MOSFET的关断速度不可能瞬间完成，如果上管还没完全关断、下管就导通了，母线和地之间直接短接，瞬间大电流会把管子烧穿。这是逆变器项目里最常见的炸管原因。
死区时间怎么算？主要是看功率管子的关断延迟参数。以常见IRFP460为例，其关断延迟典型值约100ns，加上电流下降时间约80ns，再留50%的余量，死区时间设在500ns到1us比较稳妥。代码里配置如下：
sBreakDeadTimeConfig.OffStateRunMode = TIM_OSSR_DISABLE; sBreakDeadTimeConfig.OffStateIDLEMode = TIM_OSSIDISABLE; sBreakDeadTimeConfig.LockLevel = TIM_LOCKLEVEL_1; sBreakDeadTimeConfig.DeadTime = 72; // 死区时间 = 72 / 1MHz = 72us ? 不对！ sBreakDeadTimeConfig.BreakState = TIM_BREAK_ENABLE; sBreakDeadTimeConfig.BreakPolarity = TIM_BREAKPOLARITY_HIGH; sBreakDeadTimeConfig.BreakFilter = 0; HAL_TIMEx_ConfigBreakDeadTime(&htim1, &sBreakDeadTimeConfig);注意上面代码里我特意标出的那行，是个典型错误示例。STM32的DeadTime寄存器不是直接用微秒算的，它的单位取决于定时器时钟和DTG[7:0]位段的配置规则，数值代表的是若干个t_dts周期的组合。HAL库的HAL_TIMEx_ConfigBreakDeadTime直接传寄存器值，不帮你换算。假设t_dts为125ns（72MHz时钟），想要1us死区，需要8个t_dts，对应DTG=8。但要注意，当DTG[7:5]=100时，死区时间公式会变成(64+DTG[4:0]) * t_dts * 2，换算逻辑不同。这块建议直接查阅参考手册的“Dead-time insertion”章节，每次换芯片型号都要重新核对。
2.3 SPWM查表法生成，正弦表精度怎么取
SPWM的软件实现有两条路：一是实时用sin()函数计算占空比，二是提前算好正弦表存到Flash里，运行时候查表。我在F103上实测，实时算sin虽然耗时不多（一次调用约几十微秒），但如果在中断里频繁调用，叠加PID运算后CPU负担明显上升。所以推荐查表法。
正弦表的生成可以用Python或MATLAB预先算好，直接转成C数组。比如载波频率20kHz、输出频率50Hz，则一个周期内采样点数 = 20000/50 = 400点。如果希望输出波形更细腻，可以扩展到800点甚至1200点，代价是Flash占用增多。一个float数组存400个点，约1.6KB，对F103的Flash来说毫无压力。
采样点数和频率分辨率还有一层关系：查表法的输出频率取决于“步进”。如果表长度为N，定时器中断频率为F_carrier，步进为step，那么输出频率F_out = F_carrier * step / N。想调频，改step值即可。比如N=400，step=1时输出50Hz，step=2时输出100Hz。这比重算整张表方便太多。
2.4 保护逻辑：代码里的安全底线
逆变器代码里最容易忽略的部分是保护。很多人把三相互补PWM调出波形就宣布完工，结果一接负载就出事。一套能拿去打样的代码，至少得有三级保护：过流保护、过压保护和刹车中断。
过流保护最理想的是用比较器硬件实现，信号进TIM的BKIN引脚（刹车输入），硬件自动封锁PWM输出，响应时间在几百纳秒级。软件检测到故障标志后再做后续处理——比如清故障原因、重新初始化。如果纯靠ADC采样再让软件关PWM，CPU中断响应加代码执行，延迟少说几十微秒，对功率管来说已经足够致命。
代码里的保护逻辑大致是这样的框架：
void TIM1_BRK_IRQHandler(void) { if (__HAL_TIM_GET_FLAG(&htim1, TIM_FLAG_BREAK)) { __HAL_TIM_CLEAR_FLAG(&htim1, TIM_FLAG_BREAK); // 记录故障原因 fault_code |= FAULT_OVERCURRENT; // 停止PWM输出 HAL_TIM_PWM_Stop(&htim1, TIM_CHANNEL_1); HAL_TIMEx_PWMN_Stop(&htim1, TIM_CHANNEL_1); // 其余通道相同处理 } }这里有一个值得说的设计要点：保护动作和故障恢复要分离。刹车中断里只负责“切断输出、记录状态”，不要立刻尝试恢复输出。等主循环检测到故障标志后，由用户按键或上位机命令确认，再执行复位逻辑。否则如果过流故障一直存在，代码会陷入“保护-恢复-再保护”的高速循环，功率管承受的压力更大。
3. 实操过程：从零调出一组正弦波
3.1 硬件准备：做一个低压验证板
强烈建议先用低压小功率板验证代码，别直接上220V。我第一次做的时候直接上大电解电容的母线，结果调试中一个占空比算错，管子当场冒烟，整个模块报废。后来学乖了，用可调直流电源限制在12V~24V，配一个100W左右的小电机或者纯电阻负载，先把波形和逻辑调对，再逐步升压。
从原理图角度，STM32最小系统板（比如F103C8T6蓝色板）加上六路栅极驱动芯片和六颗MOS管，就能组成最小验证平台。栅极驱动我常用IR2104系列，自带自举电路，三颗芯片管六路，外围非常简洁。连接方式：TIM1的六路PWM分别接IR2104的HIN和LIN输入，IR2104输出驱动MOS管的G极，半桥中点接电机相线。
3.2 代码初始化流程
写代码时，我习惯按以下的顺序来：
- 配置系统时钟：确保定时器时钟源正确，F103用HSE倍频到72MHz，这决定所有后续时间参数的基准。
- 配置GPIO：TIM1的CH1~CH3作为PWM输出，CH1N~CH3N作为互补输出，全部设置为复用推挽模式，注意引脚速度设为High，否则高边驱动信号边沿不够陡，开关损耗偏大。
- 配置定时器：按照2.1节的参数初始化TIM1，重点确认中央对齐模式和Period值。
- 配置死区与刹车：按2.2节设置死区时间，开启刹车功能，BKIN引脚配置为下拉输入。
- 配置输出比较通道：设置CH1~CH3三个通道的PWM模式，极性设为高有效，然后调用
HAL_TIM_PWM_Start和HAL_TIMEx_PWMN_Start启动互补输出。 - 开启中断：如果需要实时调频或做闭环控制，使能TIM1更新中断，在回调里更新CCR值。
- 启动主循环：在一个中断里按正弦表更新CCR寄存器，另一个按键中断负责调步进和死区参数。
这里有个非常实用的调试技巧：先不接MOS管，直接拿示波器探头量MCU引脚的PWM波形。如果GPIO出来的波形就异常，那问题十有八九在配置代码；如果波形正常，再接驱动器和功率级。把问题和硬件解耦，排查效率会高很多。
3.3 第一次上电可能看到的几种波形
用示波器观察逆变器输出（相电压对直流母线中点），正常情况下能看到接近正弦的PWM波群，经过LC滤波后是干净的正弦波。但有几种常见异常波形，看一眼波形就能锁定问题方向：
| 波形现象 | 可能原因 | 排查方向 |
|---|---|---|
| 输出只有半波 | 某组互补通道没有启动 | 检查CHxN是否调用了HAL_TIMEx_PWMN_Start |
| 波形不对称 | 中央对齐模式配置错误或死区过大 | 核对CounterMode和DeadTime值 |
| PWM频率不对 | 预分频或Period算错 | 用公式反推载波频率，示波器量一下 |
| 波形有毛刺跳变 | 刹车误触发 | 检查BKIN引脚电平是否被噪声干扰，加滤波 |
| 50Hz正弦波不明显 | 载波频率太低或滤波参数不匹配 | 提高载波频率或调整LC滤波器参数 |
3.4 按键调速实现
调出固定频率的正弦波只是第一步，真正实用的逆变器需要可调输出频率。前面提到用step实现调频，代码如下：
#define SINE_TABLE_SIZE 400 const float sine_table[SINE_TABLE_SIZE] = { // 用Python预生成的正弦表，范围0.0~1.0 }; volatile uint16_t current_index = 0; volatile float mod_index = 0.85f; // 调制比，决定输出幅值 void TIM1_UP_IRQHandler(void) { if (__HAL_TIM_GET_FLAG(&htim1, TIM_FLAG_UPDATE)) { __HAL_TIM_CLEAR_FLAG(&htim1, TIM_FLAG_UPDATE); current_index = (current_index + step) % SINE_TABLE_SIZE; uint32_t cc_value = (uint32_t)(sine_table[current_index] * mod_index * period_value); __HAL_TIM_SET_COMPARE(&htim1, TIM_CHANNEL_1, cc_value); // 相位差120度和240度，通过index偏移实现 // 注意current_index需加SINE_TABLE_SIZE/3和2*SINE_TABLE_SIZE/3再取模 } }相位差120度怎么实现？直接对索引做偏移即可：A相用current_index，B相用(current_index + SINE_TABLE_SIZE/3) % SINE_TABLE_SIZE，C相用(current_index + 2*SINE_TABLE_SIZE/3) % SINE_TABLE_SIZE。SINE_TABLE_SIZE必须能被3整除，400只是一个演示值，实际用399或更精确的倍数。
调制比mod_index的作用也很直观：它相当于正弦波的峰值占空比。0.85的调制比意味着占空比在0.15到0.95之间变化，给死区和上下管切换留出缓冲。如果调到0.95甚至更高，接近满占空比输出，波形容易畸变。
3.5 加一个LC滤波器看正弦波
PWM波形直接接电机，电机电感本身就能起到滤波作用，但如果想接到普通交流负载或者作为逆变电源输出，必须加LC滤波器。L和C的选取原则并不复杂：滤波器的截止频率应远低于载波频率，远高于输出频率。典型设计取截止频率为载波频率的1/10到1/20。
举个例子：载波20kHz，输出50Hz，截止频率取2kHz左右。手头有两个10mH电感（用于三相输出，每相需要一个）和两个4.7uF电容（用于Y形连接），截止频率约等于1/(2π√(LC)) ≈ 1/(2π√(10mH*4.7uF)) ≈ 734Hz，这个值偏低，但用于展示波形没问题。如果想精确设计，需要按负载阻抗和纹波要求计算，这里不展开。
4. 常见问题与排查技巧实录
4.1 上电就炸MOS管，问题出在哪
炸管是逆变器调试中最炸裂的问题，没有之一。我排查炸管问题总结出一个“三步定位法”：
第一步，检查死区配置。把死区时间临时调到2us以上，看是否还炸。如果炸的频率降低，说明原死区时间不够，换用关断速度更快的驱动或者增大死区。第二步，检查栅极信号完整性。用示波器看栅源极波形，是否存在着明显的振铃或米勒平台异常。如果波形毛刺大，需要在栅极串联电阻（常见10~22欧姆）抑制振铃。第三步，检查母线电容和布局。如果死区足够、驱动波形干净，还是炸管，很大概率是回路寄生电感过大，关断瞬间的尖峰电压超过管子耐压。此时要缩小功率回路的环路面积，或者在母线两端加吸收电容。
4.2 互补PWM输出波形不对称
明明在代码里配了中央对齐模式，示波器看两只管子的驱动波形却不对称。这种问题多半不是代码逻辑，而是硬件层面的问题：上下管用的驱动电路有延迟差异。比如自举电路在上电初期，自举电容充电需要时间，导致高边驱动比低边慢半拍。解法是在初始化时先让PWM输出一段时间的“上管关断、下管导通”状态，给自举电容预充电，再切到正常调制。
4.3 输出频率不准
用示波器频率计测输出，发现频率总比设定值偏大或偏小。这种情况先自查时钟。F103的HSE外部晶振如果是8MHz，倍频到72MHz没问题；但有些最小系统板上的晶振精度不高，或者负载电容配得不准，会导致系统时钟有偏差。另一个可能原因是Period公式理解错了。中央对齐模式下，三角载波一个完整周期需要计数从0到ARR再到0，所以实际载波频率等于定时器时钟 / (2 * (ARR+1))，不是直接除(Prescaler+1)。我见过不少人在这个点上栽跟头，调了半天代码，其实公式就不对。
4.4 加上负载后波形畸变
空载时正弦波很漂亮，一接电机波形就开始畸变。这不是代码的bug，而是逆变器带载能力不足的表现。排查方向有两个：第一，母线电压是否被拉低。直流电源供电能力不够时，大负载下母线电压跌落，占空比没变但输出电压随之下跌，波形自然变差。第二，死区效应。过大死区会造成输出电压损失，尤其在轻载时波形死区畸变更明显。这时候可以考虑加入死区补偿算法，或者在能保证安全的前提下减小死区时间。
4.5 定时器中断卡死
有人遇到程序跑着跑着突然PWM输出停滞，主循环像卡死一样毫无响应。排查后发现是TIM1的更新中断里用了HAL_Delay()，导致中断嵌套和阻塞。中断服务函数里绝对不能调用任何带等待的API，包括HAL_Delay和部分会阻塞的串口打印。正确做法是置一个标志位，把耗时操作放到主循环处理。
调试PWM相关中断还有个经验：如果怀疑中断标志混乱，直接把所有TIM相关中断全清一遍再重新使能，观察是否恢复。多数情况下是某个中断标志没清除导致反复进中断，系统看起来像卡死，实际上是在无限处理中断。
4.6 不同型号芯片的代码迁移问题
F103上跑通的项目换到F302/F334，代码不能直接编译过。原因主要在于这两类芯片的定时器寄存器布局有差异，而且F334内部有硬件Math单元，PWM外设也升级了。迁移时建议重点核对三处：时钟树配置、定时器寄存器地址、刹车和死区寄存器的位域定义。其他包括GPIO复用功能编号也要重新映射一遍。这类坑属于芯片资料阅读问题，花半天把新芯片的参考手册相关章节读一遍，能省一周调试时间。
实际操作中的几点体会
接触三相逆变代码这些年，从F103烧录裸机程序到F334跑完整的FOC控制，最大的体会是：代码本身占项目成功的比重不到一半，更大的比重在于写代码前对硬件特性的理解。PWM寄存器配置错了可以改，死区参数不合适可以重新烧录，但硬件设计上的坑往往要炸掉几个管子才能发现。所以每次做新板子，我都坚持先用低压小电流验证代码，再逐步加大功率，这是最省钱也最稳妥的推进方式。
另外想强调的是，直接抄别人的寄存器配置容易，真正理解为什么用中央对齐模式、为什么死区时间要按管子的关断特性来定、为什么刹车引脚必须接硬件比较器，才是做完一个项目后最大的收获。下次换一个完全不同的主控，这些经验依然能复用。
本文还有配套的精品资源，点击获取
