10分钟给平衡车换上FOC固件：从主板解锁到参数调优的完整保姆级指南

10分钟给平衡车换上FOC固件：从主板解锁到参数调优的完整保姆级指南

【免费下载链接】hoverboard-firmware-hack-FOCWith Field Oriented Control (FOC)项目地址: https://gitcode.com/GitHub_Trending/ho/hoverboard-firmware-hack-FOC

满怀期待把平衡车主板接到ST-Link，屏幕上却蹦出一行"Can not read memory"——这是无数 hoverboard-firmware-hack-FOC 新手撞上的第一堵墙。别慌，本文就是为此刻而写。它会在10分钟内带你走完"判断锁死→接线→解除读保护→刷入FOC固件→参数微调→通电验收"的完整链路，让这块原装平衡车主板变成一颗安静、高效、可编程的电机大脑。

先弄懂FOC：为什么值得折腾

把电机想象成发动机：普通方波固件像只会踩油门的司机，能走，但抖动、费电、噪声大；FOC（磁场定向控制）则像"导航+自动巡航"，它实时跟踪转子位置，精确决定三相绕组每一瞬间的电流方向与大小，让电机在任何角度都输出最顺滑的力矩。

刷上这个固件的实际收益，可以浓缩成三句话：

• 更安静：启动和巡航时的机械噪声明显下降
• 更省电：同一条电池续航更久，发热更低
• 更好玩：电机状态可实时读取，串口、遥控、巡航、场弱等高级玩法全部解锁

核心算法集中在Src/目录下的bldc.c与control.c，感兴趣的读者以后可以慢慢研究，现在先动手。

开动前的装备清单

下面的清单帮你把"要准备什么"一次看清，标 ✔ 的必选，标 ○ 的按需准备。

关于固件文件：最省事的方式是克隆仓库后使用自动化构建产物（Actions界面会生成hoverboard-firmware-hack-FOC_build系列文件），也可以本地编译：

git clone https://gitcode.com/GitHub_Trending/ho/hoverboard-firmware-hack-FOC

图1：项目自动构建成功后，可在产物列表下载最新的FOC固件文件

第一步 先诊断：主板是不是被"锁死"了

原厂平衡车出于防盗考虑，几乎都会开启MCU读保护（Read Out Protection）。你的主板是否被锁，连上ST-Link的那一刻就一目了然：

1. 打开 STM32 ST-Link Utility，接入ST-Link与主板
2. 点击连接后，若弹出 "Can not read memory! Disable Read Out Protection and retry" 提示，说明读保护处于开启状态

图2：弹出这行提示，说明主板处于读保护状态，需要先解锁

这一步的成功标志很直观：能正常看到芯片型号与内存内容，而不是弹窗报错。如果没被锁，恭喜你，直接跳到刷写环节即可。

第二步 接线：三根线讲清SWD

解锁之前先把线接好。主板的SWD接口在PCB上有明确标注，关键就两个引脚：PA13 → SWDIO（数据线）、PA14 → SWCLK（时钟线）。

杜邦线的接法如下（ST-Link侧 → 主板侧）：

• ST-Link SWDIO → 主板 SWDIO（PA13）
• ST-Link SWCLK → 主板 SWCLK（PA14）
• ST-Link GND → 主板 GND
• ST-Link 3.3V → 主板 3.3V（可选，部分主板需外部供电）

图3：主板上SWD编程接口（PA13/PA14）与各功能引脚一目了然，接线前先对照确认

接线时记得断电操作，确认杜邦线插紧、无短接，再上电连接。成功标志：ST-Link Utility 能识别出芯片型号（如 STM32F103xx），表示物理链路已通。

第三步 解锁：把读保护降到Level 0

线接好后，回到 STM32 ST-Link Utility 执行解锁：

1. 菜单栏点击 Target → Option Bytes...
2. 在弹出窗口中找到 Read Out Protection，将其设为 Level 0
3. 点击 Apply 写入
4. 再选择 Target → Erase Chip 擦除整片Flash

图4：在Target菜单中打开Option Bytes，即可修改读保护等级

图5：擦除完成后内存区显示全FF，底部状态栏提示已连接目标

成功标志：擦除完成后内存地址区全部变为0xFFFF，且软件不再弹出读保护报错。此时主板已处于"任你写入"状态。

第四步 刷写：把固件写进0x08000000

解锁只是拿到"入场券"，现在正式烧录FOC固件：

1. 点击工具栏 Program & Verify（编程并校验）
2. 选择之前下载的.bin或.hex固件文件
3. 地址保持默认的0x08000000（Flash起始地址），不要改动
4. 点击 Start，等待进度条走完

烧录完成后界面会提示 Verification OK，代表写入的数据和文件完全一致——这就是本步的成功标志。

第五步 参数微调：让固件"认识"你的电机

刷完固件只是第一步，想让电机转得又顺又稳，还要告诉固件你用的是哪款电机。两种方式任选：

方式A：串口命令行（轻量）用USB转TTL模块连接主板UART，串口助手设置波特率115200，输入config命令查看当前参数，重点核对：电机极对数、电流限制、转速限制。

方式B：VESC Tool（图形化，推荐新手）VESC Tool 可以一键检测电机FOC参数——极对数、磁链、电流阈值等，检测结果自动回填，省去手工换算。

图6：VESC Tool检测完成后会列出极对数、减速比、轮径等参数，可直接应用

成功标志：电机参数写入后，手动转动电机应能感受到均匀的阻尼，这是FOC锁轴生效的典型手感。

第六步 通电验收：三个小测试判断成败

• 转动测试：手拧电机，阻力应均匀连续，无卡顿、无啸叫
• 空载测试：不给负载，观察电流读数是否平稳、无异常波动
• 指令测试：通过遥控或串口发送控制指令，电机响应及时、加减速平顺

三项都通过，恭喜，你的FOC固件已经正式服役。

常见报错排雷

再进一步：这些玩法等你解锁

基础跑通之后，固件的潜力才刚刚打开：

• 场弱控制（Field Weakening）：让电机在高速区突破反电动势限制，榨出更高转速，相关逻辑可在Inc/config.h中按需开启

图7：FOC场弱逻辑在不同输入目标下的三种工作模式对比

• 控制模式切换：Inc/下的config.h与defines.h集中了大多数可调项，如电流环增益、限流、巡航开关等，改完重新编译烧录即可生效
• 串口协议开发：Src/comms.c定义了通信协议，配合 Arduino 侧Arduino/hoverserial/hoverserial.ino示例，可以做出属于自己的上位机玩法

写在最后

从"Can not read memory"的劝退弹窗，到电机响应顺滑如丝，你只用了十分钟和几次鼠标点击。那块原本"锁死"的原装主板，现在变成了一个随时可以重写、可以调校、可以接入自己代码的电机控制平台——这正是折腾开源硬件的乐趣所在。下一次，试着把巡航、场弱、串口协议都玩一遍，你会发现这台平衡车能做的事，远比出厂时多得多。

【免费下载链接】hoverboard-firmware-hack-FOCWith Field Oriented Control (FOC)项目地址: https://gitcode.com/GitHub_Trending/ho/hoverboard-firmware-hack-FOC