简介：这份资料包面向嵌入式初学者与DIY爱好者，围绕基于STM32微控制器的两轮自平衡小车展开，从硬件原理到软件实现提供了一套可落地的制作参考。包内共1430个文件，以c与h源码、d与o编译中间文件、crf与dep工程索引为主，辅以pdf文档、hex固件、uvproj工程文件及少量bat脚本，压缩包约53.19MB，覆盖原理图、源码、使用说明与开发笔记等模块。其中原理图部分讲解STM32选型、陀螺仪与加速度计连接及电机驱动电路；源码部分呈现数据采集、PID算法与电机控制逻辑；使用说明指导装配、烧录与调试，开发笔记则记录故障排查与性能优化思路。已有4138人学习下载，适合希望理解PID闭环控制、传感器应用与实时控制策略的读者按模块查阅，从理论逐步过渡到动手实践。

1. 从一只站不稳的扫把说起：STM32 自平衡小车到底是什么

你有没有试过把一把扫帚倒过来立在手心？它东倒西歪，你手忙脚乱地跟着挪，勉强撑几秒就倒了。两轮自平衡小车干的就是这件事——只不过它把“你的手”换成了电机，把“扫帚”换成了车身，靠一块 STM32 芯片在毫秒级的时间里不停判断“我往哪边歪了、该往哪边追”，让车身稳稳立住。听起来像玄学，其实是一套非常朴素的闭环逻辑：歪了就往歪的方向走，走快了就减速，反复修正。

STM32 自平衡小车，说白了就是用 STM32 单片机做大脑，配合陀螺仪和加速度传感器感知姿态，驱动两个直流电机轮子，让一块本来站不住的车体自己保持直立、还能前进后退转弯的一整套制作项目。它几乎是嵌入式入门里最经典的“综合练兵场”：传感器怎么读、电机怎么控、控制算法怎么写、代码怎么烧进板子，全都能在一个看得见摸得着的实物上跑通。适合谁？适合刚学完单片机基础、想找个能动手又能出成果的项目练手的新手，也适合想搞懂“自动控制到底怎么落地”的零基础同学。这份资料就是围绕这套小车，把从零搭建到跑起来的路径整理成了一份可以跟着做的教程。

2. 为什么值得从自平衡小车入手：它把抽象概念变成看得见的动作

很多新手学单片机，学完点灯、按键、串口就卡住了——知道寄存器怎么配，却不知道这些零件凑在一起能干嘛。自平衡小车的好处是，它逼着你把“输入—计算—输出”这条链路完整走一遍，而且每一步的结果你都能用眼睛验证：车往前倾了，轮子是不是真的往前追？追过头了，是不是开始来回晃？这种即时反馈，比看十页教材都管用。

2.1 一个项目串起四块核心知识

拆开看，一辆能站住的小车至少涉及四块内容。第一块是姿态感知：陀螺仪测角速度，加速度计测重力方向，两者融合才能得到相对准确的倾角。第二块是电机驱动：STM32 的引脚输出 PWM 波，经过驱动模块放大电流，才能带动电机正反转和调速。第三块是控制算法：最经典的是 PID，比例项负责“歪多少就追多少”，积分项消除长期偏差，微分项抑制来回震荡。第四块是实时性：整个“读传感器—算角度—算输出—改 PWM”的循环必须跑得足够快，通常要几百赫兹以上，慢了车就来不及反应。

这四块单独拎出来都不难，难的是让它们协同工作。而这恰恰是新手最缺的经验——不是某个知识点不会，而是不知道怎么把知识点拼成一个能跑的系统。自平衡小车就是最好的拼接练习。

2.2 为什么选 STM32 而不是更简单的板子

有人会问，用 Arduino 是不是更简单？确实更简单，但 STM32 的价值在于它更接近真实工程环境：主频高、定时器资源丰富、PWM 精度好、中断响应快，这些特性对自平衡这种实时控制场景很关键。而且 STM32 的生态成熟，资料多、例程多，新手遇到问题更容易搜到答案。这份资料基于 STM32 展开，意味着你练完之后，这套“配时钟、配定时器、配中断、写控制循环”的肌肉记忆可以直接迁移到其他嵌入式项目上。

入门的话建议先别纠结具体型号差异，STM32 各系列在 GPIO、定时器、PWM 这些基础外设上的用法思路是相通的，先把一套流程跑通，换芯片时查手册补差异就行。我第一次学的时候就是死磕型号对比，结果一周过去还没点亮一个灯，血泪经验：先跑起来，再谈优化。

2.3 第一个能跑的例子：让一个轮子转起来

在整车平衡之前，最该做的第一件事是让一个电机受控转动。这一步跑通，说明你的供电、驱动、PWM 输出链路是通的，后面才有资格谈平衡。下面是一段 STM32 用定时器输出 PWM 驱动电机的简化示例（以常见的 HAL 库风格示意）：

