중요 안내

주의사항

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

툴보드 ID 읽기 및 확인

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

USB 연결 방법

지원 장치

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

Loading...

주의사항

참고사항

• 작업 전에 툴보드에 USB 펌웨어가 이미 플래시되어 있는지 확인하십시오.
• 본 튜토리얼은 툴보드 ID 검색용이며, 메인보드 ID 검색에는 사용할 수 없습니다.
• 상위 컴퓨터와 툴보드가 올바르게 연결된 후에 후속 작업을 진행하십시오.

SSH 연결

• 먼저 네트워크를 통해 SSH에 로그인하십시오.
• 네트워크 로그인을 통해 SSH에 접속해야 하며, 직렬 포트 로그인은 사용할 수 없습니다.

장치 검색

• 상위 컴퓨터가 정상적으로 인터넷에 연결될 수 있는지 확인하시고, 하위 장치가 상위 컴퓨터와 연결된 데이터 케이블이 데이터 전송 기능을 가지고 있는지 확인하시기 바랍니다.
• SSH로 상위 컴퓨터에 연결한 후 lsusb를 입력하고 엔터를 누르면, 아래 이미지에서 동그라미 친 정보가 표시된다면 다음 단계로 진행할 수 있습니다.
  • 아무런 정보가 표시되지 않는 경우, 이는 상위 컴퓨터의 시스템 문제로 인한 것이며, 이쪽에서는 해결할 방법이 없습니다. 정상적인 시스템으로 교체하거나 다른 상위 컴퓨터를 사용하십시오.
  • lsusb 명령어가 없다는 메시지가 표시되면, 아래 명령어를 실행하여 설치할 수 있습니다.

    sudo apt-get install usbutils

    Loading...
• 1d50:614e는 이번에 사용할 장치입니다.
  • 일부 상위 컴퓨터에서는 시스템 문제로 인해 장치가 전부 표시되지 않거나 표시되지 않을 수도 있습니다.
  • lsusb 명령어로 장치는 표시되지만 1d50:614e가 표시되지 않는 경우, 데이터 케이블을 교체하거나 메인보드를 상위 컴퓨터의 다른 USB 포트에 연결해 보십시오.

주의사항

하나의 1d50:614e 장치를 조회한 후에야 다음 단계로 진행해야 합니다.

USB ID 검색

