树莓派4B控制42步进电机：从GPIO接线到A4988驱动的完整实战指南

写在前面：这个项目我一直想抽空整理出来。树莓派4B控制步进电机，听起来是个入门级玩法，但真正做完一遍之后你会发现，里面涉及的坑远比自己想的多。从系统安装选型、GPIO接线、驱动器配置，到脉冲时序、使能信号处理，每一环都藏着小问题，稍不注意就是电机不转、丢步，甚至驱动板冒烟。

我这次用的主角是树莓派4B和一台42步进电机（NEMA17），配合常见的A4988驱动板。整个项目做完，我的感受是：树莓派4B做上位机，负责发脉冲、算轨迹、跑上层逻辑；步进电机驱动板做下位执行，把脉冲信号翻译成绕组电流。这套组合非常经典，3D打印机、小型雕刻机、机械臂，很多都是这个路子。

这篇文章适合谁看？手里有树莓派4B、想让它“动起来”的玩家，做机器人小车、云台、自动窗帘、小型CNC的朋友，还有因为课设或者比赛需要在树莓派上驱动步进电机的学生。我尽量把原理、接线、代码、踩坑都写透，读完基本能直接照着复现。

1. 项目拆解与整体设计思路

1.1 控制步进电机的核心链路

先把自己从“单片机思维”里拽出来。树莓派和Arduino不一样，它跑的是完整的Linux系统，GPIO引脚输出能力极其有限，跟你拿来点个LED还行，但要直接驱动步进电机，门都没有。步进电机工作时相绕组电流动辄几百毫安到一两安培，树莓派GPIO最大也就输出16mA左右，硬接上去轻则驱动不了，重则烧坏树莓派的SOC内部电路。

所以整套系统的链路是这样的：

树莓派4B（决策层） → 驱动板（功率放大层） → 步进电机（执行层）

树莓派只干一件事：按照你设定的速度、方向、步数，在GPIO引脚上输出脉冲信号。驱动板收到脉冲后，把低压小电流的控制信号转换成功率级的绕组电流，按顺序给电机各相通电，电机就一步步转起来。

为什么不让树莓派直接控制？两个原因：电流不够，电压不匹配。42步进电机的额定电压虽然是12V左右，但驱动板通常用更高的VMOT电压供电（12V或24V），而树莓派GPIO输出3.3V逻辑电平。驱动板的作用就是把控制信号和功率部分隔离、放大，同时把“什么时候走一步”这个脉冲信号，转成“哪一相通电、电流多大”的精确控制。

1.2 选型：电机和驱动器的组合

电机我选了42步进电机，也就是NEMA17，这是市面上最普及的机型，没有之一。凡是在淘宝搜索“步进电机 42”，出来的基本就是它。为什么不选28步进或者57步进？28步进（比如28BYJ-48）力矩小，适合玩具级项目，而且很多是五线四相制，驱动方式反而麻烦；57步进力矩大，但个头也大，电源要求高，树莓派这个级别的项目用42最合适，扭矩一般在0.4到0.6牛米左右，驱动一个小型云台、丝杆滑台、3D打印机的挤出机都够用。

驱动器我一开始用的A4988，后来也试过DRV8825，两者的引脚基本兼容，核心区别在于最大电流和细分档位。A4988最大2A，DRV8825最大2.5A，都能驱动42电机。驱动板选型的关键是看它能吃多大电压、能扛多大电流、细分最多能到多少。A4988支持到1/16细分，DRV8825支持到1/32细分，对于绝大多数树莓派项目，1/16细分已经非常平滑了。

1.3 树莓派4B在整套方案里的定位

用过树莓派4B的人都知道，这颗BCM2711处理器的性能，用来流水灯级别的GPIO控制，其实有点浪费。我做这个项目时给它的定位就是一个“带无线通信能力的高性能脉冲源”。相比Arduino，树莓派4B的优势在于：可以跑Python、C++甚至ROS，可以接摄像头做视觉引导，可以通过SSH远程改参数，可以挂MQTT做物联网控制。这些能力是单片机方案很难同时具备的。

