본문으로 건너뛰기

운동, 리미트 및 레벨링 오류

이 페이지에서는 이동 범위, 귀환, 리미트, 프로브, 베드 메시 및 다중 Z 레벨링 관련 오류를 정리합니다. 배선, 플러그, 수동 기계 조정과 관련된 작업 시에는 먼저 전원을 차단한 후 작업하십시오.

Move out of range​

오류 메시지: 대상 좌표가 Klipper에서 허용하는 이동 범위를 벗어났습니다. 로그에 일반적으로 Move out of range: X Y Z [E]와 유사한 내용이 표시됩니다.

Loading...

일반적인 원인:

  • 슬라이서의 기계 크기가 Klipper 설정의 position_min / position_max와 일치하지 않습니다.
  • 시작 G-code, 종료 G-code, 필라멘트 교체 매크로 또는 일시 정지 매크로가 기계 범위 밖으로 이동합니다.
  • 왜곡 보정, 프로브 오프셋 또는 베드 메시 설정 사용 후, 실제 계산된 좌표가 음수가 되거나 최대 행정을 초과합니다.
  • 모델 높이가 Z축 최대 행정을 초과합니다.

해결 방법:

  1. 오류의 좌표를 확인하여 어느 축이 범위를 벗어났는지 판단합니다.
  2. 해당 축의 position_min, position_max 및 슬라이서 기계 크기를 확인합니다.
  3. 시작, 종료, 일시 정지, 필라멘트 교체 등 매크로의 정지 좌표를 확인하고, 0,0 또는 최대 경계에 위치하지 않도록 합니다.
  4. 베드 메시 중 오류가 발생한 경우, [bed_mesh]의 mesh_min, mesh_max 및 프로브 오프셋을 확인합니다.
  5. 설정을 저장하고 Klipper를 재시작한 후 다시 테스트합니다.

관련 설정 참고: 매크로 소개, 귀환 및 방향 보정 가이드.

Unable to parse move / Invalid speed​

오류 메시지: Unable to parse move 'G1 Z', Unable to parse move 'G1 X... Y... Z...', Invalid speed in 'G1 ...', Machine does not support G20 (inches) command, Unknown g-code state: xxx.

일반적인 원인:

  • G-code 행 형식이 불완전합니다. 예: G1 Z 뒤에 구체적인 좌표값이 누락됨.
  • 매크로 변수가 비어 있어 최종 생성된 이동 명령에 X, Y, Z, E 또는 F 값이 누락됨.
  • 슬라이서 시작/종료 G-code 내 줄바꿈, 중괄호, 변수명 또는 이스케이프 형식 오류.
  • F 속도 매개변수가 비어 있거나, 0이거나, 숫자가 아님.
  • G-code 파일이 인치 모드 G20을 사용했으나 Klipper는 이 명령을 지원하지 않음.
  • 매크로에서 SAVE_GCODE_STATE / RESTORE_GCODE_STATE의 이름이 일치하지 않음.

해결 방법:

  1. klippy.log에서 오류가 발생한 전체 행을 찾아, 어떤 G1, G0 또는 상태 명령에 문제가 있는지 확인합니다.
  2. 슬라이서의 시작, 종료, 일시 정지, 재개 및 필라멘트 교체 매크로를 확인하여 모든 이동 명령에 완전한 값이 있는지 확인합니다.
  3. 매크로 매개변수에 기본값을 설정하고 사용 전에 숫자로 변환합니다. 예: params.Z|default(10)|float.
  4. 슬라이서 단위가 밀리미터인지 확인하고 G20을 출력하지 않도록 합니다.
  5. Unknown g-code state 오류가 발생하면 SAVE_GCODE_STATE NAME=과 RESTORE_GCODE_STATE NAME=이 동일한 이름을 사용하는지 확인합니다.

관련 설정 참고: 매크로 소개.

Must home axis first​

오류 메시지: 축이 아직 귀환되지 않아 현재 이동 명령을 실행할 수 없습니다.

일반적인 원인:

  • 전원 켜기 또는 FIRMWARE_RESTART 후 G28을 실행하지 않음.
  • 매크로에서 귀환 명령보다 이동 명령을 먼저 실행함.
  • 인쇄 일시 정지, 재개 또는 취소 후 기계 상태가 재설정됨.
  • 귀환 매크로, 프로브 매크로 또는 센서리스 귀환 설정 이상으로 Klipper가 귀환 상태를 올바르게 기록하지 못함.

