VZBOT 参考配置

使用前必看

本页面为 VZBOT / VZBOT AWD 的 Klipper 参考配置模板，不是直接可用的成品配置。
serial、canbus_uuid、所有引脚、热敏型号、行程、限位方向、电机方向都必须按实际硬件修改。
首次上电调试时请断开皮带或保持手在急停/断电位置附近，先使用 STEPPER_BUZZ 检查每个电机。

适用范围

结构	说明
VZBOT 2WD	标准 CoreXY，X/Y 两个电机
VZBOT AWD	四电机 CoreXY，常见写法为 `stepper_x`、`stepper_x1`、`stepper_y`、`stepper_y1`
VZ-HextrudORT	可参考本文挤出机配置，实际 `rotation_distance` 仍需重新校准

需要先修改的内容

项目	位置	说明
主板 ID	`[mcu]`	USB 固件使用 `serial`，CAN 固件使用 `canbus_uuid`
机器尺寸	`[stepper_x]`、`[stepper_y]`、`[stepper_z]`	按 VZ235、VZ330 或自定义尺寸修改
电机方向	`dir_pin`	方向反了就在对应引脚前添加或删除 `!`
限位引脚	`endstop_pin`	物理限位、驱动无限位、Probe 三种方式写法不同
驱动型号	`[tmc2209]` / `[tmc5160]`	必须与实际驱动一致
热敏型号	`[extruder]`、`[heater_bed]`	按热端和热床实际传感器填写
PID 参数	`[extruder]`、`[heater_bed]`	首次调试完成后执行 PID 校准并保存

基础配置

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

[virtual_sdcard]
path: ~/printer_data/gcodes

[pause_resume]
recover_velocity: 350

[display_status]

[exclude_object]

[gcode_arcs]
resolution: 0.1

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

[temperature_sensor MCU]
sensor_type: temperature_mcu

[temperature_sensor HOST]
sensor_type: temperature_host

[printer]
kinematics: corexy
max_velocity: 500
max_accel: 10000
max_z_velocity: 20
max_z_accel: 300
square_corner_velocity: 10

提示

VZBOT 机器刚开始调试时建议先使用保守速度和加速度。确认归位、限位、加热、挤出、风扇都正常后，再逐步提高 max_velocity、max_accel 并重新做共振补偿。

2WD XY 配置

适用于只有两个 XY 电机的 VZBOT。引脚请按实际主板替换。

printer.cfg
[stepper_x]
step_pin:
dir_pin:
enable_pin:
rotation_distance: 40
microsteps: 16
full_steps_per_rotation: 200
endstop_pin:
position_min: 0
position_endstop: 0
position_max: 330
homing_speed: 50
homing_retract_dist: 0

[tmc2209 stepper_x]
uart_pin:
interpolate: False
run_current: 1.2
sense_resistor: 0.110
stealthchop_threshold: 0

[stepper_y]
step_pin:
dir_pin:
enable_pin:
rotation_distance: 40
microsteps: 16
full_steps_per_rotation: 200
endstop_pin:
position_min: 0
position_endstop: 0
position_max: 330
homing_speed: 50
homing_retract_dist: 0

[tmc2209 stepper_y]
uart_pin:
interpolate: False
run_current: 1.2
sense_resistor: 0.110
stealthchop_threshold: 0

AWD XY 配置

适用于四个 XY 电机的 VZBOT AWD。stepper_x 与 stepper_x1 应向同一方向运动，stepper_y 与 stepper_y1 也应向同一方向运动。

信息

VZBOT AWD 常见配置会出现 stepper_x1、stepper_y1 这类附加电机段。使用前请确认当前 Klipper 版本、运动学配置和示例配置支持该写法；如果使用官方新版通用运动学配置，请按对应示例改成 carriage / stepper 写法。

