📚 课程目录第4章步进电机驱动配置与方向校正

4. 步进电机驱动配置与方向校正

任务说明

在Klipper固件中，步进电机驱动配置错误会导致电机不转、抖动、异响或反方向运动。本案例将完成：为常见TMC2209驱动配置正确的电机参数，并通过方向校正解决电机反转问题。最终目标是通过Klipper的TESTRESPOND命令验证电机能按预期方向平稳转动。

硬件连接与前置条件

主控板（如Octopus、SKR等）已刷入Klipper固件，可通过USB连接上位机
步进电机驱动器为TMC2209，已连接至主控板的X/Y/Z/E对应接口
电机为42步进电机（1.8°步距角，200步/圈）
已通过 ls /dev/serial/by-id/* 确认主控板串口设备名

配置实现

在 printer.cfg 中添加或修改以下配置段。以X轴为例，其他轴同理。


[stepper_x]
step_pin: PB13
dir_pin: PB12
enable_pin: !PB14
microsteps: 16
rotation_distance: 40
endstop_pin: ^PC0
position_endstop: 0
position_max: 200
homing_speed: 50

[tmc2209 stepper_x]
uart_pin: PC4
run_current: 0.600
hold_current: 0.500
stealthchop_threshold: 0
interpolate: False

关键参数说明：

step_pin/dir_pin/enable_pin：根据主控板原理图填写实际引脚编号
rotation_distance：电机转一圈移动的距离（mm），需根据丝杆导程或皮带轮周长计算
microsteps：驱动器细分，TMC2209支持16细分
run_current：运行电流（A），需根据电机额定电流设置，一般不超过1.0A
stealthchop_threshold: 0：禁用静音模式，便于调试时听声音判断

方向校正流程

完成配置后，重启Klipper固件使配置生效：


sudo systemctl restart klipper

然后通过终端发送以下G代码命令进行测试：


STEPPER_BUZZ STEPPER=stepper_x

该命令会让电机以固定模式振动，用于验证驱动连接和电流设置。若电机无反应，检查UART接线和电流设置；若电机抖动但不动，检查step/dir引脚是否正确。

接下来测试实际运动方向：


G91                 ; 切换到相对运动模式
G1 X10 F300         ; X轴正向移动10mm
G90                 ; 切换回运动模式

观察电机轴旋转方向。若电机反转（即X轴实际向负方向移动），则需要反转方向。修改配置：


[stepper_x]
dir_pin: !PB12      ; 在dir_pin前加!号反转方向

保存配置并重启Klipper，再次执行上述测试命令，确认电机方向正确。

验证方法

完成方向校正后，执行以下完整验证序列：


STEPPER_BUZZ STEPPER=stepper_x    ; 确认电机正常振动
G28 X                             ; 回X轴原点
G91
G1 X50 F600                       ; 正向移动50mm
G1 X-50 F600                      ; 反向移动50mm
G90

判定标准：

STEPPER_BUZZ时电机有规律振动，无异常噪音
G28 X能正常回原点，不撞击限位
正向移动时电机轴顺时针旋转（从电机轴端观察），反向移动时逆时针旋转
移动距离与命令值一致（可用卡尺测量）
若以上全部满足，则配置与方向校正成功

故障排查参考

现象	可能原因	解决方法
电机完全不转	enable引脚极性错误	在enable_pin前加!或去掉!测试
电机抖动不转	电流设置过低或step引脚错误	增大run_current，检查step_pin
电机转向相反	dir_pin极性错误	在dir_pin前加!反转
电机异常发热	电流设置过高	降低run_current至电机额定值

完成以上配置与验证后，X轴步进电机驱动配置与方向校正即告完成。其余轴（Y/Z/E）按相同方法逐一配置和验证即可。