해결 방법:

  1. 수동으로 G28을 실행한 후 해당 축을 이동합니다.
  2. 시작 G-code 및 매크로를 확인하여 이동 명령 전에 귀환이 완료되었는지 확인합니다.
  3. Klipper 또는 펌웨어를 최근에 업데이트했다면 귀환 관련 매크로가 현재 버전과 여전히 호환되는지 확인합니다.
  4. 센서리스 귀환을 사용하는 경우, 드라이버 전류, 감도 및 homing_retract_dist를 확인합니다.

관련 설정 참고: 귀환 및 방향 보정 가이드, 센서리스 사용.

Endstop still triggered after retract​

오류 메시지: 귀환 시 리미트가 트리거된 후, 후퇴 거리가 끝났을 때 리미트가 여전히 트리거 상태입니다.

일반적인 원인:

  • 리미트 스위치의 상시 개방/상시 폐쇄 로직 설정이 반대입니다.
  • 리미트 스위치가 걸려 있거나, 손상되었거나, 배선 순서가 잘못되었습니다.
  • homing_retract_dist가 너무 작아 후퇴 후에도 여전히 리미트를 누르고 있습니다.
  • 센서리스 귀환 감도가 너무 높아 후퇴 후에도 트리거된 것으로 판단됩니다.
  • 드라이버 enable_pin, 모터 방향 또는 리미트 핀 설정이 잘못되어 귀환 동작이 비정상적입니다.

해결 방법:

전원 차단 작업

리미트 플러그, 모터 배선 순서를 확인하거나 와이어 하네스를 다시 연결하기 전에 프린터를 완전히 끄고 전원 공급을 차단하십시오. 전원을 켠 상태에서 테스트할 때는 웹 명령과 리미트 기계적 트리거 부위만 조작하고 터미널을 만지지 마십시오.

  1. QUERY_ENDSTOPS를 실행하여 트리거되지 않았을 때 open, 수동으로 트리거했을 때 TRIGGERED인지 확인합니다.
  2. 상태가 반대라면 리미트 핀 앞의 !를 조정합니다.
  3. 전원을 차단한 후 리미트 스위치의 기계적 상태, 배선 순서 및 플러그를 확인합니다.
  4. homing_retract_dist를 적절히 늘린 후 다시 테스트합니다.
  5. 센서리스 귀환을 사용하는 경우, 감도를 낮추고 귀환 전류가 적절한지 확인합니다.

관련 설정 참고: 리미트 관련, 센서리스 사용.

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 설정이 실제 행정과 일치하지 않아 귀환 거리가 부족합니다.
  • 센서리스 귀환 감도가 너무 낮아 기계적 끝점에 부딪혀도 트리거된 것으로 판단되지 않습니다.
  • 모터 배선 순서 또는 방향 설정 오류로 축 이동 방향이 예상과 반대입니다.

해결 방법:

  1. QUERY_ENDSTOPS를 실행하고 수동으로 리미트를 눌러 상태가 open에서 TRIGGERED로 변경되는지 확인합니다.
  2. 작은 거리로 이동하여 축 방향을 확인한 후, dir_pin 앞의 ! 조정이 필요한지 확인합니다.
  3. homing_positive_dir이 리미트가 있는 방향과 일치하는지 확인합니다.
  4. position_endstop, position_min, position_max가 실제 기계적 행정과 일치하는지 확인합니다.
  5. 센서리스 귀환 시나리오에서는 귀환 속도를 낮추고 TMC 감도를 조정합니다.

관련 설정 참고: 귀환 및 방향 보정 가이드, 리미트 관련.

센서리스 귀환 문제 해결​

센서리스 귀환은 TMC 드라이버의 DIAG 신호를 통해 모터의 스톨(Stall)을 감지하여 물리적 리미트 스위치를 대체합니다. 설정 또는 감도가 적절하지 않으면 다음과 같은 오류가 발생할 수 있습니다. 완전한 호환성 확인, 참조 설정 및 감도 디버깅 방법은 센서리스 사용을 참조하십시오.