但相应的代价是实时性不如单片机。Linux不是实时操作系统，Python的time.sleep()的定时精度也很有限，后面我会专门讲怎么解决脉冲时序抖动的问题。这里先记住一个结论：如果只是简单转一转，树莓派直接发脉冲完全没问题；如果要跑高频平滑运动（比如每秒几千步），就得用硬件PWM或者把底层时序交给驱动芯片来处理。

2. 步进电机工作原理与关键参数

2.1 步进电机为什么能精确走位

步进电机的本质是一个“数字电机”。它的转子是永磁体，定子上有多个绕组（相）。当驱动器按一定顺序给绕组通电时，定子会产生旋转的磁场，磁场牵着转子一步一步往前走。每一步转过的角度是固定的，叫做步距角。42步进电机最常见的步距角是1.8度，也就是说电机转一整圈需要200步。

很多人不理解“步进”这两个字的含义。拿闹钟的分针类比，普通直流电机是秒针的连续扫秒，而步进电机是石英钟的跳秒——每次跳一下，角度固定。正因为它每一步的角度是确定的，所以不需要编码器反馈，也可以通过“走了多少步”反推出“转到什么位置”，这就是开环控制的根基。

关键点在于：步进电机的精度不靠“测”，靠的是“每一步角度恒定”这个物理保证。前提是不丢步、不堵转、不失步。只要脉冲数准确，机械结构不打滑，电机最终停下时的位置就是可预期的。这也是步进电机之所以在3D打印机领域长盛不衰的原因——便宜、简单、开环就能达到不错的定位精度。

2.2 驱动器工作模式：整步、半步与细分

刚才说42电机转一圈要200步。如果一直按整步模式走，你会发现电机有明显的震动感，转速稍微拉高一点，共振会非常明显，噪声也大。这时候就要用到细分配置。

细分的原理不复杂：把本来该一下子切换的绕组电流，拆成多个小梯度逐步变化。A4988驱动板上有一组MS1、MS2、MS3跳线帽，组合起来可以设置1/1整步、1/2半步、1/4、1/8、1/16细分。以1/16细分为例，原本1.8度一步被切成16个微步，每个微步0.1125度，转一圈需要3200个脉冲。物理上，转子的实际位置会停留在磁场梯度的中间位置，而不是只能在整步位置，所以运行会平滑很多，共振也小。

这里有一个常见的认知误区：不是细分越大定位精度就越高。细分的本职是让运行更平滑，定位精度的上限还是受限于机械精度和步进电机的静转矩特性。微型步之间，电机的保持力矩会有波动，如果负载力矩正好介于微步和整步力矩之间，反而可能产生定位误差。所以在选择细分时，别一上来无脑开最大，要根据实际速度、力矩、噪音需求来权衡。我做云台时用1/8细分，做滑台时用1/16细分，效果都不错。

2.3 ENA+、DIR、PUL：驱动器的三个核心信号

A4988这类驱动板，面向控制器一侧的引脚有三大类：电源（VDD、GND）、电机控制逻辑（STEP、DIR）、使能（EN）。其中STEP引脚就是接收脉冲信号的口子，每来一个脉冲，电机走一个微步。DIR引脚设置方向，高电平和低电平分别对应正转和反转。ENA+引脚（在A4988上标为EN）是使能控制，低电平时驱动器正常工作，高电平时驱动器输出级关断，电机处于“脱机”状态，可以自由用手转动。

热词里专门提到“步进电机ena+”，说明这个问题确实有大量人踩坑。ENA+很容易被忽略的原因在于，很多A4988模块出厂时EN引脚默认是被拉低到有效状态的，也就是说不接这根线，电机也能正常转。但当你需要在某个时刻释放电机（比如手动校准归零位、调试机械结构时），就必须把ENA拉高。还有一个常见场景是初始上电时，如果程序还没有初始化GPIO，EN引脚悬空或者被误置为高电平，电机就会一直处于释放状态，你怎么发脉冲它都不动，这个我后面在排查章节里细说。