// 初始化定时器 PWM 通道，假设使用 TIM3 通道1 // 周期设为 1000，即 PWM 分辨率为千分之一 HAL_TIM_PWM_Start(&htim3, TIM_CHANNEL_1); // 设置占空比：compare 越大，输出高电平时间越长，电机转得越快 // 这里先给 30% 占空比，让轮子慢速转动，方便观察 __HAL_TIM_SET_COMPARE(&htim3, TIM_CHANNEL_1, 300); // 换向：通过另一个 GPIO 控制驱动模块的方向引脚 HAL_GPIO_WritePin(GPIOA, GPIO_PIN_1, GPIO_PIN_SET); // 正转 // HAL_GPIO_WritePin(GPIOA, GPIO_PIN_1, GPIO_PIN_RESET); // 反转

这段代码做了三件事：启动 PWM 输出、设定占空比、设定方向。__HAL_TIM_SET_COMPARE的第三个参数就是占空比数值，周期是 1000 时，写 300 就是 30% 输出。方向引脚决定电机正转还是反转，具体哪个引脚接哪个，要看你自己的接线和驱动模块说明。跑通这一步的标志是：轮子按你设定的速度转起来，改数值能变速，改方向引脚能换向。别小看这一步，很多新手卡在“轮子不转”，原因往往是供电不足、驱动模块使能脚没拉高、或者 PWM 通道没启动——先把单轮跑通，等于提前排掉一大半硬件坑。

3. 从零上手的学习路径：先学什么、后学什么、第一个完整例子怎么跑

新手最容易犯的错，是一上来就想让车站起来。结果传感器没校准、PID 参数乱给、电机响应方向搞反，车一上电就猛冲或者原地抖，几次下来信心全无。正确的顺序是分层推进：先让硬件听话，再让传感器说真话，最后才让算法做决策。

3.1 第一步：把硬件链路逐个点亮

在写任何控制代码之前，先做三件独立的验证。第一，电源检查：电机供电和单片机供电要分开考虑，电机启动瞬间电流大，容易把单片机拉复位，这是新手翻车的重灾区。第二，电机正反转验证：给固定占空比，确认两个轮子转向一致、速度接近，如果一边快一边慢，可能是电机个体差异或驱动通道问题。第三，编码器或霍尔信号验证：如果小车带测速，先手动转轮子，看计数是否正常增减，方向对不对。

这三步都不涉及算法，纯粹是“接线对不对、供电稳不稳、信号通不通”。我建议每验证一项就在纸上打个勾，别嫌麻烦。后面调平衡时如果车抖得厉害，你至少能确定不是硬件链路的问题，排查范围直接缩小一半。

3.2 第二步：让传感器输出可信的角度

姿态传感器是自平衡小车的眼睛。常见做法是用陀螺仪和加速度计，通过互补滤波或卡尔曼滤波融合出倾角。新手不必一上来就啃卡尔曼，互补滤波足够入门，思路也直观：加速度计长期准但抖动大，陀螺仪短期准但会漂移，两者按权重混合，既稳又不漂。

下面是一个互补滤波的简化写法：

// angle：当前融合角度；gyro_rate：陀螺仪角速度；acc_angle：加速度计算出的角度 // dt：采样周期，单位秒；alpha：信任陀螺仪的比例，通常取 0.95 到 0.98 float complementary_filter(float angle, float gyro_rate, float acc_angle, float dt, float alpha) { // 用陀螺仪积分预测新角度 float predicted = angle + gyro_rate * dt; // 用加速度计角度做修正，alpha 越大越信任陀螺仪 return alpha * predicted + (1.0f - alpha) * acc_angle; }

alpha是这段代码唯一需要调的参数：调大，角度更平滑但跟随慢；调小，跟随快但抖动明显。入门先取 0.96 左右，把车静置，看串口打印的角度是否稳定在 0 附近，再手动倾斜车身，看数值变化方向是否符合预期。这一步的验收标准很简单：车头往前倾，角度数值往一个方向变；往后仰，往反方向变。方向对了，后面 PID 的正负号才不会搞反。

3.3 第三步：用最小 PID 让车“站住几秒”

真正让车平衡的核心是一个直立环 PID。入门阶段先只写比例项，也就是“歪多少，就给多大的反向速度”。代码结构大致如下：

// target_angle：目标平衡角度，通常校准后设为 0 // current_angle：传感器融合得到的当前角度 // kp：比例系数，先给小值，逐步加大 float balance_pid(float target_angle, float current_angle, float kp) { float error = target_angle - current_angle; // 偏差 float output = kp * error; // 比例输出 // 输出限幅，防止占空比超出电机可接受范围 if (output > 1000) output = 1000; if (output < -1000) output = -1000; return output; }

