简介：围绕STM32F103C8T6搭配L298N驱动两路直流电机实现正反转与停止的入门实践资料，面向单片机初学者、嵌入式课程实验学生以及需要快速搭建电机控制原型的开发者。文档从硬件连接入手，说明L298N输出端与两台电机的接法、控制信号与STM32引脚的对应关系、外部电源与共地处理，以及仅用5V供电时避免误接端口、电机难以转动的注意事项；软件部分给出GPIO推挽输出初始化、按键扫描、电机正转、反转和停止函数的控制逻辑，包含初始化、控制函数及主循环调用示例，并讨论延时等待、中断响应、独立电源管理、编码器测速与故障处理等改进方向。压缩包内共1个PDF文件，约6.97MB，适合电脑端阅读、打印和对照实验。已有939人学习，可作为课程设计、基础实验或自学STM32 GPIO与电机驱动的参考。
1. 从一块开发板和两个电机说起：这套 L298N 驱动代码能跑出什么
桌上摊着两个黄色减速直流电机、一块红色 L298N 双 H 桥模块、一块 STM32F103C8T6 最小系统板，杜邦线插了一排，上电之后电机不转，只有"嗡"的一声闷响，手摸 L298N 的散热片已经开始发烫。这个场景几乎所有第一次用 STM32 驱动 L298N 的人都经历过。这份资源给的是一套能直接编译下载的完整工程：三个按键分别控制两个直流电机的正转、反转、停止，逻辑跑在main.c的while(1)里，底层是motor.c里几个直接操作 GPIO 的函数。
它适合两类人：一类是刚学完 GPIO 输出、想找个"看得见摸得着"的负载练手的初学者；另一类是手里有 L298N 旧模块、想快速搭个能跑的小车底盘的开发者。代码不长，但按键扫描、GPIO 推挽输出、H 桥真值表这几块拼在一起，正好是一条完整的"输入 → 逻辑 → 执行器"链路，拆开看比看十篇原理讲解都直观。
2. 硬件链路拆解：L298N 的四个 IN 脚怎么落到 PA2~PA5
接线是这套东西里最容易翻车的一环，代码没错、线接错了，现象和"程序有 bug"几乎一模一样。先把 L298N 这块板子的端子分清楚：它一侧是大电流端（OUT1~OUT4、+12V、GND、+5V），另一侧是逻辑端（IN1~IN4、ENA、ENB）。大电流端接电机和电源，逻辑端接单片机，两边绝对不能混。
2.1 电源与共地：被忽略的那根黑线
L298N 内部是两颗 H 桥，电机电流走 VS（12V 输入端），逻辑电平走 VSS（板载 5V 稳压）。这就意味着模块上有两套电源域，而这两套电源必须共地，否则 IN1~IN4 上那 3.3V 的高电平对 L298N 来说没有参考点，芯片根本认不出你给的是高还是低。现象非常经典：单片机程序跑得好好的，串口能打印、LED 会闪，电机就是不转，或者转一下就乱抖。
所以中间那个 GND 端子要引出两根线，一根接开发板的 GND，一根接外部电源的负极。很多人只接了电源负极，忘了接开发板，结果调了一下午。
再一个坑是那个+5V端子。它是 L298N 板载稳压器的输出端，不是输入端，模块用 12V 供电时这里能输出 5V，可以拔掉跳线帽给单片机供电。如果你反过来给它灌 5V，等于拿外部电源去顶板载稳压的输出，轻则电机没劲转不动，重则稳压芯片发热保护。资源正文里写"5v端口不接，不然很难转动"，说的就是这件事。
还有一个现实问题：只有 5V 电源的时候得用升压板升到 12V。升压板的输出电流能力通常就 1~2A，两个减速电机堵转时单个就能吃掉 1A 以上，一带载电压瞬间塌下去，单片机跟着复位。我一般会先空载测一次升压板输出，再接电机。
2.2 OUT 与 IN 的分工：哪里接电机，哪里接 MCU
把接线整理成一张表，照着插基本不会错：
| L298N 端子 | 接到哪里 | 说明 |
|---|---|---|
| OUT1、OUT2 | 电机 A 的两根线 | 转向反了就把这两根对调 |
| OUT3、OUT4 | 电机 B 的两根线 | 同上 |
| IN1、IN2 | PA2、PA3 | 电机 A 的方向控制 |
| IN3、IN4 | PA4、PA5 | 电机 B 的方向控制 |
| +12V | 外部电源正极 | 升压板输出或独立电池 |
| GND | 电源负极 + 开发板 GND | 必须两点都接 |
| +5V | 悬空不接 | 板载稳压输出端 |
| ENA、ENB | 保持跳线帽短接 | 拔掉就得自己给 PWM |
IN1~IN4 是纯逻辑输入，L298N 的输入高电平门槛在 2.3V 左右，STM32 的 3.3V 推挽输出直接驱动完全够用，不需要电平转换。这一点很多人会过度设计，加一堆光耦或者电平转换芯片，其实没必要，除非你的走线很长、现场干扰大。
OUT 侧反过来要小心：电机是感性负载，启停瞬间会有反向电动势，L298N 内部有续流二极管，但劣质模块上的二极管参数虚标，长期正反转切换容易击穿。真要长时间跑，建议在电机两端并一个 0.1μF 的瓷片电容，成本几毛钱。
2.3 按键资源：为什么最后用了开发板自带的三个键
资源正文里有一句很实在的话："缺键盘，直接用了整个开发板"。这是绝大多数人的真实状态——单独买几个轻触按键还要焊板子、加得上拉电阻，不如直接用开发板上现成的三个键：KEY0、KEY1 和 WK_UP。
这三个键的接法不一样，看key.h的宏定义就是 GPIO 直接读：
#define KEY0 GPIO_ReadInputDataBit(GPIOE,GPIO_Pin_4) // 读取按键0 #define KEY1 GPIO_ReadInputDataBit(GPIOE,GPIO_Pin_3) // 读取按键1 #define WK_UP GPIO_ReadInputDataBit(GPIOA,GPIO_Pin_0) // 读取WK_UPKEY0 和 KEY1 是低电平有效——按键一端接 GPIO、一端接 GND，所以 GPIO 要配成上拉输入，平时读到 1，按下读到 0。WK_UP 反过来，是高电平有效，一端接 GPIO、一端接 3.3V，GPIO 配成下拉输入，平时读到 0，按下读到 1。
这里有个必须提前说清楚的事：代码里KEY_Init()使能的是RCC_APB2Periph_GPIOA | RCC_APB2Periph_GPIOE，用了 PE3、PE4。而标题写的 STM32F103C8T6 是 48 脚封装，根本没有 PORTE，只有 PA、PB 和部分 PC、PD。资源正文里列部件时写的是stm32f103zet6，可以看出这套key.c来自一块 100 脚以上的大板子。如果你手上是 C8T6 核心板，这两个键必须换到 PB 口上，后面第 5 章会具体讲怎么改。
3. 工程结构拆解：main / motor / key 三个文件各管什么
打开工程目录，结构非常简单，就是标准外设库那套模板加两个自建模块。没有 HAL、没有 CubeMX 生成的中间层，寄存器操作全被库函数包住了，读起来门槛低，改起来也直接。
3.1 文件职责与依赖关系
整个工程可以拆成三层：
| 文件 | 层级 | 职责 |
|---|---|---|
main.c | 应用层 | 初始化外设、主循环里轮询按键、按返回值分发动作 |
motor.c/motor.h | 驱动层 | 定义电机动作函数、GPIO 初始化、引脚电平宏 |
key.c/key.h | 驱动层 | 按键 GPIO 初始化、扫描去抖、返回键值 |
delay.c/delay.h | 基础层 | 毫秒级延时，靠 SysTick 实现 |
stm32f10x_*.c | 库层 | 标准外设库，不用改 |
依赖关系很干净：main.c同时包含motor.h和key.h，motor.c只依赖库和delay.h，key.c只依赖sys.h（里面是位带操作和类型定义）。没有循环依赖，也没有全局状态变量到处飞，两个模块互相不知道对方存在，耦合点是main.c里那个switch。
这种结构的优点是改一个模块不影响另一个；缺点是main.c会慢慢变成一坨，功能一多就得自己拆状态机。当前规模下够用。
把几个文件加进工程的方式，资源正文里也提了：找一个能编译通过的标准库模板工程（带stm32f10x_gpio.c、stm32f10x_rcc.c、启动文件、system_stm32f10x.c这些），把motor.c、motor.h、key.c、key.h、delay.c、delay.h拷进对应目录，在 Keil 的工程树里 Add Existing Files，然后改main.c。别漏了头文件路径，Options for Target → C/C++ → Include Paths里要把这几个目录都加进去，否则一堆cannot open source input file。
3.2 motor.h：四个宏把引脚操作压成一行
motor.h是整个工程里最"巧"也最容易埋雷的地方。它用宏把"给某个引脚赋高/低"压成了一个函数调用样子的东西：
#define High 1 #define Low 0 #define IN1(a) if (a) \ GPIO_SetBits(GPIOA,GPIO_Pin_2);\ else \ GPIO_ResetBits(GPIOA,GPIO_Pin_2) #define IN2(a) if (a) \ GPIO_SetBits(GPIOA,GPIO_Pin_3);\ else \ GPIO_ResetBits(GPIOA,GPIO_Pin_3) #define IN3(a) if (a) \ GPIO_SetBits(GPIOA,GPIO_Pin_4);\ else \ GPIO_ResetBits(GPIOA,GPIO_Pin_4) #define IN4(a) if (a) \ GPIO_SetBits(GPIOA,GPIO_Pin_5);\ else \ GPIO_ResetBits(GPIOA,GPIO_Pin_5)逻辑说明：IN1(High)展开后就是if (1) GPIO_SetBits(GPIOA, GPIO_Pin_2); else GPIO_ResetBits(...)，效果是把 PA2 拉高。参数a传High（即 1）或Low（即 0）。
这套写法的好处是把"电平"这个语义抽出来了，Motor_1_PRun()里读起来就是"IN1 低、IN2 高"，比直接写GPIO_ResetBits(GPIOA, GPIO_Pin_2)直观。
但它有两个真实缺陷，改代码前必须知道。
第一，宏体是多条语句，却没有用do { ... } while(0)包起来。如果哪天你写成if (flag) IN1(High); else ...，展开后else会跟宏内部那个if配对，编译器不报错，行为却完全不是你想要的。这种 bug 极难查。
第二，参数a在宏体里被if (a)求值一次，如果传的是带副作用的表达式（比如IN1(x++)），虽然当前只求值一次没出问题，但这种写法本身就不安全。
我在自己项目里的做法是直接换成static inline函数，编译期一样内联，调试器还能单步进去：
static inline void IN1(uint8_t level) { if (level) GPIO_SetBits(GPIOA, GPIO_Pin_2); else GPIO_ResetBits(GPIOA, GPIO_Pin_2); }uint8_t参数、明确的作用域、能打断点，代价只是多写几行。
3.3 Motor_12_Config：初始化那十几行到底做了什么
初始化函数是整条链路的起点，代码不长，但每一行都有存在的理由：
void Motor_12_Config(void) { GPIO_InitTypeDef GPIO_InitStructure; // 定义GPIO初始化结构体 /* 1. 开时钟：GPIOA 挂在 APB2 总线上 */ RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE); /* 2. 选引脚：IN1~IN4 对应 PA2~PA5 */ GPIO_InitStructure.GPIO_Pin = GPIO_Pin_2 | GPIO_Pin_3 | GPIO_Pin_4 | GPIO_Pin_5; /* 3. 选模式：推挽输出，能主动输出高低电平 */ GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; /* 4. 选速度：50MHz，方波沿够陡 */ GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; /* 5. 写进寄存器 */ GPIO_Init(GPIOA, &GPIO_InitStructure); /* 6. 上电默认全部拉低，避免悬空导致误动作 */ GPIO_ResetBits(GPIOA, GPIO_Pin_2 | GPIO_Pin_3 | GPIO_Pin_4 | GPIO_Pin_5); }逐项说明。第 1 步最容易漏，STM32 的外设时钟默认关闭，不开时钟写 GPIO 寄存器是无效的，现象就是"程序跑通了但引脚不动"。第 2 步用按位或把四个引脚合成一个掩码，一次配置完，比写四次GPIO_Init省事。第 3 步的GPIO_Mode_Out_PP是推挽输出，能输出强高和强低；如果选成开漏GPIO_Mode_Out_OD，高电平就变成高阻态，必须外接上拉电阻，L298N 那边会读不到高电平，电机永远不转——这是个隐蔽的选型错误。
第 4 步的 50MHz 不是"引脚跑 50MHz"，而是输出驱动器的翻转速率档位。L298N 这边是静态电平控制，选 2MHz 都够，选 50MHz 只是沿更陡、抗干扰稍好，副作用是 EMI 略大。做 PWM 调速时这个参数才真正重要。
第 6 步拉低是"安全初态"。上电瞬间如果引脚是浮空的，可能被干扰拉高，L298N 收到一个乱的电平组合，电机会抽一下。先拉低，等于先给一个确定的停止状态。
要注意的是：这里全部拉低，对 L298N 来说 IN1=0、IN2=0 是"滑行停止"（电机两端断开），而Motor_1_STOP()里给的是 IN1=1、IN2=1，那是"刹车停止"（电机两端短接）。两种停止行为不一样，下面第 4 章会细说。
4. 控制逻辑落代码：从按键扫描到 H 桥电平的完整链路
代码的执行路径是单向的：KEY_Scan返回一个键值 →main的switch匹配 → 调用对应的电机动作函数 → 动作函数里通过IN1~IN4宏改电平 → L298N 的 H 桥导通方向改变 → 电机转向改变。这条链路上每一环都可以单独测。
4.1 KEY_Scan 的松手检测与优先级
按键扫描这段代码不长，但它同时干掉了三件事：去抖、松手检测、优先级。属于典型的"看着简单其实有讲究"：
u8 KEY_Scan(u8 mode) { static u8 key_up = 1; // 按键松开标志，静态变量，跨调用保持 if (mode) key_up = 1; // mode=1 支持连按，每次进来都重置标志 if (key_up && (KEY0 == 0 || KEY1 == 0 || WK_UP == 1)) { delay_ms(10); // 去抖：等 10ms 再看 key_up = 0; // 标记已按下，防止重复触发 if (KEY0 == 0) return KEY0_PRES; else if (KEY1 == 0) return KEY1_PRES; else if (WK_UP == 1) return WKUP_PRES; } else if (KEY0 == 1 && KEY1 == 1 && WK_UP == 0) { key_up = 1; // 三个键都回到未按下状态，允许下次触发 } return 0; // 无按键 }参数mode决定行为：传 0 是单次触发，按住不放只返回一次键值，必须松手再按才能触发第二次；传 1 是连按模式，按住会一直返回键值。main.c里传的是KEY_Scan(0)，因为电机控制不需要连按——按住正转键不放，电机保持正转就行，没必要每 10ms 重复下发一次指令。
key_up是static变量，函数退出后值还在，这是松手检测的核心。没有它的话，按住按键的那几百毫秒里，主循环会以每轮几十微秒的速度疯狂返回同一个键值。
去抖的delay_ms(10)是阻塞式的，这 10ms 里 CPU 什么都不干。对电机控制这种实时性要求不高的场景无所谓，但如果以后要加编码器计数或者串口通信，这个阻塞就得改成定时器扫描。这是后话。
三个键有优先级：KEY0 > KEY1 > WK_UP。同时按下时只有 KEY0 生效，因为if-else链从上往下匹配。日常用碰不到，做组合键功能的时候要留意。
4.2 电机动作函数与 H 桥真值表
电机动作函数一共六个，每个就两行，但这两行决定了 H 桥内部四个开关管的通断组合：
void Motor_1_PRun(void) // 电机1 正转 { IN1(Low); IN2(High); } void Motor_1_NRun(void) // 电机1 反转 { IN1(High); IN2(Low); } void Motor_1_STOP(void) // 电机1 停止（刹车） { IN1(High); IN2(High); }电机 2 的三个函数完全对称，只是换成IN3/IN4，也就是 PA4/PA5。
真值表拉出来看更清楚，这也是查故障时最该先对照的一张表：
| IN1 | IN2 | H 桥状态 | 电机表现 |
|---|---|---|---|
| 0 | 0 | 四个管子全关 | 滑行停止，可自由转动 |
| 0 | 1 | 一对角管导通 | 正转 |
| 1 | 0 | 另一对角管导通 | 反转 |
| 1 | 1 | 下桥臂两个管子导通 | 刹车停止，电机两端短接 |
代码里Motor_1_STOP()用的是High/High，也就是刹车模式。刹车模式下电机绕组被短接，反电动势形成回路，会产生一个阻力矩，停车更快但电流也更大。如果你需要电机停下来后还能用手轻松拨动（比如做云台式的东西），应该改成Low/Low滑行模式。
反向的情况：如果给High/High之后电机不但不停，反而猛转，那基本可以断定 IN1 和 IN2 这两根线接反了，或者电机两根线接反了。这时候别去改代码，去换线——代码逻辑是对的，硬件接反了用代码硬掰会在后续调试里制造更多混乱。
还有一个容易忽略的点：High/High是刹车，但不能长时间保持。L298N 的两个下桥臂同时导通，电机绕组相当于被短路，如果此时电机被外力带着转，感应电流全部灌进下桥臂，模块会明显发热。做长时间停止的场景，用Low/Low更稳妥。
4.3 main 的 switch 调度与那个 delay_ms(10000)
main.c的结构是标准的"初始化 + 死循环"，逻辑全在switch里：
int main(void) { vu8 key = 0; Motor_12_Config(); // 电机 GPIO 初始化，PA2~PA5 推挽输出 delay_init(); // SysTick 延时初始化 delay_ms(10000); // 上电等 10 秒，给电源和升压板稳定时间 KEY_Init(); // 按键 GPIO 初始化 while (1) { key = KEY_Scan(0); // 单次触发模式扫描 if (key) { switch (key) { case WKUP_PRES: // WK_UP 键 -> 正转 Motor_1_PRun(); Motor_2_PRun(); delay_ms(1); break; case KEY1_PRES: // KEY1 键 -> 反转 Motor_1_NRun(); Motor_2_NRun(); delay_ms(1); break; case KEY0_PRES: // KEY0 键 -> 停止 Motor_1_STOP(); Motor_2_STOP(); delay_ms(1); break; default: break; } } else { delay_ms(10); // 无按键时让出 10ms，降低空转功耗 } } }几个参数值得说。
vu8 key里的v是volatile的宏，意思是这个变量可能被中断或硬件改变，编译器不许优化掉它。这里其实没有中断参与，加不加都行，属于习惯性写法。
delay_ms(10000)那 10 秒，正文里没解释原因，我猜是为了等升压板上电稳定。5V 升 12V 的升压模块启动瞬间输出会过冲，如果这时候电机已经在转，容易把单片机拉复位。但这 10 秒在实际调试时非常误导人——上电后按什么都没反应，新手第一反应是"程序烧进去了吗"。我一般会在这 10 秒里让一个 LED 快闪，既能确认程序在跑，又能提示"正在等待"。调试完成后直接删掉或者改成 500ms。
switch里每个 case 末尾的那个delay_ms(1)其实没什么作用，动作函数执行完电平就已经变了，延时 1ms 只是让主循环节奏稍微错开一点。真正有意义的是else分支里的delay_ms(10)，它在没按键时让 CPU 空转 10ms，降低功耗。如果把这个删掉，主循环会以全速跑KEY_Scan，每次都要读三次 GPIO，功耗上去了但没有任何收益。
default分支是防御性的。KEY_Scan出错返回了一个未定义的值，switch什么都不做，电机保持上一个状态。这个设计在按键控制里没问题，但在需要"失联保护"的场景（比如遥控），应该改成"未知指令 → 立即停止"。
整条链路走下来，从按下 WK_UP 到电机转起来，实际延迟大概是：KEY_Scan里的 10ms 去抖 + 一次switch跳转 + 两次 GPIO 写寄存器，加起来 10ms 出头。人感觉不到，但如果你以后要用这个系统做循迹或者避障，10ms 的按键延迟会变成控制环路里的固定滞后，那时候就得把按键扫描挪到定时器中断里。
5. 避坑与排查：上电不转、只抖不跑、按键乱跳的现场记录
这一章全是血泪。下面五条都是我或者身边人真实踩过的，现象看起来五花八门，根因其实就那么几个。
5.1 五条高频翻车记录
第一条：电机完全不转，L298N 的电源指示灯是亮的。
现象：程序能下载，开发板上 LED 会闪，串口打印正常，但两个电机纹丝不动，L298N 的红色电源灯是亮的，摸散热片不热。
原因：没共地。只把外部电源的负极接到了 L298N 的 GND，开发板的 GND 悬空。L298N 的逻辑输入没有参考地，3.3V 在它眼里是个悬空电压，芯片判定不出高低电平。
解决：从 L298N 中间的 GND 端子再引一根线到开发板的 GND，两根地线都要接。验收方法是万用表测开发板 GND 和电源负极之间的电压，正常应该接近 0V，超过几十毫伏就是没接好。
第二条：电机只抖不转，或者转一下停一下，开发板跟着复位。
现象：按下正转键，电机"咯噔"一下就没动静了，同时开发板上的电源指示灯闪了一下。
原因：供电塌陷。用 5V 升 12V 的升压板给 L298N 供电，电机启动瞬间的堵转电流把升压板输出拉垮，电压掉到 5V 以下，单片机复位。L298N 内部还有约 1.4~2V 的压降，12V 进到电机端实际只有 10V 左右，本来就没劲，再一塌就更转不动。
解决：换独立电源。电池组或者 12V 电源适配器，输出电流至少按"两个电机堵转电流之和 × 1.5"来算。实在要用升压板，就在升压板输出并一个大电容（1000μF 以上）做缓冲，同时把main.c里那个delay_ms(10000)保留长一点，等电源稳了再动。
第三条：只有 KEY0 和 KEY1 不灵，WK_UP 正常。
现象：按 WK_UP 电机转得好好的，按 KEY0 和 KEY1 毫无反应，偶尔抽风式地触发一次。
原因：key.c里KEY_Init()的引脚配置写重复了。原代码是这样的：
GPIO_InitStructure.GPIO_Pin = GPIO_Pin_4|GPIO_Pin_3; // 第一行 GPIO_InitStructure.GPIO_Pin = GPIO_Pin_5; // 第二行覆盖了第一行 GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IPU; GPIO_Init(GPIOE, &GPIO_InitStructure);第二行把第一行的掩码整个覆盖掉了，实际只初始化了 PE5。PE3 和 PE4 保持复位后的浮空输入状态，没有内部上拉，读出来的值随环境飘，所以按键时灵时不灵。
解决：把两行合并成一行：
GPIO_InitStructure.GPIO_Pin = GPIO_Pin_3 | GPIO_Pin_4 | GPIO_Pin_5; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IPU; // 上拉输入如果 PE5 另有用途，就拆成两次独立的GPIO_Init调用，别指望一次结构体配置能管两拨引脚。
第四条：C8T6 核心板上编译不过，提示 GPIOE 未定义。
现象：把工程放进 C8T6 的模板里，key.c编译报错，或者编译过了但按键完全没反应。
原因：STM32F103C8T6 是 48 脚封装，物理上没有 PORTE。标题写的是 C8T6，但key.c里用了RCC_APB2Periph_GPIOE和GPIOE，这套代码来自 100 脚以上的大容量型号（正文里列的部件是stm32f103zet6）。
解决：把按键换到 C8T6 有的端口上，比如 KEY0 用 PB0、KEY1 用 PB1、WK_UP 用 PA0（PA0 在 C8T6 上是有的，且复位后默认就是下拉，正好适合高电平有效的按键）：
void KEY_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_GPIOB, ENABLE); /* KEY0=PB0, KEY1=PB1：上拉输入，按下读到 0 */ GPIO_InitStructure.GPIO_Pin = GPIO_Pin_0 | GPIO_Pin_1; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IPU; GPIO_Init(GPIOB, &GPIO_InitStructure); /* WK_UP=PA0：下拉输入，按下读到 1 */ GPIO_InitStructure.GPIO_Pin = GPIO_Pin_0; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IPD; GPIO_Init(GPIOA, &GPIO_InitStructure); }记得同步改key.h里的KEY0、KEY1宏，把GPIOE换成GPIOB，引脚号换成GPIO_Pin_0、GPIO_Pin_1。这两处不同步是另一个高频错误。
第五条：接上 5V 之后电机能转，但特别慢、没劲。
现象：L298N 的 +5V 端子接了外部 5V 电源，电机能转但明显无力，调什么参数都不行。
原因：+5V 是板载稳压器的输出，不是输入。外部灌 5V 进去，等于跟板载稳压器顶牛，逻辑电路供电异常，H 桥的驱动能力被削弱。同时 12V 输入端如果只给了 5V，电机端实际只有 3V 出头，当然没劲。
解决：把 +5V 端子的线拔掉，只保留 +12V 和 GND。逻辑供电由板载稳压器从 12V 降压产生。如果 12V 电源本身没有（比如只有 5V），那就老老实实加升压板，别想着从 5V 端子反向灌。
5.2 上电前的自检顺序
按这个顺序走一遍，能省掉大部分返工。
第一步，断电状态下用万用表蜂鸣档测三处通断：开发板 GND 到 L298N GND、L298N GND 到电源负极、L298N +12V 到电源正极。三处都通，再上电。
第二步，上电但不下载程序，用手指轻拨电机轴，应该能自由转动（此时 IN 全低，滑行状态）。如果拨不动，说明 H 桥已经导通了，这时候千万别插电机，先查接线。
第三步，下载程序，上电后等过那 10 秒，按 WK_UP。如果电机转但方向反了，去换 OUT1/OUT2 的线，别改代码。
第四步，如果还不转，用万用表直流电压档测 IN1 和 GND 之间的电压，按键时应该在 0V 和 3.3V 之间切换。有跳变说明单片机侧没问题，故障在 L298N 或电机侧；没跳变说明 GPIO 配置或者按键扫描有问题，回到第 3 章查。
6. 二次开发：从"能转"到"能调速、能闭环"的改造路线
这套代码的定位是"最小可用"，真要拿去做小车或者机械臂，第一件事就是加调速。L298N 有 ENA 和 ENB 两个使能端，出厂时用跳线帽短接到 5V，意思是"全速"。把跳线帽拔掉，往 ENA 上灌 PWM，就能调速。
具体做法是把 PA2~PA5 保持为方向控制，另外找一个带定时器的引脚（比如 PA6 对应 TIM3_CH1）配成复用推挽输出，用 TIM3 产生 10kHz 左右的 PWM：
void Motor_PWM_Init(uint16_t arr, uint16_t psc) { GPIO_InitTypeDef GPIO_InitStructure; TIM_TimeBaseInitTypeDef TIM_TimeBaseStructure; TIM_OCInitTypeDef TIM_OCInitStructure; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE); RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM3, ENABLE); /* PA6 -> TIM3_CH1，复用推挽 */ GPIO_InitStructure.GPIO_Pin = GPIO_Pin_6; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOA, &GPIO_InitStructure); TIM_TimeBaseStructure.TIM_Period = arr; // 自动重装值，决定 PWM 分辨率 TIM_TimeBaseStructure.TIM_Prescaler = psc; // 预分频，决定 PWM 频率 TIM_TimeBaseStructure.TIM_ClockDivision = 0; TIM_TimeBaseStructure.TIM_CounterMode = TIM_CounterMode_Up; TIM_TimeBaseInit(TIM3, &TIM_TimeBaseStructure); TIM_OCInitStructure.TIM_OCMode = TIM_OCMode_PWM1; TIM_OCInitStructure.TIM_OutputState = TIM_OutputState_Enable; TIM_OCInitStructure.TIM_Pulse = 0; // 初始占空比 0 TIM_OCInitStructure.TIM_OCPolarity = TIM_OCPolarity_High; TIM_OC1Init(TIM3, &TIM_OCInitStructure); TIM_OC1PreloadConfig(TIM3, TIM_OCPreload_Enable); TIM_Cmd(TIM3, ENABLE); }参数怎么定：arr和psc决定了 PWM 频率，公式是72MHz / ((arr+1) * (psc+1))。想要 10kHz、分辨率 100 级，就取arr=99、psc=71，算下来正好 10kHz。占空比通过TIM_SetCompare1(TIM3, duty)改，duty范围 0~arr。频率别低于 1kHz，否则电机会听到啸叫；也别高于 20kHz，L298N 的开关损耗会明显上升，模块发烫。
第二件事是改按键扫描。现在是 10ms 阻塞去抖，一旦加了串口或者编码器，这 10ms 就是灾难。我一般会把KEY_Scan挪到 1ms 的 SysTick 中断里，中断里只做状态机累加计数，主循环读标志位，彻底不阻塞。
第三件事是给电机加状态缓存。现在Motor_1_PRun()是直接写 GPIO，重复调用会重复写寄存器。改成一个motor_state结构体记录当前方向和占空比，动作函数先比较再写，既省寄存器操作，也方便以后加"软启动"——占空比从 0 开始按 100ms 一档往上爬，能明显减少齿轮箱的冲击和电流尖峰。
第四件事是错误处理。现在如果 L298N 因为过热保护关断，程序完全不知道，还在那儿傻等按键。加一个电流采样电阻 + ADC，或者简单点加个温度传感器贴着散热片，超过阈值就强制停机并在串口打印原因，比事后拆机查线强得多。
我第一次搭这套东西的时候，调了整整一个下午，最后发现是开发板 GND 那根杜邦线插在了排针的缝隙里，看着插进去了其实没接触。从那以后我每次接线完都强制走一遍万用表的通断档，一根一根确认，再上电。这个习惯后来救了我很多次。希望帮到你。
本文还有配套的精品资源，点击获取
