简介：这份资料包面向嵌入式初学者与DIY爱好者，围绕基于STM32微控制器的两轮自平衡小车展开，提供从硬件设计到软件实现的完整制作参考。包内共1430个文件，以c与h源码、d与o编译中间文件、crf与dep工程索引为主，辅以pdf原理图与说明文档、hex烧录固件、uvproj等Keil工程文件及bat脚本，压缩包约53.19MB，目录按原理图、源码、使用说明、开发笔记等模块组织。资料涵盖陀螺仪与加速度计数据采集、PID控制算法实现、电机驱动电路设计及整车装配调试流程，开发笔记还记录了故障排查与性能优化思路，便于读者对照硬件搭建、理解实时控制逻辑并复现调试过程。目前已有4138人学习下载，适合希望系统掌握STM32应用、传感器融合与自平衡控制的中级开发者参考。

1. 从“站不稳”说起：STM32 自平衡小车到底是什么

你第一次看到两轮自平衡小车的时候，多半会有一个疑问：两个轮子并排，前后没有支撑，它凭什么不倒？更奇怪的是，你用手轻轻推它一下，它不但不倒，还会往你推的方向“让一让”，然后自己站稳。很多人第一次接触 STM32 自平衡小车，就是被这个“反直觉”的动作吸引的。

说白了，它就是一个会自己找平衡的小车：车身上装了一块 STM32 单片机当“大脑”，一个姿态传感器当“内耳”，两个电机当“腿”。大脑不停地问内耳“我现在歪了多少”，然后命令腿往歪的方向多转一点，把身体拉回来。这个过程一秒钟要重复几百次，所以你看着它就像稳稳站着。STM32 自平衡小车入门，本质上就是学会把“感知—判断—动作”这条链路搭起来，让一块芯片真的能控制一个物理世界里的东西动起来。

这份资料适合谁？适合刚学完 C 语言、摸过一点单片机、想做一个“能看见结果”的项目的新手。它不要求你先懂控制理论，也不要求你会画电路板，跟着做，先让轮子转起来，再让它站起来，路是一步一步走的。

2. 为什么值得从自平衡小车入手：它把“学单片机”变成了“看得见的事”

2.1 它逼你把零散知识串成一条线

很多人学 STM32 的过程是这样的：今天点个灯，明天读个按键，后天调个串口，每个实验都能跑，但合在一起就不知道能干什么。自平衡小车不一样，它天然要求你把 GPIO、定时器、PWM、串口、传感器读取这几样东西同时用上，而且缺一个都不行。灯不亮你可以不管，但小车站不起来，你一定会去查。

我第一次搭这类项目的时候，最大的感受是：以前学定时器只知道“计数”，做了小车才明白定时器还决定了控制循环多久跑一次，跑慢了车就晃，跑快了芯片忙不过来。这种“参数和现象直接挂钩”的体验，是点灯实验给不了的。STM32 自平衡小车制作教程的价值，就在于它把抽象的外设配置变成了“车稳不稳”这种你能亲眼判断的结果。

2.2 反馈快，挫败感低，适合零基础建立信心

做项目最怕的是改了半天代码，什么反应都没有。自平衡小车的反馈非常直接：电机转不转、轮子往哪边转、车身往哪边倒，你一眼就能看出来。哪怕你还没调平衡，只要能让两个轮子按你的命令正反转，你就已经跨过了“单片机控制执行器”这道坎。

而且它的调试是分层的。先让电机转，再让传感器读数正确，再让车有一点“抵抗倾斜”的反应，最后才是稳稳站住。每一层都有明确的成功标志，新手不会一上来就被“整车调不好”吓退。这也是我建议零基础的人从这类项目入门的原因：它把一个大目标拆成了好几个能单独验证的小目标。

2.3 资料形态友好：一份压缩包就是一条现成的路

这份资料是以压缩包形式给的，里面通常包含教程文档、示例代码、电路连接说明这些内容。对新手来说，最怕的是“知道要做小车，但不知道从哪根线开始接”。有现成的教程和代码，你就不用从零去猜引脚定义和初始化顺序，可以先照着跑通，再回头理解为什么这么写。

提示：拿到压缩包后先别急着改代码，先把里面的教程文档从头翻一遍，尤其是接线图和代码目录说明，这两样决定了你后面少走多少弯路。

3. 动手前的准备：零基础第一步该装什么、接什么

3.1 先把工具链装好，别在环境上翻车

