简介：这份资源面向使用STM32单片机驱动28BYJ-48步进电机的初学者与嵌入式开发者，提供一套经过实测可用的控制代码，支持角度调节与正反转控制，适合学习步进电机驱动原理、定时器PWM输出与GPIO时序控制等基础实验场景。压缩包共120个文件，约2.39MB，以31个c源文件与32个h头文件为核心，涵盖stm32f10x_tim、rcc、usart等标准外设库模块，另含Keil工程文件（uvprojx、uvoptx）、编译中间文件及hex烧录文件，工程结构完整，可直接打开编译与下载验证。该资源已有4316人学习下载，具备一定的参考基础。读者可从中获得一套可直接运行的电机控制工程模板，便于对照理解步进电机相序驱动、转速与角度参数调整方法，并在此基础上快速移植到自己的STM32项目中，减少从零搭建工程的时间成本。
1. 从一颗“抖一下”的电机说起
手头有一块 STM32 最小系统板，一个 28BYJ-48 步进电机，外加一块 ULN2003 驱动板，这是很多人入门嵌入式控制时最先凑齐的一套硬件。它便宜、好买、接线简单，但真正上手就会发现：电机要么原地抖两下不转，要么转起来嗡嗡响、丢步、发热，甚至把驱动板上的芯片烫得不敢碰。STM32 控制 28BYJ-48 步进电机这件事，难点从来不在“让电机转”，而在于转得稳、转得准、能停下来、能换方向、能调速，还能和按键、串口、定时器这些外设配合起来。这篇笔记面向的是已经拿到源码、想把它跑起来或者改成自己项目里一个执行机构的开发者，从工程结构、驱动时序、定时器中断到二次开发，一层层拆开讲清楚。
2. 项目定位与技术选型：为什么是 STM32 加 ULN2003 这套组合
2.1 这个项目到底在解决什么问题
28BYJ-48 是一颗四相永磁式减速步进电机，内部带减速齿轮，输出轴转速低、扭矩相对可观，常见于小转台、阀门、云台、教学演示装置。它的线圈不能直接接单片机 IO，因为每相工作电流在几十毫安级别，四相同时导通时总电流会超过 STM32 单个 IO 的驱动能力，所以必须经过驱动级。ULN2003 是七路达林顿晶体管阵列，每路带续流二极管，正好用来做四相线圈的低边开关，这也是市面上最常见的“电机 + 驱动板”套装形态。
项目要解决的核心问题可以拆成四件事：第一，按正确的相序给四相线圈通电，让转子一步步走；第二，控制每一步之间的时间间隔，从而控制转速；第三，支持正反转和停止；第四，把这些动作封装成可复用的接口，方便上层业务调用。STM32 在这里承担的是“时序发生器 + 状态机”的角色，用 GPIO 输出相序，用定时器产生节拍，用主循环或中断处理按键与命令。
2.2 技术栈与硬件连接
从工程角度看，这套项目涉及的技术栈并不复杂，但每一层都有讲究：
| 层次 | 选型 | 作用 |
|---|---|---|
| 主控 | STM32F103 系列（常见最小系统板） | 产生相序信号、处理输入 |
| 驱动 | ULN2003 驱动板 | 电流放大、续流保护 |
| 执行器 | 28BYJ-48 四相步进电机 | 位置执行 |
| 开发环境 | Keil MDK 或 STM32CubeIDE | 编译、下载、调试 |
| 底层库 | 标准外设库或 HAL 库 | GPIO、TIM 配置 |
接线方式是固定的：STM32 的四个 GPIO 分别接 ULN2003 的 IN1 到 IN4，驱动板输出端接电机五线插头，驱动板 VCC 接 5V，GND 与 STM32 共地。这里有一个容易被忽略的点：ULN2003 驱动板的逻辑输入是 3.3V 兼容的，但电机侧供电必须是 5V，如果只给 3.3V，电机扭矩会明显不足，表现为“能转但带不动负载”。共地更是血泪经验，不共地时 IO 电平没有参考，电机行为会变得完全不可预测。
2.3 相序方案的选择
28BYJ-48 常见有三种驱动方式：单四拍、双四拍、八拍。单四拍每次只通一相，步距角大、扭矩小；双四拍每次通两相，扭矩大但步距角同样较大；八拍是单双交替，步距角减半，运行更平滑，是实际项目里最常用的方案。以 A、B、C、D 表示四相，八拍相序为 A-AB-B-BC-C-CD-D-DA，循环往复。代码里通常把它写成一个二维数组或者一维编码表，按索引取相。
/* 八拍相序表：每行对应一次节拍，bit0~bit3 分别对应 A/B/C/D 相 */ static const uint8_t phase_table[8] = { 0x01, /* A */ 0x03, /* A + B */ 0x02, /* B */ 0x06, /* B + C */ 0x04, /* C */ 0x0C, /* C + D */ 0x08, /* D */ 0x09 /* D + A */ };这张表是整个驱动的核心数据。索引递增即正转，递减即反转，取模 8 保证循环。用位编码而不是四个独立布尔量，好处是写端口时可以一次性输出，减少相与相之间的切换毛刺。参数上唯一需要关心的是表长必须与节拍数一致，八拍就是 8，如果误用四拍表却按 8 取模，会出现相序错乱导致电机原地抖动。
3. 工程结构与核心驱动代码拆解
3.1 目录组织与模块划分
一个能跑、能改的工程，目录不应该把所有东西堆在 main.c 里。常见的组织方式是按职责分层：底层驱动放 bsp 或 drivers 目录，业务逻辑放 app 目录，公共定义放 inc 目录。以标准外设库工程为例，典型结构如下：
project/ ├── Core/ │ ├── Inc/ │ │ ├── stepper.h /* 电机接口声明 */ │ │ └── main.h │ └── Src/ │ ├── main.c /* 初始化与主循环 */ │ ├── stepper.c /* 相序输出与节拍控制 */ │ └── stm32f1xx_it.c /* 定时器中断入口 */ ├── Drivers/ │ └── ... /* 库文件 */ └── MDK-ARM/ 或 STM32CubeIDE/stepper.c 只关心“怎么让电机走一步”，main.c 只关心“什么时候让它走、走多少步”。这种划分在后期加按键、加串口命令、加限位开关时优势非常明显，不需要动驱动层。我一般会把相序表、当前步索引、方向标志、剩余步数都收在一个结构体里，避免全局变量散落。
3.2 GPIO 初始化与相序输出
驱动层第一件事是把四个 IO 配成推挽输出，初始电平拉低，保证上电瞬间电机不会乱动。下面以标准外设库为例，HAL 库写法只是函数名不同，逻辑一致。
/* 初始化四相控制 IO，默认全部输出低电平 */ void Stepper_Init(void) { GPIO_InitTypeDef gpio; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE); gpio.GPIO_Pin = GPIO_Pin_0 | GPIO_Pin_1 | GPIO_Pin_2 | GPIO_Pin_3; gpio.GPIO_Mode = GPIO_Mode_Out_PP; /* 推挽输出 */ gpio.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOA, &gpio); GPIO_ResetBits(GPIOA, GPIO_Pin_0 | GPIO_Pin_1 | GPIO_Pin_2 | GPIO_Pin_3); }这里四个引脚选在同一端口，是为了后面能用一次写操作更新全部相位。如果分散在不同端口，输出时就要分多次写，相与相之间会产生微秒级的不同步，低速时看不出来，高速时会引起丢步。参数上 GPIO_Speed 选 50MHz 对步进电机来说绰绰有余，实际节拍频率通常只有几百赫兹到几千赫兹。
3.3 单步执行与方向控制
单步函数负责把当前索引对应的相位写到端口，然后更新索引。方向用一个有符号变量表示，正转加一，反转减一，取模时注意负数处理。
static int8_t step_index = 0; /* 当前相序索引 0~7 */ static int8_t direction = 1; /* 1 正转，-1 反转 */ /* 走一步：根据方向和索引输出对应相位 */ void Stepper_Step(void) { uint8_t phase = phase_table[step_index]; /* 一次性写四个引脚，bit0~bit3 对应 PA0~PA3 */ GPIO_WriteBit(GPIOA, GPIO_Pin_0, (phase & 0x01) ? Bit_SET : Bit_RESET); GPIO_WriteBit(GPIOA, GPIO_Pin_1, (phase & 0x02) ? Bit_SET : Bit_RESET); GPIO_WriteBit(GPIOA, GPIO_Pin_2, (phase & 0x04) ? Bit_SET : Bit_RESET); GPIO_WriteBit(GPIOA, GPIO_Pin_3, (phase & 0x08) ? Bit_SET : Bit_RESET); step_index = (step_index + direction + 8) % 8; }+8再取模是为了处理 direction 为 -1 时索引变成负数的情况，这是 C 语言取模对负数结果不直观的经典坑。如果用的是位带操作或者直接操作 ODR 寄存器，可以把四次 WriteBit 合并成一次写，效率更高，但在 F103 上四次函数调用的开销对步进电机节拍来说完全可以接受。方向切换时不要立刻反向输出，最好先停一个节拍，否则电机可能因为惯性出现失步。
3.4 定时器节拍：让转速可控
用主循环加延时来走步，转速会受其他任务影响，一旦加入按键扫描或串口打印，电机就会一顿一顿。正确做法是用定时器中断产生固定节拍，在中断里调用 Stepper_Step。以 TIM3 为例，配置成 1ms 基准，再在中断里做软件分频，就能得到任意步进间隔。
/* TIM3 配置为 1ms 中断，作为步进节拍基准 */ void Stepper_Timer_Init(uint16_t step_interval_ms) { TIM_TimeBaseInitTypeDef tim; NVIC_InitTypeDef nvic; RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM3, ENABLE); tim.TIM_Prescaler = 7200 - 1; /* 72MHz / 7200 = 10kHz */ tim.TIM_Period = 10 - 1; /* 10kHz / 10 = 1kHz，即 1ms */ tim.TIM_CounterMode = TIM_CounterMode_Up; tim.TIM_ClockDivision = TIM_CKD_DIV1; TIM_TimeBaseInit(TIM3, &tim); TIM_ITConfig(TIM3, TIM_IT_Update, ENABLE); nvic.NVIC_IRQChannel = TIM3_IRQn; nvic.NVIC_IRQChannelPreemptionPriority = 1; nvic.NVIC_IRQChannelSubPriority = 1; nvic.NVIC_IRQChannelCmd = ENABLE; NVIC_Init(&nvic); TIM_Cmd(TIM3, ENABLE); }中断服务函数里做计数分频，计满 step_interval_ms 才走一步，这样改转速只需要改一个变量，不用重配定时器。参数含义：Prescaler 决定计数频率，Period 决定溢出周期，两者相乘再除以系统时钟就是中断间隔。72MHz 下 7200 分频得 10kHz，周期计 10 个数溢出一次，正好 1ms。如果系统时钟不是 72MHz，这两个值必须同步改，否则节拍全错。
volatile uint16_t step_interval = 5; /* 每 5ms 走一步 */ static uint16_t tick_count = 0; void TIM3_IRQHandler(void) { if (TIM_GetITStatus(TIM3, TIM_IT_Update) != RESET) { TIM_ClearITPendingBit(TIM3, TIM_IT_Update); if (++tick_count >= step_interval) { tick_count = 0; if (steps_remaining > 0) { /* 还有步数要走 */ Stepper_Step(); steps_remaining--; } } } }steps_remaining 是上层设置的目标步数，中断里递减到 0 自动停，这样“走 N 步”就是一个原子操作，不需要主循环去轮询。注意这个变量要被主循环和中断同时访问，声明成 volatile 是必须的，否则编译器优化后主循环可能读到旧值。
4. 运行与调试：从编译下载到电机真正转起来
4.1 编译环境与下载流程
工程拿到手后，先确认用的是标准外设库还是 HAL 库，两者不能混用。Keil 下打开工程文件，检查 Options 里的器件型号是否与实际板子一致，Debug 页选择 ST-Link 或 DAP-Link，Flash Download 里勾选对应算法。编译通过后下载，复位，观察电机。如果电机完全不动，先别怀疑代码，用万用表量驱动板 IN1 到 IN4 在运行时的电平变化，有变化说明 MCU 侧正常，问题在驱动或供电；没变化再回头查 GPIO 和定时器。
STM32CubeIDE 的流程类似，只是工程由 CubeMX 生成，注意生成代码时不要把用户代码写在/* USER CODE */标记之外，否则重新生成会被覆盖。这是很多人第一次用 CubeMX 时踩的坑，改了半天发现一重新生成全没了。
4.2 上电自检与最小验证
在接入完整业务之前，先写一个最小验证：上电后电机正转一圈，停 1 秒，反转一圈，循环。这个动作能同时验证相序、方向、节拍和供电四件事。28BYJ-48 输出轴转一圈需要的步数不是 8 的整数倍，因为内部有减速比，常见参数是减速比约 1:64，转子步距角 5.625 度，八拍下输出轴一圈大约需要 4096 步。这个数字因批次略有差异，实际项目里我一般用 4096 作为初值，再根据实际转角微调。
/* 最小验证：正转一圈，停一秒，反转一圈 */ int main(void) { Stepper_Init(); Stepper_Timer_Init(5); while (1) { Stepper_MoveSteps(4096, 1); /* 正转一圈 */ Delay_ms(1000); Stepper_MoveSteps(4096, -1); /* 反转一圈 */ Delay_ms(1000); } }Stepper_MoveSteps 内部只做两件事：设置 direction 和 steps_remaining，然后返回，实际走步由中断完成。这种“设置目标 + 中断执行”的模式，主循环可以继续做别的事，不会被电机阻塞。Delay_ms 在这里只是演示，实际项目里应该用非阻塞的定时状态机替代。
4.3 用串口或按键做交互验证
电机能转之后，下一步是验证可控性。最省事的办法是接一个按键做启停，或者用串口发命令。串口方案调试信息更丰富，可以打印当前步数、方向、间隔，方便定位问题。命令协议不用复杂，单字符即可：+加速，-减速，f正转，b反转，s停止。解析放在主循环，收到命令只改参数，不动中断里的执行逻辑，这样职责清晰，也不会因为串口中断优先级问题打乱节拍。
调试时建议把 step_interval 的当前值一并打印出来，因为“感觉变慢了”这种主观判断不可靠，有数字才能对比。另外，加速不要一次跨度太大，从 10ms 逐步降到 2ms，观察电机是否出现失步或堵转异响，找到这套硬件能稳定运行的下限，这个下限就是后续业务里转速的上限。
5. 避坑与常见问题排查
5.1 电机只抖不转
现象：上电后电机发出轻微“哒哒”声，轴不转或只来回摆。原因通常是相序错误或接线顺序与代码不一致。ULN2003 板上 IN1 到 IN4 对应电机 A 到 D 相，如果插头插反或者代码里引脚映射写错，相序就乱了。解决办法是拿万用表逐路确认，或者写一个只通单相的程序，手动依次给 A、B、C、D 通电，看电机是否按固定方向小步转动，确认物理顺序后再套八拍表。
5.2 转起来但扭矩不足、带不动负载
现象：空载能转，一加负载就停或者丢步。原因多半是供电问题，驱动板接了 3.3V 而不是 5V，或者电源电流不够。28BYJ-48 四相同时导通时电流不小，用 USB 口直接供电经常不够。解决办法是给驱动板单独供 5V，且与 MCU 共地，电源额定电流留足余量。另一个原因是节拍太快，步进电机有启动频率限制，突然给很高的节拍会失步，需要加减速过程。
5.3 加入其他功能后电机一顿一顿
现象：单独跑电机正常，一加按键扫描或串口打印，转速就变得不均匀。原因是用了主循环延时走步，其他任务占用了时间。解决办法是把走步搬到定时器中断里，主循环只负责设置目标，这也是前面代码采用的结构。如果中断里还有其他耗时操作，要检查中断优先级和执行时间，步进节拍中断应保持短小。
5.4 电机发热严重甚至驱动板烫手
现象：运行一段时间后电机外壳明显发热，ULN2003 芯片烫手。原因是线圈长时间通电，尤其是停止时仍保持某一相导通。步进电机静态保持需要通电，但如果业务允许，停止后应关闭所有相位输出，让电机自由状态，减少发热。另外检查是否误用了双四拍且占空比过高，八拍方案在同样转速下发热相对更均匀。驱动板烫手还要确认续流二极管方向正确，驱动板本身自带，不要额外乱接。
5.5 步数不准、累计误差大
现象：让电机走 4096 步，实际转角不是一圈，多次往返后偏差越来越大。原因是每圈步数参数不准，或者存在丢步。先空载低速跑多次往返，看是否回到原点，排除丢步；再微调每圈步数。注意 28BYJ-48 的减速比和步距角存在批次差异，4096 只是常用初值，精确应用需要用外部基准（比如标记线）实测校准，把校准值写成宏，方便不同硬件复用。
6. 二次开发：把电机驱动改成项目里的可靠执行模块
拿到这份代码后，真正要做的往往不是让它转，而是把它变成一个能被业务调用的模块。我的习惯是先定义一层清晰的接口，把“走多少步、什么方向、什么速度、是否等待完成”这几个语义固定下来，底层怎么实现（中断还是 DMA、哪个定时器）对上层透明。接口大致长这样：
/* 业务层只依赖这几个函数，不关心底层定时器 */ void Stepper_SetSpeed(uint16_t interval_ms); /* 设置节拍间隔 */ void Stepper_MoveSteps(int32_t steps); /* 带符号步数，正负即方向 */ void Stepper_Stop(void); /* 立即停止并关相 */ uint8_t Stepper_IsBusy(void); /* 是否还在走 */Stepper_MoveSteps 接收带符号步数，内部把符号转成 direction，绝对值写入 steps_remaining，这样上层不用分别调正反转。Stepper_IsBusy 让上层可以做非阻塞等待，比如主循环里判断忙不忙，忙就继续处理其他任务，不忙再发下一条指令。这套接口在加限位开关时也很好扩展：中断里每走一步检查限位 IO，触发就清零 steps_remaining 并置一个到位标志。
改造时有两个验证方法我每次都会走一遍。第一是往返一致性测试：正转 N 步再反转 N 步，用标记线看是否回到起点，偏差超过预期就查丢步。第二是变速边界测试：从慢到快逐步缩短间隔，记录第一次出现失步的间隔值，把这个值乘以安全系数作为业务里的最快速度。这两个测试不需要额外硬件，一支记号笔加一张纸就能做，但能挡掉大部分后期“偶发不准”的问题。
还有一个容易被忽略的改造点：多电机协同。如果项目里有两个以上 28BYJ-48，共用一个定时器做节拍、在中断里轮询每个电机的剩余步数，比每个电机开一个定时器更省资源，也更容易做同步启停。代价是中断执行时间变长，需要控制单次中断里的工作量，必要时把相序输出做成查表加端口批量写。
从那以后我每次把这类电机接进新项目，都强制先跑一遍单相手动测试和往返一致性测试，再谈业务逻辑。硬件这东西，玄学往往只是没量到的那根线。希望帮到你。
本文还有配套的精品资源，点击获取