귀환 미트리거: No trigger on x after full movement​

오류 메시지: virtual_endstop으로 귀환할 때 No trigger on x after full movement 또는 No trigger on y after full movement 알림이 표시되며, 캐리지가 끝점에 부딪혀도 멈추지 않습니다.

일반적인 원인:

  • 감도 임계값이 적절하지 않음: TMC2209의 driver_SGTHRS가 너무 낮음(충분히 민감하지 않음) 또는 TMC5160 / TMC2240 / TMC2130의 driver_SGT가 너무 높음.
  • B 종류 메인보드에 DIAG 점퍼 캡이 설치되지 않았거나, 해당 리미트 포트에 다른 장치가 연결됨.
  • diag_pin에 풀업 기호 ^가 없어 오픈 드레인 신호가 안정적으로 트리거되지 않음.
  • 귀환 속도가 너무 낮거나 드라이버 전류가 너무 낮아 스톨 전류 변화가 DIAG 신호를 트리거할 수 없음.
전원 차단 작업

점퍼 캡, 리미트 포트 배선을 확인하거나 와이어 하네스를 연결/분리하기 전에 프린터를 끄고 전원을 차단하십시오. 전원이 켜진 상태에서 터미널을 만지거나 와이어 하네스를 연결/분리하지 마십시오.

해결 방법:

  1. 센서리스 사용 · 감도 테스트의 방법에 따라 가장 높은 감도부터 시작하여 SGTHRS / sgt를 단계별로 조정합니다.
  2. diag_pin에 ^ 풀업이 있는지 확인합니다(예: diag_pin: ^PD9). TMC5160 등 이중 DIAG 핀 드라이버의 경우 diag0_pin 또는 diag1_pin 중 어떤 것을 사용하는지 확인합니다.
  3. B 종류 메인보드에 DIAG 점퍼 캡이 설치되었고 해당 리미트 포트에 다른 장치가 연결되지 않았는지 확인합니다.
  4. 귀환 전류와 귀환 속도를 적절히 높인 후 재테스트합니다.

구성 오류: 알 수 없는 핀 칩 이름​

오류 정보: 시작 시 Unknown pin chip name 'tmc5160 stepper_x', Unknown pin chip name '^awd' 등의 오류가 발생하며 Klipper가 ready 상태로 진입하지 못합니다.

일반적인 원인:

  • endstop_pin에서 드라이버 이름과 축 이름 사이에 공백이 잘못 사용된 경우(예: tmc5160 stepper_x:virtual_endstop 올바른 표기는 밑줄 tmc5160_stepper_x:virtual_endstop을 사용해야 함).
  • diag_pin / diag0_pin / diag1_pin 핀 이름의 철자 오류 또는 잘못된 문자가 포함된 경우.

해결 방법:

  1. [stepper_x]의 endstop_pin을 확인하여 형식이 tmcXXXX_stepper_x:virtual_endstop이고 드라이버 이름과 축 이름 사이에 공백이 아닌 밑줄이 있는지 확인합니다.
  2. 드라이버 구성 섹션 이름 [tmcXXXX stepper_x] 내부에는 공백을 사용하지만, endstop_pin에서 참조할 때는 밑줄로 변경해야 하며 두 이름이 서로 일치해야 합니다.
  3. diag_pin 핀 이름의 철자를 확인하고, ^, ! 접두사와 유효한 핀 이름만 허용됩니다.

구성 오류: TMC 드라이버 구성 섹션을 찾을 수 없음​

오류 정보: Could not find any TMC driver config section for 'stepper_x' required by TMC autotuning.

일반적인 원인:

  • endstop_pin이 tmcXXXX_stepper_x:virtual_endstop을 참조하지만 구성에 해당하는 [tmcXXXX stepper_x] 드라이버 섹션이 없거나 드라이버 섹션 이름이 참조와 일치하지 않는 경우.
  • 드라이버 섹션이 주석 처리되었거나, 철자가 틀렸거나, 축 이름이 일치하지 않는 경우.

해결 방법:

  1. endstop_pin 참조와 완전히 일치하는 드라이버 구성 섹션이 존재하는지 확인합니다. 예를 들어 endstop_pin: tmc2209_stepper_x:virtual_endstop가 있으면 반드시 [tmc2209 stepper_x]가 있어야 합니다.
  2. 드라이버 섹션이 주석 처리되었거나 축 이름이 잘못되었는지 확인합니다(stepper_x와 stepper_y를 혼동하지 않도록 주의).

