MCU 연결 가이드

적용 안내

본 가이드는 MCU가 Klipper와 정상적으로 연결되지 않는 문제를 진단하고 해결하기 위한 것입니다.

준비 작업 및 주의 사항

• 비추천 상위 장치: 홍미 스마트폰, WiFi 동글, 셋톱박스 등의 장치는 사용을 피하십시오. 이들 장치는 보통 커스터마이징된 시스템을 사용하여 MCU를 제대로 인식하지 못할 수 있습니다.
• 하위 장치 수 확인: 사용하는 하위 장치(예: 툴보드)의 수를 미리 확인하십시오. 여러 개의 하위 장치가 연결되면 연결에 영향을 줄 수 있습니다.
• 배선 단순화: 보드와 툴보드의 데이터선을 제외한 모든 배선을 일시적으로 제거하고 데이터 연결만 남겨 두어 간섭을 제거하십시오.
• 권장 인터페이스: Fluidd 인터페이스 사용을 권장합니다. 이 인터페이스는 MCU 연결 상태를 보다 직관적으로 표시합니다.

첫 번째 단계: 설정 백업 및 초기화

1. 상위 장치 인터페이스 접속

브라우저에서 상위 장치의 IP 주소(예: 192.168.101.179)를 입력하여 접속하십시오.

2. 설정 파일 위치 확인

웹 인터페이스에 접속한 후, 좌측 사이드바에서 설정 옵션을 찾으십시오:

Fluidd 사용자: ...를 클릭한 후 printer.cfg를 찾습니다.

Mainsail 사용자: 기계를 클릭한 후 printer.cfg를 찾습니다.

3. 설정 파일 백업

printer.cfg 파일을 마우스 오른쪽 버튼으로 클릭하고 Duplicate를 선택하여 복사한 후, 복사본을 다음 이름으로 다시 저장하십시오:

printer_Backup.cfg

Fluidd 작업 예시:

Mainsail 작업 예시:

4. 설정 파일 초기화

다시 printer.cfg 파일을 열고 모든 내용을 삭제한 후, 아래의 기본 설정을 붙여넣으십시오:

[mcu]
serial: /tmp/klipper_host_mcu

[printer]
kinematics: none
max_velocity: 200
max_accel: 1000

5. 저장 및 재시작

• 오른쪽 상단의 SAVE & RESTART를 클릭하여 설정을 저장하고 Klipper 서비스를 재시작하십시오.
• 오류가 발생하면 일단 무시하십시오.
• 그 후, 모든 장치(상위 장치와 모든 하위 장치 포함)를 완전히 전원을 끄십시오.
• 중요: 반드시 완전히 전원을 차단해야 후속 단계를 진행할 수 있습니다.

---

두 번째 단계: 장치 감지 및 펌웨어 유형 확인

전제 조건

• 주 장치 순서: 첫 번째 MCU는 반드시 메인보드여야 하며, 툴보드가 와서는 안 됩니다.
• 펌웨어 유형: FLY 메인보드의 펌웨어가 USB 펌웨어 또는 USB 브리지 CAN 펌웨어인지 확인하십시오. 본 가이드는 다른 유형에는 적용되지 않습니다.
• 연결 방식: 먼저 SSH 연결을 수행해야 하며, 이 작업은 네트워크를 통해 이루어져야 합니다.

작업 절차

1. 장치 감지 실행

   • SSH 연결이 성공하면 다음 명령을 실행하십시오:

     lsusb

   • 시스템이 인식된 모든 USB 장치 목록을 출력합니다.

2. 명령 이상 처리

   • lsusb 명령이 없다는 메시지가 표시되면 먼저 설치하십시오:

     sudo apt-get install usbutils

   • 실행 후 장치가 전혀 표시되지 않으면 다른 상위 장치를 사용하는 것이 좋습니다.

3. 장치 정보 식별 아래 이미지를 참고하여 lsusb의 출력 결과에서 장치를 식별하십시오:

   
   

