不用管原理有多玄，先记住一句话：TT马达几乎是小车类项目的默认选项。我第一次接触这玩意儿，是在给一块STM32F103C8T6做两轮小车的时候，拆开快递盒发现里面躺着两个带齿轮箱的直流小电机，手上连驱动芯片都没有，以为接上电源就能转，结果被电流、电压、驱动电路这些概念挨个教育了一遍。后来才明白，TT马达虽然长得不起眼，但“怎么让它转”“怎么让它转得稳”“怎么在意外堵转时不烧板子”，这一套问题足够把定时器、PWM、编码器、PID这些STM32核心知识点全部串起来。这篇文章就是把那段踩坑经历整理成一套能直接照做的方案，适合刚入门STM32、准备做智能小车或课程设计的同学参考，也适合想从开环控制往闭环调速进阶的人。
1. 项目概述：先把TT马达看明白
1.1 从结构到参数：TT马达凭什么这么普及
TT马达在国内玩家圈里基本指那种长得像“白色小圆筒”的直流减速电机，学名叫直流减速电机或齿轮减速电机，因为最早在淘宝和教学套件里流通时没有正式型号，大家就按外形和用途叫成了“TT马达”。它的本质是两个东西合体：一个高速直流电机，加上一组金属或塑料减速齿轮箱。直流电机本身转速很高，但扭矩很小，直接带轮子别说爬坡了，平地起步都费劲；齿轮箱的作用就是降转速、提扭矩，让电机能拖得动车身。
常见的TT马达参数大致是这样的：额定电压3V到6V，空载转速根据减速比不同，常见有100转/分、200转/分、300转/分等规格，减速比越大转速越慢、扭矩越大。空载电流一般在100mA到300mA左右，堵转电流会冲到1A以上。很多人一看到“电流不大”就放松警惕，实际项目里电机频繁启动、堵转，电流峰值是非常可观的。
TT马达之所以普及，不只是因为它便宜，更因为结构皮实、改装方便。轮子可以直接卡在输出轴上，也可以用联轴器连接编码器支架，加上一块L型安装支架就能固定到车身上，非常适合做教学和快速原型验证。STM32驱动它，基本上就是“GPIO控制方向、PWM控制速度、编码器测转速、ADC测电流”这四板斧。
1.2 典型应用场景与选型对比
TT马达最经典的应用场景就是两轮差速小车、循迹小车、避障小车和遥控小车。所谓差速，就是左右轮转速不一致时，车身就会转向，这个逻辑和坦克转向是同一个原理。它还被大量用在智能家居小装置里，比如自动窗帘、小型云台、扫地机模型的轮组、老式门锁的电驱动部分等等。因为力矩适中、控制简单，几乎成为“STM32入门第一台作品”的标准搭配。
为了帮大家选型时心里有数，我拿TT马达和其他几种常见电机做个简单对比：
| 电机类型 | 电压范围 | 扭矩 | 控制难度 | 适合场景 | 缺点 |
|---|---|---|---|---|---|
| TT马达（直流减速） | 3-6V | 中等 | 低 | 小车、云台、窗帘 | 精度一般，噪音偏大 |
| N20微型减速电机 | 3-12V | 中低 | 中 | 微型机械臂、精密云台 | 扭矩小，需配编码器 |
| 空心杯电机 | 3-12V | 低 | 中 | 航模、高速旋转设备 | 无减速箱，扭矩小 |
| 步进电机 | 5-24V | 高 | 高 | 3D打印机、CNC | 控制复杂，体积大 |
从表格能看出来，TT马达的最大优势是在“够用”的前提下做到最简单，别拿它和步进电机比精度，它的定位就是让作品先跑起来。
2. 驱动方案与硬件接线：动手前的关键决策
2.1 为什么STM32不能直接驱动电机
很多第一次做电机的朋友都会问同一个问题：STM32的GPIO明明能输出3.3V，为什么不能直接接到TT马达上？答案是电流不够用，而且方向不可控。STM32的GPIO引脚驱动能力很有限，普通IO口的输出电流通常只有几毫安到二十毫安，而TT马达哪怕空载也要上百毫安电流，堵转甚至可以到一两安培。硬接上去的结果就是：单片机直接被拉死、复位，严重的还会烧坏引脚。
这里可以打一个比方：GPIO像是一个只有小水管闸门的水龙头，TT马达像一个需要大口径水管持续供水的大水槽，强行用小闸门去控制大水槽，水槽没灌满，闸门先崩了。所以中间必须加一个“大阀门”，也就是电机驱动芯片。驱动芯片的作用是用单片机的小信号去控制一个大电流开关，把外部电源的电能输送给电机，同时还能完成换向，实现正转反转。
方向控制方面，如果只接两根线，电机只能朝一个方向转；想让小车后退、转弯，就必须能改变电机两端电压的极性，这就需要H桥电路。H桥由四个开关管组成，通过不同开关组合改变流过电机的电流方向，驱动芯片内部已经集成好这个电路了。
2.2 驱动模块选型：L298N、TB6612、DRV8833怎么选
市面上的电机驱动模块主要有L298N、TB6612FNG、DRV8833、A4950等，再加上用分离元件搭建的MOS管H桥，选择确实有点多。我先放一张对比表，再逐个说结论。
| 驱动模块 | 最大电流 | 导通压降 | 逻辑电压 | 特点 | 适合场景 |
|---|---|---|---|---|---|
| L298N | 2A/通道 | 约2V，发热大 | 5V | 经典，模块大，需散热 | 大电流、老式教学套件 |
| TB6612FNG | 3.2A峰值 | 约0.3-0.5V | 3.3V/5V | 高效、体积小、发热低 | 小型TT马达、micro小车 |
| DRV8833 | 1.5A/通道 | 约0.3V | 3.3V/5V | 超低压、双通道 | 电池供电压低的小车 |
| 分离MOS管H桥 | 由MOS管决定 | 取决于MOS | 需单独设计 | 可定制、灵活 | 自研电路板、大功率 |
我的建议很直接：做TT马达小车优先选TB6612FNG，理由有三个。第一，它的导通压降远小于L298N，这意味着电池能量更多转化成了电机扭矩，而不是变成驱动芯片的热量。第二，逻辑电平兼容3.3V，可以直接用STM32的GPIO控制，不需要额外电平转换。第三，模块尺寸小，放在小车底盘上不占地方，走线也清爽。
L298N虽然非常经典，很多教程都在用，但它的压降大、发热严重，而且模块上的78M05线性稳压器会给逻辑电路带来额外功耗。除非你手边已经有一个现成的L298N，或者驱动的电机电流超过3A，否则我建议优先考虑TB6612。
2.3 接线要点：电源隔离、共地与去耦电容
驱动方案确定之后，接线就是另一个关键环节。以TB6612FNG为例，模块引脚包括VM、VCC、GND、STBY、AIN1/AIN2、PWMA、AO1/AO2，另一路是BIN1/BIN2、PWMB、BO1/BO2，对应第二个电机。VM接电机电源正极，通常接5V或6V，VCC接逻辑电源3.3V，GND必须和STM32共地，否则控制信号无参考电平，模块无法正常工作。
这里有一个很多人第一次做都容易犯的错误：把电机的5V电源和STM32开发板的3.3V当成同一个电源使用。如果你用USB给开发板供电，然后把VM直接接到开发板的5V引脚去驱动电机，大概率会出现“电机一启动，开发板就重启”的诡异问题。原因是电机的启动电流和堵转电流会瞬间拉低电源电压，单片机一旦欠压就会复位。正确的做法是：电机电源单独供电（电池、可调电源或大电流USB电源），并且把电机电源的负极和STM32的GND连在一起，形成共地。
更稳妥的做法是在电机电源两端并联一个100uF到470uF的电解电容，再并联一个0.1uF的瓷片电容，分别负责瞬态供电和滤除高频噪声。这个小改动几乎零成本，但能有效减少电机换向时产生的尖峰对单片机的干扰。关于共地，再强调一句：逻辑地与功率地单点相连，不要形成大面积环路，否则地线噪声会被引入控制信号。
3. 工程搭建与PWM输出：让电机先转起来
3.1 用STM32CubeMX快速生成工程
现在写STM32程序，业界主流是STM32CubeMX加HAL库，也有一些老教程教你用标准库手工搭建工程。两种方式都能跑，但我的观点是：如果是新学，直接用HAL库更划算，因为CubeMX可视化配置时钟、定时器、ADC，省掉大量初始化的手工劳动，而且HAL库函数封装得比较一致，后面迁移到其他芯片型号也容易。
下面以STM32F103C8T6（蓝板）为例，梳理一遍关键配置步骤。打开STM32CubeMX，新建工程，在芯片选择界面搜索“STM32F103C8”，选中后进入配置界面。首先是配置时钟树，在Clock Configuration里把HCLK设置为72MHz，方式一般是选择外部晶振HSE，然后通过PLL倍频。注意F103最高主频就是72MHz，别把这个数设错了，设错了后面定时器PWM频率全部偏掉。
接着配置引脚。我这里给出一个常用引脚分配方案，直接用即可：
| 引脚 | 功能 | 说明 |
|---|---|---|
| PA0 | TIM2_CH1 | 输出PWM到驱动模块PWMA |
| PA4 | GPIO输出 | 控制AIN1 |
| PA5 | GPIO输出 | 控制AIN2 |
| PA6 | TIM3_CH1 | 编码器A相输入 |
| PA7 | TIM3_CH2 | 编码器B相输入 |
| PA9 | USART1_TX | 调试串口打印 |
| PA10 | USART1_RX | 调试串口接收 |
CubeMX里点击引脚，选择对应功能。PA0选择TIM2_CH1，PA6/PA7选择TIM3_CH1和TIM3_CH2（注意编码器用，后面细说），PA4和PA5选择GPIO_Output，PA9/PA10选择USART1。TIM2在Mode里勾选Channel1为PWM Generation CH1，参数默认即可，细调放在下一步。USART1在Mode选择Asynchronous，波特率设115200。
工程管理页面里，Toolchain选择MDK-ARM（对应Keil5），Code Generator里勾选“Generate peripheral initialization as a pair of .c/.h files”，这样生成的代码是按外设拆分的，阅读和修改都比较方便。点击Generate Code按钮，生成工程，然后就能用Keil或直接VS Code配合插件打开继续写代码了。
3.2 PWM频率与占空比怎么定
关于PWM频率，很多教程喜欢直接告诉你“用20kHz”，但没解释为什么。我来补上这个环节。PWM频率的选择主要受三个因素影响：一是人耳听感，大多数可听声频率范围是20Hz到20kHz，如果PWM频率落在1kHz到几kHz区间，电机线圈和齿轮箱会发出明显啸叫，听着非常难受，所以频率尽量往20kHz或以上走；二是MOS管开关损耗，频率越高，功率管开关损耗越大，芯片会发热，但对小电流TT马达来说问题不大；三是电机电感滤波效果，频率太低会导致电流纹波大，转速抖动明显。
综合下来，TT马达驱动用10kHz到20kHz是比较合理的经验值。以72MHz主频、20kHz PWM为例，TIM2的时钟源如果是72MHz，预分频PSC设为71，得到1MHz计数频率；自动重载值ARR设为49，则PWM频率 = 1MHz / (49 + 1) = 20kHz，最大占空比分辨率是1/50，也就是2%一档，对小车的调速精度已经够用。如果希望调速更细腻，可以把PSC降低，ARR提高，比如PSC=35，ARR=99，频率还是20kHz，但占空比分辨率提升到1%。
占空比和电机电压的关系是线性的：占空比50%意味着平均电压大约是电源电压的50%。但要注意，电机在低速时存在“死区”，占空比低于某个阈值（一般10%左右）电机可能根本不动，这是启动摩擦力矩造成的，不是代码Bug，实测时心里有数就行。
3.3 两行代码让电机转起来
生成工程之后，在main.c的main函数里，先启动PWM通道。HAL库的接口很简单，启动函数调用一次即可：
HAL_TIM_PWM_Start(&htim2, TIM_CHANNEL_1);然后设置占空比，函数宏如下：
__HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_1, 500);这里的500是相比较寄存器CCR的值，如果ARR设成999，那么500就代表50%占空比。调整这个值，就能线性调节电机速度。但这只能让电机转起来，还没法控制方向。方向控制要配合GPIO：把AIN1和AIN2拉高一拉低，电机正转；反过来，反转。
HAL_GPIO_WritePin(GPIOA, GPIO_PIN_4, GPIO_PIN_SET); HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_RESET);组合起来，一个最简电机控制流程就出来了：设置方向GPIO，设置PWM占空比，然后启动PWM输出。如果需要停止，把占空比设为0，注意不要随意把驱动模块的STBY引脚拉低，否则芯片直接进入待机，后续重新使能还要等恢复时间。
4. 进阶控制一：编码器测速与速度闭环
4.1 霍尔编码器的工作原理
如果你只是让电机全速跑，上面的PWM方案已经够了。但做小车如果遇到不同地面摩擦力、电量下降、斜坡，你会发现同一个占空比在不同环境下转速差异很大。要让小车稳定走直线、精准转弯，就需要实时知道电机转速，这就轮到带编码器的TT马达上场。
带编码器的TT马达一般在电机尾部集成一个霍尔编码器，它由转盘和霍尔传感器组成。转盘上分布若干磁极对，电机转动时磁场变化产生脉冲信号。更常见的其实是光电编码器，由一个开槽码盘和光电对管组成，码盘转一圈，光路被遮挡和导通多次，输出对应的脉冲方波。霍尔版和光电版原理差不多，输出信号也一样，都是方波。
编码器输出两路信号，叫A相和B相，两者相位相差90度。这样一个脉冲周期里，根据A、B的电平组合可以判断电机旋转方向，同时还能通过四倍频技术把计数分辨率提高四倍。比如一个码盘一圈产生11个脉冲，四倍频后是44个计数/圈，配合TT马达常见的减速比30或48，输出轴转一圈对应编码器测到上千个脉冲，足够做精确速度闭环。
4.2 定时器编码器模式配置与计数读取
STM32的定时器有一个“编码器接口模式”，专门用来处理这种带A/B相的编码器信号。在编码器模式下，TIM3的CH1和CH2被用作编码器输入，硬件会自动根据A/B的相位判断方向，并且自动向上或向下计数。程序员只需要配置好模式，然后读计数器值就行，根本不需要用外部中断手动去数脉冲。
CubeMX里，TIM3的Mode选项中选择Encoder Mode，Channel1和Channel2都选择Encoder Mode，默认会配置为TI1和TI2输入。参数里面编码器模式选择TI1 and TI2（即同时计数两路信号），这样计数分辨率最高。计数范围Period设为65535，计数器会在上下限自动回绕，方便方向变化时计数逻辑不出错。注意，编码器模式下定时器不需要开启PWM输出，也不用启动定时器中断，只要初始化完，计数器就在后台自动跟着编码器转。
读取转速的代码很简单，在需要采样的时候读取TIM3计数器值，然后把上一次的值清零。例如：
int16_t speed_count = (int16_t)__HAL_TIM_GET_COUNTER(&htim3); __HAL_TIM_SET_COUNTER(&htim3, 0);因为speed_count是有符号数，电机正转时是正数，反转时是负数，正好能用于判断方向。定时读取这个值除以单位时间，再除以每圈脉冲数，就能换算成转/秒。插一句，定时器编码器模式初始化后计数器默认是0，如果上电瞬间编码器在某个位置，首次数值可能不是从0开始，不影响速度计算，只要用差值就行。
4.3 一个最小速度闭环的实现思路
有了编码器测速之后，下一步就是闭环控制。最简单的思路是：每10ms读取一次速度计数，和目标值比较，误差为正就增加PWM占空比，误差为负就减少，这就是通俗说的比例控制。但单纯的比例控制会残留稳态误差，所以常用PID。我不在这里推导完整控制理论，先给一个能跑起来的最小增量式PID代码框架：
// 定时器中断里周期执行，比如10ms一次 void Speed_Control_Task(void) { int16_t current_speed = Get_Encoder_Speed(); // 读取实时转速 int16_t error = target_speed - current_speed; integral += error; if (integral > 500) integral = 500; if (integral < -500) integral = -500; int16_t output = (int16_t)(kp * error + ki * integral + kd * (error - last_error)); if (output > 1000) output = 1000; if (output < -1000) output = -1000; if (output >= 0) { Motor_Set_Direction(FORWARD); __HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_1, output); } else { Motor_Set_Direction(BACKWARD); __HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_1, -output); } last_error = error; }这段代码有几点要注意。第一，积分项一定要限幅，否则堵转时积分一直累加，松开后电机会发疯一样冲出。第二，PID输出和PWM占空比直接关联，对于F103来说范围0到1000，上限在设计ARR时已经确定，注意不要越界。第三，kp、ki、kd三个参数要先调kp，再调ki，最后微调kd，没有捷径，只能靠实测。推荐用串口把目标值和实测值打出来，边看曲线边调参，效率高很多。
开环和闭环的差距实测非常明显。我的小车用固定占空比在瓷砖地面走直线时，跑2米能偏出去20到30厘米，地面摩擦稍微不均就会偏；换上编码器加闭环PID之后，直行误差能控制在几厘米以内，转弯的重复性也好了很多。如果预算允许，买编码器版的TT马达比普通版贵不了几块钱，强烈建议直接上编码器版。
5. 进阶控制二：电流检测与过流保护
5.1 为什么要关心电机电流
TT马达虽小，堵转电流却不小，动辄一两安培。对STM32来说，如果驱动模块短路或者电机卡死，大电流持续输出可能烧毁驱动芯片，甚至导致电池电压跌落、单片机复位。所以稍微正式一点的项目里，都应该做电流检测和过流保护。
电流检测的经典做法是在电机供电回路串联一个低阻值采样电阻，比如0.1欧姆，电机电流流过它时产生一个小的压降，把这个压降放大后给STM32的ADC采集。有些驱动板上已经预留了电流采样引脚或运放电路，比如TB6612模块本身没有直接电流输出，但像DRV8833模块有nFAULT等引脚，部分模块也有电流检测输出节点，需要仔细看手册。
也有一些方案用霍尔电流传感器模块，比如ACS712，低压电机项目也能用，但精度和成本对于TT马达来说有点浪费。我觉得学习阶段不用上高档仪器，用采样电阻加运放，理解整个链路就够了。采样电阻取值不能太大，否则采样压降会吃掉电机的工作电压并造成额外损耗；也不能太小，否则噪声太大。0.05到0.1欧姆是个合理区间。
5.2 用ADC+DMA做采样
要把电流数据连续、低开销地送到单片机，推荐用ADC加DMA的方案。在CubeMX里，启用ADC1的通道（比如PA1对应ADC1_IN1），开启连续转换模式，然后在DMA Settings里添加ADC1的DMA请求，方向设为外设到内存，数据宽度为Half Word。这样ADC每次转换完成，DMA会自动把结果搬到内存的数组里，CPU完全不用管。
采样数组建议开个稍大一点的环形缓冲，比如32个点，周期性地对数组求平均，这样能滤掉一些高频噪声。示例代码大概长这样：
#define ADC_BUF_LEN 32 uint16_t adc_buf[ADC_BUF_LEN]; // 启动ADC+DMA，此时DMA会在后台持续搬运数据 HAL_ADC_Start_DMA(&hadc1, (uint32_t *)adc_buf, ADC_BUF_LEN); // 每隔一段时间取平均 uint32_t sum = 0; for (int i = 0; i < ADC_BUF_LEN; i++) { sum += adc_buf[i]; } uint16_t adc_avg = sum / ADC_BUF_LEN; float current = (float)adc_avg / 4095.0f * 3.3f / sampling_resistance / gain;这里要注意，ADC是12位分辨率，满量程对应3.3V，读到的数字值要先换算成电压，再根据采样电阻和运放增益换算成电流。运放增益如果用的是放大10倍的电路，那实际电流就是电压除以电阻再除以增益。硬件上记得ADC引脚不要悬空，接个RC低通滤波，能有效滤掉电机换向产生的尖峰。
5.3 过流保护与堵转恢复
有了电流数据之后，过流保护逻辑就很简单了。在周期任务里检查电流值，如果大于设定阈值，比如500mA持续200ms，就认为电机堵转，立刻把PWM占空比降为0，并通过串口打印告警信息。不要一看到瞬时电流高就立刻停机，电机启动瞬间会有浪涌电流，误保护会很难受。
堵转恢复可以设计成两种策略：一是手动复位，代码检测到堵转后需要外部指令或按键才能重新启动；二是自动重试，堵转后停200ms，再尝试以小占空比启动，如果连续几次都失败才彻底停机。自动重试适合清扫机器人这种需要越障的场景，手动复位则更适合危险保护。我用的是自动重试加次数限制，体验比较均衡。
顺便提醒一句：电流采样虽然能保护电路，但不能完全代替机械限位和软件逻辑。小车上如果轮子碰到障碍物，单纯靠电流判断往往已经造成机械磨损，最好在结构设计阶段就加限位挡块或弹簧机构。
6. 实战案例：两轮差速小车的最小控制逻辑
6.1 差速运动学与转向控制
两轮差速小车的基本运动学关系其实不复杂。设左轮转速为VL，右轮转速为VR，两轮间距为L，那么车体中心的线速度大约是(VL+VR)/2，角速度大约是(VR-VL)/L。从这个公式能导出一系列直观结论：左右轮同速，车直行；左快右慢，车向右转；两轮速度大小相同方向相反，车原地旋转。
真正写代码的时候，不需要去解方程，只需要抽象出车体控制接口。比较实用的做法是面向控制量编程：遥控或上位机下发一个线速度和一个角速度指令，然后把它们分解成左右轮的目标转速，交给左右两个电机的PID控制器执行。比如：
typedef struct { float linear_speed; // 线速度，单位m/s float angular_speed; // 角速度，单位rad/s } ChassisCmd; void Chassis_Update(ChassisCmd cmd) { float v_left = cmd.linear_speed - cmd.angular_speed * WHEEL_DISTANCE / 2.0f; float v_right = cmd.linear_speed + cmd.angular_speed * WHEEL_DISTANCE / 2.0f; // 再把线速度换算成编码器目标值，交给左右PID Set_Left_Motor_Target(v_left); Set_Right_Motor_Target(v_right); }这样上层逻辑只需要关心“我要往哪走”，不用每次都为PWM和GPIO操心。很多教程喜欢直接给电机PWM值，虽然也能转弯，但移植性差，不同场地不同负载都要重新调，不够工程化。
6.2 用PID把转速稳定下来
两轮差速小车的直线稳定性完全依赖两个电机的转速一致性。如果只给两个电机相同的占空比，由于齿轮箱摩擦差异、负载不同，实际转速往往有偏差，小车就会跑偏。所以实际做法是每个电机独立一个速度PID，各自跟踪自己的目标转速。我在上一节的PID框架里说的是单个电机的控制，小车场景就是把同样的函数分别跑两路，左右两路独立计算。
调PID参数时，建议先让小车悬空，轮子不接触地面，把左右两个电机的空载PID分别调稳，再加上负载调整。悬空调试可以排除地面干扰，问题定位更快。如果出现转速振荡（能明显听到电机忽快忽慢的声音），多半是kp太大或kd太小，先把kp降下来，再加一点kd抑制超调。
串口在这里是调试利器。我习惯把当前目标速度、实际速度、PID输出三组数据通过串口发到上位机，用串口绘图工具画出来。能看到目标值和实测值的曲线重合度，比单看现象猜参数靠谱得多。推荐使用VOFA+或SerialPlot这类工具，配置简单，用起来很直观。
6.3 把模块整合进裸机状态机
在裸机环境下，不用RTOS也能把这些功能组织得很好。我常用的框架是一个固定频率的主循环加几个定时器中断，比如：
- 主循环：处理按键、遥控指令、串口指令、状态机迁移。
- 10ms定时器中断：读取编码器、执行PID速度环、执行过流检测。
- 100ms周期：向串口发送调试数据。
为什么PID要放在定时器中断而不是主循环？因为中断的周期是严格固定的，PID控制周期抖动会影响控制质量。主循环里一旦有阻塞代码，比如printf输出长字符串，控制周期就会乱掉，小车直观表现就是转速不稳、走线抖动。我在早期项目里吃过这个亏，后来凡是控制相关任务一律进中断，主循环只做用户交互和状态切换。
状态机的设计可以很简单：静止、前进、后退、左转、右转、停止。每个状态对应一组目标速度。比如避障小车，超声波检测到前方障碍物小于阈值，状态机从“前进”切到“右转”，等脱离障碍再切回“前进”。这样比直接写一堆if-else嵌套要清晰得多，也方便后面加功能。
7. 常见问题速查与调试经验
7.1 电机不转、转速异常排查
这一节用来整理我和身边人做电机控制时踩过的坑，每一条都是真实出现过的。
| 现象 | 可能原因 | 排查方法 |
|---|---|---|
| 电机完全不转 | 驱动模块STBY未拉高或VCC未供上 | 用万用表量STBY引脚电压，检查VCC是否3.3V |
| 电机只能一个方向转 | 一个方向控制GPIO没配置或接线虚焊 | 检查AIN1/AIN2电平组合，确保是一高一低 |
| 输出轴不转但有微弱嗡嗡声 | PWM占空比太低，电机达不到启动力矩 | 提高占空比到20%以上测试 |
| 转速忽高忽低 | 电源电压不稳定，或编码器接线接触不良 | 用示波器看编码器波形，检查电源纹波 |
| 电机一转单片机就重启 | 电机电源和单片机电源共用，电流跌落导致欠压复位 | 电机单独供电，加储能电容 |
| 程序下载后跑飞 | 电机干扰导致复位，也可能使能了看门狗 | 先断电机电源测试裸编译，再逐项排查 |
最常见的其实是供电问题，而不是代码问题。我见过很多人在串口能打印、GPIO正常的情况下，电机不转，最后查出来是驱动模块的VM引脚没有接6V电源，只靠VCC的3.3V逻辑电压供电，那点电流根本推不动电机。建议所有新手在排查前先画一张简单的接线图，标注每个引脚该有的电压，然后用万用表逐点核对。
7.2 ST-Link连接失败与调试环境问题
关于调试，还有一个高频问题：ST-Link突然连不上芯片，Keil提示类似“no target found”的错误。出现这个提示，先不要慌，按这个顺序排查：第一，检查SWDIO、SWCLK两根线是否接反或虚焊；第二，检查目标板是否供电，SWD接口在没有给目标板供电时，即使连接正常也检测不到芯片；第三，确认BOOT0接线，如果BOOT0被拉到1进入ISP模式，调试器也连不上；第四，检查芯片是否被读保护。
F103默认情况下是可以直接连接调试的，但如果之前烧录过程序使能了读保护，调试器确实会提示没找到目标。这时候可以用STM32CubeProgrammer或STM32 ST-LINK Utility，先做一个“connect under reset”，或者执行全片擦除。另外，有些板子的SWDIO和SWCLK引脚同时被复用为普通GPIO，如果程序里把它们配置成推挽输出拉低了电平，也会导致下载失败。解决办法是让MCU在复位瞬间保持调试口功能，Keil调试设置里勾选“Reset and Run”旁边的连接选项一般能解决。
顺带说一个工程层面的问题：关于标准库和HAL库怎么选。如果你用的是老教程，标准库工程需要手动添加启动文件、外设库文件，还要在C/C++头文件路径里添加include目录，新手经常会漏配置导致编译报错。HAL库配上CubeMX之后，这些都由工具自动生成了，可以大幅减少环境问题。实际工作中我用VSCode加EIDE插件也搭建过基于HAL库的工程，效果不错，但调试跟踪体验还是Keil更方便。
7.3 波形测量与打印调试心得
调试电机控制，最好备一台示波器，哪怕是很便宜的那种，能非常直观地看到PWM波形、编码器波形和电源纹波。如果没有示波器，可以让GPIO翻转为辅助信号接入逻辑分析仪，或者用ADC采集引脚上的电压曲线。总之，别靠猜。
我第一次调PWM时，电机完全不转，百思不得其解。后来用示波器一看，发现TIM2根本没有输出，原来CubeMX里PWM模式虽然开了，但忘记在代码里调用HAL_TIM_PWM_Start，只设置了比较寄存器，通道还是关闭状态。这类“配置了但没启动”的问题，代码层面几乎不可能通过读代码看出来，必须有波形才能定位。
串口打印的坑也不少。最典型的是printf重定向后，电机一启动，打印就卡死。原因多数是串口中断和电机PWM中断冲突，或者重定向代码写得不对。建议把调试打印放到控制周期里，只打印关键数据，不要每次都打一长串。另外，如果用了HAL_Delay做延时，而系统滴答中断被某些操作占用，会出现延时不准甚至卡死，比如在定时器中断里调用HAL_Delay就是大忌，主程序可能被中断卡住。
8. 扩展方向：从一辆小车到更多作品
8.1 给小车加上视觉模块
STM32的算力处理复杂图像比较吃力，但挂一个视觉模块就很常见了。比如K210开发板或OpenMV摄像头，处理颜色识别、形状识别、条形码识别这些视觉任务，再把结果通过串口发给STM32。STM32收到指令后控制TT马达执行对应动作，比如看到红色物体就左转，看到蓝色物体就右转，识别到条形码就前进取货。这个架构非常适合做课程设计和比赛项目，STM32管控制，视觉模块管感知，职责分明。
通信协议可以用简单的帧格式，比如帧头0xAA，然后是数据字节和校验，不要直接发字符串去解析，既容易出错又浪费CPU。我当时用K210和STM32做视觉循迹，一开始就是发字符“1”代表左转“2”代表右转，代码也能跑，但误码率很高，后来改成结构体字节流加CRC校验，明显稳了。
8.2 接入Wi-Fi模块做远程遥控
给TT马达小车加上无线控制，也是很多人的下一个目标。ESP8266模块加STM32是常见的低成本组合，用串口AT指令或SDK二次开发都行。更进一步的玩法是接机智云或阿里云物联网平台，把小车接入云端，用手机App远程控制。这时候程序结构就要改进了，至少要有一个通信协议解析层，把接收到的指令转换成控制信号，同时把电机的转速、电流等状态上传云端。
这个扩展方向还会牵扯到Bootloader和远程升级，不然每次改代码都要插线下载，很麻烦。给STM32做一个简单的串口Bootloader，配合ESP8266从云端下载固件，然后写入Flash并跳转执行，这一套做下来能学到不少嵌入式底层知识。但要提醒的是，远程升级涉及到Flash擦写，稍有疏忽可能把Bootloader也抹了，操作前务必备份原固件。
8.3 从课程设计到毕业设计
TT马达和STM32的组合能扩展出很多毕业设计题目，比如智能台灯（用电机驱动灯罩角度调节）、自动窗帘、智能晾衣架、小型自动售卖机、图书搬运机器人，这些都是非常成熟的课程设计方向。核心仍然是电机控制那套，但会增加传感器融合和用户交互，比如结合OLED屏幕用LVGL做参数显示，或者做一个USB HID和CDC复合设备，把开发板变成手柄或监视器。
我特别推荐往“状态显示”方向做深一点，因为很多人交作业时只交一个电机控制程序，显得很单薄。如果你把速度、电流、目标转速、PID参数都在屏幕或手机上实时显示出来，评委一看就知道你真正理解了整个系统。加屏幕其实不难，LVGL移植到STM32有大量现成例程，重要的是把电机状态数据组织好上传。真做下来，你会发现自己把定时器、PWM、ADC、DMA、串口、中断全部过了一遍，这就是一次完整的嵌入式项目训练。
最后再分享一点个人体会。做电机控制项目，程序写完只是开始，接线、供电、机械装配这些“不写代码”的环节往往决定项目成败。我见过太多人在取样速度闭环和视觉识别上花了大量时间，最后却因为电池供电不足导致一切白费。踏踏实实从驱动模块接线做起，用万用表量电压，用示波器看波形，把开环控制跑稳了再上闭环，这条路看似慢，其实是通往更高阶控制最快的一条路。
