본문으로 건너뛰기

일반적인 오류 개요

이 페이지는 Klipper의 일반적인 오류를 빠르게 찾기 위한 페이지입니다. 먼저 klippy.log에서 전체 오류 키워드를 찾은 후, 해당하는 분류 페이지로 이동하여 처리하세요.

빠른 색인​

오류 유형일반적인 키워드문제 해결 진입점
연결 문제Unable to connect, Timeout on connect, Wait for identify_response, Serial connection closed, Invalid CAN uuid, Lost communication, MCU Protocol error, /dev/serial/by-id, Unable to issue reset command, Got EOF when reading from device이 페이지 연결 문제, MCU ID 구성, CAN 네트워크 및 ID 검색
구성 문제not valid, not a valid config section, must be specified, Unable to parse, SAVE_CONFIG, Option conflict, virtual_sdcard, pause_resume, display_status구성 관련 오류
매크로 및 슬라이서 명령Unknown command, Error evaluating 'gcode_macro, jinja2.exceptions.UndefinedError, dict object has no attribute구성 관련 오류
모션 귀환Move out of range, Must home axis first, No trigger, Endstop still triggered, virtual_endstop, Unknown pin chip name, Homing failed due to printer shutdown모션, 리미트 및 레벨링 오류, 센서리스 귀환 문제 해결
G-code 구문 분석Unable to parse move, Invalid speed, Machine does not support G20, G2/G3모션, 리미트 및 레벨링 오류, 호 피팅 권장 사항
프로브 레벨링Probe triggered, No trigger on probe, samples_tolerance, bed_mesh, BLTouch failed, Z_TILT, QUAD_GANTRY_LEVEL, no samples between time, SVD did not converge모션, 리미트 및 레벨링 오류, BLTouch 구성 및 문제 해결
온도 가열ADC out of range, not heating at expected rate, Verify heater, temperature, Thermocouple reader fault온도, 가열 및 압출 오류
압출 문제Extrude below minimum temp, Extrude only move too long, Move exceeds maximum extrusion, Filament sensor, M600온도, 가열 및 압출 오류
성능 타임아웃Timer too close, Missed scheduling, Stepper too far in past, Move queue overflow, stepcompress, Rescheduled timer, restarting too fast, SD busy, Unhandled exception during run, hard pwm event, Can't reset time when stepper active시스템, 성능 및 서비스 오류
TMC 드라이버Unable to read tmc uart, Unable to write tmc spi, GSTAT, coil short circuit, tmcuart_responseTMC 오류 문제 해결
CAN 네트워크bytes_invalid, Network is down, No buffer space available, Invalid CAN uuid, USB CANBUS bridge, BUS-OFFCAN 네트워크 및 ID 검색, CAN 오류 문제 해결
센서 주변기기Invalid adxl345 id, No data, Insufficient axis, Eddy current sensor error, Invalid read data, load_cell_probe, START_READ_NACK, I2C, BUS_TIMEOUT가속도계 테스트 및 보정, EDDY 문제 모음, Load Cell 프로브 문제 해결, 이 페이지 I2C 통신 오류
공진 보상 및 압력 전진shaper_freq, input_shaper, pressure_advance, smooth_time, accel_chip, TEST_RESONANCES, SHAPER_CALIBRATE공진 보상 및 압력 전진

관련 구성 페이지 빠른 참조​

오류 방향권장 참조
구성 구문, 들여쓰기, 주석, 중복 핀구성 수정 설명
귀환 방향, 축 방향, 강제 이동귀환 및 방향 보정 가이드
리미트, TAP, 광학 리미트, 근접 스위치리미트 관련
센서리스 귀환, 가상 리미트 감도센서리스 사용
가열, PID, 느린 승온, 온도 보호가열 관련, verify_heater 최적화, M109 최적화
팬 구성, 드라이버 팬, 7040 팬팬 참조 구성
압출기 매개변수, 회전 거리, 압출 구성압출기 참조 구성, 머신 보정
시작/종료 매크로, 일시정지 재개, 레벨링 및 베드 메쉬 매크로매크로 소개
일반적인 디버그 명령, 프로브, 공진 보상일반적인 디버그 지침

