保姆级教程：用STM32 MotorControl Workbench配置FOC三电阻采样（附工程源码）
STM32三电阻FOC电机控制实战：从Workbench配置到代码解析
最近在调试一款无刷电机时，发现三电阻采样方案在成本与性能之间取得了不错的平衡。相比单电阻方案，它避免了复杂的电流重构算法；相较于双电阻方案，又能更准确地捕捉电流波形。本文将手把手带你用STM32 MotorControl Workbench完成全套配置流程，并深入解析三电阻采样的核心代码实现。
1. 环境准备与基础配置
在开始之前，请确保已安装STM32CubeMX和MotorControl Workbench插件。我推荐使用5.4.4以上版本，这个版本对三电阻采样做了不少优化。硬件方面，需要准备：
- 支持FOC的STM32系列开发板（如STM32F303、STM32G4等）
- 三相逆变器驱动板
- 三个精密采样电阻（通常选择0.01-0.05Ω）
- 被测电机
关键配置步骤：
- 打开Workbench选择"New Project"
- 在"Board & Drivers"中选择对应硬件型号
- 在"Current Sensing"部分勾选"Three Shunt Resistors"
- 设置正确的采样电阻阻值和运放增益
注意：运放增益设置错误会导致电流检测不准确，建议先用万用表测量实际硬件参数
2. 电机参数配置技巧
电机参数的准确性直接影响FOC控制效果。在Workbench的"Motor Parameters"页面，需要填写：
| 参数 | 说明 | 获取方法 |
|---|---|---|
| Pole pairs | 电机极对数 | 查阅电机手册或手动旋转测量 |
| Rs | 定子电阻 | 用LCR表测量相间电阻后除以2 |
| Ls | 定子电感 | LCR表测量相间电感后除以2 |
| Ke | 反电动势常数 | 空载测试或查阅手册 |
我曾遇到过因电感值填写错误导致电流环震荡的情况。这里分享一个实用技巧：可以先设置偏小的电感值，通过Workbench的"Motor Profiler"自动测量功能获取更准确参数。
3. PWM与ADC同步配置
三电阻采样的关键在于精确的PWM和ADC同步时机。在Workbench中配置时：
/* 定时器触发ADC的典型配置 */ TIM1->CCER |= TIM_CCER_CC4E; // 启用通道4 TIM1->CCMR2 |= TIM_CCMR2_OC4M_1 | TIM_CCMR2_OC4M_2; // PWM模式1 TIM1->CR2 |= TIM_CR2_MMS_1; // TRGO输出选择OC4REFADC需要配置为注入模式，关键参数包括：
- 采样时间：建议设置为PWM周期的1/10
- 触发源：选择TIM1_TRGO
- 通道分配：根据硬件连接选择对应ADC通道
在调试时，可以用逻辑分析仪同时捕捉PWM和ADC触发信号，确保时序对齐。我曾遇到因信号延迟导致的采样点偏移问题，通过调整TIM1的预分频器解决了这个问题。
4. 代码生成与关键函数解析
点击"Generate Code"后，Workbench会创建完整的工程。重点关注以下几个文件：
r3_2_pwm_curr_fdbk.c：电流采样核心算法mc_config.c：硬件配置参数motorcontrol.c：主控制循环
扇区判断与电流采样：
void R3_2_GetPhaseCurrents(PWMC_Handle_t *pHdl, ab_t *Iab) { uint8_t Sector = pHdl->_Super.Sector; uint16_t ADCDataReg1 = *pHdl->pParams_str->ADCDataReg1[Sector]; uint16_t ADCDataReg2 = *pHdl->pParams_str->ADCDataReg2[Sector]; // 根据扇区选择采样相位 switch(Sector) { case SECTOR_1: Iab->a = (int16_t)(ADCDataReg1 - pHdl->OffsetA); Iab->b = (int16_t)(ADCDataReg2 - pHdl->OffsetB); break; // 其他扇区处理... } }这段代码实现了：
- 获取当前PWM扇区
- 读取对应ADC通道的采样值
- 进行偏移校准
- 输出两相电流值
5. 采样点优化与调试技巧
三电阻采样的最大挑战在于选择合适的采样时刻。STM32的自动采样点选择算法核心逻辑如下：
uint16_t R3_2_SetADCSampPointSectX(PWMC_Handle_t *pHdl) { if ((pHandle->Half_PWMPeriod - pHdl->lowDuty) > pHandle->pParams_str->Tafter) { // 在PWM周期中间采样 pHandle->_Super.Sector = SECTOR_5; SamplingPoint = pHandle->Half_PWMPeriod - 1; } else { // 动态调整采样点 DeltaDuty = pHdl->lowDuty - pHdl->midDuty; if (DeltaDuty > (pHandle->Half_PWMPeriod - pHdl->lowDuty) * 2) { SamplingPoint = pHdl->lowDuty - pHandle->pParams_str->Tbefore; } else { SamplingPoint = pHdl->lowDuty + pHandle->pParams_str->Tafter; } } R3_2_WriteTIMRegisters(&pHandle->_Super, SamplingPoint); }调试时常见问题及解决方法：
电流波形畸变：
- 检查采样电阻布局，确保走线对称
- 调整
Tbefore和Tafter参数
采样值跳动大：
- 增加ADC采样时间
- 检查电源稳定性
- 添加硬件滤波电路
低速时控制不稳：
- 修改速度环PI参数
- 启用Workbench的"低速补偿"功能
6. 性能优化进阶技巧
当系统运行稳定后，可以考虑以下优化措施：
电流环带宽提升：
- 减小PWM死区时间
- 使用HRTIM替代普通TIM
- 开启ADC的过采样功能
效率优化：
// 在main.c中添加以下观测变量 __IO uint16_t *pADC1 = &ADC1->JDR1; __IO uint16_t *pADC2 = &ADC2->JDR1; DebugWatchAdd("Ia", (int32_t*)(pADC1), SIGNED); DebugWatchAdd("Ib", (int32_t*)(pADC2), SIGNED);通过实时监控电流波形，可以：
- 优化开关频率
- 调整死区补偿
- 验证MTPA算法效果
在实际项目中，我发现将PWM频率从10kHz提升到20kHz后，电机噪音明显降低，但需要注意MOSFET温升问题。