无刷电机这东西玩过航模的朋友应该都不陌生扭矩大、效率高、寿命长但真要自己写代码把它转起来很多人第一步就卡住了——六步换向能凑合转可噪音大、低速抖动、效率还低。FOC磁场定向控制就是来解决这个问题的它把三相电流解耦成励磁分量和转矩分量让电机像直流电机一样好控制同时保留无刷电机的高效率。ESP32 这颗芯片做 FOC 有天然优势双核 240MHz、硬件 MCPWM 模块、自带 Wi-Fi 和蓝牙做智能风扇这种需要联网控制的项目再合适不过。SimpleFOC 库把 FOC 的数学部分封装好了你不需要自己推导 Park 变换和 Clarke 变换但前提是你得把硬件接线、传感器校准、电流采样这几件事搞明白否则库再好也转不起来。这篇内容适合有 Arduino 基础、想从零搭一套无刷电机驱动系统的朋友我会把从选型到代码落地的完整链路拆开讲包括那些文档里不会写的坑。1. 先搞清楚你要驱动的是什么电机1.1 无刷电机的三相绕组与霍尔/无感方案无刷电机分内转子和外转子智能风扇一般用外转子因为扇叶可以直接固定在转子上省掉传动结构。三相绕组按星形或三角形连接星形接法更常见因为它的反电动势波形更接近正弦适合 FOC 控制。每相绕组的电阻通常在几欧姆到几十欧姆之间具体看电机功率。霍尔传感器方案是最容易上手的三个霍尔元件按 120 度电角度分布输出六种状态组合对应转子的六个扇区。SimpleFOC 支持霍尔传感器作为位置反馈精度虽然不如编码器但对于风扇这种负载变化不大的场景完全够用。无感方案无霍尔靠反电动势过零检测或者滑模观测器来估算转子位置省掉了传感器线但低速时反电动势太小估算不准启动需要开环强拖。如果你做的是智能风扇转速范围通常在 500 到 3000 RPM霍尔方案在这个区间表现稳定调试也简单。注意买电机的时候一定要确认霍尔传感器的输出类型开漏输出需要外接上拉电阻推挽输出可以直接接。很多便宜电机不标这个参数买回来发现接上没信号就是这个问题。1.2 极对数这个参数千万别填错极对数是 FOC 里最容易被忽略但影响最大的参数。它指的是转子永磁体磁极的对数比如 7 对极的电机转子转一圈电角度变化 7 个周期。SimpleFOC 里motor.pole_pairs这个参数如果填错电机会转但方向乱、力矩小、发热严重。怎么确认极对数最笨但最可靠的办法是手动转转子一圈用示波器看某一相的反电动势波形数完整正弦波的数量。没有示波器的话可以拆开电机数磁钢磁钢数量除以 2 就是极对数。比如 14 片磁钢就是 7 对极。我见过有人把 7 对极填成 14结果电机转起来像得了帕金森电流直接飙到限流值。1.3 电流采样单电阻、双电阻还是三电阻FOC 需要知道三相电流才能做闭环控制。采样方案有三种单电阻采样成本最低但需要在特定 PWM 状态下采样算法复杂双电阻采样是折中方案采两相推算第三相三电阻采样最直接每相一个采样电阻但成本最高。对于智能风扇这种低压小功率场景我推荐用集成电流采样的驱动芯片比如 DRV8313 或者 L6234它们内部集成了电流检测和放大电路输出模拟电压给 ESP32 的 ADC 读取。如果你用分立 MOS 管搭驱动那就要自己加采样电阻和运放这时候要注意运放的共模抑制比和带宽带宽不够会导致电流波形失真FOC 效果大打折扣。2. ESP32 与 SimpleFOC 的硬件搭配2.1 驱动板选型从 L6234 到 DRV8313L6234 是三半桥驱动芯片最大电流 5A工作电压 7 到 52V自带使能引脚和方向控制适合小功率云台电机。它的缺点是导通电阻较大大电流下发热明显需要加散热片。DRV8313 也是三半桥但集成了电流采样放大器和过流保护最大电流 2.5A适合更小的电机。如果你要驱动风扇这种需要持续运转的场景建议留足余量选额定电流两倍于电机工作电流的驱动板。ESP32 和驱动板的连接要注意电平匹配。ESP32 的 GPIO 是 3.3V 逻辑L6234 的输入高电平阈值是 2.3V 左右直接连没问题。但有些驱动板是 5V 逻辑那就需要电平转换否则 ESP32 输出高电平时驱动板可能识别不到。我一般会在原理图阶段就确认好逻辑电平避免后面飞线。2.2 电源设计别让电机把 ESP32 拉复位电机启动瞬间电流是额定电流的 3 到 5 倍如果电源功率不够电压会被拉低ESP32 的欠压复位就会触发表现就是电机一启动 ESP32 就重启。解决办法有两个一是电源留足余量比如电机额定 12V 2A电源至少选 12V 5A二是在电机电源和 ESP32 电源之间加 LC 滤波电感选 100uH 以上电容选 470uF 以上把电机产生的纹波滤掉。还有一个坑是共地问题。驱动板和 ESP32 必须共地否则 PWM 信号没有参考电平电机要么不转要么乱转。但共地之后电机的开关噪声会通过地线串到 ESP32 的 ADC 上影响电流采样精度。我的做法是用星形接地电源地、驱动地、控制地分别走线最后在电源入口处单点汇合。2.3 霍尔传感器接口与上拉电阻计算霍尔传感器输出通常是开漏的需要上拉到 3.3V 或 5V。上拉电阻的取值要考虑两个因素一是功耗二是上升沿时间。电阻越小上升沿越快但功耗越大。对于 3.3V 系统4.7k 到 10k 是常用值。如果电机转速很高霍尔信号频率可能到几十 kHz这时候上升沿时间要控制在 1us 以内电阻就要选小一些。计算上升沿时间的公式是 t 2.2 × R × C其中 C 是线路电容加上霍尔输出电容通常 20pF 左右。以 10k 电阻为例t 2.2 × 10000 × 20e-12 0.44us满足要求。如果线缆很长电容会增大这时候要么减小电阻要么加施密特触发器整形。3. SimpleFOC 库的配置与校准流程3.1 安装库与依赖项在 Arduino IDE 里安装 SimpleFOC 很简单库管理器搜索 SimpleFOC 就能找到。但要注意版本2.3.x 和 2.4.x 的 API 有变化网上很多教程是旧版本的直接抄会编译报错。我建议用 2.4.0 以上版本因为新版本对 ESP32 的支持更好特别是 MCPWM 的配置更稳定。除了 SimpleFOC 本身还需要安装 ESP32 的 Arduino 核心版本建议 2.0.14 以上。安装完之后在开发板管理器里选 ESP32 Dev ModuleFlash 模式选 QIO分区方案选 Default 4MB with spiffs。这些设置影响 PWM 频率的稳定性别用默认的 DIO 模式实测下来 QIO 的 PWM 抖动更小。3.2 开环测试先让电机转起来再说在接传感器之前先做开环测试确认驱动板和电机接线没问题。开环测试就是给定一个固定的电压矢量让电机以设定的速度旋转不依赖任何位置反馈。代码很简单#include SimpleFOC.h BLDCMotor motor BLDCMotor(7); BLDCDriver3PWM driver BLDCDriver3PWM(25, 26, 27, 14); void setup() { driver.voltage_power_supply 12; driver.init(); motor.linkDriver(driver); motor.voltage_limit 6; motor.init(); motor.initFOC(); } void loop() { motor.loopFOC(); motor.move(2.0); }这段代码里BLDCMotor(7)的 7 就是极对数BLDCDriver3PWM的四个参数分别是三相 PWM 引脚和使能引脚。voltage_limit设成电源电压的一半防止电流过大。开环测试时电机会有轻微抖动这是正常的因为电压矢量是固定的没有根据转子位置调整。提示开环测试时如果电机不转先检查使能引脚有没有拉高再检查三相线序。任意交换两相线电机就会反转这个可以用来验证接线。3.3 霍尔传感器校准与电角度对齐霍尔传感器装上去之后需要校准电角度偏移。SimpleFOC 提供了motor.initFOC()函数它会自动完成对齐。但前提是霍尔传感器的状态表要正确。每个电机的霍尔安装位置不同状态表也不同。SimpleFOC 默认的状态表是 1-3-2-6-4-5如果你的电机不是这个顺序就要手动改。校准步骤是这样的先把电机转到任意位置调用motor.initFOC()库会依次给三相通电记录霍尔状态变化然后计算偏移量。如果校准失败串口会打印错误信息常见的是“霍尔状态无效”这时候就要检查霍尔接线或者状态表。我遇到过一种情况霍尔传感器是好的但状态表顺序不对电机能转但效率很低电流比正常值大 30%。后来用逻辑分析仪抓了霍尔波形发现状态顺序是 1-5-4-6-2-3改过来之后电流就正常了。所以校准这一步不能省也不能想当然。4. 智能风扇的闭环控制逻辑4.1 速度环与电流环的串级结构智能风扇的核心是恒转速控制不管风阻怎么变转速要稳定。SimpleFOC 支持三种控制模式力矩控制、速度控制、位置控制。风扇用速度控制就够了。速度环的输入是目标转速输出是转矩电流然后电流环再把这个电流转换成电压矢量。串级结构的好处是响应快、抗干扰强。外环速度环带宽低内环电流环带宽高一般电流环带宽是速度环的 5 到 10 倍。SimpleFOC 里配置速度环 PID 的参数是motor.PID_velocity.P、I、D还有motor.LPF_velocity.Tf低通滤波时间常数。风扇这种负载P 设 0.2 到 0.5I 设 2 到 5D 设 0 就行因为风扇没有突变负载不需要微分项。4.2 温度传感器接入与自动调速智能风扇的“智能”体现在根据温度自动调速。ESP32 接 DS18B20 或者 DHT22 都很方便DS18B20 是单总线精度高适合测环境温度。接线就三根VCC、GND、DATADATA 接一个 4.7k 上拉到 3.3V。调速逻辑可以很简单温度低于 25 度转速 025 到 30 度转速 1000 RPM30 到 35 度转速 2000 RPM高于 35 度转速 3000 RPM。中间用线性插值避免转速突变。代码里用一个map()函数就能搞定float temp sensors.getTempCByIndex(0); float targetRPM map(temp, 25, 40, 1000, 3000); targetRPM constrain(targetRPM, 0, 3000); motor.move(targetRPM);这里要注意map()函数的输入是整数温度是浮点数的话要先转成整数或者自己写一个浮点版本的映射函数。4.3 蓝牙与 Wi-Fi 双模控制的取舍ESP32 支持蓝牙和 Wi-Fi 同时开启但两者共用射频前端同时工作时会有时间片切换导致蓝牙延迟增大。如果只是用手机 App 调个转速蓝牙就够了功耗低、连接快。如果要接入 Home Assistant 或者自己搭的服务器那就用 Wi-Fi通过 MQTT 或者 HTTP 接口控制。我实测下来蓝牙和 Wi-Fi 同时开的时候Wi-Fi 吞吐量会下降 30% 左右蓝牙音频这种对延迟敏感的应用会卡顿。但风扇控制只是发几个字节的指令影响不大。如果你追求稳定可以做一个模式切换配网时开蓝牙配网完成后关蓝牙只开 Wi-Fi。5. 调试过程中最容易踩的五个坑5.1 电机抖动但不转极对数和线序排查电机抖动但不转九成是极对数填错或者三相线序不对。排查方法先确认极对数再交换任意两相线看是否反转。如果交换后能转但方向不对就在代码里把motor.motion_downsample或者速度符号取反。还有一种可能是霍尔状态表不对这个要用逻辑分析仪抓波形确认。5.2 电流采样噪声大ADC 参考电压与滤波ESP32 的 ADC 线性度一般特别是靠近 0V 和 3.3V 的区域。电流采样信号如果直接接 ADC噪声会很大。解决办法一是加 RC 低通滤波截止频率设 1kHz 左右二是用外部 ADC 比如 ADS111516 位精度I2C 接口比 ESP32 内置的好很多。SimpleFOC 支持外部电流传感器配置一下就行。5.3 串口打印导致 FOC 循环超时调试的时候喜欢在loop()里加Serial.print但串口打印很耗时115200 波特率下打印一行要 1ms 左右。FOC 循环要求 1kHz 以上也就是 1ms 以内完成一次串口打印直接就把循环拖慢了。表现就是电机转速上不去或者抖动。解决办法用Serial.printf代替多次print或者把调试信息缓存起来每 100 次循环打印一次。5.4 电源纹波导致霍尔误触发电机 PWM 开关会在电源线上产生尖峰如果霍尔传感器的电源和电机共用尖峰可能让霍尔误触发表现就是转速显示跳变。解决办法霍尔传感器单独用 LDO 供电或者在霍尔电源脚加 100nF 加 10uF 的退耦电容。5.5 蓝牙连接不稳定天线布局与波特率ESP32 的 PCB 天线对周围金属很敏感如果驱动板离天线太近蓝牙信号会变差。布局的时候天线区域要净空不要铺铜也不要走线。另外蓝牙串口的波特率不要设太高115200 足够设 921600 反而容易丢包。6. 完整代码结构与关键参数注释6.1 主程序框架#include SimpleFOC.h #include OneWire.h #include DallasTemperature.h #define POLE_PAIRS 7 #define VOLTAGE_SUPPLY 12.0 #define VOLTAGE_LIMIT 6.0 #define TARGET_RPM_MAX 3000 BLDCMotor motor BLDCMotor(POLE_PAIRS); BLDCDriver3PWM driver BLDCDriver3PWM(25, 26, 27, 14); HallSensor sensor HallSensor(34, 35, 32, POLE_PAIRS); OneWire oneWire(4); DallasTemperature sensors(oneWire); float targetRPM 0; void setup() { Serial.begin(115200); sensor.init(); motor.linkSensor(sensor); driver.voltage_power_supply VOLTAGE_SUPPLY; driver.init(); motor.linkDriver(driver); motor.voltage_limit VOLTAGE_LIMIT; motor.controller MotionControlType::velocity; motor.PID_velocity.P 0.3; motor.PID_velocity.I 3.0; motor.PID_velocity.D 0.0; motor.LPF_velocity.Tf 0.05; motor.init(); motor.initFOC(); sensors.begin(); } void loop() { motor.loopFOC(); static unsigned long lastTempRead 0; if (millis() - lastTempRead 1000) { sensors.requestTemperatures(); float temp sensors.getTempCByIndex(0); targetRPM constrain(map(temp, 25, 40, 1000, TARGET_RPM_MAX), 0, TARGET_RPM_MAX); lastTempRead millis(); } motor.move(targetRPM); }6.2 关键参数整定经验速度环 P 值决定响应速度太大电机会震荡太小转速上不去。我的经验是从 0.1 开始试每次加 0.1直到电机开始有轻微震荡然后退回到震荡前的值。I 值消除稳态误差风扇这种负载 I 值可以大一点3 到 5 都行。低通滤波 Tf 设 0.05 到 0.1太小滤波效果不够太大响应变慢。电流环参数一般不用动SimpleFOC 的默认值对大多数小电机都适用。但如果你的电机电感特别小比如无人机电机电流环带宽要调高否则电流跟踪不上。这时候要改motor.PID_current_q.P和motor.PID_current_d.P具体值要看电机参数。6.3 串口调试与上位机波形观察SimpleFOC 有配套的上位机软件 SimpleFOCStudio可以通过串口实时看转速、电流、电压波形。用法是在代码里加motor.useMonitoring(Serial)然后在上位机里选对应的串口和波特率。这个工具对调 PID 很有帮助能看到阶跃响应和超调量。如果不想用上位机也可以在串口里打印 CSV 格式的数据然后用 Excel 或者 Python 画图。打印格式建议是target,actual,current每行三个数用逗号分隔。注意打印频率不要太高10Hz 就够了太高会影响 FOC 循环。7. 从风扇到更复杂的应用扩展7.1 加入位置控制做定向送风风扇加上位置控制就能做定向送风比如跟着人走。这时候需要更高精度的位置传感器霍尔不够用要上 AS5600 磁编码器I2C 接口12 位分辨率。SimpleFOC 支持 AS5600配置一下就行。位置控制的 PID 参数和速度环不同P 要小一些因为位置环对超调更敏感。7.2 多电机同步与 CAN 总线如果要做一个风扇阵列每个风扇独立控制那就需要多路 FOC。ESP32 有两个 MCPWM 模块理论上可以驱动两个电机但引脚资源紧张。更好的方案是用 CAN 总线每个风扇一个 ESP32 节点通过 CAN 接收转速指令。ESP32 自带 CAN 控制器加一个收发器比如 TJA1050 就行。7.3 接入 Home Assistant 的 MQTT 方案用 ESP32 的 Wi-Fi 连 MQTT 服务器把温度、转速、电流这些数据发布出去同时订阅控制主题。Home Assistant 里配置 MQTT 风扇实体就能在界面上控制。代码里用 PubSubClient 库注意 MQTT 的 keepalive 时间要设长一点因为 FOC 循环会占用 CPU网络任务可能被延迟。我在实际项目里发现ESP32 同时跑 FOC 和 MQTT 的时候Wi-Fi 任务优先级要调低否则会打断 FOC 循环。FreeRTOS 里把 FOC 任务优先级设成 5Wi-Fi 任务设成 3这样 FOC 不会被网络任务抢占。另外 MQTT 发布频率不要太高1Hz 足够了风扇状态变化没那么快。最后分享一个我踩过的坑ESP32 的 GPIO 34 到 39 是只输入引脚没有内部上拉如果霍尔传感器接在这些引脚上必须外加上拉电阻。我一开始不知道霍尔信号一直是浮空的电机转起来转速显示乱跳查了半天才发现是引脚选错了。后来换成 GPIO 32 和 33问题就解决了。选引脚的时候一定要看数据手册别凭感觉。
ESP32无刷电机FOC驱动实战：SimpleFOC从选型到智能风扇落地
无刷电机这东西玩过航模的朋友应该都不陌生扭矩大、效率高、寿命长但真要自己写代码把它转起来很多人第一步就卡住了——六步换向能凑合转可噪音大、低速抖动、效率还低。FOC磁场定向控制就是来解决这个问题的它把三相电流解耦成励磁分量和转矩分量让电机像直流电机一样好控制同时保留无刷电机的高效率。ESP32 这颗芯片做 FOC 有天然优势双核 240MHz、硬件 MCPWM 模块、自带 Wi-Fi 和蓝牙做智能风扇这种需要联网控制的项目再合适不过。SimpleFOC 库把 FOC 的数学部分封装好了你不需要自己推导 Park 变换和 Clarke 变换但前提是你得把硬件接线、传感器校准、电流采样这几件事搞明白否则库再好也转不起来。这篇内容适合有 Arduino 基础、想从零搭一套无刷电机驱动系统的朋友我会把从选型到代码落地的完整链路拆开讲包括那些文档里不会写的坑。1. 先搞清楚你要驱动的是什么电机1.1 无刷电机的三相绕组与霍尔/无感方案无刷电机分内转子和外转子智能风扇一般用外转子因为扇叶可以直接固定在转子上省掉传动结构。三相绕组按星形或三角形连接星形接法更常见因为它的反电动势波形更接近正弦适合 FOC 控制。每相绕组的电阻通常在几欧姆到几十欧姆之间具体看电机功率。霍尔传感器方案是最容易上手的三个霍尔元件按 120 度电角度分布输出六种状态组合对应转子的六个扇区。SimpleFOC 支持霍尔传感器作为位置反馈精度虽然不如编码器但对于风扇这种负载变化不大的场景完全够用。无感方案无霍尔靠反电动势过零检测或者滑模观测器来估算转子位置省掉了传感器线但低速时反电动势太小估算不准启动需要开环强拖。如果你做的是智能风扇转速范围通常在 500 到 3000 RPM霍尔方案在这个区间表现稳定调试也简单。注意买电机的时候一定要确认霍尔传感器的输出类型开漏输出需要外接上拉电阻推挽输出可以直接接。很多便宜电机不标这个参数买回来发现接上没信号就是这个问题。1.2 极对数这个参数千万别填错极对数是 FOC 里最容易被忽略但影响最大的参数。它指的是转子永磁体磁极的对数比如 7 对极的电机转子转一圈电角度变化 7 个周期。SimpleFOC 里motor.pole_pairs这个参数如果填错电机会转但方向乱、力矩小、发热严重。怎么确认极对数最笨但最可靠的办法是手动转转子一圈用示波器看某一相的反电动势波形数完整正弦波的数量。没有示波器的话可以拆开电机数磁钢磁钢数量除以 2 就是极对数。比如 14 片磁钢就是 7 对极。我见过有人把 7 对极填成 14结果电机转起来像得了帕金森电流直接飙到限流值。1.3 电流采样单电阻、双电阻还是三电阻FOC 需要知道三相电流才能做闭环控制。采样方案有三种单电阻采样成本最低但需要在特定 PWM 状态下采样算法复杂双电阻采样是折中方案采两相推算第三相三电阻采样最直接每相一个采样电阻但成本最高。对于智能风扇这种低压小功率场景我推荐用集成电流采样的驱动芯片比如 DRV8313 或者 L6234它们内部集成了电流检测和放大电路输出模拟电压给 ESP32 的 ADC 读取。如果你用分立 MOS 管搭驱动那就要自己加采样电阻和运放这时候要注意运放的共模抑制比和带宽带宽不够会导致电流波形失真FOC 效果大打折扣。2. ESP32 与 SimpleFOC 的硬件搭配2.1 驱动板选型从 L6234 到 DRV8313L6234 是三半桥驱动芯片最大电流 5A工作电压 7 到 52V自带使能引脚和方向控制适合小功率云台电机。它的缺点是导通电阻较大大电流下发热明显需要加散热片。DRV8313 也是三半桥但集成了电流采样放大器和过流保护最大电流 2.5A适合更小的电机。如果你要驱动风扇这种需要持续运转的场景建议留足余量选额定电流两倍于电机工作电流的驱动板。ESP32 和驱动板的连接要注意电平匹配。ESP32 的 GPIO 是 3.3V 逻辑L6234 的输入高电平阈值是 2.3V 左右直接连没问题。但有些驱动板是 5V 逻辑那就需要电平转换否则 ESP32 输出高电平时驱动板可能识别不到。我一般会在原理图阶段就确认好逻辑电平避免后面飞线。2.2 电源设计别让电机把 ESP32 拉复位电机启动瞬间电流是额定电流的 3 到 5 倍如果电源功率不够电压会被拉低ESP32 的欠压复位就会触发表现就是电机一启动 ESP32 就重启。解决办法有两个一是电源留足余量比如电机额定 12V 2A电源至少选 12V 5A二是在电机电源和 ESP32 电源之间加 LC 滤波电感选 100uH 以上电容选 470uF 以上把电机产生的纹波滤掉。还有一个坑是共地问题。驱动板和 ESP32 必须共地否则 PWM 信号没有参考电平电机要么不转要么乱转。但共地之后电机的开关噪声会通过地线串到 ESP32 的 ADC 上影响电流采样精度。我的做法是用星形接地电源地、驱动地、控制地分别走线最后在电源入口处单点汇合。2.3 霍尔传感器接口与上拉电阻计算霍尔传感器输出通常是开漏的需要上拉到 3.3V 或 5V。上拉电阻的取值要考虑两个因素一是功耗二是上升沿时间。电阻越小上升沿越快但功耗越大。对于 3.3V 系统4.7k 到 10k 是常用值。如果电机转速很高霍尔信号频率可能到几十 kHz这时候上升沿时间要控制在 1us 以内电阻就要选小一些。计算上升沿时间的公式是 t 2.2 × R × C其中 C 是线路电容加上霍尔输出电容通常 20pF 左右。以 10k 电阻为例t 2.2 × 10000 × 20e-12 0.44us满足要求。如果线缆很长电容会增大这时候要么减小电阻要么加施密特触发器整形。3. SimpleFOC 库的配置与校准流程3.1 安装库与依赖项在 Arduino IDE 里安装 SimpleFOC 很简单库管理器搜索 SimpleFOC 就能找到。但要注意版本2.3.x 和 2.4.x 的 API 有变化网上很多教程是旧版本的直接抄会编译报错。我建议用 2.4.0 以上版本因为新版本对 ESP32 的支持更好特别是 MCPWM 的配置更稳定。除了 SimpleFOC 本身还需要安装 ESP32 的 Arduino 核心版本建议 2.0.14 以上。安装完之后在开发板管理器里选 ESP32 Dev ModuleFlash 模式选 QIO分区方案选 Default 4MB with spiffs。这些设置影响 PWM 频率的稳定性别用默认的 DIO 模式实测下来 QIO 的 PWM 抖动更小。3.2 开环测试先让电机转起来再说在接传感器之前先做开环测试确认驱动板和电机接线没问题。开环测试就是给定一个固定的电压矢量让电机以设定的速度旋转不依赖任何位置反馈。代码很简单#include SimpleFOC.h BLDCMotor motor BLDCMotor(7); BLDCDriver3PWM driver BLDCDriver3PWM(25, 26, 27, 14); void setup() { driver.voltage_power_supply 12; driver.init(); motor.linkDriver(driver); motor.voltage_limit 6; motor.init(); motor.initFOC(); } void loop() { motor.loopFOC(); motor.move(2.0); }这段代码里BLDCMotor(7)的 7 就是极对数BLDCDriver3PWM的四个参数分别是三相 PWM 引脚和使能引脚。voltage_limit设成电源电压的一半防止电流过大。开环测试时电机会有轻微抖动这是正常的因为电压矢量是固定的没有根据转子位置调整。提示开环测试时如果电机不转先检查使能引脚有没有拉高再检查三相线序。任意交换两相线电机就会反转这个可以用来验证接线。3.3 霍尔传感器校准与电角度对齐霍尔传感器装上去之后需要校准电角度偏移。SimpleFOC 提供了motor.initFOC()函数它会自动完成对齐。但前提是霍尔传感器的状态表要正确。每个电机的霍尔安装位置不同状态表也不同。SimpleFOC 默认的状态表是 1-3-2-6-4-5如果你的电机不是这个顺序就要手动改。校准步骤是这样的先把电机转到任意位置调用motor.initFOC()库会依次给三相通电记录霍尔状态变化然后计算偏移量。如果校准失败串口会打印错误信息常见的是“霍尔状态无效”这时候就要检查霍尔接线或者状态表。我遇到过一种情况霍尔传感器是好的但状态表顺序不对电机能转但效率很低电流比正常值大 30%。后来用逻辑分析仪抓了霍尔波形发现状态顺序是 1-5-4-6-2-3改过来之后电流就正常了。所以校准这一步不能省也不能想当然。4. 智能风扇的闭环控制逻辑4.1 速度环与电流环的串级结构智能风扇的核心是恒转速控制不管风阻怎么变转速要稳定。SimpleFOC 支持三种控制模式力矩控制、速度控制、位置控制。风扇用速度控制就够了。速度环的输入是目标转速输出是转矩电流然后电流环再把这个电流转换成电压矢量。串级结构的好处是响应快、抗干扰强。外环速度环带宽低内环电流环带宽高一般电流环带宽是速度环的 5 到 10 倍。SimpleFOC 里配置速度环 PID 的参数是motor.PID_velocity.P、I、D还有motor.LPF_velocity.Tf低通滤波时间常数。风扇这种负载P 设 0.2 到 0.5I 设 2 到 5D 设 0 就行因为风扇没有突变负载不需要微分项。4.2 温度传感器接入与自动调速智能风扇的“智能”体现在根据温度自动调速。ESP32 接 DS18B20 或者 DHT22 都很方便DS18B20 是单总线精度高适合测环境温度。接线就三根VCC、GND、DATADATA 接一个 4.7k 上拉到 3.3V。调速逻辑可以很简单温度低于 25 度转速 025 到 30 度转速 1000 RPM30 到 35 度转速 2000 RPM高于 35 度转速 3000 RPM。中间用线性插值避免转速突变。代码里用一个map()函数就能搞定float temp sensors.getTempCByIndex(0); float targetRPM map(temp, 25, 40, 1000, 3000); targetRPM constrain(targetRPM, 0, 3000); motor.move(targetRPM);这里要注意map()函数的输入是整数温度是浮点数的话要先转成整数或者自己写一个浮点版本的映射函数。4.3 蓝牙与 Wi-Fi 双模控制的取舍ESP32 支持蓝牙和 Wi-Fi 同时开启但两者共用射频前端同时工作时会有时间片切换导致蓝牙延迟增大。如果只是用手机 App 调个转速蓝牙就够了功耗低、连接快。如果要接入 Home Assistant 或者自己搭的服务器那就用 Wi-Fi通过 MQTT 或者 HTTP 接口控制。我实测下来蓝牙和 Wi-Fi 同时开的时候Wi-Fi 吞吐量会下降 30% 左右蓝牙音频这种对延迟敏感的应用会卡顿。但风扇控制只是发几个字节的指令影响不大。如果你追求稳定可以做一个模式切换配网时开蓝牙配网完成后关蓝牙只开 Wi-Fi。5. 调试过程中最容易踩的五个坑5.1 电机抖动但不转极对数和线序排查电机抖动但不转九成是极对数填错或者三相线序不对。排查方法先确认极对数再交换任意两相线看是否反转。如果交换后能转但方向不对就在代码里把motor.motion_downsample或者速度符号取反。还有一种可能是霍尔状态表不对这个要用逻辑分析仪抓波形确认。5.2 电流采样噪声大ADC 参考电压与滤波ESP32 的 ADC 线性度一般特别是靠近 0V 和 3.3V 的区域。电流采样信号如果直接接 ADC噪声会很大。解决办法一是加 RC 低通滤波截止频率设 1kHz 左右二是用外部 ADC 比如 ADS111516 位精度I2C 接口比 ESP32 内置的好很多。SimpleFOC 支持外部电流传感器配置一下就行。5.3 串口打印导致 FOC 循环超时调试的时候喜欢在loop()里加Serial.print但串口打印很耗时115200 波特率下打印一行要 1ms 左右。FOC 循环要求 1kHz 以上也就是 1ms 以内完成一次串口打印直接就把循环拖慢了。表现就是电机转速上不去或者抖动。解决办法用Serial.printf代替多次print或者把调试信息缓存起来每 100 次循环打印一次。5.4 电源纹波导致霍尔误触发电机 PWM 开关会在电源线上产生尖峰如果霍尔传感器的电源和电机共用尖峰可能让霍尔误触发表现就是转速显示跳变。解决办法霍尔传感器单独用 LDO 供电或者在霍尔电源脚加 100nF 加 10uF 的退耦电容。5.5 蓝牙连接不稳定天线布局与波特率ESP32 的 PCB 天线对周围金属很敏感如果驱动板离天线太近蓝牙信号会变差。布局的时候天线区域要净空不要铺铜也不要走线。另外蓝牙串口的波特率不要设太高115200 足够设 921600 反而容易丢包。6. 完整代码结构与关键参数注释6.1 主程序框架#include SimpleFOC.h #include OneWire.h #include DallasTemperature.h #define POLE_PAIRS 7 #define VOLTAGE_SUPPLY 12.0 #define VOLTAGE_LIMIT 6.0 #define TARGET_RPM_MAX 3000 BLDCMotor motor BLDCMotor(POLE_PAIRS); BLDCDriver3PWM driver BLDCDriver3PWM(25, 26, 27, 14); HallSensor sensor HallSensor(34, 35, 32, POLE_PAIRS); OneWire oneWire(4); DallasTemperature sensors(oneWire); float targetRPM 0; void setup() { Serial.begin(115200); sensor.init(); motor.linkSensor(sensor); driver.voltage_power_supply VOLTAGE_SUPPLY; driver.init(); motor.linkDriver(driver); motor.voltage_limit VOLTAGE_LIMIT; motor.controller MotionControlType::velocity; motor.PID_velocity.P 0.3; motor.PID_velocity.I 3.0; motor.PID_velocity.D 0.0; motor.LPF_velocity.Tf 0.05; motor.init(); motor.initFOC(); sensors.begin(); } void loop() { motor.loopFOC(); static unsigned long lastTempRead 0; if (millis() - lastTempRead 1000) { sensors.requestTemperatures(); float temp sensors.getTempCByIndex(0); targetRPM constrain(map(temp, 25, 40, 1000, TARGET_RPM_MAX), 0, TARGET_RPM_MAX); lastTempRead millis(); } motor.move(targetRPM); }6.2 关键参数整定经验速度环 P 值决定响应速度太大电机会震荡太小转速上不去。我的经验是从 0.1 开始试每次加 0.1直到电机开始有轻微震荡然后退回到震荡前的值。I 值消除稳态误差风扇这种负载 I 值可以大一点3 到 5 都行。低通滤波 Tf 设 0.05 到 0.1太小滤波效果不够太大响应变慢。电流环参数一般不用动SimpleFOC 的默认值对大多数小电机都适用。但如果你的电机电感特别小比如无人机电机电流环带宽要调高否则电流跟踪不上。这时候要改motor.PID_current_q.P和motor.PID_current_d.P具体值要看电机参数。6.3 串口调试与上位机波形观察SimpleFOC 有配套的上位机软件 SimpleFOCStudio可以通过串口实时看转速、电流、电压波形。用法是在代码里加motor.useMonitoring(Serial)然后在上位机里选对应的串口和波特率。这个工具对调 PID 很有帮助能看到阶跃响应和超调量。如果不想用上位机也可以在串口里打印 CSV 格式的数据然后用 Excel 或者 Python 画图。打印格式建议是target,actual,current每行三个数用逗号分隔。注意打印频率不要太高10Hz 就够了太高会影响 FOC 循环。7. 从风扇到更复杂的应用扩展7.1 加入位置控制做定向送风风扇加上位置控制就能做定向送风比如跟着人走。这时候需要更高精度的位置传感器霍尔不够用要上 AS5600 磁编码器I2C 接口12 位分辨率。SimpleFOC 支持 AS5600配置一下就行。位置控制的 PID 参数和速度环不同P 要小一些因为位置环对超调更敏感。7.2 多电机同步与 CAN 总线如果要做一个风扇阵列每个风扇独立控制那就需要多路 FOC。ESP32 有两个 MCPWM 模块理论上可以驱动两个电机但引脚资源紧张。更好的方案是用 CAN 总线每个风扇一个 ESP32 节点通过 CAN 接收转速指令。ESP32 自带 CAN 控制器加一个收发器比如 TJA1050 就行。7.3 接入 Home Assistant 的 MQTT 方案用 ESP32 的 Wi-Fi 连 MQTT 服务器把温度、转速、电流这些数据发布出去同时订阅控制主题。Home Assistant 里配置 MQTT 风扇实体就能在界面上控制。代码里用 PubSubClient 库注意 MQTT 的 keepalive 时间要设长一点因为 FOC 循环会占用 CPU网络任务可能被延迟。我在实际项目里发现ESP32 同时跑 FOC 和 MQTT 的时候Wi-Fi 任务优先级要调低否则会打断 FOC 循环。FreeRTOS 里把 FOC 任务优先级设成 5Wi-Fi 任务设成 3这样 FOC 不会被网络任务抢占。另外 MQTT 发布频率不要太高1Hz 足够了风扇状态变化没那么快。最后分享一个我踩过的坑ESP32 的 GPIO 34 到 39 是只输入引脚没有内部上拉如果霍尔传感器接在这些引脚上必须外加上拉电阻。我一开始不知道霍尔信号一直是浮空的电机转起来转速显示乱跳查了半天才发现是引脚选错了。后来换成 GPIO 32 和 33问题就解决了。选引脚的时候一定要看数据手册别凭感觉。