DIR和STEP信号在实际接线时，通常会通过限流电阻和光耦隔离后再进入驱动芯片，所以A4988上的STEP+、STEP-实际上是差分输入。常见接法是把STEP-接到树莓派GND，STEP+接到GPIO；DIR同理。但要注意，不同厂家生产的模块，接口定义和逻辑极性可能不同，买回来的模块最好看一下丝印或者卖家原理图，不要想当然。

3. 硬件接线与系统环境准备

3.1 树莓派4B系统安装选型

我见过很多新手在第一步就卡住了。树莓派4B装什么系统？官方推荐的是树莓派OS，但热搜词里“树莓派4b安装ubuntu20.04”和“树莓派4b安装ubuntu22.04”的出现频率非常高，说明不少人在正经做项目时会首选Ubuntu Server或者Ubuntu Desktop。

这两个方向我都试过，结论如下：如果只是控制步进电机，树莓派OS（Raspberry Pi OS Lite）是最省心的选择，因为它的内核和驱动对树莓派4B的硬件支持最完整，GPIO库的兼容性也最好。但如果你想在树莓派上跑ROS2、跑机器视觉、或者用很多工业自动化方面的软件包，Ubuntu 22.04 Server会更合适，因为软件生态更统一，Python库的预编译包也更全。

我这次最终用的是Ubuntu 22.04 Server，原因很简单：我需要同时用到GPIO控制和网络服务，Ubuntu Server装起来干净，占用资源少，普通交互全走SSH。刷系统的步骤不复杂：用树莓派官方Imager工具烧录Ubuntu Server 22.04镜像到TF卡，第一次开机用用户名ubuntu和密码ubuntu登录，然后立即改密码，apt update && apt upgrade，就完事了。烧录时记得在Imager的“高级设置”里预先把SSH和WiFi配置好，否则没接显示器没接网线的时候会非常难受。

3.2 GPIO编号与接线：从引脚图到实物连接

树莓派4B的40针GPIO，有两种编号方式：BOARD编号（按物理引脚位置，从1到40）和BCM编号（按芯片内部通用GPIO口编号）。在Python的RPi.GPIO或者gpiod库中使用时，这两种方式完全不同，极容易搞混。我的习惯是统一用BCM编号，并且在代码开头写个注释，防止自己过几天就忘。

我这次用的BCM引脚如下：

接线时有几个细节必须注意。首先，树莓派的GND和驱动板的GND必须连在一起，也就是“共地”。如果不共地，脉冲信号没有参考电平，驱动板无法正确识别高低电平，电机表现为随机抖动或者完全不动。其次，树莓派GPIO输出的是3.3V电平，A4988的逻辑电压VDD建议是5V，但很多模块的STEP/DIR/EN输入是兼容3.3V的，直接接没问题；如果模块上没有明确说明兼容3.3V，稳妥起见加一个电平转换模块。最后，电机相的接线不能接错。42步进电机通常是四线两相制，用万用表电阻挡可以量出两组线圈：A+和A-为一组，B+和B-为一组。接反一组的话，电机只会震动不会转，方向也会反，这个九成新手都遇到过。

关于热词里的“树莓派4b的风扇针脚”，这里也顺带提一句。树莓派4B板子的PCB上靠近USB-C口的位置有一个4针的风扇接口（FAN），它不是标准的GPIO，专门用来给官方风扇供电和测速的。很多人刚开始会把风扇线插错到GPIO排针上，一下就把风扇或者引脚烧了。我这个项目里树莓派在跑Ubuntu Server，负载不高，但散热片一定要加。如果你的项目里树莓派还要同时做视觉处理、跑模型推理，那4B发热量不小，建议还是用官方风扇接那个专用风扇口，别用GPIO供电。

3.3 电源设计要求与实测

