【亲测可用】STM32 麦轮小车源码完整上手指南:6 步让小车原地横着走
【亲测可用】STM32 麦轮小车源码完整上手指南:6 步让小车原地横着走
底盘搭好了,四个麦克纳姆轮也装上了,可对着开发板却犯了愁:转速怎么调?编码器怎么读?四个轮子怎么配合才能横着走?STM32麦轮小车源码就是冲着这个痛点来的——一套驱动麦轮(麦克纳姆轮)底盘的 STM32 单片机源码,把 PWM 调速、编码器反馈和四轮独立控制都写清楚了。拿到手烧录进板子,你的小车就能原地横移。
这个项目能做什么 🎯
| 使用场景 | 上板后的实际效果 | 对你意味着什么 |
|---|---|---|
| 原地横移 | 不转向,小车直接左右平移 | 窄通道挪车、侧向作业不用反复打方向 |
| 斜向走位 | 四轮转速按不同组合变化,小车斜着走、绕着走 | 走位更直接,路径不用"先转再走" |
| 速度可量化 | 编码器把转速变成可读取的数字 | 调参时不再靠"感觉快了",而是有具体读数 |
代码在真实硬件上跑过,参数区间也预先调过,烧录后就能动;等你想改的时候,也有一份经过验证的基线可以下手。
原理速览
PWM 调速:用占空比给电机"喂电"
PWM 调速就是用脉冲占空比控制电机端的平均电压,进而控制转速。类比一下:就像快速开关水龙头,水开的时间占比越大,水流越大;"占空比"就是每一轮里水开着的时间比例。源码里 TIM8 的四个通道(PWMA~PWMD,定义见 motor.h)对应四个轮子,改一个 CCR 的值只影响一个轮子,排查问题时很好隔离。
编码器闭环:让速度"说得出数字"
编码器接口模式让定时器直接数电机脉冲,把"轮子转了多少"变成可读的数字。好比导航不断比对当前位置和规划路线,偏了就提示你校正。encoder.c 里把 TIM2~TIM5 都初始化成编码器接口,Read_Encoder() 随时取计数值,拿它做速度闭环和位置校准都有据可依。ENCODER_TIM_PERIOD 默认设为 65535,这是 F103 16 位定时器的上限,一般保持不动即可。
四轮独立控制:全向移动的"编排"
每个麦轮由独立的电机驱动,底盘往哪儿动,取决于四个轮子速度值的组合——像四个舞者各跳各的拍子,整体效果全看你怎么编排。落到操作上:前进是四轮同向同速,横移是左右两侧轮子一正一反,斜行取中间组合,本质就是换一组数字。
从零跑起来
- 硬件准备:一块 STM32F103 开发板(源码按 F103 的寄存器编写)、4 个电机驱动模块、麦克纳姆轮底盘、电源。
- 环境搭建:安装 STM32CubeIDE 或 Keil 等任意支持 STM32 的编译环境。
- 导入源码:本地已有仓库直接打开即可;想从 Git 获取则执行
git clone https://gitcode.com/open-source-toolkit/9952d核心驱动代码在1.标准版麦轮小车源码/HARDWARE/目录下。 - 配置引脚:对照 motor.h 里的 PWMA~PWMD(TIM8 四通道)和 INA~IND(方向脚),以及 encoder.h 中 TIM2~TIM5 对应的引脚,按你的实际接线逐根检查。
- 编译烧录:把工程编译通过后,用 SWD/JTAG 烧录进芯片。
- 验证运行:上电后先单独给一个轮子低占空比,确认转向正确;再依次试横移、斜行组合,观察小车是否按预期动作。
调参与排坑 🛠️
| 现象 | 可能原因 | 处理办法 |
|---|---|---|
| 烧录后某个轮子不动 | 该通道的 PWM 或方向引脚与实际接线对不上 | 对照 motor.h 中的宏定义逐个核对 GPIO |
| 直行跑偏、原地打转 | 四轮参数没对齐,或有轮子打滑 | 先单轮测速校准,再整体走直线复测 |
| 速度忽快忽慢、漂移 | 占空比和实际转速没建立对应关系 | 用编码器读数核对每档 PWM,修正映射参数 |
| 换芯片后报错或行为异常 | 源码基于 F103 寄存器直接编写 | 换回 F103 系列,或按芯片手册改寄存器配置 |
| 轮子方向和预期相反 | 电机两根线接反或方向脚逻辑相反 | 交换电机线,或在代码中反转该通道 |
建议的调试顺序:单轮正反转 → 四轮同速直线 → 横移组合 → 斜行组合,逐层加难度,出问题也能快速定位。
适合谁 & 资源索引
无论你是想入门 STM32 电机控制的学生、搭全向底盘的电子爱好者,还是准备在底盘上继续做二次开发的开发者,这套源码都可以直接当模板用。
- 电机驱动(PWM 初始化 + 方向脚定义):1.标准版麦轮小车源码/HARDWARE/MOTOR/
- 编码器(TIM2~TIM5 编码器接口 + 读数):1.标准版麦轮小车源码/HARDWARE/ENCODER/
- 项目说明:README.md
- 许可协议:LICENSE
- 源码压缩包备份:1.标准版麦轮小车源码.rar
写在最后
麦轮底盘的价值,在于"想去哪就去哪"的自由度,而这套源码把最琐碎的底层工作替你做好了。跑通之后,无论加遥控、加视觉还是上 SLAM,都是顺理成章的下一步——欢迎把你调出的新参数和新玩法分享回来,让后来人少走弯路。