VZBOT 참조 구성

사용 전 필독

이 페이지는 VZBOT / VZBOT AWD의 Klipper 참조 구성 템플릿으로, 바로 사용 가능한 완성 구성이 아닙니다.
serial, canbus_uuid, 모든 핀, 서미스터 모델, 스트로크, 리미트 방향, 모터 방향은 실제 하드웨어에 맞게 수정해야 합니다.
첫 전원 on 디버깅 시에는 벨트를 분리하거나 비상 정지/전원 차단 위치 근처에 손을 유지하고, 먼저 STEPPER_BUZZ를 사용하여 각 모터를 점검하십시오.

적용 범위

구조	설명
VZBOT 2WD	표준 CoreXY, X/Y 두 개 모터
VZBOT AWD	4모터 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 동축 모터가 서로 충돌함​

홈 방향 오류​

핫엔드 온도가 급변하거나 표시 이상​

관련 자료​