연결 문제​

MCU ID 설정 설명​

Klipper에서 MCU ID란 [mcu] 또는 [mcu xxx] 구성 섹션에서 컨트롤보드 연결을 식별하는 정보를 말합니다. 통신 방식에 따라 작성 방법이 다릅니다:

연결 방식구성 항목예시
USB 펌웨어serial:serial: /dev/serial/by-id/usb-Klipper_xxxxxxxxxxxx
CAN 펌웨어canbus_uuid:canbus_uuid: xxxxxxxxxxxx
RS232 장치serial:serial: /dev/serial/by-path/xxxxxxxxxxxx
호스트 MCUserial:serial: /tmp/klipper_host_mcu

기입 규칙:

  1. 메인보드는 기본적으로 [mcu]를 사용하고, 툴보드나 확장보드는 [mcu tool], [mcu toolboard] 등 사용자 정의 이름을 사용합니다.
  2. USB 펌웨어는 serial:만 기입하고, CAN 펌웨어는 canbus_uuid:만 기입합니다. 동일한 [mcu]에 두 항목을 동시에 유지하지 마십시오.
  3. 다중 MCU 시스템에서 각 [mcu xxx]는 실제 고유 ID를 사용해야 하며, 동일한 USB ID나 CAN UUID를 복사하지 마십시오.
  4. [mcu xxx]의 이름은 핀 접두사에 영향을 줍니다. 예를 들어 [mcu tool]의 핀은 tool:gpio13으로 작성해야 합니다. 이름의 대소문자는 일관성을 유지해야 합니다.
  5. 문서 예시의 xxxxxxxx는 직접 사용할 수 없으며, 실제 검색된 ID로 교체해야 합니다.
  6. RS232 장치는 serial: 외에도 일반적으로 baud: 250000과 restart_method: command를 추가로 기입해야 합니다. 해당 제품 문서를 기준으로 합니다.

일반적인 오류:

  • 플래싱 모드 ID(예: katapult, canboot가 포함된 ID)를 Klipper 펌웨어 ID로 잘못 사용하는 경우.
  • USB 펌웨어에 canbus_uuid:를 설정하거나, CAN 펌웨어에 이전 serial:을 유지하는 경우.
  • RS232 장치에서 경로만 기입하고 필요한 baud: 또는 restart_method:를 누락하는 경우.
  • 툴보드를 [mcu]로 설정하여 메인보드 MCU 구성을 덮어쓰는 경우.
  • 핀 접두사와 MCU 이름이 일치하지 않는 경우. 예: 구성이 [mcu toolboard]인데 핀을 tool:gpio13으로 작성하는 경우.