귀환 시 비상정지: Homing failed due to printer shutdown​

오류 정보: 귀환 중 프린터가 shutdown 상태가 되며 Homing failed due to printer shutdown 메시지가 표시됩니다.

일반적인 원인:

  • 이는 무한대 센서 전용 오류가 아니라 귀환 중 다른 shutdown(예: DIAG 신호 지터로 인한 오작동, 드라이버 오류, 서비스 재시작)이 발생하여 비상정지된 경우입니다.
  • 실제 원인은 klippy.log에서 Homing failed 이전의 첫 번째 shutdown 오류를 확인해야 합니다.

해결 방법:

  1. klippy.log를 열어 Homing failed due to printer shutdown 바로 위에 있는 첫 번째 shutdown 오류를 찾아 해당 분류에 따라 문제를 해결합니다.
  2. 위에 Can't reset time when stepper active 오류가 있는 경우 시스템, 성능 및 서비스 오류에 따라 처리합니다.
  3. DIAG 신호 지터로 인한 오작동인 경우 diag_pin 풀업과 점퍼 캡을 확인하고 감도를 적절히 낮춥니다.

관련 문서: 무한대 센서 사용, 전체 이동 후 엔드스톱 미트리거, TMC 오류 진단

프로브 및 레벨링 문제​

전원 차단 후 작업

BLTouch, Probe, TAP, Klicky, EDDY 등의 프로브 배선, 커넥터 또는 핀 배열을 점검하기 전에 프린터 전원을 완전히 끄고 전원 공급 장치를 분리하십시오. 전원이 켜진 상태에서는 쿼리 명령 실행 또는 상태 관찰만 수행하고, 배선이나 케이블을 분리/연결하지 마십시오.

이동 전 프로브 트리거됨​

오류 정보: 귀환 또는 프로빙 이동이 시작되기 전에 프로브가 이미 트리거된 상태입니다.

오류 원인:

  • 전원 공급 또는 리셋 후 프로브의 기본 상태가 TRIGGERED입니다.
  • 프로브 핀 배열 오류 또는 접촉 불량으로 인해 신호가 항상 트리거된 상태로 유지됩니다.
  • BLTouch 프로브가 걸려서 수축되지 않는 등의 프로브 기계적 결함.
  • Z축이 이미 최저 위치에 있어 프로브가 눌려 있는 경우.

해결 방법:

  1. QUERY_PROBE를 실행하여 히트 베드에 닿지 않은 상태에서 상태가 open인지 확인합니다.
  2. QUERY_ENDSTOPS를 실행하여 엔드스톱/프로브 신호가 올바른지 확인합니다.
  3. BLTouch의 경우: BLTOUCH_DEBUG COMMAND=pin_up으로 프로브가 수축되었는지 확인한 후 QUERY_PROBE로 확인합니다.
  4. Z축의 현재 위치를 확인하고 필요한 경우 먼저 Z축을 올립니다.
  5. 전원을 차단한 후 프로브 배선과 sensor_pin 구성을 확인합니다.

관련 구성 참고: 엔드스톱 관련, 자주 사용하는 디버그 명령어.

전체 이동 후 프로브 미트리거​

오류 정보: 프로브가 전체 하강 이동 범위 내에서 트리거되지 않았습니다.

일반적인 원인:

  • 프로브 배선, 전원 공급 또는 핀 구성 오류.
  • 프로브 장착 높이가 부적절하여 하강 이동 범위 내에서 트리거할 수 없음.
  • Z축 방향, 프로브 오프셋 또는 레벨링 영역 구성 오류.
  • 프로브 자체 결함 또는 이동 중 케이블 접촉 불량.

해결 방법:

  1. QUERY_PROBE를 실행하고 수동으로 프로브를 트리거하여 상태가 정상적으로 변경되는지 확인합니다.
  2. 전원을 차단한 후 프로브 전원 공급, 신호선 및 구성 핀을 확인합니다.
  3. 프로브 장착 높이를 확인하고 하강 전 프로브가 트리거될 수 있는 범위 내에 있는지 확인합니다.
  4. [probe], [bed_mesh], [z_tilt] 또는 [quad_gantry_level]의 프로빙 지점이 히트 베드를 벗어나지 않는지 확인합니다.
  5. 특정 위치에서만 문제가 발생하는 경우 케이블 드래그 및 프로브 오프셋을 중점적으로 확인합니다.