printer.cfg
[stepper_x]
step_pin:
dir_pin:
enable_pin:
rotation_distance: 40
microsteps: 16
full_steps_per_rotation: 200
endstop_pin:
position_min: 0
position_endstop: 0
position_max: 330
homing_speed: 50
homing_retract_dist: 0

[tmc5160 stepper_x]
cs_pin:
spi_bus:
interpolate: False
run_current: 1.6
sense_resistor: 0.033
driver_TBL: 1
driver_TOFF: 3
driver_DISS2G: 1
driver_DISS2VS: 1

[stepper_x1]
step_pin:
dir_pin:
enable_pin:
rotation_distance: 40
microsteps: 16
full_steps_per_rotation: 200

[tmc5160 stepper_x1]
cs_pin:
spi_bus:
interpolate: False
run_current: 1.6
sense_resistor: 0.033
driver_TBL: 1
driver_TOFF: 3
driver_DISS2G: 1
driver_DISS2VS: 1

[stepper_y]
step_pin:
dir_pin:
enable_pin:
rotation_distance: 40
microsteps: 16
full_steps_per_rotation: 200
endstop_pin:
position_min: 0
position_endstop: 0
position_max: 330
homing_speed: 50
homing_retract_dist: 0

[tmc5160 stepper_y]
cs_pin:
spi_bus:
interpolate: False
run_current: 1.6
sense_resistor: 0.033
driver_TBL: 1
driver_TOFF: 3
driver_DISS2G: 1
driver_DISS2VS: 1

[stepper_y1]
step_pin:
dir_pin:
enable_pin:
rotation_distance: 40
microsteps: 16
full_steps_per_rotation: 200

[tmc5160 stepper_y1]
cs_pin:
spi_bus:
interpolate: False
run_current: 1.6
sense_resistor: 0.033
driver_TBL: 1
driver_TOFF: 3
driver_DISS2G: 1
driver_DISS2VS: 1

AWD 电机方向检查

分别执行 STEPPER_BUZZ STEPPER=stepper_x、STEPPER_BUZZ STEPPER=stepper_x1、STEPPER_BUZZ STEPPER=stepper_y、STEPPER_BUZZ STEPPER=stepper_y1。
同一轴的两个电机必须朝同一方向动作。
如果同轴两个电机互相拉扯，立即断电，修改其中一个 dir_pin 的 ! 状态。

Z 轴配置

单 Z 配置

printer.cfg
[stepper_z]
step_pin:
dir_pin:
enable_pin:
microsteps: 16
rotation_distance: 4
full_steps_per_rotation: 200
endstop_pin:
position_min: -5
position_endstop: 0
position_max: 330
homing_speed: 5
second_homing_speed: 2.5
homing_retract_dist: 5

[tmc2209 stepper_z]
uart_pin:
interpolate: False
run_current: 1.0
sense_resistor: 0.110
stealthchop_threshold: 0

使用 Probe 作为 Z 限位

printer.cfg
[stepper_z]
step_pin:
dir_pin:
enable_pin:
microsteps: 16
rotation_distance: 4
full_steps_per_rotation: 200
endstop_pin: probe:z_virtual_endstop
position_min: -5
position_max: 330
homing_speed: 5
second_homing_speed: 2.5
homing_retract_dist: 5

[probe]
pin:
x_offset: 0
y_offset: 0
# z_offset: 0
speed: 5
lift_speed: 10
samples: 3
samples_result: median
sample_retract_dist: 2
samples_tolerance: 0.075
samples_tolerance_retries: 3

挤出机配置

VZBOT 常见使用 VZ-HextrudORT、Goliath、Dragon、Rapido 等热端组合。下面只提供通用参考，rotation_distance 必须实测。

printer.cfg
[extruder]
step_pin:
dir_pin:
enable_pin:
microsteps: 16
full_steps_per_rotation: 200
rotation_distance: 22.5
gear_ratio: 50:8
nozzle_diameter: 0.400
filament_diameter: 1.750
heater_pin:
sensor_type: PT1000
sensor_pin:
min_temp: 0
max_temp: 400
max_extrude_only_distance: 1000
max_extrude_only_velocity: 200
max_extrude_only_accel: 10000
pressure_advance: 0.02
pressure_advance_smooth_time: 0.03

