본문으로 건너뛰기

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

이 페이지에서는 이동 범위, 귀환, 리미트, 프로브, 베드 메시 및 다중 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 등 프로브의 배선, 플러그 또는 선 순서를 점검하기 전에 프린터를 완전히 끄고 전원 공급을 차단하십시오. 전원이 켜진 상태에서는 조회 명령을 실행하거나 상태를 관찰만 하고, 배선을 뽑거나 꽂지 마십시오.

Probe triggered prior to movement​

오류 메시지: 홈링 또는 프로빙 이동이 시작되기 전에 프로브가 이미 트리거 상태입니다.

오류 원인:

  • 프로브가 전원 투입 또는 리셋 후 기본 상태가 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 설정을 점검합니다.

관련 설정 참고: 리미트 관련, 자주 쓰는 디버그 명령.

No trigger on probe after full movement​

오류 메시지: 프로브가 전체 하강行程 내에서 트리거되지 않았습니다.

흔한 원인:

  • 프로브 배선, 전원 공급 또는 핀 설정 오류입니다.
  • 프로브 설치 높이가 부적절하여 하강行程 내에서 트리거할 수 없습니다.
  • Z축 방향, 프로브 오프셋 또는 레벨링 영역 설정 오류입니다.
  • 프로브 본체 고장, 또는 이동 시 배선 접촉 불량입니다.

해결 방법:

  1. QUERY_PROBE를 실행하고 수동으로 프로브를 트리거하여 상태가 정상적으로 변하는지 확인합니다.
  2. 전원을 차단한 후 프로브 전원 공급, 신호선 및 설정 핀을 점검합니다.
  3. 프로브 설치 높이를 확인하여 하강 전에 프로브가 트리거 가능 범위에 있는지 확인합니다.
  4. [probe], [bed_mesh], [z_tilt] 또는 [quad_gantry_level]의 프로빙 포인트가 히트베드를 벗어나는지 확인합니다.
  5. 특정 위치에서만 문제가 발생하면 배선 끌림과 프로브 오프셋을 중점적으로 점검합니다.

관련 설정 참고: 리미트 관련, 매크로 소개.

Probe samples exceed 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​

오류 메시지: 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 failed to verify sensor state​

오류 메시지: BLTouch failed to verify sensor state; retrying. 여러 번 재시도 후 오류가 발생합니다.

흔한 원인:

  • 복제/클론 BLTouch가 Klipper 내부 센서 검증을 통과하지 못합니다.
  • sensor_pin에 풀업 저항이 설정되지 않았습니다(^ 접두사 누락).
  • BLTouch 제어 핀 또는 센서 핀 배선 오류입니다.
  • 프로브 자체 점검 실패로 빨간 불이 깜빡입니다.

해결 방법:

  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 자체 점검이 정상인지 확인합니다: 전원 투입 후 프로브가 몇 번伸缩하고 빨간 불이 계속 켜져 있으면 정상입니다.

BLTouch failed to deploy​

오류 메시지: BLTouch failed to deploy.

흔한 원인:

  • BLTouch 프로브가 기계적으로 걸려서 나오지 않습니다.
  • control_pin 배선 또는 설정 오류로 프로브가伸出 신호를 받지 못합니다.
  • 복제/클론 BLTouch의 타이밍이 호환되지 않습니다.
  • 프로브 전원 공급 부족(메인보드 3.3V를 사용하고 5V가 아님).

해결 방법:

  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. 프로브가 걸린 경우 프로브 모듈 교체 또는 판매처 문의를 권장하며, 전원이 켜진 기기를 분해하지 마십시오.

전체 가이드: 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. 특정 축 홈링 시에만 발생하면 해당 축 모터선과 리미트 스위치 배선의 차폐 및 접지를 중점적으로 점검합니다.

관련 문제 해결: Lost communication with 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...