본문으로 건너뛰기

설정 클래스 오류

이 페이지에서는 설정 구간 충돌, 매개변수 철자, include 파일 및 SAVE_CONFIG 관련 문제를 정리합니다. 설정을 수정한 후 먼저 klippy.log에서 첫 번째 설정 오류를 확인한 후, 단계별로 처리하세요.

homing override method always homes X and Y before homing Z​

오류 메시지: 안전 Z 홈과 홈 오버라이드 설정이 충돌합니다.

Loading...

오류 원인: [safe_z_home]와 [homing_override]가 동시에 설정되어 Klipper가 어떤 홈 로직을 사용할지 확인할 수 없습니다.

해결 방법:

  1. 설정 파일에서 [safe_z_home]와 [homing_override]를 검색하세요.
  2. 실제 기계 홈 로직에 따라 하나만 남기세요.
  3. 저장 후 Klipper를 재시작하세요.

관련 설정 참고: 홈 및 방향 보정 가이드, 홈 오버라이드 참고 설정.

Option 'xxx' is not valid in section 'yyy'​

오류 메시지: Option 'xxx' is not valid in section 'yyy', 지정된 설정 구간에 인식되지 않는 옵션 이름이 있습니다.

일반적인 원인:

  • 옵션명 철자 오류, 예: sensor_pin을 sensor_ping으로 작성.
  • 다른 설정 구간의 옵션을 현재 구간에 잘못 붙여넣음, 예: [probe]의 옵션을 [stepper_z]에 작성.
  • Klipper 버전 업그레이드 후, 이전 버전에서 지원되던 옵션이 제거되거나 이름이 변경됨.
  • 실제 매개변수가 아닌 주석 내용을 사용, 예: default_parameter_z.

해결 방법:

  1. 오류에서 지적한 설정 구간과 옵션명을 주의 깊게 확인하고 철자를 확인하세요.
  2. Klipper 설정 참조 문서를 참고하여 해당 옵션이 어떤 설정 구간에 속하는지 확인하세요.
  3. 최근 Klipper를 업그레이드했다면 설정 변경 기록을 확인하여 옵션에 변경 사항이 있는지 확인하세요.
  4. 잘못된 옵션을 삭제하거나 올바른 설정 구간으로 이동하세요.

관련 설정 참고: 설정 수정 설명.

Section 'xxx' is not a valid config section​

오류 메시지: Section 'xxx' is not a valid config section, Unknown config object 또는 특정 설정 구간을 Klipper가 인식할 수 없습니다.

일반적인 원인:

  • 설정 구간명 철자 오류, 예: [bed_mesh]를 [bedmesh]로 작성.
  • 현재 Klipper 버전이 해당 설정 구간을 지원하지 않거나, 업데이트/다운그레이드 후 설정 형식이 호환되지 않음.
  • 타사 플러그인 설정을 복사했지만 해당 플러그인, 확장 모듈 또는 Klipper 브랜치가 설치되지 않음.
  • include 파일에 다른 기계나 다른 메인보드의 설정 구간이 남아 있음.

해결 방법:

  1. 오류의 설정 구간명을 기준으로 printer.cfg와 모든 include 파일에서 해당 부분을 찾으세요.
  2. 철자가 Klipper 설정 참조와 일치하는지 확인하고, 설정 구간명에 한글 괄호나 전각 기호를 사용하지 마세요.
  3. 설정이 타사 플러그인이나 맞춤형 매크로 패키지에서 온 경우, 해당 플러그인이 설치되어 있고 현재 Klipper 버전과 호환되는지 확인하세요.
  4. 해당 부분의 용도를 모르겠다면 먼저 주석 처리하고 Klipper를 재시작한 후, 단계별로 복원하세요.

관련 설정 참고: 설정 수정 설명.

Unable to open config file / Include file does not exist​

오류 메시지: Unable to open config file /home/xxx/printer_data/config/printer.cfg 또는 Include file 'xxx.cfg' does not exist.

일반적인 원인:

  • printer.cfg 파일 경로가 잘못되었거나 파일이 실수로 삭제됨.
  • [include]가 참조하는 하위 설정 파일이 존재하지 않거나 파일명이 일치하지 않음.
  • KIAUH 등의 설치 도구가 자동으로 [include] 참조를 생성했지만 해당 cfg 파일이 설치되지 않음.
  • 권한 문제로 Klipper가 설정 파일을 읽을 수 없음.

해결 방법:

  1. printer.cfg가 Klipper 설정 디렉토리(일반적으로 ~/printer_data/config/printer.cfg)에 존재하는지 확인하세요.
  2. 모든 [include xxx.cfg] 줄을 확인하여 참조하는 파일이 실제로 존재하는지 확인하세요.
  3. fluidd.cfg 또는 mainsail.cfg가 없는 경우, 해당 웹 인터페이스의 설치 문서를 참고하여 설정을 추가하세요.
  4. 설정 파일 권한이 올바른지 확인하세요: ls -la ~/printer_data/config/.

Unable to parse option / option must be specified​

오류 메시지: Unable to parse option 'xxx' in section 'yyy', Option 'xxx' in section 'yyy' must be specified, 또는 must have minimum/maximum, must be above/below.