ls /dev/serial/by-id/*

• 아래 명령어를 입력하고 엔터를 누르면 정상적으로 작동할 경우 아래와 같은 파란색 ID 한 줄이 나타납니다. (아래는 예시입니다.)

Loading...

• 아래 명령어를 입력한 후 ID가 나타나지 않고 lsusb에서 장치가 보인다면 다른 상위 컴퓨터 또는 다른 운영체제를 사용해 보십시오.

주의사항

여러 개의 ID가 나타날 경우, 해당 ID는 사용 중인 메인보드의 MCU 모델에 따라 선택하시기 바랍니다.

USB ID를 설정에 입력하기

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

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

위험

참고: 문서에 표시된 모든 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 버스 신호 안정성을 보장하고 통신 오류를 방지하는 핵심 요소입니다.

Loading...

CAN 툴 보드 설정 완전 가이드

사전 준비

중요 전제 조건

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

하드웨어 연결 및 종단 저항 설정

안전 우선

• 완전한 전원 차단: 모든 배선 작업은 장치의 전원이 완전히 차단된 상태에서 수행해야 합니다.
• 단락 방지: 작업 전 모든 장치의 전원을 분리하세요.

연결 규격표

장치 유형	종단 저항 요구사항	설정 방식
CAN 툴 보드	120Ω 종단 저항 필요	점퍼 캡 또는 DIP 스위치로 활성화
메인 보드 CAN 인터페이스	120Ω 종단 저항 필요	점퍼 캡 또는 DIP 스위치로 활성화
UTOC 모듈	내장 120Ω 저항 있음	추가 연결 불필요

설정 및 측정 단계

1. 하드웨어 설정

   • 메인 보드 CAN 인터페이스 옆의 120Ω 점퍼 캡 또는 DIP 스위치가 연결/켜져 있는지 확인하세요.
   • 툴 보드의 120Ω 점퍼 캡 또는 DIP 스위치가 연결/켜져 있는지 확인하세요.

2. 저항 측정(전원 차단 상태)

   • 측정 지점: CAN-H와 CAN-L 사이
   • 도구: 멀티미터

저항값 고장 진단표

주의사항

• 측정은 반드시 전원 차단 상태에서 테스트해야 합니다.
• 측정 범위가 140Ω 정도라면 CAN-H와 CAN-L이 반대로 연결되었을 수 있습니다.

측정값	상태	가능한 원인	해결책
60Ω 정도	✅ 정상	양단 저항이 올바르게 연결됨	설정 완료
120Ω 정도	❌ 이상	회선이 끊어졌거나 연결되지 않음	모든 배선 확인
40Ω 정도	❌ 이상	세 곳에 저항이 연결됨	중간 저항 제거

중요 주의사항

• UTOC 모듈: 내장 저항이 있으므로, 연결 시 메인 보드는 종단 저항을 추가로 연결할 필요 없음.
• 연결 시나리오:
  • 툴 보드 ↔ 메인 보드(양단 모두 종단 저항 필요)
  • 툴 보드 ↔ UTOC ↔ 호스트 컴퓨터(툴 보드만 종단 저항 필요)
• 고장 진단 절차:

  저항 측정 → 60Ω → 정상 사용
         ↓
      이상값 → 위 표 참조 → 조정 후 재측정

하드웨어 점검 목록

• 모든 장치 전원 완전 차단
• 메인 보드 CAN 인터페이스 종단 저항 연결됨(UTOC 제외)
• 툴 보드 종단 저항 연결됨
• 멀티미터 측정 저항값≈60Ω
• CAN-H와 CAN-L 배선이 올바르고 견고함

전문가 조언

올바른 종단 저항 설정은 CAN 버스 통신 품질에 매우 중요합니다. 저항값 편차는 통신 불안정 또는 데이터 손실을 초래할 수 있습니다.

CAN 네트워크 설정 요구사항

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

요약 절차

1. 하드웨어 준비: 전원 차단 상태 배선, 종단 저항 설정, 측정 확인 60Ω
2. 네트워크 확인: 호스트 컴퓨터 CAN 네트워크가 올바르게 설정되었는지 확인
3. 호스트 컴퓨터 연결: UTOC 또는 USB 브리지 메인 보드를 통해 호스트 컴퓨터 연결
4. 펌웨어 상태: 툴 보드가 Klipper-can 또는 Katapult-can 모드인지 확인
5. 후속 작업: 후속 튜토리얼에 따라 ID 검색 및 설정 수행

이제 CAN 툴 보드의 하드웨어 연결 및 네트워크 환경이 준비되었으며, ID 검색 및 설정 작업을 진행할 수 있습니다.

SSH 연결

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

장치 검색

• 이제 상위 컴퓨터에 정상적으로 로그인한 상태라면 lsusb 명령어를 입력하여 장치를 검색할 수 있습니다. 다음과 같은 경우 중 하나가 발생할 수 있습니다.
  • lsusb 입력 시 ls 명령어를 찾을 수 없다는 메시지가 나오면, 아래 명령어를 입력하여 설치할 수 있습니다.

    sudo apt-get install usbutils

  • lsusb 입력 후 아무 반응이 없는 경우, 이는 시스템 문제로 해결이 불가능하므로 다른 정상적인 시스템으로 교체해야 합니다.
  • 아래 사진과 같은 정보가 나타납니다. 참고용이므로, 1d50:606f가 표시되는지만 확인하시면 됩니다.
    Loading...
• 1d50:606f는 이번에 사용할 장치입니다.
• 여러 개의 1d50:606f가 나타난다면, 하나를 제외하고는 제거해야 합니다. 그렇지 않으면 향후 플래싱 및 펌웨어 연결에 영향을 줄 수 있습니다. 예를 들어 FLY MINI PAD의 경우, 외부 CAN 브리지 장치가 아닌 내장된 UTOC를 사용하는 것이 좋습니다.
• 만약 나타나지 않았다면, 케이블 연결 상태와 펌웨어가 올바르게 작성되었는지 스스로 확인하십시오.

참고 사항

1d50:606f가 나타날 경우에만 CAN ID 검색을 진행해야 합니다.

CAN ID 검색

• Fly-Armbian / 일반 시스템
• Fly-FAST 시스템

다음 명령을 실행하여 CAN 장치 ID를 검색하세요:

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

다음 명령을 실행하여 CAN 장치 ID를 검색하세요:

python ~/klipper/scripts/canbus_query.py can0

검색 결과 설명

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

결과 표시	상태 설명	후속 작업
Application: Klipper	장치에 Klipper 펌웨어가 구워짐	해당 ID를 직접 사용 가능
Application: CANBOOT 또는 Katapult	장치가 Bootloader 모드임	Klipper 펌웨어 구워야 사용 가능
Total 0 uuids found	어떤 장치도 찾지 못함	다음 문제 확인: 1. CAN 네트워크 설정이 올바른가 2. CAN 속도가 일치하는가(기본 1Mbps) 3. 이미 설정에서 해당 ID를 사용 중인가(먼저 비활성화 후 저장, 전원 차단 재시작 필요)

Loading...

중복 ID에 관하여

장치 ID가 printer.cfg에 이미 설정되어 있다면, 검색 결과에 표시되지 않습니다. 재검색이 필요한 경우:

1. 설정 파일에서 해당 장치 ID를 주석 처리
2. 설정 저장 및 Klipper 재시작
3. 모든 장치 전원 차단 후 재시작

CAN 장치 ID 설정

1. 설정 파일 가져오기

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

Fluidd 왼쪽 탐색 모음의 {...} 아이콘 클릭, printer.cfg 찾기 Loading...

Mainsail 상단 탐색 모음의 기계 클릭, printer.cfg 찾기 Loading...

2. 장치 설정 추가

printer.cfg에 툴 보드 설정을 추가하세요:

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

설정 설명

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

3. 저장 및 재시작

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

Loading...

주의

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

• RS232 참조 배선

Loading...

인터페이스 설정 설명

주의사항

중요한 준비

1. 펌웨어 요구사항:
   툴보드에 RS232 펌웨어가 반드시 설치되어야 하며, 그렇지 않으면 통신이 불가능함
2. 공통 접지 필수:
   ⚠️ 툴보드를 연결하기 전, 동일한 전원을 사용하거나 툴보드와 메인보드의 GND를 연결하여 공통 접지를 해야함 (24V/12V 전원을 공유하는 것으로 충분함)
3. 인터페이스 특징:
   • 듀얼 RS232 인터페이스는 독립적으로 또는 동시에 두 개 모두 사용 가능
   • Klipper serial: 파라미터는 하드웨어적으로 고정되어 수정 불가

배선 규격

왼쪽 인터페이스(SERIAL3) 배선 방법 Loading...

오른쪽 인터페이스(SERIAL4) 배선 방법 Loading...

• 왼쪽 인터페이스(SERIAL3)
• 오른쪽 인터페이스(UART4)

설정 절차

1. printer.cfg 편집

   [mcu Laser]
   serial: /dev/serial3  # 왼쪽 인터페이스 고정 장치 노드
   baud: 250000
   restart_method: command

2. 주요 설정 설명
   • [mcu Laser]에서 Laser는 사용자가 임의로 변경 가능
   • /dev/serial3은 왼쪽 인터페이스 전용 노드이며, 변경 불가

설정 절차

1. printer.cfg 편집

   [mcu ToolBoard]
   serial: /dev/serial4  # 오른쪽 인터페이스 고정 장치 노드
   baud: 250000
   restart_method: command

2. 주요 설정 설명
   • [mcu ToolBoard]에서 ToolBoard는 사용자가 임의로 변경 가능
   • /dev/serial4은 오른쪽 인터페이스 전용 노드이며, 변경 불가

설정 ID

1. 브라우저를 열고 주소 표시줄에 호스트 컴퓨터의 IP 주소를 입력함. 예를 들어 호스트 컴퓨터의 IP가 192.168.101.179이면 직접 입력한 후 엔터를 누름

Loading...

2. 호스트 컴퓨터의 웹 인터페이스를 열고 왼쪽 사이드바의 설정 메뉴에서 다음을 찾음:

fluidd의 경우: {…} 클릭 후 printer.cfg 확인 가능 Loading...

mainsail의 경우: 기계 클릭 후 printer.cfg 확인 가능 Loading...

3. 해당 ID 입력

Loading...

Loading...

2. 설정 적용

   • 설정 코드를 해당 영역에 붙여넣은 후
   • 오른쪽 상단의 SAVE & RESTART 버튼 클릭

3. Klipper에서 ADC out of range 경고가 나타나는 경우 정상적인 현상이며, 히트베드와 온도 센서를 메인보드에 연결하고 노즐 및 히트베드의 온도 센서 핀을 올바르게 설정한 후 저장 및 재시작하면 됨.