平衡车主板 FOC 固件改造全攻略hoverboard-firmware-hack-FOC 烧录与参数调优上手指南【免费下载链接】hoverboard-firmware-hack-FOCWith Field Oriented Control (FOC)项目地址: https://gitcode.com/GitHub_Trending/ho/hoverboard-firmware-hack-FOC是不是也遇到过这种情况平衡车起步一冲一冲电机嗡嗡作响爬坡明显没劲松了油门还滑出去老远其实问题不在车本身而在原厂固件只用了最基础的换相方式驱动电机。开源项目 hoverboard-firmware-hack-FOC 把磁场定向控制FOC算法塞进普通平衡车主板让扭矩输出更平滑、噪声更低、能耗更小还能解锁弱磁提速。一、先搞懂FOC 固件到底改了什么你可以这样理解换相控制就像用三档固定的硬油门轮流给三相线圈通电简单粗暴而 FOC 把电机电流拆成产生磁力和产生扭矩两个分量分别做闭环控制相当于给每个电机装了一个可以无级调节的电子油门。三种控制方式对比可通过 config.h 中的CTRL_TYP_SEL切换控制方式平顺度效率高速表现额外能力换相Commutation一般一般一般无正弦波Sinusoidal较好较好较好无FOC优秀优秀优秀弱磁提速、转速/扭矩闭环整条路线一句话认板子 → 解锁芯片 → 烧录固件 → 选输入变体 → 调 FOC 参数 → 架起车轮测试。二、动手前认出你的主板和每个接口这一步的目标刷写前确认三样东西——芯片、SWD 口、两条传感器线避免接错烧板。主芯片通常是STM32F103RCT6部分板子是GD32F103RCT6固件都支持。刷写前先把仓库克隆到本地后面所有改动都在这个克隆副本里做git clone https://gitcode.com/GitHub_Trending/ho/hoverboard-firmware-hack-FOCSWD 刷写口用 ST-Link V2 接入对应关系如下ST-Link 引脚主板位置SWDIOPA14SWCLKPA13GNDGND3.3V3.3V可选左右两条传感器线缆各 4 针内含 GND、12/15V 和 USART2左线/ USART3右线接遥控器、电位器、串口调试都靠它们。⚠️ 线缆里的红线是 15V 电源接 USB 转 TTL 或传感器时千万别用它另外左线USART2引脚不耐受 5V务必用 3.3V 电平的串口模块。三、刷写 FOC 固件解锁、擦除、写入三步走做完后你看到的ST-Link Utility 报 Verification OK重新上电电机不再按原厂逻辑换相。原厂主板大多开了读保护RDP不解除就没法写入分三步解除保护ST-Link Utility 菜单Target → Option Bytes...把 Read Out Protection 改为 Level 0 后 Apply擦除芯片Target → Erase Chip把原厂程序清空写入固件Program Verify选择编译好的.bin起始地址保持0x08000000等 Verification OK。固件文件有两种来源任选其一现成产物到项目的 Actions 构建页下载对应的.bin本地编译PlatformIO 下执行pio run -e VARIANT_USARTenv 名与变体一一对应产物在build/目录或用 Makefile 命令行编译make -e VARIANTVARIANT_ADC 习惯命令行解锁的话Makefile 里已内置make unlockopenocd 解除 RDP和make flashst-flash写入build/hover.bin前提是机器上装好了 openocd 与 st-flash。⚠️ 烧录地址别乱改RC 芯片固定从0x08000000开始不同容量芯片的芯片级擦除范围会有差异。四、选好输入变体告诉固件你打算怎么开这辆车做完后你看到的转动你的输入设备两个电机随之平滑加减速。固件内置 10 种输入变体只需在 platformio.ini选 env、Keil 工程的 Target 下拉菜单、或 config.h 中选中对应的VARIANT_*宏同一时间只能启用一个。变体输入方式接在哪典型场景VARIANT_ADC两个电位器左线自制遥控、电动小车VARIANT_USART串口指令左线/右线Arduino 或单片机控制VARIANT_NUNCHUKWii 手柄右线电动轮椅、搬运车VARIANT_PPMRC 遥控器 PPM右线遥控滑板VARIANT_PWMRC 遥控器 PWM右线遥控滑板VARIANT_IBUSFlySky iBUS右线遥控器改装VARIANT_HOVERCAR刹车油门双踏板左线踏板改造车VARIANT_HOVERBOARD保留侧板通信左右线原车姿态平衡控制未完成VARIANT_TRANSPOTTERGameTrak 方向杆左线运输小车VARIANT_SKATEBOARDRC PWM右线电动滑板烧录后如果电机转向和直觉相反在对应变体区打开INVERT_L_DIRECTION/INVERT_R_DIRECTION再编译一次即可。五、调一调 FOC 参数让它匹配你的用法打开 Inc/config.h重点看这四个参数CTRL_MOD_REQFOC 控制模式。机械臂、快速响应类项目选VLT_MODE电压模式要恒定转速抗负载选SPD_MODE人坐在上面代步选TRQ_MODE扭矩模式松输入自动滑行。注意SPD_MODE/TRQ_MODE只在 FOC 下可用I_MOT_MAX单电机最大电流A直接决定扭矩上限默认 15别超过电机和电池的承受范围N_MOT_MAX最大转速rpm默认 1000是你唯一的极速保险丝INVERT_L_DIRECTION/INVERT_R_DIRECTION左右电机转向修正变体区各有一份按需打开。进阶玩法——弱磁Field Weakening默认关闭把FIELD_WEAK_ENA设为 1 后固件会在高转速段向电机注入反向磁场分量从FIELD_WEAK_LO开始线性增强到FIELD_WEAK_HI达到FIELD_WEAK_MAX牺牲少量效率换取更高的转速上限。⚠️ 重新校准弱磁参数前一定架起车轮电机可能转得飞快功耗大幅上升甚至触发电池保护板BMS的过压保护。六、卡住了查这里现象可能原因处理方法ST-Link 报 Can not read memory读保护未解除按第三节步骤先解除 RDP电机抖动或尖叫电机参数与实际控制不匹配核对 Src/BLDC_controller_data.c 中已校准的电机参数不要乱改定点数值输入完全无响应变体选错或接错线缆对照第四节表格核对变体与左/右线一上电就自动关机电池电压校准不准按 config.h 中 BAT 区注释把万用表实测值与调试输出第 5 项写回BAT_CALIB_*编译时报 Variant not defined!没有选任何 VARIANT在 platformio.ini 或 config.h 里选一个变体通用调试手段在 config.h 中打开DEBUG_SERIAL_USART2左线或DEBUG_SERIAL_USART3右线用 3.3V USB 转串口接 GND 和 RX终端设115200 波特率就能实时看到输入值、左右指令cmdL/cmdR、电池电压BatV和温度多数问题一眼定位。 串口调试和输入设备若占用同一条线缆二者只能开一个——config.h 里的宏校验会在编译期直接拦住冲突。七、安全清单 还能玩什么刷写完成后的安全清单逐条过一遍第一次通电测试前架起车轮远离身体串口接线只用 GND 和 RX/TX红线 15V 别碰开弱磁前评估电机与电池余量先低速验证电池电压显示不对时重新标定BAT_CALIB_*别凭感觉改报警阈值。调顺之后还有不少可玩空间点到为止打开CRUISE_CONTROL_SUPPORT获得巡航定速在TRQ_MODE下启用ELECTRIC_BRAKE_ENABLE松油门自动缓刹而不是滑行试VARIANT_HOVERCAR双踏板改造双击刹车倒车配合MULTI_MODE_DRIVE三档驾驶模式卡丁车既视感接其他平台ROS、单片机可以从 Arduino/hoverserial/ 的串口示例入手。想真正弄懂 FOC就从 Src/BLDC_controller.c 和 Src/BLDC_controller_data.c 开始逐段读——从能转到懂原理这才是改造的最大乐趣 【免费下载链接】hoverboard-firmware-hack-FOCWith Field Oriented Control (FOC)项目地址: https://gitcode.com/GitHub_Trending/ho/hoverboard-firmware-hack-FOC创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/10/23 1:54:59 · 阅读 1.2k 平衡车主板 FOC 固件改造全攻略：hoverboard-firmware-hack-FOC 烧录与参数调优上手指南
平衡车主板 FOC 固件改造全攻略hoverboard-firmware-hack-FOC 烧录与参数调优上手指南【免费下载链接】hoverboard-firmware-hack-FOCWith Field Oriented Control (FOC)项目地址: https://gitcode.com/GitHub_Trending/ho/hoverboard-firmware-hack-FOC是不是也遇到过这种情况平衡车起步一冲一冲电机嗡嗡作响爬坡明显没劲松了油门还滑出去老远其实问题不在车本身而在原厂固件只用了最基础的换相方式驱动电机。开源项目 hoverboard-firmware-hack-FOC 把磁场定向控制FOC算法塞进普通平衡车主板让扭矩输出更平滑、噪声更低、能耗更小还能解锁弱磁提速。一、先搞懂FOC 固件到底改了什么你可以这样理解换相控制就像用三档固定的硬油门轮流给三相线圈通电简单粗暴而 FOC 把电机电流拆成产生磁力和产生扭矩两个分量分别做闭环控制相当于给每个电机装了一个可以无级调节的电子油门。三种控制方式对比可通过 config.h 中的CTRL_TYP_SEL切换控制方式平顺度效率高速表现额外能力换相Commutation一般一般一般无正弦波Sinusoidal较好较好较好无FOC优秀优秀优秀弱磁提速、转速/扭矩闭环整条路线一句话认板子 → 解锁芯片 → 烧录固件 → 选输入变体 → 调 FOC 参数 → 架起车轮测试。二、动手前认出你的主板和每个接口这一步的目标刷写前确认三样东西——芯片、SWD 口、两条传感器线避免接错烧板。主芯片通常是STM32F103RCT6部分板子是GD32F103RCT6固件都支持。刷写前先把仓库克隆到本地后面所有改动都在这个克隆副本里做git clone https://gitcode.com/GitHub_Trending/ho/hoverboard-firmware-hack-FOCSWD 刷写口用 ST-Link V2 接入对应关系如下ST-Link 引脚主板位置SWDIOPA14SWCLKPA13GNDGND3.3V3.3V可选左右两条传感器线缆各 4 针内含 GND、12/15V 和 USART2左线/ USART3右线接遥控器、电位器、串口调试都靠它们。⚠️ 线缆里的红线是 15V 电源接 USB 转 TTL 或传感器时千万别用它另外左线USART2引脚不耐受 5V务必用 3.3V 电平的串口模块。三、刷写 FOC 固件解锁、擦除、写入三步走做完后你看到的ST-Link Utility 报 Verification OK重新上电电机不再按原厂逻辑换相。原厂主板大多开了读保护RDP不解除就没法写入分三步解除保护ST-Link Utility 菜单Target → Option Bytes...把 Read Out Protection 改为 Level 0 后 Apply擦除芯片Target → Erase Chip把原厂程序清空写入固件Program Verify选择编译好的.bin起始地址保持0x08000000等 Verification OK。固件文件有两种来源任选其一现成产物到项目的 Actions 构建页下载对应的.bin本地编译PlatformIO 下执行pio run -e VARIANT_USARTenv 名与变体一一对应产物在build/目录或用 Makefile 命令行编译make -e VARIANTVARIANT_ADC 习惯命令行解锁的话Makefile 里已内置make unlockopenocd 解除 RDP和make flashst-flash写入build/hover.bin前提是机器上装好了 openocd 与 st-flash。⚠️ 烧录地址别乱改RC 芯片固定从0x08000000开始不同容量芯片的芯片级擦除范围会有差异。四、选好输入变体告诉固件你打算怎么开这辆车做完后你看到的转动你的输入设备两个电机随之平滑加减速。固件内置 10 种输入变体只需在 platformio.ini选 env、Keil 工程的 Target 下拉菜单、或 config.h 中选中对应的VARIANT_*宏同一时间只能启用一个。变体输入方式接在哪典型场景VARIANT_ADC两个电位器左线自制遥控、电动小车VARIANT_USART串口指令左线/右线Arduino 或单片机控制VARIANT_NUNCHUKWii 手柄右线电动轮椅、搬运车VARIANT_PPMRC 遥控器 PPM右线遥控滑板VARIANT_PWMRC 遥控器 PWM右线遥控滑板VARIANT_IBUSFlySky iBUS右线遥控器改装VARIANT_HOVERCAR刹车油门双踏板左线踏板改造车VARIANT_HOVERBOARD保留侧板通信左右线原车姿态平衡控制未完成VARIANT_TRANSPOTTERGameTrak 方向杆左线运输小车VARIANT_SKATEBOARDRC PWM右线电动滑板烧录后如果电机转向和直觉相反在对应变体区打开INVERT_L_DIRECTION/INVERT_R_DIRECTION再编译一次即可。五、调一调 FOC 参数让它匹配你的用法打开 Inc/config.h重点看这四个参数CTRL_MOD_REQFOC 控制模式。机械臂、快速响应类项目选VLT_MODE电压模式要恒定转速抗负载选SPD_MODE人坐在上面代步选TRQ_MODE扭矩模式松输入自动滑行。注意SPD_MODE/TRQ_MODE只在 FOC 下可用I_MOT_MAX单电机最大电流A直接决定扭矩上限默认 15别超过电机和电池的承受范围N_MOT_MAX最大转速rpm默认 1000是你唯一的极速保险丝INVERT_L_DIRECTION/INVERT_R_DIRECTION左右电机转向修正变体区各有一份按需打开。进阶玩法——弱磁Field Weakening默认关闭把FIELD_WEAK_ENA设为 1 后固件会在高转速段向电机注入反向磁场分量从FIELD_WEAK_LO开始线性增强到FIELD_WEAK_HI达到FIELD_WEAK_MAX牺牲少量效率换取更高的转速上限。⚠️ 重新校准弱磁参数前一定架起车轮电机可能转得飞快功耗大幅上升甚至触发电池保护板BMS的过压保护。六、卡住了查这里现象可能原因处理方法ST-Link 报 Can not read memory读保护未解除按第三节步骤先解除 RDP电机抖动或尖叫电机参数与实际控制不匹配核对 Src/BLDC_controller_data.c 中已校准的电机参数不要乱改定点数值输入完全无响应变体选错或接错线缆对照第四节表格核对变体与左/右线一上电就自动关机电池电压校准不准按 config.h 中 BAT 区注释把万用表实测值与调试输出第 5 项写回BAT_CALIB_*编译时报 Variant not defined!没有选任何 VARIANT在 platformio.ini 或 config.h 里选一个变体通用调试手段在 config.h 中打开DEBUG_SERIAL_USART2左线或DEBUG_SERIAL_USART3右线用 3.3V USB 转串口接 GND 和 RX终端设115200 波特率就能实时看到输入值、左右指令cmdL/cmdR、电池电压BatV和温度多数问题一眼定位。 串口调试和输入设备若占用同一条线缆二者只能开一个——config.h 里的宏校验会在编译期直接拦住冲突。七、安全清单 还能玩什么刷写完成后的安全清单逐条过一遍第一次通电测试前架起车轮远离身体串口接线只用 GND 和 RX/TX红线 15V 别碰开弱磁前评估电机与电池余量先低速验证电池电压显示不对时重新标定BAT_CALIB_*别凭感觉改报警阈值。调顺之后还有不少可玩空间点到为止打开CRUISE_CONTROL_SUPPORT获得巡航定速在TRQ_MODE下启用ELECTRIC_BRAKE_ENABLE松油门自动缓刹而不是滑行试VARIANT_HOVERCAR双踏板改造双击刹车倒车配合MULTI_MODE_DRIVE三档驾驶模式卡丁车既视感接其他平台ROS、单片机可以从 Arduino/hoverserial/ 的串口示例入手。想真正弄懂 FOC就从 Src/BLDC_controller.c 和 Src/BLDC_controller_data.c 开始逐段读——从能转到懂原理这才是改造的最大乐趣 【免费下载链接】hoverboard-firmware-hack-FOCWith Field Oriented Control (FOC)项目地址: https://gitcode.com/GitHub_Trending/ho/hoverboard-firmware-hack-FOC创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考