[tmc2209 extruder]
uart_pin:
interpolate: False
run_current: 0.7
sense_resistor: 0.110

VZ-HextrudORT 常见参考值

挤出机	参考值	说明
VZ-HextrudORT Low T8	`rotation_distance: 22.5`	需要实测微调
VZ-HextrudORT Low T10	`rotation_distance: 23.8425`	需要实测微调
VZ-HextrudORT Low Plus T8	`rotation_distance: 29.7`	需要实测微调
VZ-HextrudORT Low Plus T10	`rotation_distance: 29.11`	需要实测微调

热床配置

printer.cfg
[heater_bed]
heater_pin:
sensor_type: Generic 3950
sensor_pin:
min_temp: 0
max_temp: 130
# control: pid
# pid_Kp:
# pid_Ki:
# pid_Kd:

PID 校准命令：

PID_CALIBRATE HEATER=heater_bed TARGET=100
SAVE_CONFIG

风扇配置

printer.cfg
[fan]
pin:
max_power: 1.0
cycle_time: 0.002
hardware_pwm: false
shutdown_speed: 0

[heater_fan hotend_fan]
pin:
max_power: 1.0
kick_start_time: 0.5
heater: extruder
heater_temp: 50.0

[controller_fan driver_fan]
pin:
max_power: 1.0
shutdown_speed: 0
kick_start_time: 0.5
fan_speed: 0.8
idle_timeout: 90
idle_speed: 0.4
stepper: stepper_x,stepper_y

热床网格

printer.cfg
[bed_mesh]
speed: 150
horizontal_move_z: 5
mesh_min: 30,30
mesh_max: 300,300
probe_count: 5,5
mesh_pps: 2,2
algorithm: bicubic
bicubic_tension: 0.2

提示

mesh_min 和 mesh_max 需要根据探针偏移、热床尺寸、喷头可达范围一起计算，不能直接照抄。

调试顺序

修改 [mcu]，确认 Klipper 能连接主板。
检查温度显示，常温下热端和热床温度应接近环境温度。
使用 STEPPER_BUZZ 逐个检查电机动作，AWD 同轴电机必须同向。
不装皮带或松皮带时检查 XY 方向。
低速执行 G28 X、G28 Y、G28 Z，确认限位触发方向。
执行热端和热床 PID 校准。
校准挤出机 rotation_distance。
完成 Z_OFFSET、热床调平、共振补偿和压力提前校准。

常见问题

Klipper 提示找不到 `stepper_x1`

检查是否把 AWD 配置中的 [stepper_x1] 整段漏掉，或者段名写成了其他名字。

AWD 同轴电机互相打架

立即断电，检查同一轴两个电机的接线顺序和 dir_pin。不要在互相拉扯的状态下继续通电测试。

归位方向错误

CoreXY 中 X/Y 方向会互相影响。先确保同轴 AWD 电机同向，再尝试调整 X/Y 的 dir_pin，每次只改一处并记录结果。

热端温度跳变或显示异常

优先检查热敏型号、接线、端子压接和 sensor_pin。PT1000、NTC 100K、热电偶/放大板的配置方式不同，不能混用。

适用范围​

需要先修改的内容​

基础配置​

2WD XY 配置​

AWD XY 配置​

Z 轴配置​

单 Z 配置​

使用 Probe 作为 Z 限位​

挤出机配置​

VZ-HextrudORT 常见参考值​

热床配置​

风扇配置​

热床网格​

调试顺序​

常见问题​

Klipper 提示找不到 stepper_x1​

AWD 同轴电机互相打架​

归位方向错误​

热端温度跳变或显示异常​

相关资料​