일반적인 원인:

  • 필수 매개변수가 누락됨, 예: [extruder]에 step_pin, dir_pin, heater_pin 또는 sensor_type 누락.
  • 매개변수 형식 오류, 예: 숫자가 필요한 곳에 텍스트를 입력하거나, 좌표 목록에 쉼표 누락.
  • 매개변수 값이 Klipper 허용 범위를 벗어남, 예: run_current, max_temp, position_max 설정이 부적절.
  • 설정을 복사할 때 한글 문장 부호, 전각 기호 또는 보이지 않는 문자가 포함됨.

해결 방법:

  1. 오류의 설정 구간과 매개변수명을 기준으로 해당 .cfg 파일에서 항목별로 확인하세요.
  2. 숫자, 좌표 및 목록 매개변수의 경우 형식이 예시와 일치하는지 확인하세요, 예: mesh_min: 20, 20.
  3. must be above/below 또는 minimum/maximum의 경우, 먼저 공식 예시나 메인보드 튜토리얼 권장값으로 복원하세요.
  4. 저장 후 RESTART를 실행하고, 여전히 실패하면 klippy.log에서 첫 번째 설정 오류를 확인하세요.

관련 설정 참고: 설정 수정 설명.

Unknown pin chip name / pin used multiple times​

오류 메시지: Unknown pin chip name 'xxx', Invalid pin description 'xxx', pin xxx used multiple times in config.

일반적인 원인:

  • 다중 MCU 설정에서 핀 접두사를 잘못 작성, 예: EBBCan:PB0를 존재하지 않는 MCU 이름으로 작성.
  • 핀명 철자 오류 또는 메인보드 튜토리얼의 핀을 다른 메인보드에 그대로 복사.
  • 동일한 물리적 핀이 여러 기능에 중복 사용됨, 예: 팬, 히터, 엔드스톱이 동일한 핀을 사용.
  • 핀 반전 !, 풀업 ^, 풀다운 ~가 잘못된 위치에 작성됨.

해결 방법:

  1. [mcu xxx]의 이름이 핀 접두사와 완전히 일치하는지 확인하세요(대소문자 구분).
  2. 메인보드 핀맵을对照하여 각 pin:, step_pin:, dir_pin:, heater_pin:이 현재 메인보드에 속하는지 확인하세요.
  3. 모든 include 파일에서 오류 핀을 검색하고 중복 항목을 삭제하거나 교체하세요.
  4. 핀 수정자는 핀명 앞에 작성해야 합니다, 예: ^PB7, !PC13, mcu2:^PB7.

관련 설정 참고: 설정 수정 설명, 팬 참고 설정.

gcode command XXX already registered​

오류 메시지: Error: gcode command XXX already registered.

오류 원인: 두 개의 다른 매크로나 시스템 모듈이 동일한 G-code 명령어 이름을 등록했습니다, 예: 두 매크로가 모두 [gcode_macro NEXT]를 정의.

일반적인 상황:

  • 사용자 정의 매크로가 Klipper 시스템 모듈이나 타사 설정과 충돌.
  • 여러 [gcode_macro M600] 정의.

해결 방법:

  1. printer.cfg 및 모든 [include] 파일에서 중복 정의를 검색하세요.
  2. 충돌하는 [gcode_macro]를 삭제하거나 이름을 변경하세요.
  3. [homing_override], [gcode_macro PAUSE], [gcode_macro RESUME], [gcode_macro CANCEL_PRINT] 등 일반적인 매크로를 확인하세요.

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

SAVE_CONFIG 실패 또는 설정 충돌​

오류 메시지: SAVE_CONFIG 실행 후 Unable to write config, Option conflict, Cannot save config 메시지가 표시되거나, 저장 후 프린터가 시작되지 않습니다.

일반적인 원인:

  • printer.cfg 파일 권한이 부족하여 Klipper 프로세스가 쓸 수 없음, 일반적으로 sudo로 설정 파일을 편집한 후 발생.
  • 자동 저장 영역(#*# 표시 블록)의 설정 항목이 수동 [include] 파일의 동일한 옵션과 충돌.
  • MCU가 shutdown 상태여서 SAVE_CONFIG가 새 설정을 정상적으로 전달할 수 없음.
  • printer.cfg 파일 끝에 구문 오류가 있거나 잘려서 자동 저장 영역 쓰기에 실패.
  • 여러 include 파일이 PID, Z offset 등 SAVE_CONFIG가 자동 저장하지 말아야 할 매개변수를 중복 정의.

해결 방법:

  1. 설정 파일 권한을 확인하세요:

    ls -la ~/printer_data/config/printer.cfg

    소유자가 현재 사용자가 아니면 다음을 실행하세요: sudo chown $USER:$USER ~/printer_data/config/printer.cfg

  2. SAVE_CONFIG 후 프린터가 시작되지 않으면 printer.cfg 하단을 열어 #*# 자동 저장 영역을 확인하세요.

  3. 동일한 옵션이 include 파일에도 있으면 자동 저장 영역의 중복 항목을 삭제하거나 include 파일에서 통합 관리하세요.

  4. MCU가 shutdown 상태이면 먼저 FIRMWARE_RESTART를 실행한 후, 다시 SAVE_CONFIG를 실행하세요.

  5. 권한이 정상적이지만 여전히 쓸 수 없으면 디스크 공간을 확인하세요: df -h ~/printer_data/.

관련 설정 참고: 설정 수정 설명.

Loading...