관련 구성 참고: 엔드스톱 관련, 매크로 소개.

프로브 샘플이 samples_tolerance 초과​

오류 정보: Probe samples exceed samples_tolerance 또는 로그에 Probe samples exceed tolerance. Retrying...가 반복적으로 나타납니다.

일반적인 원인:

  • 프로브의 반복성이 낮아 여러 번 샘플링한 Z 높이 차이가 samples_tolerance를 초과합니다.
  • 히트 베드, 갠트리, 핫엔드 또는 프로브 고정이 불안정하여 프로빙 시 흔들림이 발생합니다.
  • 프로브 속도가 너무 빠르거나 하강 거리/회수 거리가 부적절합니다.
  • 유도, 와전류 또는 압력 센서가 온도 드리프트, 전자기 간섭의 영향을 받습니다.

해결 방법:

  1. 프로브, 핫엔드, 베드 플레이트 및 갠트리 구조가 견고하게 고정되었는지 확인합니다.
  2. [probe]의 speed를 낮추고 sample_retract_dist를 적절히 늘립니다.
  3. 예를 들어 samples_tolerance를 0.01에서 0.03 또는 0.05로 임시 완화하여 테스트합니다.
  4. 유도/와전류 프로브를 사용하는 경우 히트 베드와 노즐 온도가 안정될 때까지 기다린 후 레벨링을 수행합니다.
  5. 특정 영역에서만 문제가 발생하는 경우 해당 영역의 베드 표면, 자석 시트, 케이블 드래그 및 프로브 오프셋을 확인합니다.

관련 구성 참고: 기계 보정, 매크로 소개.

프로브 전에 귀환 필수​

오류 정보: Must home before probe.

일반적인 원인:

  • G28을 실행하지 않고 PROBE, BED_MESH_CALIBRATE, Z_TILT_ADJUST 또는 QUAD_GANTRY_LEVEL을 실행한 경우.
  • 매크로에서 레벨링 명령을 호출하기 전에 XY/Z가 귀환되었는지 확인하지 않은 경우.
  • FIRMWARE_RESTART, 비상정지 또는 오류 복구 후 Klipper가 귀환 상태를 초기화한 경우.

해결 방법:

  1. 먼저 G28을 실행한 후 프로브 또는 레벨링 명령을 실행합니다.
  2. 레벨링 매크로 시작 부분에 귀환 조건문을 추가하거나 직접 G28을 추가합니다.
  3. 독립 Z 프로브를 사용하는 경우 endstop_pin: probe:z_virtual_endstop 및 [probe] 구성이 완전한지 확인합니다.

관련 구성 참고: 귀환 및 방향 보정 가이드, 매크로 소개.

BLTouch 센서 상태 확인 실패​

오류 정보: BLTouch failed to verify sensor state; retrying. 여러 번 재시도 후 오류 발생. 일반적인 원인:

  • 불법 복제/클론 BLTouch가 Klipper 내부 센서 인증을 통과하지 못함.
  • sensor_pin에 풀업 저항이 설정되지 않음 (^ 접두사 누락).
  • BLTouch 제어 핀 또는 센서 핀 배선 오류.
  • 프로브 자체 테스트 실패, 빨간색 LED 점멸.

해결 방법:

  1. 먼저 BLTOUCH_DEBUG COMMAND=pin_down, BLTOUCH_DEBUG COMMAND=touch_mode 및 QUERY_PROBE를 실행하여 상태를 확인합니다.

  2. 수동 테스트는 통과하지만 자동 귀환/프로빙 시 계속 오류가 발생하면 [bltouch]에 다음을 추가합니다:

    pin_up_touch_mode_reports_triggered: False

  3. sensor_pin에 풀업 저항이 설정되었는지 확인합니다. 예: sensor_pin: ^PC4.

  4. BLTouch 자체 테스트가 정상적인지 확인합니다: 전원을 켠 후 프로브가 몇 번 수축/신장되고 빨간색 LED가 계속 켜져 있으면 정상입니다.

