중요 안내

주의사항

본 튜토리얼은 툴보드의 배선 및 ID 검색에 대해 다루며, 관련 단계는 메인보드에는 적용되지 않으니 주의하시기 바랍니다.
툴보드를 사용하지 않으시는 경우, 본 튜토리얼은 무시하셔도 됩니다.

툴보드 ID 읽기 및 확인

USB ID 획득
CANBus UUID 획득
RS232 사용 방법

USB 연결 방법

지원 장치

장치 유형	연결 방식	요구사항 / 전제 조건
툴보드	D8-Pro 메인보드의 USB-A 포트에 연결	USB 통신 펌웨어 플래시 필요
확장 메인보드	D8-Pro 메인보드의 USB-A 포트에 연결	USB 통신 펌웨어 플래시 필요
USB 카메라	D8-Pro 메인보드의 USB-A 포트에 연결	드라이버 없이 플러그 앤 플레이 가능한 제품
USB 드라이브	D8-Pro 메인보드의 USB-A 포트에 연결	FAT32 파일 시스템으로 포맷 권장

주의사항

중요 전제

도구 보드 ID 검색을 시작하기 전에 반드시 다음 모든 조건을 충족하는지 확인하세요:

펌웨어 준비: 도구 보드에 USB 펌웨어가 플래시되었거나 USB 플래시 모드에 있어야 합니다.
목표 명확: 본 튜토리얼은 도구 보드의 ID 검색에만 사용되며, 메인보드 ID에는 적용되지 않습니다.
하드웨어 연결: 도구 보드가 USB를 통해 상위 기기의 USB-A 포트에 올바르게 연결되어 있어야 합니다.
로그인 방식: 네트워크 SSH를 통해 상위 기기에 로그인하여 작업하세요. 직렬 포트(시리얼) 로그인은 사용하지 마십시오.

USB ID 검색