4. 펌웨어 유형 확인 -刷入한 펌웨어에 따라 lsusb 결과에서 다음 핵심 정보를 확인하십시오:

   • USB 펌웨어: 1d50:614e로 표시되어야 함
   • USB 브리지 CAN 펌웨어: 1d50:606f로 표시되어야 함
   • USB Katapult 펌웨어: 1d50:6177로 표시되어야 함
   • RS232 어댑터(UTOR 또는 D8/D8PRO 메인보드 사용 시): 1a86:7523으로 표시되어야 함 (G2T 사용 시에는 해당 단계 불필요)

---

세 번째 단계: 장치 ID 검색

중요 안내

• USB ID 검색: USB 펌웨어에만 적용되며, CAN 또는 RS232에는 사용할 수 없습니다.
• CAN ID 검색: CAN 버스 장치에만 적용되며, USB 또는 RS232에는 사용할 수 없습니다.
• RS232 ID 검색: RS232 펌웨어에만 적용되며, USB 또는 CAN에는 사용할 수 없습니다.
• RS232 전용성: RS232 펌웨어는 일반적으로 툴보드에만 사용되며, 주 MCU에는 사용되지 않습니다.

펌웨어 유형에 따라 방법 선택

USB 펌웨어 장치 USB 장치 ID를 검색하기 위해 다음 명령을 실행하십시오:

ls /dev/serial/by-id/*

USB 브리지 CAN 장치 시스템 유형에 따라 다음 명령 중 하나를 선택하여 CAN ID를 검색하십시오:

Fly_Armbian 또는 일반 상위 장치

~/klippy-env/bin/python ~/klipper/scripts/canbus_query.py can0

Fly_FAST 시스템

python ~/klipper/scripts/canbus_query.py can0

RS232 펌웨어 장치 RS232 장치 경로를 검색하기 위해 다음 명령을 실행하십시오:

ls /dev/serial/by-path/*

결과 해석 및 처리

USB ID 검색 결과

명령 실행 후, 터미널에 아래와 유사한 장치 ID(예시)가 표시됩니다:

• ✅ 즉시 사용 가능: usb- 필드 뒤에 Klipper라고 표시된 경우
• ⚠️ 펌웨어 재刷 필요: usb- 필드 뒤에 katapult라고 표시된 경우

CAN ID 검색 결과

명령 실행 후, 실제 상황에 따라 판단하십시오:

• ✅ 즉시 사용 가능: Application: 필드 끝에 Klipper라고 표시된 경우
• ⚠️ 펌웨어 재刷 필요: Application: 필드 끝에 CANBOOT 또는 Katapult라고 표시된 경우
• ❌ 장치를 찾을 수 없음: Total 0 uuids found라고 표시된 경우, 가능한 원인은 다음과 같습니다:
  • CAN 네트워크 설정 오류
  • CAN 속도 불일치(상위 장치, 메인보드, 툴보드의 속도가 동일해야 함)
  • 해당 ID가 이미 사용 중(설정에서 차단한 후 전원을 끄고 재시작해야 함)

RS232 ID 검색 결과

명령 실행 후, 터미널에 RS232 장치 경로(예시)가 표시됩니다:

• /dev/serial/by-path/platform-3f980000.usb-usb-0:1.2:1.0-port0

RS232 설정 특수 요구사항

RS232 장치는 설정 시 반드시 보드레이트와 재시작 방법을 지정해야 합니다:

[mcu toolboard]
serial: <여기에 검색된 RS232 장치 경로 입력>
baud: 250000
restart_method: command

---

네 번째 단계: 주 MCU ID 설정

준비 사항

설정을 시작하기 전에 툴보드와 상위 장치 또는 메인보드의 연결이 끊어져 있어야 하며, 장치 인식 충돌을 방지해야 합니다.

다시 printer.cfg 파일을 열고, [mcu] 섹션의 serial: /tmp/klipper_host_mcu 설정 줄을 찾습니다.

연결 방식에 따라 아래에 해당하는 방법을 참고하여 설정하십시오:

USB 연결 설정

serial: 뒤의 /tmp/klipper_host_mcu를 검색된 USB ID로 대체하십시오.

설정 예시:

# 검색된 USB ID:
# /dev/serial/by-id/usb-Klipper_stm32h723xx_12345-if00

# 설정 변경:
[mcu]
serial: /dev/serial/by-id/usb-Klipper_stm32h723xx_12345-if00

CAN 연결 설정

serial: /tmp/klipper_host_mcu 설정을 canbus_uuid:로 대체하고 검색된 CAN ID를 입력하십시오.

설정 예시:

# 검색된 CAN ID:
# 688e89f0e401

# 설정 변경:
[mcu]
canbus_uuid: 688e89f0e401

설정을 저장하고 Klipper 서비스를 재시작하십시오.

---

다섯 번째 단계: 주 MCU 연결 검증

주 MCU 설정이 완료되면 연결 성공 여부를 검증해야 합니다:

1. Fluidd 인터페이스를 열고, 좌측 메뉴에서 System을 클릭하십시오.
2. MCU 정보 확인: Mcu Information 아래에서 Micro-Controller 정보를 찾으십시오.
3. 마이크로컨트롤러 모델 확인: 표시된 모델이 실제 메인보드의 마이크로컨트롤러 모델과 일치하는지 확인하십시오.

검증 핵심 사항

• 주 제어기가 STM32H723이라면 Micro-Controller는 반드시 H723 관련 모델로 표시되어야 합니다.
• 표시가 올바르지 않거나 인식되지 않으면 앞의 설정 단계를 확인하십시오.

---

여섯 번째 단계: 툴보드 MCU 추가

주 MCU 연결 검증이 성공하면 툴보드를 추가할 수 있습니다:

1. 툴보드 다시 연결: 툴보드의 데이터선을 다시 상위 장치 또는 메인보드에 연결하십시오.
2. 설정 파일 편집: printer.cfg 파일 맨 아래에 툴보드 설정을 추가하십시오.
3. 툴보드 ID 설정: 툴보드의 펌웨어 유형에 따라 추가된 설정 섹션에 해당 ID를 입력하십시오.

MCU 이름 설명

설정의 mcu1, mcu2 등은 단순히 다른 장치를 구분하기 위한 임시 이름입니다. 설정 파일 내에서 고유한 이름이라면 사용자가 자유롭게 지정할 수 있습니다.

설정 형식:

[mcu mcu1]
# 툴보드 ID 설정을 여기에 추가

설정 예시:

USB 툴보드

[mcu mcu1]
serial: /dev/serial/by-id/usb-Klipper_stm32f446xx_54321-if00

CAN 툴보드

[mcu mcu1]
canbus_uuid: 688e89f0e402

RS232 툴보드

[mcu mcu1]
serial: /dev/serial/by-path/platform-3f980000.usb-usb-0:1.2:1.0-port0
baud: 250000
restart_method: command

주의 사항:

• 각 MCU는 유일한 ID를 가져야 하며, 툴보드 ID는 주 MCU 및 다른 장치와 중복되지 않아야 합니다.
• MCU 이름은 자유롭게 지정할 수 있습니다(예: toolboard, extruder_mcu 등). 단, 설정 파일 내에서 고유해야 합니다.
• 반드시 앞 단계에서 검증된 유효한 툴보드 ID를 사용하십시오.
• RS232 장치는 반드시 baud: 250000 및 restart_method: command 매개변수를 설정해야 합니다.
• 여러 개의 툴보드를 설정할 경우, 구분을 위해 각 장치에 서로 다른 이름을 지정하십시오.

설정 완료 후, Klipper 서비스를 저장하고 재시작하십시오.

---

일곱 번째 단계: 모든 MCU 연결 검증

툴보드를 추가하고 Klipper를 재시작한 후, 모든 MCU의 연결 상태를 다시 검증해야 합니다:

1. Fluidd 인터페이스를 열고, 좌측 메뉴에서 System을 클릭하십시오.
2. MCU 정보 확인: Mcu Information 아래에서 모든 MCU가 정확히 인식되었는지 확인하십시오.
3. 각 MCU 상태 확인: 주 MCU와 툴보드가 모두 연결 상태로 표시되어야 합니다.

검증 핵심 사항

• 주 MCU와 모든 툴보드가 목록에 표시되어야 합니다.
• 각 MCU의 연결 상태는 "연결됨"이어야 합니다.
• 특정 MCU가 표시되지 않거나 연결에 실패하면 설정과 물리적 연결을 확인하십시오.

---

여덟 번째 단계: 펌웨어 버전 확인

모든 MCU 연결이 완료되면 펌웨어 버전 호환성을 검증해야 합니다:

1. Fluidd 인터페이스를 열고, 좌측 메뉴에서 System을 클릭하십시오.
2. 버전 정보 확인: Mcu Information 아래에서 Version 필드를 찾으십시오.
3. 버전 일치 확인: 모든 MCU의 펌웨어 버전이 상위 장치의 Klipper 버전과 일치해야 합니다.

버전 호환성 안내

• 커스터마이징된 컴파일 펌웨어: 사전 설정된 커스터마이징 장치를 제외하고, 모든 직접 컴파일된 펌웨어는 상위 장치의 Klipper 버전과 일치해야 합니다.
• Fly-FAST 시스템: FAST 시스템의 펌웨어 버전은 시스템 버전과 일치하며, 컴파일된 Klipper 펌웨어도 시스템 버전과 일치합니다.
• 버전 불일치의 결과: 다른 버전의 펌웨어는 기능 오류, 통신 실패 또는 시스템 불안정을 초래할 수 있습니다.

검증 핵심 사항:

• 주 MCU와 모든 툴보드의 Version 정보는 표시되어야 하며, 버전이 일치해야 합니다.
• 버전이 일치하지 않으면 해당 펌웨어를 다시刷해야 합니다.

---

아홉 번째 단계: 설정 파일 복구 및 업데이트

모든 MCU 연결이 정상임을 확인한 후, 원래의 설정 파일을 복구하고 MCU 설정을 업데이트해야 합니다:

1. 현재 설정 파일 삭제

   • 설정 파일 관리 인터페이스에서 현재 printer.cfg 파일을 찾아 삭제하십시오.

2. 백업 설정 복구

   • 이전에 백업한 printer_Backup.cfg 파일의 이름을 printer.cfg로 다시 변경하십시오.

3. MCU 설정 업데이트

   • 복구된 printer.cfg 파일을 열고
   • 기존의 [mcu] 설정 섹션을 찾아 앞 단계에서 검색한 ID로 업데이트하십시오:

   USB 연결 설정:

   [mcu]
   serial: /dev/serial/by-id/usb-Klipper_stm32h723xx_12345-if00
   # 실제 검색된 주 MCU USB ID로 대체

   CAN 연결 설정:

   [mcu]
   canbus_uuid: 688e89f0e401
   # 실제 검색된 주 MCU CAN UUID로 대체

4. 툴보드 설정 업데이트(해당 시)

   • 설정 파일에서 툴보드에 해당하는 [mcu] 섹션을 찾아
   • 연결 방식에 따라 실제 검색된 툴보드 ID로 업데이트하십시오:

   USB 툴보드:

   [mcu toolboard]
   serial: /dev/serial/by-id/usb-Klipper_stm32f446xx_54321-if00

   CAN 툴보드:

   [mcu toolboard]
   canbus_uuid: 688e89f0e402

   RS232 툴보드:

   [mcu toolboard]
   serial: /dev/serial/by-path/platform-3f980000.usb-usb-0:1.2:1.0-port0
   baud: 250000
   restart_method: command

5. 저장 및 재시작

   • 모든 MCU 설정 업데이트 후, SAVE & RESTART를 클릭하여 설정을 저장하고 Klipper를 재시작하십시오.
   • 다시 System 페이지로 들어가 모든 MCU 연결 상태가 정상인지 확인하십시오.

중요 안내

• 이번 연결 테스트에서 실제로 검색된 올바른 ID를 반드시 사용하십시오.
• 여러 개의 툴보드를 설정할 경우, 각각의 [mcu] 섹션 ID를 하나씩 업데이트하십시오.
• RS232 툴보드는 반드시 baud: 250000 및 restart_method: command 매개변수를 포함해야 합니다.
• 설정 복구 후, 기존의 프린터 설정(예: 스테퍼 모터, 엔드스탑 등)은 변경되지 않습니다.

이로써 MCU 연결 오류 진단 및 설정 복구가 모두 완료되었습니다.