MCU 연결 가이드
본 가이드는 MCU가 Klipper와 정상적으로 연결되지 않는 문제를 진단하고 해결하기 위한 것입니다.
준비 사항 및 주의사항
- 권장하지 않는 호스트 장치: Redmi 휴대폰, WiFi 스틱, 셋톱박스 등의 장치는 사용을 피하십시오. 이러한 장치는 일반적으로 맞춤형 또는 수정된 시스템을 사용하여 MCU를 올바르게 인식하지 못할 수 있습니다.
- 슬레이브 장치 수 확인: 사용 중인 슬레이브 장치(예: 툴보드)의 수를 미리 확인하십시오. 여러 개의 슬레이브 장치는 연결에 영향을 줄 수 있습니다.
- 배선 간소화: 메인보드와 툴보드에서 데이터 케이블을 제외한 모든 배선을 임시로 제거하고, 필요한 데이터 연결만 유지하여 간섭을 배제하십시오.
- 권장 인터페이스: Fluidd 인터페이스 사용을 권장합니다. MCU 연결 상태를 보다 직관적으로 표시합니다.
1단계: 설정 백업 및 초기화
1. 호스트 인터페이스 접속
브라우저에 호스트의 IP 주소를 입력하여 접속합니다.
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 브리지 CAN 펌웨어인지 확인하십시오. 본 가이드는 다른 유형에는 적용되지 않습니다.
- 연결 방식: 먼저 SSH 연결을 하십시오. 이 작업은 네트워크를 통해 수행해야 합니다.
작업 단계
-
장치 감지 실행
- SSH 연결에 성공하면 다음 명령을 실행합니다.
lsusb
- 시스템이 인식된 모든 USB 장치를 나열합니다.
- SSH 연결에 성공하면 다음 명령을 실행합니다.
-
명령어 예외 처리
lsusb명령이 없다는 메시지가 표시되면 먼저 설치하십시오.sudo apt-get install usbutils- 실행 후 장치가 전혀 표시되지 않으면 호스트를 교체하는 것이 좋습니다.
-
장치 정보 식별 아래 그림을 참조하여
lsusb출력 결과에서 장치를 식별합니다.Loading...Loading... -
펌웨어 유형 확인
- 플래시한 펌웨어에 따라
lsusb결과에서 다음 중요 정보를 확인하십시오.- USB 펌웨어:
1d50:614e가 표시되어야 합니다. - USB 브리지 CAN 펌웨어:
1d50:606f가 표시되어야 합니다. - USB Katapult 펌웨어:
1d50:6177이 표시되어야 합니다. - RS232 어댑터 (UTOR 사용 또는 D8 및 D8PRO 메인보드 사용 시):
1a86:7523이 표시되어야 합니다. (G2T 사용 시 이 단계는 필요하지 않습니다.)
- USB 펌웨어:
- 플래시한 펌웨어에 따라
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 브리지 CAN 장치 시스템 유형에 따라 해당 명령을 선택하여 CAN ID를 검색합니다.
- 일반 호스트
- Fly_FAST 시스템
~/klippy-env/bin/python ~/klipper/scripts/canbus_query.py can0
python ~/klipper/scripts/canbus_query.py can0
RS232 펌웨어 장치 다음 명령을 실행하여 RS232 장치 경로를 검색합니다.
ls /dev/serial/by-path/*
결과 해석 및 처리
USB ID 검색 결과
명령 실행 후 터미널에 다음과 유사한 장치 ID가 표시됩니다(예시).
- 직접 사용 가능:
usb-필드 뒤에Klipper가 표시됨(예:usb-Klipper_stm32f407xx_...). Klipper 펌웨어가 플래시되었음을 의미합니다. - 펌웨어 플래시 필요:
usb-필드 뒤에katapult가 표시됨(예:usb-katapult_stm32f407xx_...). 현재 Bootloader 상태이며 Klipper 펌웨어를 플래시해야 합니다. - 인식 불가능: 아래 예시 ID에서
usb-필드 뒤에1a86_USB_Serial이 표시됨. 이 장치는 CH340 시리얼 변환 칩으로 Klipper/katapult 펌웨어를 실행하는 MCU가 아니므로 해당 펌웨어를 먼저 플래시해야 합니다.
/dev/serial/by-id/usb-1a86_USB_Serial-if00-port0
- 정상적인 경우는 다음과 같습니다.
CAN ID 검색 결과
명령 실행 후 터미널 반환 결과에 따라 판단하십시오.
- 직접 사용 가능: 표시된 ID 끝의
Application:필드가Klipper로 표시됨. - 펌웨어 플래시 필요: 표시된 ID 끝의
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 장치를 설정할 때 반드시 보드레이트와 재시작 방법을 지정해야 합니다.
[mcu toolboard]
serial: <여기에 조회된 RS232 장치 경로를 입력>
baud: 250000
restart_method: command
4단계: 메인 MCU ID 설정
설정을 시작하기 전에 툴보드와 호스트 또는 메인보드의 연결이 끊어져 있는지 확인하여 장치 인식 충돌을 방지하십시오.
printer.cfg 파일을 다시 열고 [mcu] 섹션에서 serial: /tmp/klipper_host_mcu 설정 줄을 찾습니다.
연결 방식에 따라 아래 해당 방법을 참조하여 설정합니다.
- USB 연결 설정
- CAN 연결 설정
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
serial: /tmp/klipper_host_mcu 설정 항목을 canbus_uuid:로 바꾸고 검색된 CAN ID를 입력합니다.
설정 예시:
# 검색된 CAN ID가 다음과 같은 경우:
# 688e89f0e401
# 설정을 다음과 같이 수정합니다.
[mcu]
canbus_uuid: 688e89f0e401
설정을 저장하고 Klipper 서비스를 재시작합니다.
5단계: 메인 MCU 연결 확인
메인 MCU 설정을 완료한 후 연결이 성공했는지 확인해야 합니다.
- Fluidd 인터페이스를 열고 왼쪽 메뉴에서
System을 클릭합니다. - MCU 정보 확인:
Mcu Information아래에서Micro-Controller정보를 찾습니다. - 메인 컨트롤러 모델 확인: 표시된 모델이 메인보드의 실제 메인 컨트롤러 모델과 일치하는지 확인합니다.
- 메인 컨트롤러가 STM32H723인 경우
Micro-Controller는 반드시 H723 관련 모델로 표시되어야 합니다. - 올바르게 표시되지 않거나 인식할 수 없는 경우 이전 설정 단계를 확인하십시오.
6단계: 툴보드 MCU 추가
메인 MCU가 이미 성공적으로 연결되었고 툴보드, 다중 MCU 또는 보드 간 핀 설정을 추가해야 하는 경우 계속해서 확인하십시오. 툴보드 MCU 추가 및 보드 간 설정.
이상으로 메인 MCU 연결 진단이 완료되었습니다.