운동, 리미트 및 레벨링 오류
이 페이지에서는 이동 범위, 원점 복귀, 리미트, 프로브, 베드 메시 및 다중 Z 레벨링 관련 오류를 정리합니다. 배선, 커넥터, 수동 기계적 조정이 필요한 경우 먼저 전원을 차단한 후 작업하십시오.
Move out of range
오류 메시지: 대상 좌표가 Klipper에서 허용하는 이동 범위를 벗어났습니다. 로그에는 일반적으로 Move out of range: X Y Z [E]와 유사한 내용이 표시됩니다.
일반적인 원인:
- 슬라이서의 기계 크기가 Klipper 설정의
position_min/position_max와 일치하지 않습니다. - 시작 G-code, 종료 G-code, 필라멘트 교체 매크로 또는 일시 정지 매크로가 기계 범위 밖으로 이동합니다.
- 스큐 보정, 프로브 오프셋 또는 베드 메시 설정 사용 후 실제 계산된 좌표가 음수가 되거나 최대 스트로크를 초과합니다.
- 모델 높이가 Z축 최대 스트로크를 초과합니다.
해결 방법:
- 오류의 좌표를 확인하여 어떤 축이 범위를 벗어났는지 판단합니다.
- 해당 축의
position_min,position_max및 슬라이서 기계 크기를 확인합니다. - 시작, 종료, 일시 정지, 필라멘트 교체 등 매크로의 정지 좌표를 확인하여
0,0또는 최대 경계에 정지하지 않도록 합니다. - 베드 메시 스캔 중 오류가 발생하면
[bed_mesh]의mesh_min,mesh_max및 프로브 오프셋을 확인합니다. - 설정을 저장하고 Klipper를 재시작한 후 다시 테스트합니다.
관련 설정 참고: 매크로 소개, 원점 복귀 및 방향 보정 가이드.
Must home axis first
오류 메시지: 축이 아직 원점 복귀되지 않아 현재 이동 명령을 실행할 수 없습니다.
일반적인 원인:
- 전원 켜기 또는
FIRMWARE_RESTART후G28을 실행하지 않았습니다. - 매크로에서 원점 복귀 명령보다 이동 명령을 먼저 실행합니다.
- 인쇄 일시 정지, 재개 또는 취소 후 기계 상태가 재설정되었습니다.
- 원점 복귀 매크로, 프로브 매크로 또는 무한 리미트 원점 복귀 설정이 비정상적이어서 Klipper가 원점 복귀 상태를 올바르게 기록하지 못했습니다.
해결 방법:
- 해당 축을 이동하기 전에 수동으로
G28을 실행합니다. - 시작 G-code 및 매크로를 확인하여 이동 명령 전에 원점 복귀가 완료되었는지 확인합니다.
- Klipper 또는 펌웨어를 최근에 업데이트한 경우 원점 복귀 관련 매크로가 현재 버전과 여전히 호환되는지 확인합니다.
- 무한 리미트 원점 복귀를 사용하는 경우 드라이버 전류, 감도 및
homing_retract_dist를 확인합니다.
관련 설정 참고: 원점 복귀 및 방향 보정 가이드, 무한 리미트 사용.
Endstop still triggered after retract
오류 메시지: 원점 복귀가 리미트를 트리거한 후 후퇴 거리가 끝날 때 리미트가 여전히 트리거 상태입니다.
일반적인 원인:
- 리미트 스위치의 상시 개방/상시 폐쇄 로직 설정이 반대입니다.
- 리미트 스위치가 걸렸거나, 손상되었거나, 배선 순서가 잘못되었습니다.
homing_retract_dist가 너무 작아 후퇴 후에도 리미트를 누르고 있습니다.- 무한 리미트 원점 복귀 감도가 너무 높아 후퇴 후에도 트리거된 것으로 판단됩니다.
- 드라이버
enable_pin, 모터 방향 또는 리미트 핀 설정이 잘못되어 원점 복귀 동작이 비정상적입니다.
해결 방법:
리미트 커넥터, 모터 배선 순서를 확인하거나 케이블을 다시 연결하기 전에 프린터를 완전히 끄고 전원 공급을 차단하십시오. 전원 테스트 시에는 웹 명령과 리미트 기계적 트리거 부위만 조작하고 단자는 만지지 마십시오.
QUERY_ENDSTOPS를 실행하여 트리거되지 않았을 때open, 수동 트리거 후TRIGGERED인지 확인합니다.- 상태가 반대인 경우 리미트 핀 앞의
!를 조정합니다. - 전원을 끄고 리미트 스위치의 기계적 상태, 배선 순서 및 커넥터를 확인합니다.
homing_retract_dist를 적절히 늘린 후 다시 테스트합니다.- 무한 리미트 원점 복귀를 사용하는 경우 감도를 낮추고 원점 복귀 전류가 적절한지 확인합니다.
No trigger on endstop after full movement
오류 메시지: No trigger on x after full movement, No trigger on y after full movement 또는 유사한 리미트 미트리거 메시지.
일반적인 원인:
- 원점 복귀 방향 설정이 잘못되어 모터가 리미트에서 멀어지는 방향으로 이동합니다.
- 리미트 스위치가 연결되지 않았거나, 커넥터가 느슨하거나, 핀 설정이 잘못되었습니다.
position_endstop,position_min,position_max설정이 실제 스트로크와 일치하지 않아 원점 복귀 거리가 부족합니다.- 무한 리미트 원점 복귀 감도가 너무 낮아 기계적 끝단에 부딪혀도 트리거된 것으로 판단되지 않습니다.
- 모터 배선 순서 또는 방향 설정이 잘못되어 축 이동 방향이 예상과 반대입니다.
해결 방법:
QUERY_ENDSTOPS를 실행하고 수동으로 리미트를 눌러 상태가open에서TRIGGERED로 변경되는지 확인합니다.- 작은 거리로 이동하여 축 방향을 확인한 후
dir_pin앞의!조정이 필요한지 확인합니다. homing_positive_dir이 리미트가 있는 방향과 일치하는지 확인합니다.position_endstop,position_min,position_max가 실제 기계적 스트로크와 일치하는지 확인합니다.- 무한 리미트 원점 복귀 시나리오에서는 원점 복귀 속도를 낮추고 TMC 감도를 조정합니다.
관련 설정 참고: 원점 복귀 및 방향 보정 가이드, 리미트 관련.
프로브 및 레벨링 문제
BLTouch, Probe, TAP, Klicky, EDDY 등 프로브의 배선, 커넥터 또는 배선 순서를 확인하기 전에 프린터를 완전히 끄고 전원 공급을 차단하십시오. 전원 공급 시에는 쿼리 명령만 실행하거나 상태를 관찰하고, 케이블을 연결/분리하지 마십시오.
Probe triggered prior to movement
오류 메시지: 원점 복귀 또는 프로브 이동이 시작되기 전에 프로브가 이미 트리거 상태입니다.
오류 원인:
- 프로브가 전원 켜기 또는 리셋 후 기본 상태가
TRIGGERED입니다. - 프로브 배선 순서 오류 또는 접촉 불량으로 신호가 항상 트리거 상태입니다.
- 프로브 기계적 고장(예: BLTouch 프로브가 걸려 수축 불가).
- Z축이 이미 최저 위치에 있어 프로브가 눌려 있습니다.
해결 방법:
QUERY_PROBE를 실행하여 베드에 닿지 않은 상태에서 상태가open인지 확인합니다.QUERY_ENDSTOPS를 실행하여 리미트/프로브 신호가 올바른지 확인합니다.- BLTouch의 경우:
BLTOUCH_DEBUG COMMAND=pin_up으로 프로브가 수축되었는지 확인하고,QUERY_PROBE로 재확인합니다. - Z축 현재 위치를 확인하고 필요한 경우 먼저 Z축을 올립니다.
- 전원을 차단하고 프로브 배선 및
sensor_pin설정을 확인합니다.
관련 설정 참고: 리미트 관련, 자주 사용하는 디버그 명령어.
No trigger on probe after full movement
오류 메시지: 프로브가 전체 하강 스트로크 내에서 트리거되지 않았습니다.
일반적인 원인:
- 프로브 배선, 전원 공급 또는 핀 설정 오류.
- 프로브 설치 높이가 부적절하여 하강 스트로크 내에서 트리거할 수 없습니다.
- Z축 방향, 프로브 오프셋 또는 레벨링 영역 설정 오류.
- 프로브 자체 고장 또는 이동 중 케이블 접촉 불량.
해결 방법:
QUERY_PROBE를 실행하고 수동으로 프로브를 트리거하여 상태가 정상적으로 변경되는지 확인합니다.- 전원을 차단하고 프로브 전원 공급, 신호선 및 설정 핀을 확인합니다.
- 프로브 설치 높이를 확인하고 하강 전 프로브가 트리거 가능한 범위에 있는지 확인합니다.
[probe],[bed_mesh],[z_tilt]또는[quad_gantry_level]의 프로브 포인트가 베드를 벗어나는지 확인합니다.- 특정 위치에서만 문제가 발생하는 경우 케이블 드래그 및 프로브 오프셋을 집중적으로 확인합니다.
Probe samples exceed samples_tolerance
오류 메시지: Probe samples exceed samples_tolerance 또는 로그에 Probe samples exceed tolerance. Retrying...이 반복적으로 나타납니다.
일반적인 원인:
- 프로브 반복성이 낮아 여러 번 샘플링한 Z 높이 차이가
samples_tolerance를 초과합니다. - 베드, 갠트리, 핫엔드 또는 프로브 고정이 불안정하여 프로빙 시 흔들림이 발생합니다.
- 프로브 속도가 너무 빠르거나 하강 거리/복귀 거리가 부적절합니다.
- 유도, 와전류 또는 압력 센서가 온도 드리프트 또는 전자기 간섭의 영향을 받습니다.
해결 방법:
- 프로브, 핫엔드, 베드 플레이트 및 갠트리 구조가 견고하게 고정되었는지 확인합니다.
[probe]의speed를 낮추고sample_retract_dist를 적절히 늘립니다.- 임시로
samples_tolerance를 완화하여 테스트합니다(예:0.01에서0.03또는0.05로 조정). - 유도/와전류 프로브를 사용하는 경우 베드와 노즐 온도가 안정될 때까지 기다린 후 레벨링합니다.
- 특정 영역에서만 문제가 발생하는 경우 해당 영역의 베드 표면, 자석 시트, 케이블 드래그 및 프로브 오프셋을 확인합니다.
Must home before probe
오류 메시지: Must home before probe.
일반적인 원인:
G28을 실행하지 않고PROBE,BED_MESH_CALIBRATE,Z_TILT_ADJUST또는QUAD_GANTRY_LEVEL을 실행했습니다.- 매크로에서 레벨링 명령을 호출하기 전에 XY/Z가 원점 복귀되었는지 보장하지 않았습니다.
FIRMWARE_RESTART, 비상 정지 또는 오류 복구 후 Klipper가 원점 복귀 상태를 지웠습니다.
해결 방법:
- 먼저
G28을 실행한 후 프로브 또는 레벨링 명령을 실행합니다. - 레벨링 매크로 시작 부분에 원점 복귀 판단을 추가하거나 직접
G28을 추가합니다. - 독립 Z 프로브를 사용하는 경우
endstop_pin: probe:z_virtual_endstop및[probe]설정이 완전한지 확인합니다.
관련 설정 참고: 원점 복귀 및 방향 보정 가이드, 매크로 소개.
BLTouch failed to verify sensor state
오류 메시지: BLTouch failed to verify sensor state; retrying. 여러 번 재시도 후 오류 발생.
일반적인 원인:
- 불법 복제/클론 BLTouch가 Klipper 내부 센서 검증을 통과하지 못합니다.
sensor_pin에 풀업 저항이 설정되지 않았습니다(^접두사 누락).- BLTouch 제어 핀 또는 센서 핀 배선 오류.
- 프로브 자체 테스트 실패, 빨간색 LED 점멸.
해결 방법:
-
먼저
BLTOUCH_DEBUG COMMAND=pin_down,BLTOUCH_DEBUG COMMAND=touch_mode및QUERY_PROBE를 실행하여 상태를 확인합니다. -
수동 테스트는 통과하지만 자동 원점 복귀/프로빙 시 여전히 오류가 발생하면
[bltouch]에 다음을 추가합니다:pin_up_touch_mode_reports_triggered: False -
sensor_pin에 풀업 저항이 설정되었는지 확인합니다(예:sensor_pin: ^PC4). -
BLTouch 자체 테스트가 정상인지 확인합니다: 전원 켜기 후 프로브가 몇 번 수축/신장되고 빨간색 LED가 계속 켜져 있어야 정상입니다.
BLTouch failed to raise probe
오류 메시지: 원점 복귀 또는 프로빙 후 Klipper가 BLTouch 프로브가 성공적으로 수축되지 않았음을 감지했습니다.
일반적인 원인:
- 구형 버전 클론 BLTouch가 프로브 수축 상태를 보고할 수 없습니다.
- 프로브 기계적 걸림, 코어 이동 또는 나사 풀림.
control_pin배선 또는 설정 오류.
해결 방법:
-
프로브 제어 기능을 테스트합니다:
BLTOUCH_DEBUG COMMAND=pin_down및BLTOUCH_DEBUG COMMAND=pin_up. -
동작은 정상이지만 오류가 발생하면
[bltouch]에 다음을 추가합니다:pin_up_reports_not_triggered: False -
프로브가 걸린 경우 프로브 모듈을 교체하거나 A/S에 문의하십시오. 전원이 켜진 장치를 분해하지 마십시오.
horizontal_move_z can't be less than probe's z_offset
오류 메시지: horizontal_move_z can't be less than probe's z_offset.
일반적인 원인:
PROBE_CALIBRATE후 저장된z_offset이 레벨링 설정의horizontal_move_z보다 큽니다.- 노즐, 프로브 마운트 또는 핫엔드 교체 후 프로브 설치 높이가 크게 변경되었습니다.
- 여러 include 파일에서
horizontal_move_z또는z_offset이 중복 설정되었습니다.
해결 방법:
- 모든
horizontal_move_z및z_offset을 검색하여 최종 적용 설정을 확인합니다. - 관련 레벨링 설정의
horizontal_move_z를 프로브z_offset보다 큰 안전한 값으로 설정합니다. z_offset이 비정상적으로 큰 경우 프로브 설치 높이를 다시 확인하고PROBE_CALIBRATE를 실행합니다.- 저장 후
RESTART를 실행하고BED_MESH_CALIBRATE또는 레벨링 명령을 다시 테스트합니다.
bed_mesh: cannot exceed a probe_count of 6
오류 메시지: bed_mesh: cannot exceed a probe_count of 6 when using lagrange interpolation.
오류 원인: lagrange 보간법은 높은 샘플 수에서 진동하기 쉽습니다. Klipper는 이 알고리즘 사용 시 단일 축 프로브 포인트 수가 6을 초과할 수 없도록 제한합니다.
해결 방법:
-
7x7,9x9또는 더 촘촘한 그리드가 필요한 경우[bed_mesh]에서 다음을 설정합니다:algorithm: bicubic -
촘촘한 그리드가 필요하지 않은 경우
probe_count를6,6이하로 낮춥니다. -
적응형 베드 메시가 슬라이서 또는 매크로에서
PROBE_COUNT를 전달하는 경우 최종 포인트 수와 알고리즘이 일치하는지도 확인합니다. -
수정 후 저장하고
RESTART를 실행합니다.
관련 설정 참고: 매크로 소개.
bed_mesh: Unknown profile
오류 메시지: bed_mesh: Unknown profile [xxx] 또는 베드 메시 설정 로드 시 프로필을 찾을 수 없다는 메시지.
일반적인 원인:
- 시작 G-code 또는 매크로에서
BED_MESH_PROFILE LOAD=xxx를 실행했지만 해당 이름으로 저장된 적이 없습니다. BED_MESH_CLEAR를 실행했거나 자동 저장 영역의 베드 메시 데이터를 삭제했습니다.- 베드 메시 보정 완료 후
SAVE_CONFIG를 실행하지 않았습니다. - 프로필 이름의 대소문자 또는 공백이 일치하지 않습니다.
해결 방법:
BED_MESH_OUTPUT을 실행하거나 설정 끝의 자동 저장 영역을 확인하여 기존 프로필 이름을 확인합니다.- 필요한 프로필이 없으면
BED_MESH_CALIBRATE를 다시 실행한 후SAVE_CONFIG를 실행합니다. - 시작 G-code의
BED_MESH_PROFILE LOAD=를 수정하여 이름이 실제 저장된 이름과 일치하도록 합니다. - 매 인쇄 전에 베드 메시를 다시 스캔하는 경우 불필요한 프로필 로드 명령을 제거할 수 있습니다.
관련 설정 참고: 매크로 소개.
Z_TILT_ADJUST / QUAD_GANTRY_LEVEL 오류
오류 메시지: Z_TILT_ADJUST: Point X,Y not reachable with current probe offset, QUAD_GANTRY_LEVEL: Max adjustment X.XXXX exceeds limit 또는 갠트리 레벨링 후 편차가 여전히 너무 큼.
일반적인 원인:
- 프로브 오프셋 설정이 올바르지 않아 계산된 프로브 포인트가 베드 범위를 벗어납니다.
- 여러 Z축 갠트리 편차가
max_adjust허용 범위를 초과합니다. - Z축 모터 방향이 일치하지 않아 갠트리가 반대 방향으로 기울어집니다.
- 리미트 스위치 설치 높이가 일치하지 않아 원점 복귀 후 각 Z축 시작 위치 차이가 너무 큽니다.
- 갠트리 기계적 구조 느슨함, 벨트 미끄러짐 또는 리드 너트 간격 과다.
해결 방법:
Z 리드 스크류, 타이밍 벨트, 커플링을 수동으로 조정하거나 갠트리 리미트 설치를 확인하기 전에 프린터를 완전히 끄고 전원 공급을 차단하십시오. 모터에 전원이 공급되어 토크를 유지하는 상태에서 리드 스크류나 타이밍 벨트를 강제로 회전시키지 마십시오.
[probe]의x_offset,y_offset및[z_tilt]또는[quad_gantry_level]의points를 확인합니다.- 편차가
max_adjust를 초과하는 경우 완전히 전원을 차단하고 수동으로 갠트리를 대략 수평으로 조정한 후 다시 전원을 켜고 원점 복귀 및 레벨링을 실행합니다. STEPPER_BUZZ STEPPER=stepper_z및STEPPER_BUZZ STEPPER=stepper_z1(실제 이름으로)을 실행하여 각 Z 모터의 개별 이동 방향이 일치하는지 확인합니다.- 전원을 차단하고 갠트리 각 모서리의 리미트 스위치 설치 높이가 일치하는지, 리드 너트, 타이밍 벨트 장력 및 커플링에 미끄러짐이 있는지 확인합니다.
- 단순히
max_adjust제한이 너무 작은 경우 값을 적절히 늘릴 수 있지만 기본값의 2-3배를 초과하지 않도록 합니다.
관련 설정 참고: 원점 복귀 및 방향 보정 가이드.