kp的调法有讲究：从很小开始，比如能让轮子轻微转动的量级，然后逐步加大，直到车能短暂站住但开始低频晃动，说明比例项到位了；再加微分项抑制晃动。注意输出要限幅，否则一旦角度突变，PWM 直接拉满，车会猛冲出去。我第一次调的时候没限幅，车直接窜下桌子，从那以后每次上电前都先把车架空、轮子离地，确认转向和力度正常再放地上。

验收标准：用手扶住车，松手后它能自己站住两三秒，虽然会晃但不倒。做到这一步，说明感知、控制、执行三条链路已经闭环，剩下的就是加微分、加积分、调参数、加遥控，一步步把稳定性做上去。

4. 新手最容易踩的五个坑：现象、原因和解决

4.1 上电就猛冲或原地剧烈抖动

现象：一给电，轮子突然全速转或者车身疯狂抖。原因通常是 PID 正负号反了，或者角度方向与电机补偿方向不一致——车往前倾，代码却让轮子往后追，等于越帮越忙。解决：先把车架空，手动倾斜车身，观察轮子转向是否朝着“追回倾斜”的方向；如果反了，把 PID 输出取反或调换电机方向定义，再重新小幅度试。

4.2 角度数值一直漂移，静止时也在慢慢变

现象：车明明没动，串口打印的角度却持续往一个方向爬。原因是陀螺仪存在零偏，积分后角度会漂。解决：上电后先做静止校准，采集几百个陀螺仪样本求平均值作为零偏，后续读数都减掉这个值；同时确认互补滤波里加速度计的修正权重没有设得太小。

4.3 电机一转，单片机就复位或程序跑飞

现象：轮子启动瞬间，板子重启、串口断开。原因是电机和单片机共用电源，启动电流把电压拉低。解决：电机供电和逻辑供电分开，电机端加足够容量的电容，必要时用独立电池给电机供电，共地即可。这是硬件坑里最常见的一个，别急着怀疑代码。

4.4 车能站但一直低频来回晃，越晃越大

现象：车像不倒翁一样左右摇摆，幅度逐渐增大直到倒。原因通常是比例系数偏大或微分不足，系统在“追过头”和“追不够”之间震荡。解决：先把比例系数降一点，让响应变柔，再逐步加微分项抑制变化速度；每次只改一个参数，改完观察一轮再动下一个。

4.5 照抄参数却完全跑不起来

现象：别人给的 PID 参数，自己用就抖或倒。原因：每辆车的电机功率、轮径、重心高度、传感器安装位置都不同，参数没有通用性。解决：把别人的参数只当起点，按“先比例、再微分、后积分”的顺序自己重调；调参时固定电池电压和场地，减少变量。

5. 下一步学什么：把一辆能站的车做成一辆能跑的车

车能站住之后，学习路径其实才刚打开。接下来最值得投入的方向有三个。第一是串级控制：在直立环外面再套一个速度环，让车在保持平衡的同时按指定速度前进，这是从“不倒”到“能跑”的关键一步。第二是转向控制：用两个轮子的差速实现转弯，配合遥控或蓝牙指令，小车就有了完整的运动能力。第三是调试手段升级：学会用串口波形、上位机曲线观察角度和输出变化，比盯着车看高效得多，调参时能少走很多弯路。

给一个具体的练习建议：先给速度环加一个很小的目标速度，观察车是往前追还是往后让，确认方向后再慢慢加目标值。下面是一个串级结构的示意，帮助理解两层环的关系：

// 外环：速度环，输入目标速度与编码器实测速度，输出一个角度修正量 float speed_output = speed_pid(target_speed, measured_speed, kp_speed, ki_speed); // 内环：直立环，目标角度 = 原始平衡角 + 速度环修正 float final_angle = balance_angle + speed_output; float pwm_output = balance_pid(final_angle, current_angle, kp_balance, kd_balance);

外环的输出不是直接给电机，而是去微调内环的目标角度——车想往前跑，就把目标角度稍微前倾一点，直立环自然会驱动轮子去追。这种“环套环”的结构是运动控制的常见套路，理解了它，你再看别的平衡类项目会轻松很多。

学习节奏上，我建议每加一个功能就单独验证一次，别一口气把速度环、转向、遥控全加上再调试，出了问题根本不知道是哪一层。我自己吃过这个亏：一次改了三处代码，车行为完全失控，回退版本折腾了一晚上。从那以后我每次改控制逻辑都强制走一遍“架空验证—低速试跑—正常跑”的流程，宁可慢一点，也不让问题叠在一起。希望这份资料能帮你把第一步迈出去，先让一个轮子转起来，再让一辆车站起来，剩下的路你会越走越顺。

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