BLTouch failed to deploy​

오류 메시지: BLTouch failed to deploy.

일반적인 원인:

  • BLTouch 프로브가 기계적으로 걸려 나오지 않음.
  • control_pin 배선 또는 설정 오류로 프로브가 신장 신호를 받지 못함.
  • 불법 복제/클론 BLTouch의 타이밍 비호환.
  • 프로브 전원 공급 부족 (메인보드 5V 대신 3.3V 사용).

해결 방법:

  1. 프로브 제어를 수동으로 테스트: BLTOUCH_DEBUG COMMAND=pin_down, 프로브가 나오는지 확인합니다.
  2. [bltouch]의 control_pin과 sensor_pin이 메인보드 문서와 일치하는지 확인합니다.
  3. BLTouch 전원이 5V인지 확인합니다 (일부 메인보드는 점퍼로 선택 필요).
  4. 프로브가 완전히 작동하지 않으면 전원을 차단하고 배선과 커넥터를 점검하며, 필요시 프로브 모듈을 교체합니다.

BLTouch failed to raise probe​

오류 메시지: 귀환 또는 프로빙 후 Klipper가 BLTouch 프로브가 성공적으로 수축되지 않았음을 감지.

일반적인 원인:

  • 구버전 클론 BLTouch가 프로브 수축 상태를 보고할 수 없음.
  • 프로브가 기계적으로 걸리거나, 자석 코어가 이동하거나 나사가 풀림.
  • control_pin 배선 또는 설정 오류.

해결 방법:

  1. 프로브 제어 기능 테스트: BLTOUCH_DEBUG COMMAND=pin_down 및 BLTOUCH_DEBUG COMMAND=pin_up.

  2. 동작은 정상이지만 오류가 발생하면 [bltouch]에 다음을 추가합니다:

    pin_up_reports_not_triggered: False

  3. 프로브가 걸린 경우, 프로브 모듈을 교체하거나 A/S에 문의하고, 전원이 켜진 상태에서 분해하지 마십시오.

전체 가이드: BLTouch 배선, 테스트, 클론 호환성 및 출력 모드 등 전체 설정 설명은 BLTouch 설정 및 문제 해결을 참조하십시오.

Communication timeout during homing​

오류 메시지: Communication timeout during homing x, Communication timeout during homing y 등.

일반적인 원인:

  • 귀환 중 모터 운동으로 인한 전자기 간섭으로 CAN 버스 통신 패킷 손실.
  • USB 통신선 접촉 불량, 운동 중 진동으로 인한 연결 끊김.
  • MCU 과부하 (예: 귀환과 동시에 다수의 센서 쿼리 트리거).

해결 방법:

  1. CAN/USB 통신선 배선이 모터선, 히터선, 전원선에서 멀리 떨어져 있는지 확인합니다.
  2. 통신선 커넥터가 견고한지 확인하고, 더 나은 품질의 차폐선으로 교체합니다.
  3. 모든 MCU 펌웨어 버전이 일치하는지 확인합니다.
  4. 특정 축 귀환 시에만 발생하는 경우, 해당 축의 모터선과 리미트 스위치 와이어 하네스의 차폐 및 접지를 중점적으로 점검합니다.

관련 문제 해결: MCU 통신 끊김, CAN 오류 문제 해결

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가 중복 설정됨.

해결 방법:

  1. 모든 horizontal_move_z 및 z_offset를 검색하여 최종 적용 설정을 확인합니다.
  2. 관련 레벨링 설정에서 horizontal_move_z를 프로브 z_offset보다 큰 안전한 값으로 설정합니다.
  3. z_offset이 비정상적으로 큰 경우, 프로브 장착 높이를 다시 확인하고 PROBE_CALIBRATE를 실행합니다.
  4. 저장 후 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을 초과할 수 없도록 제한합니다.

해결 방법:

  1. 7x7, 9x9 또는 더 조밀한 그리드가 필요한 경우 [bed_mesh]에서 다음을 설정합니다:

    algorithm: bicubic

  2. 조밀한 그리드가 필요하지 않은 경우 probe_count를 6,6 이하로 낮춥니다.

  3. 슬라이서 또는 매크로에서 PROBE_COUNT를 전달하는 적응형 메쉬 베드의 경우에도 최종 포인트 수와 알고리즘이 일치하는지 확인합니다.

  4. 수정 후 저장하고 RESTART를 실행합니다.