步进电机系统里最容易被低估的就是电源。42步进电机额定电流一般在1.5A左右，两相同时通电时峰值电流更高，所以驱动板VMOT电源至少需要12V 2A。我用的是一个12V 5A的开关电源，给A4988和电机共用一路，实测在1/16细分、转速120rpm、空载的情况下，瞬时电流在0.8A到1.2A之间波动，电源余量很充足。

千万不要试图用树莓派4B的5V引脚给步进电机供电。树莓派的5V引脚只能应付小电流外设，USB口挂了移动硬盘都可能电压骤降，别说带步进电机了。一旦启动瞬间电流冲击导致树莓派电压跌落，轻则系统重启，重则烧掉稳压电路。

A4988的VDD引脚接5V，可以从树莓派4B的5V引脚直接取电，但前提是逻辑部分电流很小（只有几毫安），不会对树莓派电源造成实质影响。如果对安全有更高要求，可以用独立的5V电源给VDD供电，并把电源地全部连在一起。这样做的好处是，即使驱动板故障，也不容易通过电源线反冲烧坏树莓派。

4. 完整代码实现：从最简转动到细分控制

4.1 环境准备与gpiod库的坑

树莓派上控制GPIO的Python库有很多，最传统的是RPi.GPIO，但它对Ubuntu 22.04 Server的支持其实不太友好，因为RPi.GPIO依赖树莓派内核里的bcm2835驱动，而Ubuntu Server可能没有对应的头文件，安装时就报错。我在Ubuntu 22.04上用的是gpiod（libgpiod的Python绑定），这是Linux内核GPIO子系统的用户态接口，树莓派OS和Ubuntu都能用，而且不依赖具体的Python包维护状况。

安装gpiod很简单：

sudo apt install python3-libgpiod gpiod

确认GPIO通道是否可用，可以用命令行工具：

gpioinfo

不过要提醒一句，gpiod的操作方式和RPi.GPIO不同。gpiod操作的对象是chip和line，树莓派4B的CPU GPIO在chip0上，BCM编号直接映射为line offset。也就是说，GPIO17在gpiod里就是chip0的line 17。这个映射关系在树莓派上没问题，但如果你将来换了其他开发板，务必先用gpioinfo确认线路编号。

4.2 最简版代码：正转、反转、停止

先上一个最精简的版本，目标就一个：让电机以固定的速度连续正转，几秒后反转，再几秒后停下来。

import gpiod import time CHIP = '/dev/gpiochip0' STEP_PIN = 17 DIR_PIN = 27 EN_PIN = 22 chip = gpiod.Chip(CHIP) step_line = chip.get_line(STEP_PIN) dir_line = chip.get_line(DIR_PIN) en_line = chip.get_line(EN_PIN) step_line.request(consumer='step_motor', type=gpiod.LINE_REQ_DIR_OUT) dir_line.request(consumer='step_motor', type=gpiod.LINE_REQ_DIR_OUT) en_line.request(consumer='step_motor', type=gpiod.LINE_REQ_DIR_OUT) # 使能驱动器，低电平有效 en_line.set_value(0) def set_direction(direction): # direction: 1 or 0 dir_line.set_value(direction) def step_once(): step_line.set_value(1) time.sleep(0.0005) step_line.set_value(0) time.sleep(0.0005) def rotate(seconds, direction): set_direction(direction) end_time = time.time() + seconds while time.time() < end_time: step_once() try: print("正转 3 秒") rotate(3, 1) print("反转 3 秒") rotate(3, 0) print("停止并释放电机") en_line.set_value(1) finally: step_line.release() dir_line.release() en_line.release()

这个代码很粗糙，但它是理解步进电机控制的最小骨架。每调用一次step_once()，STEP引脚上产生一个高电平脉冲，宽度是0.5毫秒，然后恢复低电平，再等0.5毫秒，这样一个完整脉冲周期是1毫秒。按这个频率算下来就是每秒1000个脉冲。如果驱动器设为1/16细分，电机转一圈需要3200个脉冲，那么此时转速就是每秒0.3125圈，也就是18.75 rpm。

