MCU 연결 가이드

적용 범위

이 가이드는 MCU가 Klipper와 정상적으로 연결되지 않는 문제를 진단하고 해결하는 데 사용됩니다.

준비 작업 및 주의 사항

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

단계 1: 설정 백업 및 초기화

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

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

2. 설정 파일 찾기

WEB 인터페이스에 진입한 후 좌측 사이드바에서 설정 옵션을 찾습니다:

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가 설정을 저장하고 서비스를 재시작합니다.
• 오류가 발생하면 잠시 무시하십시오.
• 그 후, 상위 장치와 모든 하위 장치를 완전히 전원을 끄십시오.
• 중요 : 후속 단계를 진행하기 위해서는 전원이 완전히 차단되어야 합니다.

---

단계 2: 장치 검출 및 펌웨어 종류 확인

전제 조건

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

작업 절차

1. 장치 검출 실행

   • SSH 연결이 성공하면 다음 명령을 실행합니다:

     lsusb

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

2. 명령 오류 처리

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

     sudo apt-get install usbutils

   • 실행 후 아무 장치도 표시되지 않으면 상위 장치를 교체하는 것이 좋습니다.

3. 장치 정보 식별 아래 그림을 참고하여 lsusb 출력 결과에서 장치를 식별하십시오:

   
   

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

   • USB 펌웨어 : 1d50:614e로 표시되어야 함
   • USB Bridge CAN 펌웨어 : 1d50:606f로 표시되어야 함
   • USB Katapult 펌웨어 : 1d50:6177로 표시되어야 함
   • RS232 어댑터 (UTOR 또는 D8/D8PRO 메인보드 사용 시): 1a86:7523로 표시되어야 함 (G2T 사용 시 이 단계는 필요 없음)

---

단계 3: 장치 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 Bridge 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

---

단계 4: 주 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 서비스를 재시작하십시오.

---

단계 5: 주 MCU 연결 확인

주 MCU 설정이 완료된 후 연결이 성공했는지 확인합니다:

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

확인 포인트

• 마이크로컨트롤러가 STM32H723이면 Micro-Controller에 반드시 H723 관련 모델이 표시되어야 함
• 표시가 잘못되었거나 인식되지 않으면 앞의 설정 단계를 확인하십시오

---

단계 6: 툴보드 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 서비스를 저장하고 재시작하십시오.

---

단계 7: 모든 MCU 연결 확인

툴보드를 추가하고 Klipper를 재시작한 후 모든 MCU의 연결 상태를 다시 확인합니다:

1. Fluidd 인터페이스 열기, 좌측 메뉴에서 System 클릭
2. MCU 정보 확인: Mcu Information 아래 모든 MCU가 정확히 인식되었는지 확인
3. 각 MCU 상태 확인: 주 MCU와 툴보드가 모두 연결 상태인지 확인

확인 포인트

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

---

단계 8: 펌웨어 버전 확인

모든 MCU 연결이 완료된 후 펌웨어 버전 호환성을 확인합니다:

1. Fluidd 인터페이스 열기, 좌측 메뉴에서 System 클릭
2. 버전 정보 확인: Mcu Information 아래 Version 필드 찾기
3. 버전 일치 확인: 모든 MCU 펌웨어 버전이 상위 장치 Klipper 버전과 일치하는지 확인

버전 호환성 설명

• 사용자 정의 컴파일 펌웨어 : 사전 설정된 커스텀 장치를 제외하고, 모든 사용자 정의 컴파일 펌웨어는 상위 장치 Klipper 버전과 일치해야 함
• Fly-FAST 시스템 : FAST 시스템의 펌웨어 버전은 시스템 버전과 일치하며, 컴파일된 Klipper 펌웨어도 시스템 버전과 일치함
• 버전 불일치 시 문제 : 서로 다른 버전의 펌웨어는 기능 오류, 통신 실패 또는 시스템 불안정을 유발할 수 있음

확인 포인트:

• 주 MCU와 모든 툴보드의 Version 정보가 표시되고 버전이 일치해야 함
• 버전이 일치하지 않으면 해당 펌웨어를 다시 플래시해야 함

---

단계 9: 설정 파일 복원 및 업데이트

모든 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 연결 오류 진단 및 설정 복원 작업이 모두 완료되었습니다.