관련 설정 참조: 매크로 소개.

bed_mesh: Unknown profile​

오류 메시지: bed_mesh: Unknown profile [xxx] 또는 메쉬 베드 설정 로드 시 프로필을 찾을 수 없음.

일반적인 원인:

  • 시작 G-code 또는 매크로에서 BED_MESH_PROFILE LOAD=xxx를 실행했지만 해당 이름으로 저장된 적이 없음.
  • BED_MESH_CLEAR를 실행했거나 자동 저장 영역의 메쉬 베드 데이터가 삭제됨.
  • 메쉬 베드 교정 완료 후 SAVE_CONFIG를 실행하지 않음.
  • 프로필 이름의 대소문자 또는 공백 불일치.

해결 방법:

  1. BED_MESH_OUTPUT을 실행하거나 설정 끝의 자동 저장 영역을 확인하여 기존 프로필 이름을 확인합니다.
  2. 필요한 프로필이 없으면 BED_MESH_CALIBRATE를 다시 실행한 다음 SAVE_CONFIG를 실행합니다.
  3. 시작 G-code의 BED_MESH_PROFILE LOAD=를 수정하여 이름이 실제 저장된 이름과 일치하도록 합니다.
  4. 매 인쇄 전에 메쉬 베드를 다시 스캔하는 경우 불필요한 프로필 로드 명령을 제거할 수 있습니다.

관련 설정 참조: 매크로 소개.

bed_mesh 고급 설정 오류​

오류 메시지: bed_mesh: ERROR, fade_target lies outside of mesh z range, bed_mesh: Mesh extends outside of the fade range, bed_mesh: Cannot probe zero reference position, bed_mesh: invalid min/max points, bed_mesh: malformed 'xxx' value.

일반적인 원인:

  • fade_target이 현재 메쉬 베드 Z 높이 범위를 벗어나거나 메쉬 베드 데이터의 전체 편차가 너무 큼.
  • mesh_min, mesh_max, zero_reference_position이 프로브 오프셋 계산 후 프로브 불가능 영역에 위치.
  • faulty_region이 제로 기준점을 덮어 Klipper가 기준 위치를 프로브할 수 없음.
  • 좌표 목록 형식 오류, 쉼표 누락 또는 중국어 문장 부호 사용.
  • 적응형 메쉬 베드 매크로에서 전달된 MESH_MIN/MESH_MAX가 기기 크기, 프로브 오프셋과 일치하지 않음.

해결 방법:

  1. [bed_mesh]의 mesh_min, mesh_max, probe_count, fade_start, fade_end, fade_target을 확인합니다.
  2. fade_target의 의미를 모르는 경우 우선 해당 항목을 삭제하여 Klipper가 기본 동작을 사용하도록 합니다.
  3. 모든 프로브 포인트에 [probe]의 x_offset/y_offset을 더한 후에도 기기의 이동 가능 범위 내에 있는지 확인합니다.
  4. zero_reference_position 또는 faulty_region을 설정한 경우 제로 기준점이 결함 영역 내에 있지 않은지 확인합니다.
  5. 적응형 메쉬 베드에서 오류가 발생하면 고정 mesh_min/mesh_max로 먼저 테스트하여 기본 메쉬 베드 설정이 정상인지 확인한 후 매크로를 복원합니다.

