중요 안내 사항

참고 사항

• 본 튜토리얼은 툴보드의 배선 및 ID 검색 절차에 대해 설명하며, 관련 절차는 메인보드에는 적용되지 않으므로 구분하시기 바랍니다.
• 툴보드를 사용하지 않는 경우, 본 튜토리얼은 무시하셔도 됩니다.

툴보드 ID 읽기 및 확인

USB ID 확인

• 데이터 전송 기능이 있는 케이블을 준비해 주세요. 특히 길이가 긴 케이블의 경우 페라이트 코어가 있는 케이블을 사용하는 것이 좋습니다.
• USB 케이블을 통해 툴보드를 상위 컴퓨터에 연결합니다.

주의사항

참고사항

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

SSH 연결

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

장치 검색

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

    sudo apt-get install usbutils

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

주의사항

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

USB ID 검색

ls /dev/serial/by-id/*

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

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

주의사항

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

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 참고 설정

  mainsail 참고 설정

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

CANBus UUID 확인

• ID 검색 전 XT30 케이블을 사용하여 툴보드를 UTOC 또는 브리지 펌웨어가 플래시된 메인보드에 연결하십시오. 아래는 참고용 배선도입니다.

• 다이얼 스위치가 올바른 위치로 설정되었는지 확인하시기 바랍니다.

  

• 전원이 꺼진 상태에서 CAN H와 CAN L 사이의 저항값이 약 60Ω인지 멀티미터로 측정하십시오. 만약 120Ω이라면 120Ω 점퍼를 연결해야 하며, 약 40Ω이라면 점퍼를 제거해야 합니다.

  

  CAN 툴보드 설정 완벽 가이드

  준비 사항

  중요한 전제 조건

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

  하드웨어 연결 및 터미널 저항 설정

  안전이 최우선

  • 완전히 전원 차단: 모든 배선 작업은 장치의 전원이 완전히 꺼져 있는 상태에서 수행해야 함
  • 단락 방지: 작업 전 모든 장치의 전원을 분리함

  연결 사양 표

  장치 유형	터미널 저항 요구 사항	설정 방법
  CAN 툴보드	120Ω 터미널 저항 필요	점퍼 캡 또는 다이얼 스위치로 활성화
  메인보드 CAN 인터페이스	120Ω 터미널 저항 필요	점퍼 캡 또는 다이얼 스위치로 활성화
  UTOC 모듈	내장된 120Ω 저항 포함	추가 연결 불필요

  설정 및 측정 단계

  1. 하드웨어 설정

     • 메인보드 CAN 인터페이스 옆의 120Ω 점퍼 캡 또는 다이얼 스위치가 설치되었거나 활성화되었는지 확인
     • 툴보드의 120Ω 점퍼 캡 또는 다이얼 스위치가 설치되었거나 활성화되었는지 확인

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

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

  저항값 문제 해결 표

  주의 사항

  • 측정은 반드시 전원 차단 상태에서 수행해야 함
  • 측정값이 약 140Ω이라면 CAN-H와 CAN-L이 반대로 연결되었을 수 있음

  측정값	상태	가능한 원인	해결 방법
  약 60Ω	✅ 정상	양쪽 끝 저항이 올바르게 연결됨	설정 완료
  약 120Ω	❌ 비정상	선로 단절 또는 미연결	모든 배선 확인
  약 40Ω	❌ 비정상	세 지점이 저항에 연결됨	중간 저항 제거
  약 90Ω	❌ 비정상	한쪽 끝만 저항 연결됨	다른 쪽 점퍼 캡 확인

  중요한 주의 사항

  • 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가 표시되는지만 확인하시면 됩니다.
      
  • 1d50:606f는 이번에 사용할 장치입니다.
  • 여러 개의 1d50:606f가 나타난다면, 하나를 제외하고는 제거해야 합니다. 그렇지 않으면 향후 플래싱 및 펌웨어 연결에 영향을 줄 수 있습니다. 예를 들어 FLY MINI PAD의 경우, 외부 CAN 브리지 장치가 아닌 내장된 UTOC를 사용하는 것이 좋습니다.
  • 만약 나타나지 않았다면, 케이블 연결 상태와 펌웨어가 올바르게 작성되었는지 스스로 확인하십시오.
  참고 사항

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

  CAN ID 검색

  Fly-Armbian / 일반 시스템

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

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

  Fly-FAST 시스템

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

  python ~/klipper/scripts/canbus_query.py can0

  검색 결과 설명

  검색 명령어 실행 후 다음과 같은 경우가 나타날 수 있음:

  결과 표시	상태 설명	후속 작업
  Application: Klipper	장치에 Klipper 펌웨어가 플래시됨	해당 ID를 바로 사용 가능
  Application: CANBOOT 또는 Katapult	장치가 부트로더 모드임	Klipper 펌웨어를 플래시한 후 사용 가능
  Total 0 uuids found	장치를 찾을 수 없음	다음 사항 확인: 1. CAN 네트워크 설정이 올바른지 2. CAN 속도가 일치하는지 (기본값 1Mbps) 3. 설정에서 이미 해당 ID를 사용 중인지 (먼저 차단한 후 저장하고 재부팅)

  
  중복 ID에 대한 설명

  장치 ID가 printer.cfg에 설정되어 있다면 검색 결과에 표시되지 않음. 다시 검색하려면:

  1. 설정 파일에서 해당 장치 ID를 주석 처리
  2. 설정을 저장하고 Klipper 재시작
  3. 모든 장치의 전원을 끄고 다시 켬

  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. 저장 및 재시작

  1. 우측 상단의 SAVE & RESTART 버튼 클릭
  2. 시스템이 자동으로 설정을 저장하고 Klipper를 재시작함
  
  주의 사항

  문서에 나와 있는 모든 ID는 예시임, 실제 각 메인보드의 ID는 서로 다름, 실제 획득한 ID로 수정 및 입력해야 함

RS232 사용 방법

• ID 검색 전 XT30 케이블을 사용하여 툴보드를 UTOR 또는 G2T에 연결하십시오. 아래는 참고용 배선도입니다.

• 다이얼 스위치가 올바른 위치로 설정되었는지 확인하시기 바랍니다.

  

  검색 툴보드의 RS232 ID

  주의사항

  중요한 준비

  1. 펌웨어 요구사항:
     툴보드는 반드시 RS232 펌웨어를 플래시해야 통신이 가능함
  2. 접지 필수:
     ⚠️ 툴보드 연결 전, 툴보드와 메인보드의 GND가 연결되어 있어야 함 (동일한 24V/12V 전원을 사용하면 됨)

  RS232 주의사항

  • D8, D8PRO 및 C8P만 RS232 인터페이스를 지원함, 다른 메인보드는 지원하지 않음
  • RS232를 지원하지 않는 메인보드는 G2T 또는 UTOR를 사용하여 연결해야 함, 본 튜토리얼은 UTOR를 사용하여 연결함

  RS232 ID 검색

  1. 브라우저를 열고 주소창에 상위 컴퓨터의 IP 주소를 입력함, 예를 들어 상위 컴퓨터 IP가 192.168.101.179이면 그대로 입력하고 엔터를 누름
  
  2. 상위 컴퓨터의 웹 인터페이스를 열고 좌측 사이드바의 설정 메뉴에서 다음을 찾음:

  fluidd의 경우: {…} 클릭 후 printer.cfg를 찾을 수 있음

  mainsail의 경우: 머신 클릭 후 printer.cfg를 찾을 수 있음

  3. printer.cfg에 들어간 후 상단 오른쪽의 DEVICES 클릭
  4. SERIAL 클릭 후 새로고침

  fluidd 새로고침

  mainsail 새로고침

  5. ID 복사, 화살표 위치 클릭 시 복사됨

  fluidd에서 ttyUSB가 존재하는지 확인하고 Path_by_hardware도 존재해야 함, 이것이 RS232_ID임

  mainsail에서 ttyUSB가 존재하는지 확인하고 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는 사용할 수 없습니다 !!!!!!

  serial: /dev/serial/by-id/usb-1a86_USB_Serial-if00-port0