跑这个程序时最容易发现的问题有三个：一是电机只震动不转，大概率是两相绕组的其中一组接反了；二是电机转了但方向和你预期相反，把DIR的高低电平反过来，或者交换A+和A-接线即可；三是转速很慢或者完全不动，检查一下细分跳线帽设置和脉冲频率。

4.3 进阶：封装一个步进电机类，支持指定步数和速度

只“转着玩”显然不够，实际项目里更常见的需求是：让电机转到指定位置后停下，或者以指定速度走指定步数。这里需要对脉冲频率做更精确的控制。

一个关键问题在前面提到过：Python的time.sleep在Linux下最小精度其实在几毫秒左右，如果脉冲周期小于1毫秒，sleep的抖动就会导致速度不均匀，声音会变得刺耳，电机动态性能也会变差。最简单的优化是用busy-wait（忙等待），即循环里用time.perf_counter_ns()做高精度延时，但这种方法会占满CPU核心。

下面这个类用busy-wait实现了指定步数、指定转速的脉冲输出：

import gpiod import time class StepperMotor: def __init__(self, step_pin, dir_pin, en_pin, steps_per_rev=3200): chip = gpiod.Chip('/dev/gpiochip0') self.step_line = chip.get_line(step_pin) self.dir_line = chip.get_line(dir_pin) self.en_line = chip.get_line(en_pin) self.step_line.request(consumer='stepper', type=gpiod.LINE_REQ_DIR_OUT) self.dir_line.request(consumer='stepper', type=gpiod.LINE_REQ_DIR_OUT) self.en_line.request(consumer='stepper', type=gpiod.LINE_REQ_DIR_OUT) self.steps_per_rev = steps_per_rev self.enable() def enable(self): self.en_line.set_value(0) def disable(self): self.en_line.set_value(1) def set_speed_rpm(self, rpm): # 根据转速计算脉冲周期，单位秒 steps_per_sec = self.steps_per_rev * rpm / 60.0 self.half_period = 1.0 / (2.0 * steps_per_sec) def move_steps(self, steps, direction): self.dir_line.set_value(direction) for _ in range(steps): self.step_line.set_value(1) self._busy_wait(self.half_period) self.step_line.set_value(0) self._busy_wait(self.half_period) def move_revolutions(self, revs, direction, rpm): self.set_speed_rpm(rpm) steps = int(revs * self.steps_per_rev) self.move_steps(steps, direction) @staticmethod def _busy_wait(seconds): end = time.perf_counter_ns() + seconds * 1e9 while time.perf_counter_ns() < end: pass if __name__ == '__main__': motor = StepperMotor(STEP_PIN=17, DIR_PIN=27, EN_PIN=22) motor.move_revolutions(2, direction=1, rpm=60) motor.disable()

这个类里的关键参数是steps_per_rev。我默认设置成3200，也就是1.8度电机配1/16细分的值。如果你的驱动板是1/8细分，就要改成1600，否则“转一圈”的实际圈数会不对。建议在代码里用常量把细分倍率写清楚，方便后期调整。

有人会问，move_steps里每次脉冲都用busy_wait，那STATUS是不是会崩？实测下来，树莓派4B有4个核心，单核跑busy-wait，其他核心照常处理网络和IO，不会对整个系统造成明显影响。但要注意，这种写法只适合单电机项目。如果你要同时控制多台电机，就得考虑把脉冲生成放到硬件PWM或者DMA层面，否则CPU会被占满，其他任务全部卡顿。

4.4 用硬件PWM替代软件脉冲，提升稳定性

软件发脉冲有一个无解的问题：Linux的进程调度会打断你的循环。就算你用busy-wait，也可能在某些时刻被内核调度抢占几十微秒，导致脉冲间隔不均匀。对于步进电机，脉冲间隔抖动直接表现为转速波动和噪声，严重时会引起共振丢步。