관련 설정 참조: 매크로 소개, 기기 교정.

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 리드스크류, 동기 벨트, 커플링을 수동으로 조정하거나 갠트리 엔드스톱 장착을 확인하기 전에 프린터를 완전히 종료하고 전원 공급을 차단하십시오. 모터에 전원이 인가되어 토크를 유지하는 상태에서 리드스크류나 동기 벨트를 강제로 회전시키지 마십시오.

  1. [probe] 섹션의 x_offset, y_offset과 [z_tilt] 또는 [quad_gantry_level] 섹션의 points를 확인하십시오.
  2. 편차가 max_adjust를 초과하는 경우, 완전히 전원을 차단한 후 갠트리를 수동으로 대략 수평으로 맞춘 다음, 다시 전원을 켜고 귀환 및 레벨링을 수행하십시오.
  3. STEPPER_BUZZ STEPPER=stepper_z 및 STEPPER_BUZZ STEPPER=stepper_z1(실제 이름 기준)을 실행하여 각 Z 모터의 개별 이동 방향이 일관되는지 확인하십시오.
  4. 전원을 차단한 후 갠트리 각 모서리의 엔드스톱 설치 높이가 일관되는지, 리드스크류 너트, 동기 벨트 장력, 커플링에 미끄러짐이 있는지 확인하십시오.
  5. 단순히 max_adjust 제한이 너무 작은 경우 값을 적절히 늘릴 수 있지만, 기본값의 2~3배를 초과하지 않도록 하십시오.

관련 설정 참고: 귀환 및 방향 보정 가이드.

no samples between time​

오류 메시지: no samples between time X.X and X.X, 일반적으로 BED_MESH_CALIBRATE 실행 후 발생.

일반적인 원인:

  • EDDY 와전류 프로브 또는 Cartographer와 같은 스트리밍 샘플링 프로브의 펌웨어 버전이 호스트 Klipper와 일치하지 않음.
  • 베드 메쉬 샘플링 중 프로브 데이터 스트림이 중단됨(CAN 통신 지터, USB 대역폭 부족).
  • Klipper 업데이트 후 프로브 모듈 펌웨어가 함께 업데이트되지 않음.
  • 호스트 CPU 부하가 너무 높아 샘플링 데이터 타임스탬프에 이상이 발생함.

해결 방법:

  1. 프로브 모듈(EDDY, Cartographer 등) 펌웨어 버전이 현재 Klipper 버전과 일치하는지 확인하고, 필요한 경우 프로브 펌웨어를 다시 플래시하십시오.
  2. CAN 버스 상태를 확인하여 bytes_retransmit, bytes_invalid가 지속적으로 증가하지 않는지 확인하십시오.
  3. 카메라, KlipperScreen 및 기타 고부하 서비스를 일시적으로 중지한 후 베드 메쉬 보정을 다시 수행하십시오.
  4. 특정 영역에서만 오류가 발생하는 경우, 해당 영역이 프로브 유효 감지 범위를 벗어나는지 확인하십시오.
  5. 베드 메쉬 샘플링 속도를 낮춘 후(speed 매개변수 감소) 재테스트해 보십시오.

EDDY 프로브 관련: EDDY 문제 모음

SVD did not converge in Linear Least Squares​

오류 메시지: numpy.linalg.LinAlgError: SVD did not converge in Linear Least Squares, 일반적으로 BED_MESH_CALIBRATE 또는 ACCEPT 실행 후 shutdown 발생.

일반적인 원인:

  • 베드 메쉬 샘플링 지점 데이터가 비정상적임(모두 동일, NaN 포함 또는 극단적인 점프), numpy가 행렬 피팅을 완료할 수 없음.
  • 샘플링 중 프로브가 이상을 트리거함(예: EDDY 데이터 스트림 중단, Cartographer 모델 범위 초과).
  • 히트베드 표면에 금속 이물질이 있거나 프로브 감지면이 오염되어 개별 지점 판독값이 심각하게 벗어남.
  • 호스트 numpy 버전이 너무 오래되었거나 설치가 손상됨.

해결 방법:

  1. BED_MESH_CALIBRATE를 다시 실행하여 매번 동일한 지점에서 실패하는지 관찰하십시오.
  2. 히트베드 표면이 깨끗한지, 프로브 감지면에 필라멘트 잔여물이나 금속 파편이 있는지 확인하십시오.
  3. 프로브가 EDDY/Cartographer인 경우 펌웨어 버전이 Klipper와 일치하는지 확인하고 CAN 통신 안정성을 점검하십시오.
  4. probe_count를 줄여서(예: 7x7에서 5x5로) 재테스트하여 단일 지점 이상 영향을 배제하십시오.
  5. 문제가 지속되면 호스트 numpy 업데이트: pip install --upgrade numpy.
  6. klippy.log에서 오류 발생 전에 Toolhead stopped outside model range 또는 프로브 시간 초과와 같은 선행 오류가 있는지 확인하십시오.
Loading...