简介：面向STM32F103C8T6开发者的步进电机驱动完整例程，基于HAL库实现，涵盖GPIO推挽输出、定时器PWM生成、中断换相以及细分驱动等关键环节，适合刚入门电机控制的学生、工程师，也适合需要参考实际硬件接线的项目开发者。压缩包共有131个文件，以C源码、H头文件为主，同时保留uvprojx工程文件、axf/hex编译输出和ioc引脚配置，便于直接打开、烧录与二次修改，压缩后大小约5.71MB，目录结构清晰。资源已有4540人学习，教程内容从步进电机的步距角与励磁顺序讲起，细化到加减速、失步处理等工程问题，并提醒电源匹配注意事项；拿到后既可作为课堂实验代码，也能快速移植到自己项目中，是一份理论与实践结合紧密的电机控制资料。 stm32f103c8t6步进电机驱动程序，这个话题几乎是每个玩过F103C8T6最小系统板的人都绕不开的一关。十几块钱的板子，配上十几块钱的步进电机和驱动板，就能搭出雕刻机、机械臂、循迹小车这类项目最基础的运动单元。但同样一套代码，有人一次通电就顺畅运转，有人却卡在“电机只抖不转”和“方向永远反着来”的坑里，烧录几十次依然无果。这篇文章我就把一次完整的步进电机驱动开发过程从头到尾捋一遍：先认清硬件，再讲CubeMX工程配置，然后是能直接用的驱动代码，最后重点说说调试中那些用示波器看不出来、但实际一定会遇到的坑。无论你手头是28BYJ-48五线四相电机，还是42步进电机配A4988，这套流程都能直接套。
1. 先把硬件认清：28BYJ-48、42步进电机与F103C8T6引脚分配
写驱动之前，最容易被忽略但最重要的一件事，是把手上的硬件分清楚。很多朋友上来就搜“步进电机驱动程序”，结果网上的代码一会儿是GPIO翻转、一会儿是PWM脉冲，把自己看晕了——其实原因很简单，不同步进电机需要的驱动方式完全不同，混用代码就是“只抖不转”的头号来源。
1.1 28BYJ-48 + ULN2003：小扭矩场景的入门组合
28BYJ-48是一款小型四相五线永磁式步进电机，自带1/64减速齿轮箱，市场上最常见的驱动板就是ULN2003达林顿管阵列模块。它内部结构决定了它天然适合低速、小扭矩的场景，比如智能窗帘、云台、小型机械臂，不适合拿去带雕刻机主轴这类负载。
接线这块我多说几句。它的五根线里，红色通常是公共端，接5V；蓝色、粉色、黄色、橙色分别对应四个相位线圈，接到ULN2003模块的IN1到IN4。但是不同厂家出来的电机颜色排列经常不一样，所以最靠谱的确认方法不是对着网图看颜色，而是用万用表电阻档去量：公共端到另外四根线之间电阻大致相等，大约在50欧姆左右，任意两根相线之间的电阻则是公共端到单相电阻的两倍。这个判断方法在我踩过几次颜色坑之后成了固定操作，能省很多时间。
ULN2003模块的输入端可以直接接受3.3V逻辑，F103C8T6的GPIO输出驱动它没有问题。每通道能承受约500mA，驱动28BYJ-48这类小电机绰绰有余。需要强调的是，这种电机空载转速非常低，输出轴转一圈大约需要4096个脉冲，所以它天生就不是为高速准备的，把频率拉太高反而会丢失力矩，得不偿失。
1.2 42步进电机 + A4988：雕刻机与3D打印的主流方案
再说另一种更常见的组合：两相四线42步进电机搭配A4988驱动板。这种电机的工作电压一般在8~35V，额定电流常见0.4A~1.7A，必须通过A4988这类专用驱动芯片来供电和控制，绝对不可能直接用GPIO去驱动绕组，电流完全不够。
A4988模块上有几个关键引脚：VMOT接电机外部电源，VDD接3.3V或5V逻辑电源（F103C8T6输出3.3V刚好兼容），STEP接收脉冲输入，每来一个上升沿电机走一步；DIR控制方向电平；ENABLE低电平使能；MS1/MS2/MS3三个引脚用来设置细分模式。细分是这类驱动器的核心功能，它让每个脉冲对应的机械角度变小，从而让运行更平滑、噪声更低。常用组合是全部悬空为1细分，逐次配置可以实现1/2、1/4、1/8、1/16细分，越细分同样转速下需要的脉冲频率越高，但位置分辨率也越高。
另外有个很容易被忽略的硬件细节：A4988模块的VMOT引脚旁边一定要接一个10μF以上的电解电容，否则电机供电一波动，轻则电机抖动，重则驱动板直接损坏。这个电容在很多淘宝模块上出厂时被省略了，需要自己焊上去，别省这一步。
1.3 F103C8T6引脚能力与接线速查
F103C8T6是Cortex-M3内核，主频72MHz，GPIO翻转速度理论上可以达到50MHz，但实际用在步进电机驱动场景下，脉冲频率通常只有几百Hz到几十kHz，完全够用。3.3V逻辑电平既能直接给ULN2003输入端，也能满足A4988的VDD要求，不需要额外电平转换。
我常用的一组接线是这样的，程序示例也都按这个引脚分配来写，你可以根据自己板子灵活调整：
| ULN2003（28BYJ-48方案） | F103C8T6引脚 | 说明 |
|---|---|---|
| IN1 | PA0 | 对应蓝色线圈（以实际测量为准） |
| IN2 | PA1 | 对应粉色线圈 |
| IN3 | PA2 | 对应黄色线圈 |
| IN4 | PA3 | 对应橙色线圈 |
| VCC | 外部5V正极 | 给驱动板供电，不要从3.3V取电 |
| A4988（42步进电机方案） | F103C8T6引脚 | 说明 |
|---|---|---|
| STEP | PA0（TIM2_CH1） | 接收PWM脉冲 |
| DIR | PA1 | 方向电平，高低切换 |
| ENABLE | PA2 | 低电平使能 |
| VDD | 3.3V | 逻辑电源 |
| VMOT | 外部8~35V | 电机主电源 |
| GND | GND | 必须共地，这是重中之重 |
电源共地这个点我必须单独拎出来强调一遍。不少人用USB给开发板供电，同时用外部开关电源给A4988供电，结果两边地不接在一起，STEP脉冲的高电平参考电位就乱了，电机会出现不转、乱转、抖动等一堆莫名其妙的现象。只要把两路电源的负极接到一起，很多问题当场消失。
2. 用CubeMX + HAL库搭建驱动工程：定时器是关键
硬件接好之后，软件工程的结构直接影响后续调试难度。我现在的习惯是CubeMX生成HAL库工程，因为无论用标准库还是HAL，真正涉及步进电机驱动的核心逻辑其实差不多，但HAL库对定时器的封装更直观，而且换芯片时改动量小。特别是你以后从C8T6换到F103RCT6或者国产替代型号时，引脚重映射一下就行，驱动代码几乎不用动。
2.1 为什么不用delay而是用定时器
新手最容易写的驱动是这样：把GPIO置高、延时一下、置低、再延时，循环产生脉冲。这种方法做演示确实可以，但有两个硬伤。第一个是CPU全程被占死，电机一转，LCD刷新、按键扫描、串口通信全部卡住；第二个是脉冲间隔完全依赖延时函数的准确性，一旦在循环里插了别的事，脉冲频率就变得不均匀，步进电机的“每脉冲走固定角度”这种特性就会受影响，高速时还容易加剧失步。
所以实际项目里，要么用定时器PWM输出脉冲信号给A4988的STEP引脚，要么用定时器中断去驱动28BYJ-48的相序状态机。定时器的优势在于，脉冲的产生是硬件自动完成的，CPU不用管，只需要设置好频率参数，然后该干嘛干嘛去。
频率计算的公式也不难理解：定时器输入时钟一般是72MHz，经过预分频器PSC分频后得到计数时钟，再经过自动重装载值ARR计数到一个周期。最终输出脉冲频率f = 72MHz / ((PSC + 1) × (ARR + 1))。比如PSC设为71，计数时钟就是1MHz；ARR设为999，输出频率正好是1kHz，也就是每秒1000个脉冲。这样算下来，想让电机跑某个速度，反推ARR就行，非常直接。
2.2 CubeMX里的关键配置项
在CubeMX中新建工程，器件选择STM32F103C8Tx。有两点配置一定要提前做对。
第一点，SYS里的Debug选项要选Serial Wire。否则工程默认禁用了SWD接口，程序第一次烧录进去之后，ST-Link就再也连不上芯片了，那滋味非常酸爽。第二点，RCC里HSE选Crystal/Ceramic Resonator，前提是你的最小系统板上有8MHz晶振。如果用的是内部RC振荡器，后面所有定时器频率计算都要按内部时钟来，精度差一些也无妨，但尽量用外部晶振，因为步进电机对脉冲频率稳定性是有要求的。
GPIO部分，把PA0、PA1、PA2配置为GPIO_Output，推挽输出，速度选Low或Medium就够了。很多教程喜欢把GPIO速度拉到Very High，其实没这个必要，步进电机的脉冲频率不高，低速档位反而能减少噪声。定时器部分，如果用的是A4988方案，把TIM2的Channel1配置为PWM Generation CH1，Prescaler先填71，Counter Period先填999，默认参数就行，后面代码里会动态修改ARR来控制速度。生成代码之后，main函数里调用HAL_TIM_PWM_Start(&htim2, TIM_CHANNEL_1)启动输出，再通过__HAL_TIM_SET_AUTORELOAD(&htim2, arr)修改频率，这套流程就完整了。
2.3 初始化顺序里的一个细节
初始化顺序虽然看着不起眼，但实际能避免不少麻烦。我建议在main函数一开始就把DIR和ENABLE引脚电平设置好，ENABLE拉高（失能），DIR给默认方向，定时器PWM先以较低频率启动，然后再按业务逻辑切换。这么做是为了防止上电瞬间硬件随机状态导致电机猛跳一步。
还有一个细节值得注意：CubeMX生成的工程里，HAL_TIM_PWM_Start之后，修改ARR的时机要选在定时器运行中也没问题，但如果你在极高速的脉冲输出中去改ARR，可能会有一次脉冲周期的跳变。普通应用完全不用管，但如果做高精度定位，建议用定时器的Update事件回调来改，保证变更发生在周期边界。驱动代码阶段不必追求这种极致，先让电机转起来再说。
3. 驱动代码实现：两种电机的完整控制逻辑
到了这一步，终于进入驱动代码本身。网上很多帖子把两种电机混在一起讲，导致以为“步进电机驱动就是给脉冲”就行了，实际上28BYJ-48和A4988方案在代码实现上有本质区别：前者需要自己控制四个相线的通电组合顺序，后者只需要一个脉冲信号加一个方向电平。
3.1 28BYJ-48的四相八拍时序实现
28BYJ-48属于四相电机，最简单的驱动方式是单四拍，也就是A相通电、然后B相、C相、D相轮流切换，每步对应一个角度，但振动比较大，力矩偏小。更常用的是八拍工作方式，在单相导通之间插入相邻两相同时通电的状态，也就是A→AB→B→BC→C→CD→D→DA这八个状态循环，运动更平滑，力矩也更大。我实际使用中一直用八拍，稳定性明显好于四拍。
对应相序表可以这么写：
const uint8_t step_table[8][4] = { {1, 0, 0, 0}, // A {1, 1, 0, 0}, // AB {0, 1, 0, 0}, // B {0, 1, 1, 0}, // BC {0, 0, 1, 0}, // C {0, 0, 1, 1}, // CD {0, 0, 0, 1}, // D {1, 0, 0, 1}, // DA };然后写一个步进函数，传入步序号，把对应电平写到四个引脚上：
void Motor_Step(uint8_t step_index) { HAL_GPIO_WritePin(IN1_GPIO_Port, IN1_Pin, step_table[step_index][0]); HAL_GPIO_WritePin(IN2_GPIO_Port, IN2_Pin, step_table[step_index][1]); HAL_GPIO_WritePin(IN3_GPIO_Port, IN3_Pin, step_table[step_index][2]); HAL_GPIO_WritePin(IN4_GPIO_Port, IN4_Pin, step_table[step_index][3]); }如果你想让它连续转动，最简单的办法是在一个循环里让索引递增并循环，同时加延时控制速度。正转就是索引递增，反转就递减。这样实现完全能跑，但正如前面说的，延时占用CPU，所以更好的做法是把Motor_Step放到定时器中断里，每隔固定时间步进一次，CPU就可以去做其他事情。需要慢速就增大中断周期，需要快速就减小中断周期。
需要注意一点：不同厂家的28BYJ-48线圈接线顺序可能不同，如果你按上面的相序表接上之后电机抖动而不转，把IN1和IN2两条线交换一次再试，或者把数组遍历方向反过来，多半就能解决。这不是BUG，是硬件接线差异。
3.2 A4988的脉冲-方向控制
A4988方案的代码比28BYJ-48简单得多。因为驱动芯片内部已经帮你完成了电流控制和相位分配，你只需要给STEP引脚送一个频率正确的脉冲串，再通过DIR引脚决定方向即可。这意味着“定时器PWM输出”成了最合适的控制方式。
关键代码就这几行：
// 设置脉冲频率，单位Hz void Motor_SetSpeed(uint16_t freq_hz) { uint16_t arr = 1000000 / freq_hz - 1; // PSC=71时计数时钟为1MHz __HAL_TIM_SET_AUTORELOAD(&htim2, arr); } // 方向控制 void Motor_SetDir(uint8_t dir) { HAL_GPIO_WritePin(DIR_GPIO_Port, DIR_Pin, dir ? GPIO_PIN_SET : GPIO_PIN_RESET); }启动时先拉高ENABLE引脚进行失能（低电平使能），设置好方向，然后启动PWM：
HAL_GPIO_WritePin(EN_GPIO_Port, EN_Pin, GPIO_PIN_RESET); // 使能 Motor_SetDir(1); HAL_TIM_PWM_Start(&htim2, TIM_CHANNEL_1); Motor_SetSpeed(1000); // 启动后以1kHz脉冲运行这套代码执行后，电机就会以1kHz的脉冲速率持续转动。A4988对STEP脉冲的宽度要求不高，最小高电平时间约1微秒，DIR信号需要在脉冲上升沿前建立至少5微秒，我们的定时器PWM完全满足这些时序要求，所以通信层面基本不用担心。
3.3 速度、圈数与位置的换算方法
写到这里，有一件事必须讲透，就是“脉冲频率”和“电机实际转速”之间的换算。这个换算关系取决于电机的固有步距角和驱动板的细分设置，最容易让人迷糊。
以常见的42步进电机为例，标称步距角是1.8°，也就是说电机内部转一圈需要200个整步脉冲。A4988如果设置为16细分，那么每一个脉冲只让电机转过1.8°/16 = 0.1125°，转一圈需要的脉冲数就是200×16 = 3200个。于是目标转速RPM和脉冲频率f之间的公式就是：f = RPM × 3200 / 60。反过来，已知脉冲频率f，转速RPM = f × 60 / 3200。
28BYJ-48则不同，它内部电机本身在八拍模式下每脉冲转5.625°，但经过1/64减速齿轮箱之后，输出轴每脉冲实际转角约为0.0879°，转一圈需要约4096个脉冲。这些数值不是凭空背下来的，一定要在写速度控制函数之前先算清楚，否则“让它转一圈”这种最基本的操作都会出现明显偏差。
我在实际项目里通常会把步数、速度、目标位置封装成一个简单的控制结构体，用一个变量记录当前累计脉冲数，另一个变量记录目标脉冲数，然后在定时器中断里做比较，决定继续走还是停下来。这样位置控制就变得非常直观，想走半圈就传1600个脉冲（42电机16细分），想走一圈就传3200个，程序逻辑跟业务层彻底解耦。
4. 四个典型调试问题：抖动、方向反、发热与失步
把代码写完之后，真正的修行才刚刚开始。下面这四个问题我几乎每个项目都会遇到，有些是接线错误，有些是参数设置不当，但它们的排查链路是固定的，掌握了可以省下大量盲调时间。
4.1 电机只抖不转：先查相序顺序和电源电流
现象很典型：上电后电机发出“嗡嗡”或“咔咔”的抖动声，轴不转或者原地轻微振动，感觉像被卡住。这个问题在28BYJ-48和A4988方案里都可能出现，但原因略有不同。
对于28BYJ-48，第一嫌疑是相序接错。线圈通电顺序不对，转子在磁场中被来回拉扯，就会抖而不转。我的排查方法是先在程序里把延时调大，让每一步非常慢，然后观察电机是否在一步一步地“咔嗒”挪动。如果每一步都有反应但最后不连贯，基本就是相序问题，交换任意两根相线再试，一般几次就能试出正确顺序。第二嫌疑是电源电流不足，尤其用USB口供电时，启动瞬间压降会导致驱动板逻辑混乱，建议换外部5V电源。
对于A4988方案，只抖不转最常见的元凶是VMOT电源没有接好，或者Vref电流调得太低。A4988用STEP脉冲驱动电机转动，但如果电流设置过小，电机连克服空载摩擦的力矩都不够，就会表现为STEP脉冲在走，轴却在原地抖。此时先测一下Vref电压，再用万用表确认VMOT确实有电压，排查链路很快就收敛了。
4.2 方向反了不要改接线：改一个变量就行
方向反在我接触的项目里出现频率极高。想要反转，很多人第一反应是交换A+和A-，或者把28BYJ-48的四根线重新排列，但这样做费时费力，而且还容易在拔插过程中造成短路。
其实反转只需要两处改动。A4988方案中，把DIR引脚的电平取反就行，也就是程序里原来写GPIO_PIN_SET的地方改成GPIO_PIN_RESET。28BYJ-48方案中，把相序数组的遍历方向反过来，原来是索引递增就改成递减。就这么简单。
我自己的习惯是定义一个方向常量或者枚举，而不是在多个地方硬编码电平值。这样以后想改转向，只需要改一个宏定义或者一个配置参数。调试的时候，先在轴上画一条标记线，程序里让电机走去100步，关机后再运行反向100步，对比起始位置就能确认方向逻辑是否正确。
4.3 电机发热发烫：大概率不是程序问题而是电流没调好
很多第一次玩步进电机的人，摸到电机外壳烫手都会担心是不是程序写错了导致过流。实际上步进电机在工作时本来就会发热，因为它的绕组始终有电流流过，用于维持定位力矩。表面温度在60℃左右属于正常范围，长时间运行到70~80℃也不是稀罕事。
但如果你摸到A4988驱动芯片已经烫到不敢碰，或者电机在低速空载时几分钟内就异常发烫，那就要查Vref电流设置了。A4988的电流上限由Vref引脚电压决定，典型计算公式是I = Vref / (8 × Rs)，其中Rs是模块上的采样电阻值，市面常见模块一般是0.1Ω。假设你的42步进电机额定电流是0.6A，那么Vref应该设在0.6×8×0.1 = 0.48V。调节方法是用小一字螺丝刀拧模块上的电位器，同时用万用表测Vref测试点对地电压，边拧边看电压稳定在目标值附近。
必须强调的是，Vref不是越高越好。A4988的持续输出能力有限，超调不仅让电机过热，还会让驱动芯片进入过温保护，然后出现“跑着跑着突然没力”的奇怪现象，很多人还以为是程序死机了，其实是驱动板热保护。
4.4 高速失步：发给电机的脉冲太快了
失步的典型表现是：低速时转向和位置都正常，但把速度调上去之后，电机开始“哒哒”响，位置越来越偏，停下后实际位置和目标位置差了一大截。原因不是程序BUG，而是步进电机的物理特性——转速越高，反电动势越大，输出扭矩越小，如果脉冲频率超过了电机当前负载下的最大跟踪频率，转子就跟不上脉冲了。
遇到失步，我的处理顺序是：先降低脉冲频率，看是否恢复正常；再检查细分设置，把细分从1/16降到1/8或1/4，因为细分越高，相同转速下脉冲频率越高，对电机的跟踪能力要求也越高；最后考虑负载问题，如果是机械结构卡滞导致的失步，程序里再优化也无济于事。
一个冷知识：42步进电机的自启动频率一般在300~500Hz左右，也就是说不做加减速直接启动，500Hz以上就有失步风险。如果应用场景要求更高速度，就必须引入加减速曲线，这也是下一节要展开的内容。
5. 进阶：加减速曲线与闭环控制的前置思路
当电机能在低速稳定运行、方向可控、位置能算准之后，其实已经满足大部分入门项目的需求了。但如果你的目标是雕刻机或者高精度机械臂，那加减速曲线就是绕不开的一道坎。
5.1 为什么启动不能直接跳到目标速度
想象一下手动挡汽车起步的场景：起步用一档，转速上来之后再逐步升档，而不是直接挂到五档猛踩油门。步进电机启动也是同样的道理，转子在静止状态下惯性很大，如果第一个脉冲周期就要求它跑1000Hz，它根本来不及响应，直接就失步了。
所以加减速的本质是给转子一个短暂的“缓冲期”，让脉冲频率从较低的启动值，逐步爬升到目标值。最常用的是梯形加减速：启动时频率低，然后线性增加，达到目标速度后匀速运行，接近目标位置时再线性下降，直到停下来。S型曲线更平滑，但复杂度也更高，实际工程里多数场景梯形已经够用。
5.2 梯形加减速的定时器实现
在A4988方案里，实现梯形加减速非常直接，因为速度就是由ARR决定的。核心思路是在加速阶段每隔一段时间修改一次ARR，让脉冲频率逐步增加。
一个简化的示意可以这样写：
// 从start_freq加速到target_freq，每步增加step_hz，间隔delay_ms void Motor_AccelerateTo(uint16_t start_freq, uint16_t target_freq) { for (uint16_t f = start_freq; f < target_freq; f += 20) { Motor_SetSpeed(f); HAL_Delay(10); } Motor_SetSpeed(target_freq); }这个写法虽然用了HAL_Delay，但只是在启动阶段占用CPU，匀速阶段脉冲由定时器自动产生，不影响其他任务。实际项目中我会把加速过程也放进状态机里，在定时器更新中断里修改ARR，这样整个运动过程CPU都是空闲的。
加速段的频率增量不是越大越好，增量太大加速太猛，照样失步。启动频率一般从100Hz到300Hz之间开始比较安全，具体值取决于电机和负载，需要实测调整。减速段同样重要，急停时惯性会让转子冲过目标位置，所以刹车也要一步步减下来。加减速是对称的还是不对称的，取决于机械结构，我都建议先做对称的，省事也直观。
5.3 闭环控制的前置思路：从“开环计数”到“实时校正”
开环控制依赖一个前提：每个脉冲对应固定的机械角度。但这个前提在过载和高速时并不成立，所以才会失步。想要彻底解决精度问题，就得走向闭环：在电机轴或者丝杆末端加位置传感器，实时读取实际位置，与目标位置做比较，一旦发现偏差就通过算法校正输出。
F103C8T6在这方面的扩展能力其实不错。它的定时器自带编码器模式，可以直接接正交编码器，读取增量位置；也可以接磁编码器芯片，比如MT6701，通过I2C或SPI接口获取绝对角度。闭环步进电机之所以在雕刻机领域流行，就是因为驱动器可以实时检测转子是否失步，并在后续脉冲中做补偿。
如果你只是做入门项目，我不建议一上来就闭环，先把开环加减速调明白，理解脉冲和角度之间的关系，再考虑编码器反馈，学习曲线会平滑很多。反过来，如果一开始就上闭环，遇到问题根本分不清是调节参数的问题还是速度规划的问题，调试难度会几何级增长。
说实话，F103C8T6驱动步进电机这套东西，真正难的不是让电机转起来，而是让它转得准、转得稳、不失控。从选对驱动板、搭好定时器工程，到把加减速和方向逻辑封装清楚，每一步都比表面上看起来更有讲究。我自己反复调整过的经验是：先把28BYJ-48的八拍时序在低速下调通，再把A4988的PWM脉冲跑顺，最后再加入加减速曲线，一套驱动代码就基本能通吃大多数小项目了。顺带提醒一句，调试时一定要先在空载情况下验证，再带负载，不然各种异常叠加在一起，你会很难判断问题出在软件还是机械。
本文还有配套的精品资源，点击获取