解决思路是把脉冲生成交给硬件。树莓派4B的GPIO有一个专用的PWM模块，但传统的树莓派PWM只有两路可用引脚，BCM 18和BCM 19。如果只用一台电机，硬件PWM完全够用。做法是把GPIO 18设为PWM输出，频率设为步进电机需要的脉冲频率，占空比设为50%，然后通过改变频率来控制转速。

用pigpio库可以非常方便地实现：

import pigpio import time pi = pigpio.pi() PWM_PIN = 18 DIR_PIN = 27 EN_PIN = 22 pi.set_mode(PWM_PIN, pigpio.OUTPUT) pi.set_mode(DIR_PIN, pigpio.OUTPUT) pi.set_mode(EN_PIN, pigpio.OUTPUT) pi.write(EN_PIN, 0) # 使能 pi.write(DIR_PIN, 1) # 方向 pi.set_PWM_frequency(PWM_PIN, 1000) # 1kHz 脉冲 pi.set_PWM_dutycycle(PWM_PIN, 128) # 50% 占空比 time.sleep(5) pi.set_PWM_dutycycle(PWM_PIN, 0) # 停止

pigpio的底层是树莓派的DMA和硬件PWM，精度远高于纯Python发脉冲，而且几乎不占CPU。唯一的代价是pigpio需要在树莓派上启动一个后台守护进程，安装方式也不复杂：apt install pigpio，然后sudo systemctl enable pigpiod。

硬件PWM方式有一个限制：它不是通过脉冲个数来控制位置的，而是通过频率和持续时间来控制“跑了多少步”。如果要精确定位，需要配合累加计步，或者采用“频率控制 + 定时中断计算步数”的策略。实际项目里我通常是这么做的：低速精确定位用软件发脉冲次数；告诉恒速连续转动用硬件PWM。两者互补。

5. 常见问题与排查技巧实录

5.1 电机不转，先按这个顺序查

“我照着教程接了线，为什么电机纹丝不动？”这个问题我见了不下几十次。每次我都建议按下面的顺序排查，不要东猜西猜：

第一步，看驱动板指示灯。A4988上电后如果VDD正常，指示灯应该亮。如果指示灯都不亮，查VDD供电和GND接线。

第二步，听声音。发脉冲时把耳朵贴近电机，如果听到轻微的“滋滋”声，说明有电流在切换绕组，脉冲已经到驱动板了，问题可能出在绕组接线或者电流设置上。如果完全安静，说明脉冲根本没进去，检查STEP接线和共地。

第三步，用手摸电机轴。如果电机轴有锁紧力，怎么拧都拧不动，说明驱动板输出级已经使能，电源和电机接线都没问题；如果轴是松的，说明驱动器处于脱机状态，检查EN引脚电平。

第四步，确认细分跳线。A4988的MS1、MS2、MS3如果全部悬空，就是整步模式；如果你接的是1/16细分跳线帽，但板上丝印和实际不一致，可能导致脉冲和转速的对应关系乱掉。

第五步，检查电流限制。A4988的VREF电压决定了输出电流，如果VREF调得太低，电机可能完全没有力矩，即使有脉冲也转不动。这个需要用小螺丝刀慢慢调，不建议新手一开始就动这个电位器。

5.2 ENA+引脚的典型坑

ENA（使能）引脚是最容易被忽略、又最容易出问题的信号。我的第一版代码里压根没管EN引脚，结果发现一个奇怪的现象：程序启动时电机转得好好的，但只要树莓派重启，电机就锁死了，直到我手动把EN引脚拉低一次才恢复。

原因在于：A4988的EN引脚默认是低电平有效，很多模块内部带有上拉或下拉电阻，逻辑状态在复位瞬间是不确定的。树莓派GPIO在系统启动过程中，引脚会短暂处于输入态或高阻态，这时候EN引脚电平可能被外部干扰拉到无效状态。解决方法是把EN引脚明确接到树莓派GPIO上，并且在上电后的第一时间（代码开头）就把它设置为有效电平。