ls /dev/serial/by-id/*

정상적인 경우: 터미널에 아래와 유사한 ID가 표시됩니다(아래 그림은 예시일 뿐).
Loading...

아래 명령어 입력 후 ID가 나타나지 않지만 lsusb에 장치가 표시된다면, 상위 기기나 상위 기기 시스템을 교체해 보세요.

주의사항

여러 개의 ID가 나타나는 경우, 메인보드 MCU 모델에 해당하는 ID를 선택하세요.

USB ID를 설정 파일에 입력하기

fluidd의 경우: {…} 를 클릭하면 printer.cfg 파일을 찾을 수 있습니다.

mainsail의 경우: 기계를 클릭하면 printer.cfg 파일을 찾을 수 있습니다.

위험

참고: 문서에 나오는 모든 ID는 예시일 뿐이며, 실제 각 메인보드의 ID는 다릅니다. 실제로 얻은 ID를 바탕으로 수정하여 입력하세요.

도구 보드 USB ID 입력

아래는 참조 설정입니다.
주의사항
- 아래 설정의 toolboard는 도구 보드 이름을 의미합니다. 다른 이름이라면 해당 이름으로 바꾸세요.
위험
[mcu toolboard] serial: <여기에 방금 조회한 ID로 교체하세요>
- 도구 보드의 ID를 추가할 때는 반드시 [mcu toolboard]에 serial:과 검색한 도구 보드 ID를 추가해야 합니다.
- 아래는 참조 설정입니다.
- 본 튜토리얼은 도구 보드 ID 검색 및 설정을 위한 것이며, 일반적으로 메인보드에 정상적으로 연결된 상태여야 합니다.
- 또한 메인보드는 반드시 [mcu]이고, 도구 보드는 [mcu toolboard]입니다.
fluidd 참조

Loading...
mainsail 참조

Loading...
- 오른쪽 상단의 SAVE & RESTART를 클릭하면 자동으로 저장되고 Klipper가 재시작됩니다.

CAN 참조 배선

종단 저항 설정 확인:

장치	설정 방법	목표 상태
메인보드	`120Ω` 표시가 있는 점퍼 핀 또는 DIP 스위치 찾기	점퍼 캡 연결 또는 `ON`으로 전환
툴보드	`120Ω` 표시가 있는 점퍼 핀 또는 DIP 스위치 찾기	점퍼 캡 연결 또는 `ON`으로 전환

목적: 이 저항은 CAN 버스 신호 안정성과 통신 오류 방지를 위한 핵심 요소입니다.

CAN 툴 보드 설정 완전 가이드

사전 준비

중요 전제 조건

툴 보드 상태: 툴 보드에 Klipper-can 펌웨어가 플래시되었거나 Katapult-can 모드에 있는지 확인하세요.
주의사항: 본 튜토리얼은 툴 보드 ID 검색에만 사용되며, 메인 보드 ID 검색에는 적용되지 않습니다.
연결 요구사항: 툴 보드는 다음 장치 중 하나에 연결되어야 합니다:
- UTOC 모듈
- USB 브리지 CAN 펌웨어가 플래시된 메인 보드
최종 연결: 위 장치는 호스트 컴퓨터에 연결되어야 합니다.

CAN 네트워크 구성 요구사항

기본 구성: 본 튜토리얼은 호스트 컴퓨터의 CAN 네트워크가 이미 구성되어 있다고 가정합니다.
Fly 사용자: Fly 호스트 컴퓨터를 사용하고 Fly-FAST 시스템을 실행 중이라면, CAN은 기본적으로 구성되어 있습니다(속도 1Mbps).
첫 사용자: 반드시 아래 튜토리얼을 먼저 읽어주세요: CAN 구성 튜토리얼

SSH 연결

네트워크를 통해 SSH에 로그인하세요(직렬 포트 로그인은 사용하지 마세요).
호스트 컴퓨터와 CAN 네트워크 장치가 정상적으로 연결되어 있는지 확인하세요.

CAN ID 검색

일반 호스트 컴퓨터 검색 명령어

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

FLY 호스트 컴퓨터 검색 명령어

python3 ~/klipper/scripts/canbus_query.py can0

검색 결과 설명

CANID

주의사항: 메인 보드 ID는 이전 문서에서 Klipper에 이미 구성되어 있으며, 정상적인 경우 메인 보드의 CANID를 검색할 수 없습니다.
빠른 확인 방법: 확인이 필요한 경우, 먼저 메인 보드와 툴 보드 사이의 CAN 연결 케이블을 분리한 후, 검색을 다시 실행하세요.

검색 명령어 실행 후, 다음과 같은 상황이 발생할 수 있습니다:

결과 표시	상태 설명	후속 작업
`Application: Klipper`	장치에 Klipper 펌웨어가 플래시됨	해당 ID를 직접 사용 가능
`Application: CANBOOT` 또는 `Katapult`	장치가 Bootloader 모드에 있음	Klipper 펌웨어를 플래시한 후 사용 가능
`Total 0 uuids found`	어떤 장치도 찾지 못함	다음 문제를 확인하세요: 1. CAN 네트워크 구성이 올바른지 2. CAN 속도가 일치하는지(기본 1Mbps) 3. 해당 ID가 이미 구성 파일에서 사용 중인지(먼저 주석 처리한 후 저장하고 전원을 끄고 재시작)

중복 ID에 관하여

장치 ID가 printer.cfg에 이미 구성되어 있다면, 검색 결과에 표시되지 않습니다. 다시 검색하려면:

구성 파일에서 해당 장치 ID를 주석 처리하세요.
구성을 저장하고 Klipper를 재시작하세요.
모든 장치의 전원을 끄고 다시 켜세요.

CAN 장치 ID 구성

1. 구성 파일 가져오기

사용하는 웹 인터페이스에 따라 printer.cfg 구성 파일을 찾으세요:

Fluidd
왼쪽 탐색 바의 {...} 아이콘을 클릭하고, printer.cfg를 찾으세요.

Mainsail
상단 탐색 바의 기계를 클릭하고, printer.cfg를 찾으세요.

2. 장치 구성 추가

printer.cfg에 툴 보드 구성을 추가하세요:

[mcu toolboard]
canbus_uuid: <여기에 검색된 ID를 입력하세요>

구성 설명

toolboard는 툴 보드 이름이며, 실제 상황에 따라 수정하세요.
메인 보드 ID인 경우, 구성 섹션은 [mcu]여야 합니다.
정상 구성에서는 메인 보드는 [mcu]를, 툴 보드는 [mcu toolboard]를 사용합니다.

3. 저장 및 재시작

오른쪽 상단의 SAVE & RESTART 버튼을 클릭하세요.
시스템이 자동으로 구성을 저장하고 Klipper를 재시작합니다.

주의

문서에 나타나는 모든 ID는 예시이며, 실제 각 메인 보드의 ID는 다릅니다. 실제로 획득한 ID에 따라 수정하여 입력하세요.

RS232 참조 배선

툴 보드의 RS232 ID 검색

주의사항

중요 준비 사항

펌웨어 요구사항:
툴 보드에 반드시 RS232 펌웨어를 플래시해야 합니다, 그렇지 않으면 통신이 불가능합니다.
강제 접지 공유:
⚠️ 툴 보드를 연결하기 전에, 반드시 툴 보드와 메인 보드의 GND를 연결해야 합니다(동일한 24V/12V 전원을 공유하면 됩니다).

RS232 주의사항

D8, D8PRO 및 C8P가 RS232 인터페이스를 지원하는 것 외에 다른 메인 보드는 RS232 인터페이스를 지원하지 않습니다.
지원되지 않는 메인 보드는 G2T 또는 UTOR를 사용하여 연결해야 합니다.

RS232 ID 검색

브라우저를 열고 주소 표시줄에 상위 컴퓨터의 IP 주소를 입력합니다. 예를 들어, 상위 컴퓨터 IP가 192.168.101.179인 경우 직접 입력하고 엔터를 누릅니다.

상위 컴퓨터의 WEB 인터페이스를 열고 왼쪽 사이드바의 구성 옵션에서 다음을 찾습니다:

fluidd의 경우: {…} , 클릭하여 들어가면 printer.cfg를 찾을 수 있습니다.

mainsail의 경우: 기계, 클릭하여 들어가면 printer.cfg를 찾을 수 있습니다.

printer.cfg를 클릭하여 들어간 후, 오른쪽 상단의 DEVICES를 클릭합니다.

SERIAL을 클릭한 후 새로고침합니다.

fluidd 새로고침

mainsail 새로고침

ID를 복사합니다. 화살표가 가리키는 부분을 클릭하면 복사할 수 있습니다.

fluidd의 경우 ch341-uart가 존재하는지 확인한 후 Path_by_hardware를 클릭합니다. 이것이 RS232_ID입니다.

mainsail의 경우 CH341-UART가 존재하는지 확인한 후 Path_by_hardware를 클릭합니다. 이것이 RS232_ID입니다.

주의사항

UTOR를 사용하여 툴 보드를 연결할 때 일반적으로 두 개의 RS232_ID가 나타납니다. 하나씩 시도해 보세요.

툴 보드 RS232 ID 입력

아래는 참조 구성입니다.
주의사항
- 아래 구성의 toolboard는 툴 보드 이름을 의미합니다. 다른 이름인 경우 해당 이름으로 바꾸세요.
위험
[mcu toolboard] serial: <여기에 방금 조회한 ID로 교체하세요> baud: 250000 restart_method: command
- 툴 보드의 ID를 추가할 때는 반드시 [mcu toolboard]에 serial:을 더하고 검색한 툴 보드의 ID를 추가해야 합니다.
- 아래는 참조 구성입니다.
- 본 튜토리얼은 툴 보드 ID 검색 및 구성을 위한 것입니다. 정상적인 경우 이미 메인 보드에 정상적으로 연결되어 있어야 합니다.
- 메인 보드는 반드시 [mcu]이고, 툴 보드는 [mcu toolboard]입니다.
- 오른쪽 상단의 SAVE & RESTART을 클릭하면 자동으로 저장되고 klipper가 재시작됩니다.

위험

참고: 문서에 나타나는 모든 ID는 예시일 뿐이며, 실제 각 메인 보드의 ID는 모두 다릅니다. 실제로 획득한 ID를 입력하세요.

툴보드 ID 읽기 및 확인

USB 연결 방법​

지원 장치​

주의사항​

USB ID 검색​

USB ID를 설정 파일에 입력하기​

도구 보드 USB ID 입력​

CAN 툴 보드 설정 완전 가이드​

사전 준비​

CAN 네트워크 구성 요구사항​

SSH 연결​

CAN ID 검색​

검색 결과 설명​

CAN 장치 ID 구성​

1. 구성 파일 가져오기​

2. 장치 구성 추가​

3. 저장 및 재시작​

툴 보드의 RS232 ID 검색​

주의사항​

RS232 주의사항​

RS232 ID 검색​

툴 보드 RS232 ID 입력​

USB 연결 방법

지원 장치

주의사항

USB ID 검색

USB ID를 설정 파일에 입력하기

도구 보드 USB ID 입력

CAN 툴 보드 설정 완전 가이드

사전 준비

CAN 네트워크 구성 요구사항

SSH 연결

CAN ID 검색

검색 결과 설명

CAN 장치 ID 구성

1. 구성 파일 가져오기

2. 장치 구성 추가

3. 저장 및 재시작

툴 보드의 RS232 ID 검색

주의사항

RS232 주의사항

RS232 ID 검색

툴 보드 RS232 ID 입력