USB ID 조회: USB 펌웨어는 ls /dev/serial/by-id/*를 실행하여 ID를 확인할 수 있습니다.

CAN ID 조회: CAN 네트워크 및 ID 검색

RS232 경로 조회: ls -l /dev/serial/by-path/를 실행하여 안정적인 장치 경로를 확인합니다.

툴보드 구성: 툴보드 MCU 추가 및 크로스보드 구성

mcu 'xxx': 연결할 수 없음​

오류 메시지: 호스트가 메인보드를 찾거나 연결할 수 없습니다.

Loading...

일반적인 원인:

  • USB 장치 ID가 입력되지 않았거나 잘못 입력되었습니다.
  • CAN UUID가 입력되지 않았거나, 잘못 입력되었거나, 장치가 온라인 상태가 아닙니다.
  • UTOC, USB 케이블, CAN 브리지 펌웨어 또는 전원 공급에 이상이 있습니다.
  • CAN0이 시작되지 않았거나 CAN 네트워크 구성에 이상이 있습니다.

처리 방법:

  1. klippy.log를 열고 맨 아래로 이동하여 구체적인 오류 메시지를 확인합니다.

  2. [Errno 2]가 나타나면 일반적으로 검색된 USB 장치 ID를 printer.cfg에 추가하지 않았음을 의미합니다.

    Loading...

  3. Timeout on connect, Wait for identify_response 또는 Serial connection closed가 나타나면 MCU 연결 핸드셰이크 시간 초과에 따라 계속 문제를 해결하십시오. 이는 USB 연결과 시리얼 브리지 연결 모두에서 발생할 수 있습니다.

    Loading...

  4. Unable to open CAN port: [Errno 19] No such device가 나타나면 일반적으로 UTOC 장치, USB 브리지 CAN 펌웨어 또는 CAN0 장치가 없음을 의미합니다.

    Loading...

  5. [Errno 100] Network is down 또는 [Errno 105] No buffer space available가 나타나면 CAN 네트워크 및 ID 검색에 따라 CAN0 구성을 다시 확인하십시오.

mcu 'mcu': 잘못된 CAN UUID​

오류 메시지: CAN UUID가 유효하지 않거나 인식할 수 없습니다.

Loading...

오류 원인: canbus_uuid:가 잘못 입력되었거나, 장치가 온라인 상태가 아니거나, CAN 네트워크가 정상적으로 통신하지 않습니다.

해결 방법:

  1. CAN 네트워크 및 ID 검색에 따라 CAN UUID를 다시 검색합니다.
  2. printer.cfg에 실제 검색된 UUID가 입력되었는지 확인합니다.
  3. 동일한 [mcu]에 serial:과 canbus_uuid:가 동시에 활성화되어 있지 않은지 확인합니다.
  4. CAN-H, CAN-L, 터미네이션 저항, 전원 공급 및 펌웨어 CAN 속도를 확인합니다.

'mcu' 섹션의 'serial' 옵션은 반드시 지정해야 합니다​

오류 메시지: [mcu] 구성 섹션에 serial을 지정해야 합니다.

Loading...

오류 원인: USB 펌웨어 연결 시 serial:을 입력하지 않았거나 [mcu] 구성 섹션이 실수로 삭제되었습니다.

해결 방법:

  1. USB 장치 ID를 다시 검색합니다.
  2. printer.cfg의 [mcu] 구성 섹션에 다음을 입력합니다:
[mcu]
serial: /dev/serial/by-id/실제 검색된 ID
  1. 저장 후 Klipper를 재시작합니다.

현재 메인보드에 CAN 펌웨어가 플래시된 경우 serial:을 계속 입력하지 말고 canbus_uuid:를 사용하십시오.

USB ID를 찾을 수 없음 / 시스템 서비스 간섭​

오류 메시지: ls /dev/serial/by-id/* 실행 시 출력이 없거나 No such file or directory 오류가 발생합니다. Klipper 연결 시 mcu 'xxx': Unable to open serial port, [Errno 2] No such file or directory 오류가 발생하거나 USB 메인보드가 시스템에서 반복적으로 연결이 끊겼다가 다시 연결됩니다.

일반적인 원인:

  • 메인보드가 Klipper 펌웨어 실행 상태가 아니며 여전히 Katapult / CanBoot / DFU 등의 플래시 모드에 있습니다.
  • USB 케이블, USB 포트, 호스트 전원 공급 또는 메인보드 전원 공급에 이상이 있습니다.
  • Debian 11 Bullseye의 일부 udev 버전에 문제가 있어 /dev/serial/by-id/ 장치 경로가 생성되지 않을 수 있습니다.
  • 데스크톱 Linux에 ModemManager 또는 BRLtty가 설치되어 있을 수 있으며, 이러한 서비스가 시리얼 장치를 선점하여 Klipper가 메인보드에 안정적으로 연결하지 못할 수 있습니다.

문제 해결 방법:

전원 차단 작업

USB 케이블을 다시 연결하거나, 메인보드 전원 케이블을 확인하거나, USB / CAN 배선을 정리하기 전에 프린터를 완전히 끄고 전원 공급을 차단하십시오. 전원이 켜진 상태에서 인터페이스 배선 순서를 정리하거나 터미널을 만지지 마십시오.

  1. 먼저 메인보드에 Klipper 펌웨어가 플래시되어 실행 중인지 확인하십시오. USB ID에는 usb-Klipper가 포함되어야 하며 katapult, canboot, Bootloader 또는 DFU 모드 ID를 printer.cfg에 작성하지 마십시오.
  2. 전원을 차단한 후 안정적인 USB 데이터 케이블과 호스트 USB 포트로 교체하고, 다시 전원을 켠 후 ls /dev/serial/by-id/*를 다시 실행합니다.
  3. Debian 11 Bullseye, 구버전 MainsailOS / FluiddPi / Armbian 등을 사용하는 경우 다음 명령을 실행하여 udev 버전을 확인합니다:
apt-cache policy udev
  1. Debian 11의 udev 문제로 확인되면 시스템 정상 업데이트 소스를 통해 udev를 업그레이드하거나 최신 시스템 이미지로 교체하는 것을 우선적으로 고려하십시오.
  2. 시리얼 포트를 선점할 수 있는 서비스가 있는지 확인합니다:
systemctl list-units --all | grep -Ei 'ModemManager|brltty'
  1. 이러한 서비스가 설치되어 있고 현재 호스트에서 모뎀 또는 점자 터미널 기능이 필요하지 않은 경우, 이전 명령에서 표시된 전체 유닛 이름을 명령에 대체하여 서비스를 중지 및 비활성화한 후 시스템을 재시작합니다:
sudo systemctl disable --now ModemManager.service
sudo systemctl disable --now brltty.service
sudo systemctl disable --now brltty.path
  1. 완료 후 USB ID를 다시 확인하고 printer.cfg의 [mcu]에 있는 serial:이 실제 출력과 일치하는지 확인합니다.

관련 구성 참조: MCU ID 구성.

Serial connection closed / Timeout on connect / Wait for identify_response​

오류 메시지: Klipper 시작 또는 FIRMWARE_RESTART 실행 시 로그에 다음 오류가 순차적으로 또는 반복적으로 나타납니다:

mcu 'xxx': Timeout on connect
mcu 'xxx': Wait for identify_response
serialhdl.error: mcu 'xxx': Serial connection closed

오류 성격: 이 오류 그룹은 호스트가 MCU와 연결을 시도했지만 MCU가 지정된 시간 내에 펌웨어 식별 정보를 반환하지 않았음을 의미합니다. 이는 연결 핸드셰이크 실패를 설명하며 펌웨어 매개변수, 장치 경로, 배선 또는 하드웨어 자체 중 무엇이 원인인지 직접적으로 지적하지는 않습니다.

일반적인 원인:

  • MCU 펌웨어의 통신 인터페이스, 핀, 클록, 시작 주소 또는 부트로더 오프셋 선택이 잘못되었습니다.
  • 펌웨어가 올바르게 플래시되지 않았거나 메인보드가 여전히 DFU, Bootloader, Katapult / CanBoot 등의 플래시 모드에 있습니다.
  • serial:에 잘못되었거나, 오래되었거나, 불완전한 장치 경로가 사용되었습니다.
  • USB 데이터 케이블, USB 포트, 시리얼 브리지 칩 또는 메인보드 전원 공급에 이상이 있습니다.
  • CAN 툴보드 사용 시 브리지 장치, CAN 네트워크 또는 canbus_uuid: 구성에 이상이 있습니다.

해결 방법:

  1. 전체 klippy.log를 확인하여 이 오류 그룹이 최초 시작 연결 단계에서 발생했는지, 아니면 인쇄 중 MCU 연결 끊김 후 재연결 시 발생했는지 확인합니다.
  2. 다음 명령을 실행하여 시스템이 MCU를 안정적으로 인식하는지 확인하고 출력을 [mcu]의 serial:과 전체적으로 비교합니다:
ls -l /dev/serial/by-id/
dmesg --ctime | tail -n 80
  1. USB ID가 존재하고 안정적이지만 Wait for identify_response가 계속 표시되면 해당 FLY 제품 문서에 따라 펌웨어 컴파일 매개변수와 플래시 방법을 다시 확인하고 통신 인터페이스, 부트로더 오프셋 및 클록 구성을 중점적으로 확인하십시오. 플래시 모드의 장치 ID를 printer.cfg에 작성하지 마십시오.
  2. USB ID가 존재하지 않거나 dmesg에서 반복적으로 연결이 끊기면 이 페이지의 USB ID를 찾을 수 없음 / 시스템 서비스 간섭에 따라 시스템과 연결을 확인하십시오.
전원 차단 작업

USB / CAN 배선을 다시 연결하거나 교체하거나 메인보드 전원 공급 인터페이스를 확인하기 전에 프린터를 완전히 끄고 전원 공급을 차단하십시오. 전원이 켜진 상태에서 배선 순서를 정리하거나 터미널을 만지지 마십시오.

  1. 전원을 차단한 후 신뢰할 수 있는 완제품 데이터 케이블과 호스트 인터페이스로 교체한 다음 다시 전원을 켜서 테스트합니다. 전원 공급 장치를 분해하거나 AC 배선을 변경하지 마십시오.
  2. CAN 장치는 계속해서 CAN 오류 해결을 참조하여 브리지 장치, CAN 상태 및 UUID를 다시 확인하십시오.
  3. 첫 연결이 정상이고 인쇄 중에만 Serial connection closed가 발생하는 경우, 우선 Lost communication with MCU에 따라 실행 중 연결 끊김을 점검하고, 문제를 은폐하기 위해 펌웨어를 반복적으로 플래시하지 마십시오.

Lost communication with MCU​

오류 메시지: Klipper와 MCU 통신이 중단되며, 로그에 Lost communication with MCU, Lost communication with mcu 또는 유사한 메시지가 나타날 수 있습니다.

일반적인 시나리오: 원점 복귀 또는 이동 중에 리미트 스위치가 트리거되면 메인보드나 툴보드가 연결이 끊어집니다. 다시 전원을 켜면 연결이 복구됩니다.

일반적인 원인:

  • 리미트 스위치 배선 오류로 트리거 시 신호 핀이 전원 또는 접지와 비정상적으로 단락됩니다.
  • 3선식 리미트, 광전 리미트 또는 홀 리미트 사용 시 전원, 접지, 신호선 순서가 잘못 연결되었습니다.
  • 리미트 배선 하네스의 피복 손상, 압착 또는 케이블 체인 운동 중 단락.
  • 리미트 트리거 순간 메인보드 전원 변동으로 MCU 재시작 또는 USB / CAN 통신 중단.
  • MCU와 호스트 간 USB / CAN 통신 케이블이 강한 간섭원을 통과하여 리미트 트리거나 이동 시 연결 끊김이 더 쉽게 발생.
  • 구성의 리미트 핀이 실제 배선과 일치하지 않아 잘못된 인터페이스가 트리거됨.

점검 방법:

전원 차단 작업

리미트 케이블을 분리하거나, 배선 순서를 확인하거나, 케이블 체인 하네스를 점검하거나, 멀티미터로 통전/저항을 측정하기 전에 프린터를 완전히 끄고 전원 공급 장치를 분리하십시오. 멀티미터 저항/통전 모드는 전원이 차단된 상태에서만 사용할 수 있으며, 전원이 켜진 상태에서 저항 측정이나 단락 테스트는 금지됩니다.

  1. 전원을 차단한 후 리미트 스위치 배선 순서를 확인하고, 특히 3선식 리미트의 VCC, GND, Signal이 잘못 연결되었는지 확인합니다.
  2. 전원을 차단한 후 해당 리미트 케이블을 임시로 분리하고 다시 장착한 다음 전원을 켜서 메인보드가 여전히 연결이 끊어지는지 테스트합니다.
  3. 전원을 차단한 후 멀티미터 통전/저항 모드로 리미트 트리거 전후에 단락이 있는지 확인하고, 신호 핀이 전원에 연결되었는지 중점적으로 확인합니다.
  4. 케이블 체인, 커넥터 및 하네스 굽힘 위치를 점검하여 트리거 또는 이동 중 압착으로 인한 단락이 없는지 확인합니다.
  5. MCU와 호스트 간 USB / CAN 통신 케이블을 점검하고, 가능한 모터 케이블, 히터 케이블, 히트베드 케이블 및 전원 케이블을 피하십시오.
  6. 기기 외함, 전원 공급 장치 또는 차폐층이 확실하게 접지되지 않은 경우 간섭에 더 취약할 수 있습니다. 제조사가 제공한 접지점과 콘센트 상태만 확인하고, 전원 공급 장치를 직접 분해하거나 AC 접지를 변경하지 마십시오.
  7. 구성의 리미트 핀이 메인보드 문서 및 실제 배선과 일치하는지 확인합니다.
  8. 문제가 해결된 후 QUERY_ENDSTOPS를 실행하여 리미트 상태가 open에서 TRIGGERED로 정상적으로 전환되는지 확인합니다.

관련 구성 참조: 리미트 관련, 전원 배선 설명.

Unable to issue reset command on MCU​

오류 메시지: Unable to issue reset command on MCU 'xxx', 로그에는 일반적으로 webhooks client ...: Disconnected 및 Restarting printer가 함께 나타납니다.

오류 성격: 이 오류는 일반적으로 첫 번째 오류가 아니라, MCU 연결 끊김, 전원 차단 또는 통신 중단 후 Klipper가 MCU에 리셋 명령을 보내는 데 실패했을 때의 후속 메시지입니다. 점검 시 위로 스크롤하여 더 먼저 나타난 첫 번째 실제 오류(예: Lost communication with MCU, Timer too close, Verify heater, TMC 오류 등)를 찾아야 합니다.

일반적인 원인:

  • 선행 MCU 연결 끊김, USB / CAN 통신 중단 또는 펌웨어 충돌로 리셋 명령이 전달되지 않음.
  • 메인보드, 툴보드 또는 외부 MCU 전원 공급 부족으로 리셋 중 전원이 끊어짐.
  • USB 케이블, CAN 케이블 접촉 불량 또는 케이블 손상.
  • MCU가 고부하 작업(예: 가열, 다중 지점 베드 레벨링) 실행 중 강제로 리셋됨.
  • 호스트와 MCU 간 신호가 강한 간섭(모터 케이블, 히터 케이블이 통신 케이블에 근접)을 받음.

해결 방법:

전원 차단 작업

USB / CAN 케이블을 다시 연결하거나, 케이블을 점검하거나, 배선을 정리하기 전에 프린터를 완전히 끄고 전원 공급 장치를 분리하십시오. 전원이 켜진 상태에서 케이블을 뽑거나 터미널을 만지지 마십시오.

  1. klippy.log를 열고 Unable to issue reset command 이전에 첫 번째 실제 오류를 찾아 해당 분류에 따라 점검합니다.
  2. 전원을 차단한 후 USB / CAN 케이블을 다시 연결하고, 신뢰할 수 있는 완제품 케이블로 교체하며 연결이 확실한지 확인합니다.
  3. 메인보드 및 툴보드 전원 공급이 안정적인지 확인하고, 모터, 히트베드 등 고전력 장비와 불안정한 전원 회로를 공유하지 않도록 합니다.
  4. USB / CAN 통신 케이블이 모터 케이블, 히터 케이블 및 히트베드 케이블을 피하도록 확인합니다.
  5. FIRMWARE_RESTART를 실행하고, 필요한 경우 전체 기기의 전원을 10초 동안 차단한 후 다시 켭니다.
  6. 문제가 반복되는 경우 Lost communication with MCU 및 CAN 오류 해결을 계속 참조하여 점검합니다.

Got EOF when reading from device​

오류 메시지: Got EOF when reading from device, 로그에서 일반적으로 Attempting MCU 'xxx' reset command 이후에 나타나며, 호스트가 MCU에 리셋을 시작할 때 직렬/USB 연결이 이미 끊어졌음을 나타냅니다.

오류 성격: 이 오류는 호스트 운영 체제(Linux) 계층에서 반환된 오류로, Klipper는 단지 pyserial이 읽은 파일 끝 표시(EOF)를 전달한 것입니다. 이는 USB / 직렬 링크가 물리적으로 끊어졌거나 장치가 사라졌음을 나타내며, 구성 매개변수 문제가 아닙니다.

일반적인 원인:

  • USB 케이블 품질 불량, 접촉 불량, USB 포트 전원 공급 부족으로 장치가 리셋 중 연결이 끊어짐.
  • 메인보드, 툴보드 전원 변동으로 MCU 리셋 또는 전원 차단으로 장치가 시스템에서 사라짐.
  • 호스트 USB 컨트롤러 이상, USB 포트 고장 또는 시스템 USB 절전 정책.
  • CAN 툴보드가 USB 브리지를 통해 연결될 때 브리지 장치 연결 끊김(이 경우 로그에 Unable to issue reset command on MCU가 동시에 나타날 수 있음).

해결 방법:

전원 차단 작업

USB / CAN 케이블을 다시 연결하거나, 전원 케이블을 점검하거나, 케이블을 교체하기 전에 프린터를 완전히 끄고 전원 공급 장치를 분리하십시오.

  1. 먼저 어떤 MCU에서 오류가 발생했는지 확인한 다음 해당 USB / CAN 연결 링크를 점검합니다.
  2. 전원을 차단한 후 USB 케이블을 다시 연결하고, 고품질 USB 케이블로 교체하며 호스트의 다른 USB 포트에서 테스트합니다.
  3. ls /dev/serial/by-id/*를 실행하여 장치가 시스템에 아직 있는지 확인합니다. 장치가 사라진 경우 전원 공급, 케이블 또는 MCU 리셋 계층 문제입니다.
  4. 메인보드 및 툴보드 전원 공급이 안정적인지 확인하고, 전원 케이블의 전압 강하가 정상인지 확인합니다(전원 공급 장치를 직접 분해하거나 AC 배선을 변경하지 마십시오).
  5. 로그에 Unable to issue reset command on MCU가 동시에 나타나는 경우 Unable to issue reset command를 함께 참조하여 처리합니다.
  6. CAN 툴보드와 관련된 경우 CAN 오류 해결에 따라 버스 상태를 점검합니다.
  7. 문제가 반복되는 경우 Lost communication with MCU를 참조하여 계속 점검합니다.

Timeout on wait for 'xxx' response​

오류 메시지: Timeout on wait for 'neopixel_result' response, Timeout on wait for 'trsync_state' response 등.

일반적인 원인:

  • CAN / USB 통신 링크가 불안정하여 MCU가 호스트 요청에 신속하게 응답하지 못함.
  • MCU 부하가 과도함(예: 고속 인쇄 + 다축 동시 이동 + 가속도계 쿼리 동시 실행).
  • Neopixel LED 수가 너무 많거나 데이터 케이블 품질이 낮아 neopixel_result 시간 초과.
  • MCU 펌웨어 버전이 호스트와 일치하지 않음.

해결 방법:

  1. USB / CAN 통신 케이블 연결이 견고한지 확인하고, 가능한 모터 케이블, 히터 케이블 등 간섭원을 피하십시오.
  2. Neopixel 시간 초과인 경우 LED 수를 줄이거나 고품질 데이터 케이블로 교체하고 data_pin 구성이 올바른지 확인합니다.
  3. 모든 MCU 펌웨어 버전이 일치하는지 확인하고, 필요한 경우 다시 컴파일하여 플래시합니다.
  4. 인쇄 속도와 가속도를 낮추고 재현 여부를 관찰합니다.

MCU Protocol error​

오류 메시지: MCU 프로토콜 오류, 로그에 MCU Protocol error, Unknown command 또는 Command format mismatch가 나타날 수 있습니다.

Loading...

일반적인 원인:

  • 호스트 Klipper를 업데이트했지만 메인보드 또는 툴보드 펌웨어를 다시 컴파일하고 플래시하지 않음.
  • 메인보드, 툴보드, EDDY, ADXL 등 외부 MCU 펌웨어 버전이 호스트 Klipper와 일치하지 않음.
  • 맞춤형 시스템 또는 타사 플러그인을 사용하여 Klipper 호스트 측과 MCU가 지원하는 명령이 일치하지 않음.

해결 방법:

  1. 최근 Klipper, 시스템 이미지 또는 플러그인을 업데이트했는지 확인합니다.
  2. 모든 MCU의 Klipper 펌웨어를 다시 컴파일하고 플래시합니다.
  3. 툴보드, EDDY, ADXL 등 외부 MCU인 경우 해당 외부 펌웨어도 함께 업데이트합니다.
  4. 맞춤형 시스템을 사용하는 경우 해당 시스템이 현재 Klipper 버전을 지원하는지 확인합니다.
  5. 플래시 완료 후 FIRMWARE_RESTART를 실행하고 다시 연결하여 테스트합니다.

I2C 통신 오류 (START_READ_NACK / BUS_TIMEOUT)​

오류 메시지: MCU 'xxx' I2C request to addr 42 reports error START_READ_NACK, I2C request to addr 104 reports error START_READ_NACK 또는 I2C ... BUS_TIMEOUT.

일반적인 원인:

  • I2C 장치 주소 설정 오류 또는 버스에 해당 주소의 장치가 없음.
  • I2C 배선 느슨함, 단선 또는 SDA/SCL 반대로 연결.
  • 풀업 저항 부족 또는 버스 길이가 너무 길어 신호 감쇠 발생.
  • 센서가 준비되기 전에 읽음 (예: 전원을 켠 직후 즉시 쿼리).
  • 여러 I2C 장치의 주소 충돌.

해결 방법:

전원 차단 작업

I2C 배선, 센서 모듈 또는 풀업 저항을 점검하기 전에 프린터를 완전히 끄고 전원 공급을 차단하십시오.

  1. 전원을 차단한 후 I2C 배선(SDA, SCL, VCC, GND)이 견고한지 확인하고, 반대로 연결되지 않았는지 확인하십시오.
  2. 설정의 I2C 주소가 실제 장치와 일치하는지 확인하십시오. 일반적인 주소: ADXL345는 0x53(83) 또는 0x1D(29), MPU6050은 0x68(104)입니다.
  3. I2C 버스에 풀업 저항(보통 4.7kΩ)이 있는지 확인하십시오. 모듈에 기본 제공되는 경우 추가로 설치할 필요가 없습니다.
  4. 버스 길이가 긴 경우(30cm 초과), 배선을 짧게 하거나 I2C 속도를 낮추십시오.
  5. 시작 시에만 한 번 발생하는 경우, 센서 초기화 지연일 수 있으므로 이후 안정적으로 작동하는지 관찰하십시오.
  6. 동일한 I2C 버스에서 두 장치가 동일한 주소를 사용하지 않는지 확인하십시오.

EDDY 프로브 I2C 오류: EDDY 와전류 프로브에서 BUS_TIMEOUT 오류가 발생하는 경우 EDDY 문제 모음을 참조하십시오.

분야별 FAQ​

분야진입 경로
설정 충돌, 매개변수 구문 분석, SAVE_CONFIG설정 관련 오류
알 수 없는 명령, 매크로 템플릿, 슬라이서 시작 G-code설정 관련 오류
모션, 귀환, 리미트, 프로브, 베드 레벨링모션, 리미트 및 레벨링 오류
센서리스 귀환, virtual_endstop, DIAG 감도센서리스 귀환 문제 해결, 센서리스 사용
온도, 가열, 압출, 필라멘트 감지온도, 가열 및 압출 오류
성능, 타임아웃, 펌웨어, 시스템 서비스시스템, 성능 및 서비스 오류
G2/G3, 원호 피팅, 슬라이서 경로 정밀도원호 피팅 권장 사항
TMC 드라이버 통신, 과열, 코일 문제TMC 오류 문제 해결
CAN 네트워크, UUID, bytes_invalidCAN 네트워크 및 ID 검색
가속도계 및 공진 테스트가속도계 테스트 및 보정
EDDY 와전류 프로브EDDY 문제 모음
Load Cell, 압력 센서 프로브Load Cell 프로브 문제 해결
Loading...