【亲测可用】STM32 麦轮小车源码完整上手指南:6 步让小车原地横着走

原创2026-11-12 14:09:551,904 阅读

【亲测可用】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 位定时器的上限,一般保持不动即可。

四轮独立控制:全向移动的"编排"

每个麦轮由独立的电机驱动,底盘往哪儿动,取决于四个轮子速度值的组合——像四个舞者各跳各的拍子,整体效果全看你怎么编排。落到操作上:前进是四轮同向同速,横移是左右两侧轮子一正一反,斜行取中间组合,本质就是换一组数字。

从零跑起来

  1. 硬件准备:一块 STM32F103 开发板(源码按 F103 的寄存器编写)、4 个电机驱动模块、麦克纳姆轮底盘、电源。
  2. 环境搭建:安装 STM32CubeIDE 或 Keil 等任意支持 STM32 的编译环境。
  3. 导入源码:本地已有仓库直接打开即可;想从 Git 获取则执行 git clone https://gitcode.com/open-source-toolkit/9952d 核心驱动代码在 1.标准版麦轮小车源码/HARDWARE/ 目录下。
  4. 配置引脚:对照 motor.h 里的 PWMA~PWMD(TIM8 四通道)和 INA~IND(方向脚),以及 encoder.h 中 TIM2~TIM5 对应的引脚,按你的实际接线逐根检查。
  5. 编译烧录:把工程编译通过后,用 SWD/JTAG 烧录进芯片。
  6. 验证运行:上电后先单独给一个轮子低占空比,确认转向正确;再依次试横移、斜行组合,观察小车是否按预期动作。

调参与排坑 🛠️

现象 可能原因 处理办法
烧录后某个轮子不动 该通道的 PWM 或方向引脚与实际接线对不上 对照 motor.h 中的宏定义逐个核对 GPIO
直行跑偏、原地打转 四轮参数没对齐,或有轮子打滑 先单轮测速校准,再整体走直线复测
速度忽快忽慢、漂移 占空比和实际转速没建立对应关系 用编码器读数核对每档 PWM,修正映射参数
换芯片后报错或行为异常 源码基于 F103 寄存器直接编写 换回 F103 系列,或按芯片手册改寄存器配置
轮子方向和预期相反 电机两根线接反或方向脚逻辑相反 交换电机线,或在代码中反转该通道

建议的调试顺序:单轮正反转 → 四轮同速直线 → 横移组合 → 斜行组合,逐层加难度,出问题也能快速定位。

适合谁 & 资源索引

无论你是想入门 STM32 电机控制的学生、搭全向底盘的电子爱好者,还是准备在底盘上继续做二次开发的开发者,这套源码都可以直接当模板用。

写在最后

麦轮底盘的价值,在于"想去哪就去哪"的自由度,而这套源码把最琐碎的底层工作替你做好了。跑通之后,无论加遥控、加视觉还是上 SLAM,都是顺理成章的下一步——欢迎把你调出的新参数和新玩法分享回来,让后来人少走弯路。

登录后查看全文
STM32麦轮小车源码