BLTouch 설정 및 문제 해결
이 문서는 Klipper에서 BLTouch 프로브의 배선, 설정, 테스트, 보정 및 일반적인 문제 해결에 대해 설명합니다.
관련 오류: BLTouch 관련 오류의 빠른 해결은 모션, 엔드스탑 및 레벨링 오류를 참조하세요.
배선 및 설정
시작하기 전에 프린터를 완전히 종료하고 전원 공급 장치를 분리하세요. 전원이 켜진 상태에서 케이블을 연결/분리하거나, 커넥터 핀 배열을 정리하거나, 터미널을 만지지 마십시오.
BLTouch에는 두 그룹의 케이블이 있습니다:
- 세 가닥(서보/제어 단자): 노란색 선이
control_pin신호선입니다. - 두 가닥(센서 단자): 흰색 선이
sensor_pin신호선입니다.
제어 단자를 메인보드의 Servo / BLTouch 제어 핀에 연결하고, 센서 단자를 메인보드의 Probe / Z-Max 등 엔드스탑 입력 핀에 연결하십시오. 특정 핀은 해당 FLY 메인보드 설정 문서를 참조하세요.
대부분의 BLTouch sensor_pin은 풀업 저항을 구성해야 하며, 핀 이름 앞에 ^ 접두사를 추가합니다. 예: sensor_pin: ^PC4
기본 설정 예시:
[bltouch]
sensor_pin: ^PC4
control_pin: PA1
x_offset: 0
y_offset: 0
z_offset: 0
speed: 5
BLTouch를 Z축 귀환 엔드스탑으로 사용하려면 다음이 필요합니다:
[stepper_z]에서endstop_pin: probe:z_virtual_endstop을 설정하고position_endstop을 삭제합니다.[safe_z_home]설정을 추가합니다:
[safe_z_home]
home_xy_position: 100, 100 # 베드 중심 좌표로 변경
speed: 50
z_hop: 10 # 귀환 전 10mm 상승
z_hop_speed: 5
z_hop은 프로브가 펼쳐진 상태에서도 베드나 고정 장치에 부딪히지 않을 정도로 충분히 높아야 합니다.
초기 테스트
자가 진단
전원을 켜면 BLTouch가 자동으로 자가 진단을 수행해야 합니다: 프로브가 위아래로 여러 번 움직인 후 수축되고, 빨간색 LED가 계속 켜집니다. 빨간색 LED가 깜빡이거나 프로브가 펼쳐진 상태로 멈추면 전원을 차단하고 배선과 설정을 확인하십시오.
제어 핀 테스트
BLTOUCH_DEBUG COMMAND=pin_down
프로브가 펼쳐지고 빨간색 LED가 꺼지는지 확인합니다. 그런 다음:
BLTOUCH_DEBUG COMMAND=pin_up
프로브가 수축되고 빨간색 LED가 다시 켜지는지 확인합니다. 빨간색 LED가 깜빡이면 이상이 있는 것입니다.
센서 핀 테스트
BLTOUCH_DEBUG COMMAND=pin_down을 실행하여 프로브가 펼쳐지는지 확인합니다.BLTOUCH_DEBUG COMMAND=touch_mode를 실행합니다.QUERY_PROBE를 실행하면probe: open이 반환되어야 합니다.- 손톱으로 프로브 핀을 살짝 위로 밀어 올린 후
QUERY_PROBE를 다시 실행하면probe: TRIGGERED가 반환되어야 합니다. BLTOUCH_DEBUG COMMAND=pin_up을 실행하여 프로브를 수축합니다.
QUERY_PROBE 결과가 올바르지 않으면 일반적으로 배선 또는 설정 오류입니다(일부 클론 버전은 특별 처리가 필요하며, 아래 참조).
프로브 테스트
프린트 헤드를 베드에서 멀리 이동시키고 G28(또는 PROBE)을 실행합니다. 프린트 헤드가 내려오기 시작하면 손톱으로 프로브 핀을 살짝 건드려 트리거되도록 합니다. 언제든지 프린터를 끌 준비를 하십시오. 성공한 후 프로브가 베드에 닿도록 정상적인 귀환을 한 번 더 실행합니다.
오류 복구 (빨간색 LED 깜빡임)
BLTouch가 비정상 상태에 빠져 빨간색 LED가 계속 깜빡이면 다음을 실행하십시오:
BLTOUCH_DEBUG COMMAND=reset
일반적인 트리거 원인: 프로브가 펼쳐진 상태에서 막혀 보정이 중단된 경우입니다.
reset 후에도 정상 작동하지 않으면 프로브 내부 자석 코어가 변위되었을 수 있습니다:
BLTouch 프로브를 분해하거나 조정하기 전에 프린터를 완전히 종료하고 전원 공급 장치를 분리하십시오.
- 전원을 차단한 후 프로브 상단 나사를 풀고 볼펜을 사용하여 자석 코어를 조심스럽게 원래 위치로 밀어 넣습니다.
- 프로브를 다시 장착하여 자연스럽게 펼쳐진 위치에 놓이게 합니다.
- 나사 위치를 조심스럽게 조정하고, 전원을 켠 후
BLTOUCH_DEBUG COMMAND=reset,pin_up,pin_down을 사용하여 수축/펼침과 빨간색 LED가 정상인지 테스트합니다.
클론 버전 호환성
대부분의 클론 BLTouch는 기본 설정으로 정상 작동하지만, 일부 클론 장치에는 다음과 같은 문제가 있습니다:
필요성이 확인되지 않은 상태에서 pin_up_reports_not_triggered 또는 pin_up_touch_mode_reports_triggered를 False로 설정하지 마십시오. 정품 BLTouch는 이 두 항목을 수정해서는 안 됩니다. 잘못된 설정은 프로브 시간을 증가시키고 프린터를 손상시킬 수 있습니다.
touch_mode 미지원
일부 클론 장치는 touch_mode를 지원하지 않아 QUERY_PROBE 명령이 정상 작동하지 않지만 G28 / PROBE는 여전히 성공할 수 있습니다. 이러한 장치에서는 probe_with_touch_mode를 활성화하지 마십시오.
BLTouch failed to verify sensor state
클론 장치가 Klipper 내부 센서 검증을 통과하지 못합니다. 먼저 센서 핀 테스트에 따라 QUERY_PROBE 결과가 올바른지 확인하십시오. 수동 테스트가 항상 정상인데도 오류가 보고되면 다음을 추가하십시오:
[bltouch]
pin_up_touch_mode_reports_triggered: False
BLTouch failed to raise probe
구형 클론 장치는 프로브 수축 상태를 보고할 수 없습니다. 테스트 방법:
- 프린트 헤드를 베드에서 멀리 이동시킵니다.
BLTOUCH_DEBUG COMMAND=pin_down→ 펼쳐짐 확인.QUERY_PROBE→probe: open이 반환되어야 합니다.BLTOUCH_DEBUG COMMAND=pin_up→ 수축 확인.QUERY_PROBE→probe: open대신probe: TRIGGERED가 반환되면 장치가 수축을 보고할 수 없는 것입니다.
확인 후 추가:
[bltouch]
pin_up_reports_not_triggered: False
BLTouch V3 버전 주의사항
V3.0 신호 문제
BLTouch V3.0의 sensor_pin이 필터 커패시터가 있는 엔드스탑 핀에 연결된 경우 트리거 신호를 안정적으로 보내지 못할 수 있습니다. 이는 QUERY_PROBE 테스트는 정상이지만 G28 / PROBE 시 프린트 헤드가 가끔 멈추지 않는 현상으로 나타납니다. 해결 방법:
[bltouch]
probe_with_touch_mode: True
V3.1 간헐적 오류 상태
BLTouch V3.1은 성공적인 프로브 후에 때때로 몇 초간 빨간색 LED가 깜빡입니다. Klipper가 자동으로 이 오류를 지우므로 일반적으로 해롭지 않습니다. probe_with_touch_mode: True를 설정하면 이 문제를 방지할 수 있습니다.
일부 클론 장치와 BLTouch V2.0 및 이전 버전은 probe_with_touch_mode: True를 활성화하면 정밀도가 저하될 수 있으며 프로브 펼침 시간이 증가합니다. 변경 전후에 PROBE_ACCURACY 명령을 사용하여 비교 테스트하십시오.
다중 프로브 시 수축 안 함
기본적으로 Klipper는 매 프로브 후 프로브를 수축했다가 다시 펼치므로 다중 프로브 시 시간이 오래 걸립니다. 다음 옵션을 설정하면 연속 프로브 간에 프로브를 펼친 상태로 유지할 수 있습니다:
[bltouch]
stow_on_each_sample: False
False로 설정하면 Klipper가 프로브가 펼쳐진 상태에서 수평 이동할 수 있습니다. 모든 프로브 작업의 Z 간격이 충분한지 반드시 확인하십시오. 그렇지 않으면 수평 이동 시 프로브가 장애물에 부딪혀 프린터가 손상될 수 있습니다.
stow_on_each_sample: False를 사용할 때는 probe_with_touch_mode: True를 함께 설정하는 것이 좋습니다. 신호 로직을 단순화하고 안정성을 높일 수 있습니다. 일부 클론 장치는 이 옵션 없이 후속 트리거를 감지하지 못할 수 있습니다.
오프셋 보정
PROBE_CALIBRATE 명령을 사용하여 x_offset, y_offset 및 z_offset을 보정합니다.
z_offset의 이상적인 값은 1mm에 가깝습니다. 편차가 너무 크면 프로브 장착 높이를 조정하는 것이 좋습니다: 프로브는 노즐이 베드에 닿기 전에 충분히 일찍 트리거되어야 하며, 동시에 수축 후에는 인쇄물을 긁지 않도록 노즐보다 충분히 높아야 합니다. 조정 후 PROBE_CALIBRATE를 다시 실행해야 합니다.
출력 모드 (5V / Open-Drain)
BLTouch V3.0 및 V3.1은 5V 및 Open-Drain 두 가지 출력 모드를 지원하며, 기본값은 Open-Drain입니다.
- 메인보드 입력 핀이 5V 하이 레벨을 필요로 하고 5V를 견딜 수 있는 경우 다음을 설정할 수 있습니다:
[bltouch]
set_output_mode: 5V
메인보드 입력 신호선이 5V를 견딜 수 있다고 확인된 경우에만 5V 모드를 사용하십시오. 잘못된 설정은 메인보드 CPU를 손상시킬 수 있습니다.
- V3.0: V3.0은 모드를 기억할 수 없으므로 시작할 때마다
set_output_mode: 5V를 설정해야 합니다. - V3.1:
BLTOUCH_STORE MODE=5V를 한 번 실행하여 내부 EEPROM에 모드를 저장할 수 있으며, 이후set_output_mode를 구성할 필요가 없습니다. 저장 명령을 반복해서 실행하지 마십시오. EEPROM 수명은 약 10만 회입니다. - 기타 프로브: 일부 프로브는 회로 보드 점퍼 또는 트레이스 절단을 통해 출력 모드를 영구적으로 설정하므로
set_output_mode매개변수가 필요하지 않습니다.