i3 单 Z 参考配置

使用前必看

• 本页面为 i3 / Cartesian 单 Z 机器的 Klipper 参考配置模板，不是直接可用的成品配置。
• serial、所有引脚、热敏型号、行程、限位方向、电机方向都必须按实际硬件修改。
• 首次上电调试时请先使用 STEPPER_BUZZ 检查每个电机，不要直接执行整机归位。

适用范围

结构	说明
i3 单 Z	X/Y/Z 各一个步进电机，Z 轴单丝杆或单电机同步双丝杆
Cartesian	X/Y/Z 直角坐标结构，非 CoreXY
入门机型改 Klipper	适合作为基础配置模板，再按主板和机器尺寸修改

需要先修改的内容

项目	位置	说明
主板 ID	[mcu]	USB 固件一般使用 serial
机器尺寸	[stepper_x]、[stepper_y]、[stepper_z]	按实际打印范围修改 position_max
电机方向	dir_pin	方向反了就在对应引脚前添加或删除 !
限位引脚	endstop_pin	按实际限位口修改，并确认是否需要 ^ / !
热敏型号	[extruder]、[heater_bed]	按热端和热床实际传感器填写
PID 参数	[extruder]、[heater_bed]	首次调试完成后执行 PID 校准并保存
挤出步进值	[extruder]	rotation_distance 必须实测校准

基础配置

printer.cfg

[include mainsail.cfg]
# [include fluidd.cfg]

[virtual_sdcard]
path: ~/printer_data/gcodes

[pause_resume]

[display_status]

[exclude_object]

[mcu]
serial: /dev/serial/by-id/usb-Klipper_xxxxxxxxxxxxx-if00

[temperature_sensor MCU]
sensor_type: temperature_mcu

[temperature_sensor HOST]
sensor_type: temperature_host

[printer]
kinematics: cartesian
max_velocity: 300
max_accel: 3000
max_z_velocity: 5
max_z_accel: 100

提示

i3 结构刚开始调试时建议先使用保守速度和加速度。确认方向、限位、加热、挤出都正常后，再逐步提高速度和加速度。

X/Y/Z 轴配置

示例使用 235 × 235 × 250 mm 行程。请按实际机器尺寸修改 position_max。

printer.cfg

[stepper_x]
step_pin:
dir_pin:
enable_pin:
microsteps: 16
rotation_distance: 40
endstop_pin:
position_endstop: 0
position_max: 235
homing_speed: 50

[stepper_y]
step_pin:
dir_pin:
enable_pin:
microsteps: 16
rotation_distance: 40
endstop_pin:
position_endstop: 0
position_max: 235
homing_speed: 50

[stepper_z]
step_pin:
dir_pin:
enable_pin:
microsteps: 16
rotation_distance: 8
endstop_pin:
position_endstop: 0.0
position_max: 250
homing_speed: 5
second_homing_speed: 2.5
homing_retract_dist: 5

挤出机配置

printer.cfg

[extruder]
step_pin:
dir_pin:
enable_pin:
microsteps: 16
rotation_distance: 33.683
nozzle_diameter: 0.400
filament_diameter: 1.750
heater_pin:
sensor_type: EPCOS 100K B57560G104F
sensor_pin:
min_temp: 0
max_temp: 250
max_extrude_only_distance: 100.0
# control: pid
# pid_Kp:
# pid_Ki:
# pid_Kd:

注意

rotation_distance: 33.683 是常见 MK8 类挤出机参考值，实际使用前必须重新校准。

热床配置

printer.cfg

[heater_bed]
heater_pin:
sensor_type: EPCOS 100K B57560G104F
sensor_pin:
min_temp: 0
max_temp: 130
# control: pid
# pid_Kp:
# pid_Ki:
# pid_Kd:

PID 校准命令：

PID_CALIBRATE HEATER=extruder TARGET=200
PID_CALIBRATE HEATER=heater_bed TARGET=60
SAVE_CONFIG

风扇配置

printer.cfg

[fan]
pin:
max_power: 1.0
shutdown_speed: 0

手动调平螺丝

下方坐标为 235 mm 热床参考值，需要按实际螺丝位置修改。

printer.cfg

[bed_screws]
screw1: 30.5,37
screw2: 30.5,207
screw3: 204.5,207
screw4: 204.5,37

12864 屏幕配置

如果机器使用 ST7920 12864 屏幕，可参考下方配置。未使用屏幕时请删除或注释本段。

printer.cfg

[display]
lcd_type: st7920
cs_pin:
sclk_pin:
sid_pin:
encoder_pins:
click_pin:

归位覆盖参考

部分 i3 机器热床向前移动范围较大，喷嘴可能碰到热床线缆护套。可通过 homing_override 固定 Y、X、Z 的归位顺序。

注意

启用下方配置后，单独执行 G28 X / G28 Y / G28 Z 的行为会受到影响。请确认机器结构确实需要该配置。

printer.cfg

#[homing_override]
#gcode:
#    G28 Y
#    G28 X
#    G28 Z

调试顺序

1. 修改 [mcu]，确认 Klipper 能连接主板。
2. 检查热端和热床温度，常温下应接近环境温度。
3. 使用 STEPPER_BUZZ 逐个检查 X/Y/Z/挤出机电机方向。
4. 使用 QUERY_ENDSTOPS 检查限位状态。
5. 低速执行 G28 X、G28 Y、G28 Z，确认单轴归位正常。
6. 执行热端和热床 PID 校准。
7. 校准挤出机 rotation_distance。
8. 完成热床手动调平和 Z 偏移校准。

常见问题

归位方向错误

修改对应轴的 dir_pin，添加或删除 ! 后重启 Klipper 再测试。

限位状态相反

修改 endstop_pin，添加或删除 !。常闭限位常见写法为 ^!引脚。

挤出长度不准

不要只依赖示例值，请按机器校准流程重新计算 rotation_distance。