平衡车无刷轮毂电机 FOC 开源固件(hoverboard-firmware-hack-FOC)
本项目为市售两轮平衡车的原厂主控板提供一套开源磁场定向控制(FOC)固件。原厂固件用六步换相驱动电机,本固件改用 FOC 后噪声与振动明显降低,输出转矩更平顺、电机效率更高因而更省电,并可通过弱磁(相位超前)进一步拓宽最高转速区间。固件运行在 STM32F103RCT6(部分主板为 GD32F103RCT6)上,支持换相、正弦、FOC 三种控制方式,FOC 下可选电压、转速、转矩三种闭环模式;提供 ADC 电位器、串口、Wii 手柄、PPM/PWM/iBUS 遥控、Hovercar 卡丁车、TranspOtter、滑板车等 10 种输入变体,可用 Makefile、PlatformIO、Keil MDK 三种工程直接编译烧录,并附带一份 Arduino 串口控制示例。
标签 | 电机控制 / FOC / STM32 / 开源固件 / 平衡车 / 无刷直流电机 |
开源协议 | GPL-3.0 |
Star 数 | 1852(截至 2026-11-20) |
文件大小 | 解压后 88.86 MB(约 89 兆字节),共 619 个文件;压缩包 38.39 MB(约 38 兆字节) |
适用硬件 | 双轮平衡车主控板(STM32F103RCT6 / GD32F103RCT6)+ 带霍尔的轮毂电机 |
详细介绍
总述
把一台平衡车拆开,里面是一块六边形的双电机主控板:一颗 STM32F103RCT6 同时驱动左右两个带霍尔传感器的无刷轮毂电机,板载 XT60 主电源输入、充电检测、母线电流采样,原厂通过两根 4 芯侧板线把按键、电量与状态灯引到两侧的侧板上。本仓库把这套硬件上的固件整体重写,用 FOC(磁场定向控制)取代原厂的六步换相,并保留了对原始硬件的完整兼容——不改一块硬件,只换固件就能让平衡车、卡丁车、滑板车这类改装车跑得更安静、更省电。
源码附带主控板逆向工程原理图、STM32/GD32 数据手册与电机资料,控制参数以定点数形式给出并附已标定好的控制器,所有可调参数集中在 Inc/config.h 与 Src/BLDC_controller_data.c 两个文件里。
一、核心特性
噪声与振动更低:相比六步换相,FOC 消除了换相时刻的转矩脉动,电机运行明显更安静。
转矩输出平顺、效率更高:同样的负载下电流更小,续航更长,电机发热更低。
支持弱磁 / 相位超前:在高速段注入 d 轴电流,突破反电动势限制,拓宽最高转速区间。
三种控制方式:换相(COM_CTRL)、正弦(SIN_CTRL)、FOC(FOC_CTRL,出厂默认)。
FOC 三种闭环模式:电压模式、转速模式、转矩模式,用 config.h 里的 CTRL_MOD_REQ 切换。
全模式保护:最大电机转速与最大电机电流限制,适合机器人等对安全性有要求的场景。
自由滑行与电刹车:转矩模式下目标转矩为 0 时电机可自由滑行,也可开启电刹车替代滑行。
静止保持:开启 STANDSTILL_HOLD_ENABLE 后可在静止时锁住位置。
10 种输入变体:一套代码适配电位器、串口、Wii 手柄、PPM/PWM/iBUS 遥控、卡丁车、滑板车等改装形态。
三种工程开箱即用:Makefile(arm-none-eabi-gcc + st-flash)、PlatformIO、Keil MDK-ARM,另附 Arduino 示例。
二、硬件资源信息
2.1 主控板概况
主控芯片:STM32F103RCT6(ARM Cortex-M3),部分主板为 GD32F103RCT6,本固件同样支持。
两路 4 芯侧板线(原本接左右侧板),引出 GND、12/15V 与 USART2、USART3。
USART2、USART3 均支持 UART、PWM、PPM、iBUS 输入;USART2 可作 12 位 ADC 使用,USART3 可作 I2C 使用。
电平注意:USART3(右侧短线)5V 耐受,USART2(左侧长线)不耐 5V。
PWM 载波 16 kHz(同时用作蜂鸣器),死区时间 48 个计数。
电池按 10S 铅酸/锂电(标称 36V 级)标定,母线电压与电流均有采样。
2.2 主控板接口定义
接口 / 功能 | 引脚 | 说明 |
|---|---|---|
电源按键 | PA1 / PA5 | PA1 按键输入,PA5 自锁(Latch)控制 |
左电机相线 | PA0 / PC3 | A 相 / B 相,第三相为公共端 |
右电机相线 | PC4 / PC5 | B 相 / C 相 |
直流母线电流 | PC0 / PC1 | 左电机 / 右电机电流采样 |
左霍尔接口 | HALL A/B/C | 5V 供电,限流 100mA |
右霍尔接口 | HALL A/B/C | 5V 供电,限流 100mA |
左侧板线(长线) | PA2 / PA3 | USART2:TX+ADC1 / RX+ADC2,可输出 PWM1、PWM2、PPM、iBUS;15V 200mA;不耐 5V |
右侧板线(短线) | PB10 / PB11 | USART3:TX+SCL / RX+SDA,可输出 PWM1、PWM2、PPM、iBUS;15V 200mA;5V 耐受 |
充电检测 | PA12 | 充电器插入检测 |
SWD 调试口 | PA13 / PA14 | SWDIO / SWCLK,3.3V 供电,限流 30mA |
主电源输入 | XT60 | 电池接入 |
图 2 主控板接口与引脚定义(原厂板实物标注)
图为原厂主控板实物标注:左右两侧青色线为霍尔线,黄/蓝/绿三根粗线为电机相线,底部排针为两根侧板线的引出脚,右上角为 XT60 主电源与 SWD 调试口。
2.3 轮毂电机
参数 | 数值 |
|---|---|
极槽配合 | 27 槽 30 极(27N30P) |
KV 值 | 15.98 rpm/V |
定子质量 | 3146 g |
转动惯量 | 7.01 g·m² |
绕线方式 | 13.5 匝,4 股并绕 |
漆包线线径 | 0.5 mm |
位置反馈 | 3 个开关型霍尔(HALL A/B/C) |
图 3 拆开的轮毂电机:外转子磁钢、定子绕组与霍尔板
图 4 27N30P 定子绕线与三相引出方式示意
三、控制方式
3.1 三种控制类型
在 Inc/config.h 中用 CTRL_TYP_SEL 选择控制类型,出厂默认为 FOC_CTRL:
COM_CTRL 六步换相,与原厂方案一致,实现最简单,平顺性最差。
SIN_CTRL 正弦波驱动,电流连续,噪声与振动低于换相,可用相位超前提速。
FOC_CTRL 磁场定向控制(默认),d/q 轴解耦,效率与平顺性最好,支持三种闭环模式。
3.2 FOC 的三种闭环模式
在 FOC 控制下,用 CTRL_MOD_REQ 选择闭环目标:
VLT_MODE(电压模式,出厂默认):控制器向电机施加恒定电压。适合机器人等需要快速响应的场合。
SPD_MODE(转速模式):闭环跟随输入的转速目标(RPM),能抑制负载扰动。适合机器人、定速巡航类应用。
TRQ_MODE(转矩模式):闭环跟随输入的转矩目标;目标为 0 时电机可自由滑行。适合有人乘坐的大多数场景。
3.3 各控制方式对比
控制方式 | 复杂度 | 效率 | 平顺性 | 弱磁 | 自由滑行 | 静止保持 |
|---|---|---|---|---|---|---|
换相 COM | - | - | ++ | 不适用 | 不适用 | + |
正弦 SIN | + | ++ | ++ | +++ | 不适用 | + |
FOC 电压模式 | ++ | +++ | ++ | ++ | 不适用 | +(需开启静止保持) |
FOC 转速模式 | +++ | +++ | + | ++ | 不适用 | +++ |
FOC 转矩模式 | +++ | +++ | +++ | ++ | +++(可换电刹车) | 不适用(需开启静止保持) |
(表中“+++”表示最优。转矩模式的自由滑行量可用 ELECTRIC_BRAKE_MAX 调整;所有 FOC 模式均带最大转速与最大电流保护。)
3.4 弱磁 / 相位超前
弱磁默认关闭,在 config.h 中把 FIELD_WEAK_ENA 置 1 开启。介入过程为线性插值:输入目标从 FIELD_WEAK_LO(默认 750)开始注入,到 FIELD_WEAK_HI(默认 1000)达到最大值 FIELD_WEAK_MAX(默认 5A;10 寸轮上测试到 10A)。选择正弦控制时对应的是相位超前 PHASE_ADV_MAX。
图 5 弱磁强度随输入目标变化的三种标定方式
⚠️ 重新标定弱磁前请做好全部安全措施:电机可能转得极快,功耗会大幅上升,并可能触发电池 BMS 的过压保护。
四、例程变体
同一套代码通过编译宏切换输入方式,覆盖常见的平衡车改装形态:
变体 | 控制输入 | 说明 |
|---|---|---|
VARIANT_ADC | 两个电位器接左侧板线 | 最简的模拟量控制,适合快速验证驱动是否正常 |
VARIANT_USART | 串口协议(右侧板线 USART3) | 可由 Arduino 或上位机发指令,附 hoverserial 示例 |
VARIANT_NUNCHUK | Wii 双节棍手柄 | 单手控制油门、刹车与转向 |
VARIANT_PPM | 航模遥控 PPM 汇总信号 | 单线传输多通道 |
VARIANT_PWM | 航模遥控 PWM 信号 | 常规单通道 PWM |
VARIANT_IBUS | 富斯 iBUS 协议(左侧板线) | 富斯接收机直连 |
VARIANT_HOVERCAR | 双踏板:油门 + 刹车 | 静止时双击刹车进入倒车,可选巡航控制 |
VARIANT_HOVERBOARD | 读取左右侧板数据 | 侧板需刷 hacked 固件;平衡控制器尚未实现 |
VARIANT_TRANSPOTTER | TranspOtter 车体 | 平衡车改装的四轮运输平台 |
VARIANT_SKATEBOARD | 遥控 PWM(右侧板线) | 滑板 / 滑板车改装 |
图 6 使用 VARIANT_HOVERCAR 变体改装的卡丁车
五、编译与烧录
方式 | 入口文件 | 说明 |
|---|---|---|
Makefile + arm-none-eabi-gcc | Makefile | make 生成 elf/hex/bin,make flash 通过 st-flash 写入 0x8000000 |
PlatformIO | platformio.ini | 取消注释 default_envs 选择变体,一键编译下载 |
Keil MDK-ARM | MDK-ARM/mainboard-hack.uvprojx | 在 Target 下拉框选择变体后编译 |
Arduino 示例 | Arduino/hoverserial/hoverserial.ino | 上位机串口发指令的参考代码 |
烧录工具为 ST-Link(SWD)。若芯片被读保护,可用 openocd 执行 stm32f1x unlock 解锁后再烧录。
六、项目目录与文件大小
目录 | 文件数 | 大小 |
|---|---|---|
Drivers(STM32 HAL 库与 CMSIS) | 542 | 55.38 MB(约 55 兆字节) |
docs(原理图、数据手册、电机资料、图片) | 35 | 32.62 MB(约 33 兆字节) |
Src(固件源码) | 13 | 0.34 MB(约 348 千字节) |
MDK-ARM(Keil 工程) | 3 | 0.28 MB(约 287 千字节) |
Inc(头文件与 config.h) | 12 | 0.15 MB(约 154 千字节) |
根目录(Makefile、链接脚本、README 等) | 8 | 0.07 MB(约 72 千字节) |
Arduino(串口示例) | 1 | 0.01 MB(约 10 千字节) |
.github(自动编译工作流) | 5 | 小于 0.01 MB |
合计 | 619 | 88.86 MB(约 89 兆字节) |
七、上传文件清单
文件 | 说明 | 大小 |
|---|---|---|
完整源码包(解压后即上表结构) | 38.39 MB(约 38 兆字节) | |
20150722_hoverboard_sch.pdf | 平衡车主控板逆向工程原理图 | 256.3 KB(约 0.25 兆字节) |
20190620_at32_hover_sch.pdf | AT32F403 主板的原理图 | 417.1 KB(约 0.41 兆字节) |
图1 ~ 图6(jpg / png) | 详情页配图,已按顺序编号 | 合计约 1.3 MB(约 1.35 兆字节) |
八、注意事项
VARIANT_HOVERBOARD 变体只实现了读取侧板数据,平衡控制算法尚未实现,不能直接当原厂固件用。
原厂侧板需要单独刷 hacked 固件才能与主板通信(分体式 split board 不在本固件支持范围内)。
左侧板线(USART2)不耐 5V,接入 5V 逻辑信号前务必做电平转换,否则可能损坏主控。
修改弱磁、最大电流、最大转速等参数后,请先在架空车轮的状态下验证,再落地骑行。
九、相关链接
上手与排障 Wiki:https://github.com/EFeru/hoverboard-firmware-hack-FOC/wiki
FOC 控制器设计(Simulink 模型):https://github.com/EFeru/bldc-motor-control-FOC
原始换相版固件:https://github.com/lucysrausch/hoverboard-firmware-hack
开源协议:GPL-3.0(衍生作品需同样开源)