新手最容易卡住的地方往往不是代码，而是“代码写完了，怎么弄进芯片”。你需要准备两样东西：一个是写代码和编译的软件环境，一个是把程序下载进 STM32 的工具。常见的选择是 Keil 这类集成开发环境，配合 ST-Link 之类的下载器。具体用哪个版本、怎么装，资料里的教程一般会写，照着做就行。

装完之后不要急着打开小车工程，先做一个最小验证：新建或者打开一个最简单的工程，编译一次，看能不能生成可下载的文件，再下载进去看有没有反应。这一步看起来多余，但它能帮你把“环境问题”和“小车问题”分开。我见过太多人小车调不出来，最后发现是下载器驱动没装好。

# 示意：编译完成后确认输出文件是否存在 # 不同环境输出目录不同，以教程说明为准 ls ./build/ # 预期能看到 .hex 或 .bin 之类的可下载文件

上面这段只是帮你确认“编译真的产出了能下载的文件”。如果这一步就没有输出，说明工程配置或编译选项有问题，先解决它，别往下走。参数上你只需要关注输出文件的路径和名字，后面下载时要用到。

3.2 接线先接“最小系统”，别一次全接上

接线是新手翻车的高发区。我的建议是分两步：先只接电源和下载线，确认芯片能被识别；再接电机驱动和传感器。一次把所有线都插上，出了问题你根本不知道是哪一根。

接线时重点看三件事：电源电压对不对、电机驱动的输入输出有没有接反、传感器的方向装没装对。尤其是传感器，装反了车会往错误的方向“救自己”，结果越救越倒。资料里的接线图要对着看，不要凭感觉插。

注意：上电前先检查电源正负极，电机和传感器都别带电插拔。这一步省不得，烧一次模块的代价比多花十分钟检查大得多。

3.3 先跑通“让轮子转”，这是你的第一个里程碑

在碰平衡逻辑之前，先写一个最简单的程序：让两个轮子按固定速度正转，再反转，再停。这个程序不涉及传感器，只涉及 GPIO 和 PWM。它的意义是验证“大脑能指挥腿”。

// 示意：用 PWM 让电机以固定占空比转动 // 具体引脚和定时器通道以你的接线和教程为准 void motor_forward(void) { // 设置方向引脚，决定正转 HAL_GPIO_WritePin(GPIOA, GPIO_PIN_0, GPIO_PIN_SET); HAL_GPIO_WritePin(GPIOA, GPIO_PIN_1, GPIO_PIN_RESET); // 设置 PWM 占空比，数值越大转得越快 __HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_1, 300); }

这段代码里，方向引脚决定轮子往哪边转，PWM 的比较值决定转多快。300 这个数不是固定的，你的电机和电源不同，合适的值也不同，先从中间值试，听声音、看转速再调。如果轮子不转，先查方向引脚有没有设对、PWM 定时器有没有启动、电机驱动有没有供电。把这一步跑通，你就有资格进入下一章了。

4. 让车“感觉到自己歪了”：传感器读数与第一个闭环

4.1 先读懂传感器在说什么

自平衡小车能站住的前提，是它知道自己歪了多少。这个信息来自姿态传感器，常见的是能输出加速度和角速度的模块。加速度能感知重力方向，角速度能感知转动快慢，两者结合才能得到比较稳的倾角。

新手在这一步最常见的困惑是：读出来的数一直在跳。这不是坏了，而是传感器本来就有噪声。你要做的不是追求一个“完美静止的数”，而是先确认“车往前倾时，读数往一个方向变；往后倾时，往另一个方向变”。这个方向关系对了，后面的控制才有意义。

// 示意：读取传感器并打印原始值，先不做任何滤波 // 具体读取函数以你使用的传感器和驱动为准 int16_t acc_x = read_accel_x(); int16_t gyro_y = read_gyro_y(); printf("acc_x=%d, gyro_y=%d\r\n", acc_x, gyro_y);

这段代码的目的不是控制，而是“观察”。你把车往前倾、往后倾，看串口打印出来的数怎么变，记下变化方向。参数上你只需要关注两个通道：一个反映倾斜，一个反映转动。等你能凭读数判断车的姿态，再谈控制。

4.2 第一个闭环：让车“往歪的反方向用力”

所谓闭环，就是让车的动作依赖传感器的读数，而不是你写死的固定值。最小闭环可以很简单：车往前倾，就让轮子往前转一点，试图把车身“追回来”。这个逻辑听起来粗糙，但它就是自平衡的核心雏形。

