일반적인 디버그 명령어

팁

본 튜토리얼은 Fluidd 웹 인터페이스를 주요 작업 환경으로 사용합니다.
본 튜토리얼은 프린터 연결 성공 후 디버깅 시나리오에 적용됩니다.
본 문서는 일반적인 명령어만 제공하며, 다양한 이유로 모든 사용 가능한 명령어가 완전히 나열되지 않았을 수 있습니다.

드라이버 관련

주의

설정되지 않았거나 고장난 드라이버는 감지할 수 없습니다.
모든 드라이버에 정상적으로 전원이 공급되고, 메인보드에 정상적으로 전원이 공급되며, 드라이버 점퍼 및 설정이 올바른지 확인하십시오.

드라이버 상태 확인

이 명령어는 SPI/UART 모드에서 TMC 드라이버의 통신 상태를 확인하는 데 사용됩니다. 콘솔에서 실행:
```
DUMP_TMC STEPPER=stepper_x
DUMP_TMC STEPPER=stepper_y
DUMP_TMC STEPPER=stepper_z
DUMP_TMC STEPPER=extruder
```

팁

동일 축에 여러 모터가 있는 경우(예: stepper_x1, stepper_z1 등) 실제 설정 이름으로 바꾸십시오.

강제 드라이버 이동

먼저 printer.cfg에 다음 설정을 추가하십시오:
```
[force_move]
enable_force_move: true
```

그런 다음 콘솔에서 STEPPER_BUZZ 명령어를 실행하면 모터가 1mm 앞뒤로 왕복 운동합니다:

STEPPER_BUZZ STEPPER=stepper_x
STEPPER_BUZZ STEPPER=stepper_y
STEPPER_BUZZ STEPPER=stepper_z
STEPPER_BUZZ STEPPER=extruder

force_move를 활성화하면 웹 제어판을 통해서도 강제 이동할 수 있습니다.
한 번에 하나의 모터만 이동할 수 있습니다.
다축 상황(예: 듀얼 Z축)에서는 먼저 귀환(Home)을 수행한 후 제어하십시오.

강제 프린트 헤드 위치 설정

콘솔에 다음 명령어를 입력하면 프린트 헤드 위치를 강제로 설정할 수 있으며, 설정 후 바로 이동을 제어할 수 있습니다:
```
SET_KINEMATIC_POSITION x=100 y=100 z=100
```

압출기 스텝 값 보정

보정 전 확인 사항:
1. 압출기 드라이버가 정상 작동하는지 확인하십시오.
2. full_steps_per_rotation과 gear_ratio가 올바르게 설정되었는지 확인하십시오.

참고 설정:

full_steps_per_rotation: 200        # 회전당 스텝 수 (1.8도=200, 0.9도=400)
gear_ratio: 50:10                   # 기어비 (BMG는 50:17, 출력축이 앞, 입력축이 뒤)
rotation_distance: 22.522           # 구동 기어 둘레, 단위 mm

보정 공식:

새 rotation_distance = 이전 rotation_distance × 실제 압출 길이 / 설정 압출 길이

새 rotation_distance를 구한 후 소수점 3자리까지 유지하십시오.

가열 관련

PID 보정

팁

TARGET= 뒤에 설정하는 목표 온도는 정상 인쇄 시 사용하는 온도여야 합니다.
여러 가열 장치가 있는 경우 HEATER= 뒤의 값을 실제 이름으로 바꾸십시오.

압출 헤드:

PID_CALIBRATE HEATER=extruder TARGET=245

히트 베드:

PID_CALIBRATE HEATER=heater_bed TARGET=100

PTC:
```
PID_CALIBRATE HEATER=PTC TARGET=70
```

온도 오류 관련

팁

가열 대기 시간 초과 문제는 M109 최적화를 참조하십시오.
온도 변동으로 인한 오류는 verify_heater 최적화를 참조하십시오.

온도 제어 명령어

압출 헤드 온도 설정 및 목표 도달 대기:

M109 S245          # 압출 헤드를 245°C로 가열하고 대기
M104 S245          # 압출 헤드를 245°C로 가열 (대기 없음)

히트 베드 온도 설정 및 목표 도달 대기:

M190 S100          # 히트 베드를 100°C로 가열하고 대기
M140 S100          # 히트 베드를 100°C로 가열 (대기 없음)

모든 히터 끄기:
```
TURN_OFF_HEATERS
```

팬 제어:

M106 S255          # 모델 팬 최대 속도
M106 S128          # 모델 팬 50% 속도
M107               # 모델 팬 끄기

엔드스톱 관련

표준 리미트 스위치

위험

리미트 스위치가 2선식인지 확인하십시오. 3선식인 경우 반드시 선 배열 순서가 올바른지 확인해야 하며, 그렇지 않으면 메인보드가 손상될 수 있습니다!

리미트 상태 조회:
```
QUERY_ENDSTOPS
```
리미트가 상시 개방(미트리거) 상태인지 확인하고, 실행 후 다음과 유사한 정보가 반환되어야 합니다:

손으로 리미트 스위치를 누른 후 QUERY_ENDSTOPS를 다시 실행하면 리미트 상태가 변경되어야 합니다:

리미트 상태가 변경되면 배선이 올바르다는 것을 의미합니다.

센서리스 귀환

센서리스 귀환 기본 상태는 open(미트리거)이어야 합니다. 그렇지 않으면 설정 또는 배선에 문제가 있음을 나타냅니다.
조회 방법은 표준 리미트와 동일합니다:
```
QUERY_ENDSTOPS
```

프로브 관련

BL-TOUCH

디버그 명령어:

명령어 기능
BLTOUCH_DEBUG COMMAND=pin_down 프로브 전개
BLTOUCH_DEBUG COMMAND=pin_up 프로브 수납
BLTOUCH_DEBUG COMMAND=touch_mode 접촉 확인 모드 진입

명령어	기능
`BLTOUCH_DEBUG COMMAND=pin_down`	프로브 전개
`BLTOUCH_DEBUG COMMAND=pin_up`	프로브 수납
`BLTOUCH_DEBUG COMMAND=touch_mode`	접촉 확인 모드 진입

Probe & TAP

프로브 상태 조회 (정상 미트리거 시 open 표시):
```
QUERY_PROBE
```
핀 구성 시 내부 풀업 ^을 추가하는 것을 권장합니다.

프로브 반복성 테스트

기본 10회 샘플링:
```
PROBE_ACCURACY
```
100회 샘플링 (더 정확):
```
PROBE_ACCURACY samples=100
```

Z축 오프셋 보정

PROBE_CALIBRATE                          # 프로브 Z 오프셋 보정
TESTZ Z=-0.1                             # Z 오프셋 미세 조정 (음수 = 노즐이 베드에 가까워짐)
ACCEPT                                   # 현재 오프셋 값 수락
ABORT                                    # 이 보정 포기
SAVE_CONFIG                              # 보정 결과를 설정 파일에 저장

고급 명령어: 압출, 모션 제어, 메쉬 베드, 공명 보상, 시스템 제어 및 특수 유형 모듈의 디버그 명령어는 고급 명령어 및 시스템 작동을 참조하십시오.

드라이버 관련​

드라이버 상태 확인​

강제 드라이버 이동​

강제 프린트 헤드 위치 설정​

압출기 스텝 값 보정​

가열 관련​

PID 보정​

온도 오류 관련​

온도 제어 명령어​

엔드스톱 관련​

표준 리미트 스위치​

센서리스 귀환​

프로브 관련​

BL-TOUCH​

Probe & TAP​

프로브 반복성 테스트​

Z축 오프셋 보정​