另一个容易被忽略的场景是：调试机械结构时，你需要手动转动电机轴来调整位置。这时候如果驱动器还在使能状态，电机轴是锁死的，拧不动，容易误以为机械卡死了。正确做法是在程序里提供一个“释放电机”的入口，把EN引脚置为无效电平，让转子自由旋转。我后来给控制界面加了一个“脱机”按钮，调试效率提升了好几个档次。

5.3 树莓派重启、驱动板过热、风扇问题

树莓派4B跑Ubuntu Server控制步进电机，正常负载不算高，但如果你在Jupyter Notebook里跑程序，同时开着摄像头预览画面，那CPU温度轻松上80度。这时候散热风扇就很重要了。热词里“树莓派4b的风扇针脚”被反复搜索，说明很多人第一次见到那个4针风扇接口会抓狂。那个接口是专用的，不是GPIO，如果你买的是3针风扇，接上去会少一根测速线，但供电和地还是能用的。如果买的是5V普通风扇（两根线），可以直接从GPIO的5V和GND取电，但要注意电流不能太大，一般小风扇几十毫安没问题，大风扇还是老实接外部电源。

驱动板过热也一样常见。A4988如果电流设置过高、散热片没贴、环境温度又高，芯片表面温度很容易冲到80度以上。步进电机驱动芯片过热后有一个很隐蔽的症状：刚开始转得很正常，转了一会儿之后开始随机丢步，再严重一点直接停止输出。如果遇到这种“越转越不对劲”的情况，先断电摸一下驱动板，烫手的话就降电流、降电压、加散热片，或者换DRV8825这种耐温更高的芯片。

5.4 常见问题速查表

把我在这个项目里遇到过的、以及帮别人排查过的典型问题整理成一张表，方便你对照处理：

5.5 给新手的几条实战建议

最后分享几个我做了好几轮项目才总结出来的实用习惯。

第一，先裸奔再装壳。新拿到电机和驱动板，先别急着固定在机架上。直接用杜邦线搭一个最小测试电路，确认“树莓派发脉冲 -> 驱动板输出 -> 电机转动”这条链路完全跑通，再考虑机械安装。否则一旦机械阻力导致丢步，你根本分不清是电气问题还是机械问题。

第二，用逻辑分析仪看脉冲。几十块钱的逻辑分析仪（比如常见的8通道USB分析仪）配合Sigrok软件，可以直接抓取STEP、DIR、EN三根线的时序。电机不转的时候，先看脉冲到底有没有发出来、频率是多少、电平对不对。这个方法比用万用表量电压直观十倍，我现在做任何GPIO相关项目都会先接一个逻辑分析仪做调试。

第三，给代码加一个“急停”按钮。用GPIO监听一个按键，按下后立刻释放所有引脚并退出程序，这在调试时能避免不少意外。特别是步进电机带负载时，一旦程序bug导致持续输出脉冲、电机顶到限位，轻则丢步，重则损坏机械结构。

第四，功率预算一定要留余量。即使你的电机空载电流只有0.8A，也要按1.5A到2A来选电源。原因很简单，步进电机的电流是动态变化的，启动瞬间、低频运行时峰值电流会比额定值高不少。电源余量不足时，电压会被拉低，驱动板芯片供电不足，最典型的现象就是“转速一高就丢步”。另外，树莓派4B最好用官方5V 3A的电源适配器供电，不要和电机共用同一路电源的5V输出，避免互相干扰。

这个项目做完之后，说实话我对“树莓派+步进电机”这套组合的定位有了更清晰的认识。它非常适合做中小型自动化设备的控制核心，尤其是需要联网、视觉、远程调参的场景。下一步我打算在这个基础上接一个编码器，做成闭环控制——毕竟步进电机开环的极限就在那里，负载变化稍微大一点，丢步风险就上来了。热词里也有“42步进电机闭环控制”和“步进电机foc”方向，如果你也想继续深入，可以先从给电机加装正交编码器开始，用树莓派读AB相脉冲做修正，这条路比直接上FOC要平滑得多。等这套闭环方案跑通了，我再写一篇文章出来。