// 示意：最简比例控制，倾角越大，输出越大 // angle 为当前倾角，target 为目标平衡角度 float error = angle - target; float output = Kp * error; set_motor_output(output);

这里的 Kp 是一个需要你手调的系数。Kp 太小，车反应软，倒了也不怎么用力；Kp 太大，车会来回猛晃甚至抖动。新手调这个参数的血泪经验是：先从小值开始，一点点加，每次加完观察车的反应，别一次跳很大。target 是你希望车保持的角度，通常接近竖直，具体值要结合传感器安装方向来定。

4.3 调参时看什么、改什么

调参不是玄学，它有观察顺序。先看车有没有“抵抗倾斜”的趋势：你轻轻推它，它有没有往反方向用力。如果没有，先检查输出方向对不对，再加大 Kp。如果有但晃得厉害，说明用力过猛，减小 Kp 或者加入对转动速度的抑制。

这个阶段不要追求“一放就稳”，先追求“推它一下，它会自己往回找”。等这个反应稳定了，再考虑更细的调节。我第一次调的时候就是太心急，一上来就想让它站住，结果参数越调越乱，后来退回到“只让它有抵抗反应”这一步，反而很快找到了方向。

5. 新手最容易踩的坑：排查清单

5.1 现象：上电后轮子完全不转

原因通常有三个：电机驱动没供电、方向引脚设错、PWM 定时器没启动。解决顺序是先量电机驱动的电源脚有没有电压，再看代码里方向引脚和 PWM 通道是不是和接线一致，最后确认定时器启动函数有没有被调用。别一上来就怀疑芯片坏了，绝大多数是供电或配置问题。

5.2 现象：轮子转了，但车一歪就往错误方向倒

这是方向反了，常见于传感器装反或者电机接线反。原因是控制输出和实际倾斜方向没有对上。解决办法很简单：把电机两根线对调，或者在代码里把输出取反，二选一。改完再推一下车，看它是不是开始“追”倾斜方向。

5.3 现象：车能站一下但一直抖

原因是 Kp 偏大或者控制循环太快太慢。先减小 Kp 看抖动是否减轻，再检查控制循环的周期是不是稳定。如果你的循环里塞了打印语句，周期会变得很不稳，调试阶段可以打印，但正式跑的时候要把打印去掉或者降低频率。

5.4 现象：传感器读数漂移，静止时数也在慢慢变

这是这类传感器的常见特性，不一定是故障。原因是零偏会随温度和时间变化。新手不用一上来就做复杂补偿，先保证车在短时间内的反应是对的，等基础功能跑通再考虑校准。资料里如果有校准步骤，按步骤做一遍即可。

5.5 现象：照着教程做，但自己的板子和教程不一样

原因是教程针对的硬件版本和你手里的可能不同。解决办法是以你自己的原理图和引脚定义为准，把教程里的引脚号、定时器通道替换成你实际用的。不要硬套，先确认“我的板子上这个功能接在哪个脚”，再改代码。

6. 跑通第一个例子之后：下一步学什么

第一个例子跑通的标准，不是车能站十分钟，而是你能独立完成“上电—传感器读数—电机响应—推一下有抵抗”这条链路。到了这一步，你已经跨过了新手最难的门槛。接下来怎么走，我建议按下面的顺序来，不要跳。

具体来说，先别急着加新功能，而是把现有工程“拆开再装回去”：改一个引脚，看现象怎么变；改一个参数，看车怎么反应。这个过程比看十篇理论文章都管用。然后去理解滤波，知道为什么传感器读数需要处理，但不用一上来就推公式，先会用、能看到效果就行。

再往后，你可以尝试把控制循环的周期固定下来，观察周期变化对稳定性的影响。这一步会让你真正理解“实时控制”是什么意思。资料里的教程文档这时候就派上用场了，带着你遇到的具体现象去翻，比从头读到尾效率高得多。

我第一次做这类项目的时候，最大的教训是总想一步到位，结果每个环节都半懂不懂。后来我强迫自己每改一个地方就记录一次现象，哪怕只是“Kp 从 5 加到 8，抖动变明显”这种一句话。这个习惯让我后面调任何参数都有据可查，不再靠感觉瞎试。从那以后我每次动手前都强制走一遍“先最小验证、再逐步叠加”的流程，希望这个习惯也能帮到你。

本文还有配套的精品资源，点击获取