본문으로 건너뛰기

도구 보드 MCU 추가 및 크로스 보드 구성

이 페이지는 메인 MCU 연결이 성공적으로 완료된 후, 도구 보드를 추가하고 다중 MCU 상태를 확인하며 크로스 보드 핀을 구성하는 데 사용됩니다. 아직 메인 MCU 연결 검증을 완료하지 않았다면 먼저 MCU 연결 가이드를 완료하세요.

1단계: 도구 보드 준비 및 연결​

도구 보드 추가를 시작하기 전에 다음 사항을 확인하세요:

  • 메인 MCU가 MCU 연결 가이드에 따라 연결 검증을 완료했는지 확인합니다.
  • 도구 보드에 펌웨어가 올바르게 플래시되었는지 확인합니다.
  • 도구 보드가 CAN, USB 또는 RS232 중 어떤 통신 방식을 사용하는지 확인했습니다.
전원 차단 작업

시작하기 전에 프린터를 완전히 끄고 전원 공급을 차단하세요. 전원이 켜진 상태에서 케이블을 연결/분리하거나, 인터페이스 배선 순서를 정리하거나, 단자에 접촉하지 마십시오.

전원을 완전히 차단한 후, 도구 보드 데이터 케이블을 호스트 컴퓨터 또는 메인보드의 해당 인터페이스에 연결하세요. 전원 공급 장치를 분해하거나, 주전원 배선을 변경하거나, 노출된 단자에 접촉하지 마십시오. 연결이 확실한지 확인한 후 다시 전원을 켜십시오.

여러 도구 보드를 하나씩 추가

여러 개의 동일한 유형의 도구 보드를 동시에 연결하면 ID를 구분하기 어렵습니다. 한 번에 하나의 도구 보드만 연결하고 기록하는 것이 좋습니다. 도구 보드를 추가하거나 제거할 때마다 반드시 전원을 완전히 차단해야 합니다.

2단계: 도구 보드 ID 조회 및 기록​

도구 보드와 메인보드는 동일한 MCU ID 입력 규칙을 사용합니다:

MCU ID 설정 설명​

Klipper에서 MCU ID란 [mcu] 또는 [mcu xxx] 구성 섹션에서 컨트롤보드 연결을 식별하는 정보를 말합니다. 통신 방식에 따라 작성 방법이 다릅니다:

연결 방식구성 항목예시
USB 펌웨어serial:serial: /dev/serial/by-id/usb-Klipper_xxxxxxxxxxxx
CAN 펌웨어canbus_uuid:canbus_uuid: xxxxxxxxxxxx
RS232 장치serial:serial: /dev/serial/by-path/xxxxxxxxxxxx
호스트 MCUserial:serial: /tmp/klipper_host_mcu

기입 규칙:

  1. 메인보드는 기본적으로 [mcu]를 사용하고, 툴보드나 확장보드는 [mcu tool], [mcu toolboard] 등 사용자 정의 이름을 사용합니다.
  2. USB 펌웨어는 serial:만 기입하고, CAN 펌웨어는 canbus_uuid:만 기입합니다. 동일한 [mcu]에 두 항목을 동시에 유지하지 마십시오.
  3. 다중 MCU 시스템에서 각 [mcu xxx]는 실제 고유 ID를 사용해야 하며, 동일한 USB ID나 CAN UUID를 복사하지 마십시오.
  4. [mcu xxx]의 이름은 핀 접두사에 영향을 줍니다. 예를 들어 [mcu tool]의 핀은 tool:gpio13으로 작성해야 합니다. 이름의 대소문자는 일관성을 유지해야 합니다.
  5. 문서 예시의 xxxxxxxx는 직접 사용할 수 없으며, 실제 검색된 ID로 교체해야 합니다.
  6. RS232 장치는 serial: 외에도 일반적으로 baud: 250000과 restart_method: command를 추가로 기입해야 합니다. 해당 제품 문서를 기준으로 합니다.

일반적인 오류:

  • 플래싱 모드 ID(예: katapult, canboot가 포함된 ID)를 Klipper 펌웨어 ID로 잘못 사용하는 경우.
  • USB 펌웨어에 canbus_uuid:를 설정하거나, CAN 펌웨어에 이전 serial:을 유지하는 경우.
  • RS232 장치에서 경로만 기입하고 필요한 baud: 또는 restart_method:를 누락하는 경우.
  • 툴보드를 [mcu]로 설정하여 메인보드 MCU 구성을 덮어쓰는 경우.
  • 핀 접두사와 MCU 이름이 일치하지 않는 경우. 예: 구성이 [mcu toolboard]인데 핀을 tool:gpio13으로 작성하는 경우.

USB ID 조회: USB 펌웨어는 ls /dev/serial/by-id/*를 실행하여 ID를 확인할 수 있습니다.

CAN ID 조회: CAN 네트워크 및 ID 검색

RS232 경로 조회: ls -l /dev/serial/by-path/를 실행하여 안정적인 장치 경로를 확인합니다.

툴보드 구성: 툴보드 MCU 추가 및 크로스보드 구성

USB, CAN, RS232 조회 명령 및 결과 설명: MCU ID 구성

ID를 기록할 때 동시에 고유하고 짧은 MCU 이름을 결정하세요. 예: toolboard, toolboard1 또는 toolboard2. 그리고 다음 사항을 확인하세요:

  • USB ID에 usb-Klipper_...가 포함되어 있으며, Katapult/Bootloader 플래시 모드 ID가 아닙니다.
  • CAN 조회 결과에 Application: Klipper가 표시됩니다.
  • RS232는 /dev/serial/by-path/ 아래의 안정적인 경로를 사용하며, 제품 요구 사항에 따라 보드율과 재시작 방식을 입력합니다.
  • 도구 보드 ID가 메인보드 및 다른 도구 보드와 중복되지 않습니다.

3단계: 도구 보드 MCU 추가​

도구 보드 ID를 얻은 후, 먼저 현재 전체 printer.cfg를 백업한 다음 해당 MCU 구성 섹션을 추가하세요:

[mcu toolboard]
serial: /dev/serial/by-id/usb-Klipper_stm32f446xx_54321-if00
명명 규칙
  • MCU 이름은 완전히 사용자 정의할 수 있습니다. 예: toolboard, tool, extruder_mcu 등. 구성 내에서 고유하게 유지하기만 하면 됩니다.
  • MCU 이름은 크로스 보드 핀의 접두사로 사용됩니다. 예: [mcu toolboard]를 참조할 때 toolboard:PA0으로 작성합니다. 이름의 대소문자는 일관되게 유지해야 합니다.
  • 각 MCU의 이름과 ID는 고유해야 하며, 메인 MCU나 다른 도구 보드와 중복될 수 없습니다.
  • 여러 도구 보드를 구성할 때는 각 장치에 다른 이름을 설정하여 구분하세요.

구성 완료 후 SAVE & RESTART를 클릭하여 Klipper를 저장하고 재시작합니다.

4단계: 모든 MCU 연결 확인​

도구 보드를 추가하고 Klipper를 재시작한 후, 모든 MCU가 온라인 상태인지 확인해야 합니다:

  1. Fluidd 인터페이스를 열고 왼쪽 메뉴에서 System을 클릭합니다.
  2. Mcu Information 아래에서 메인 MCU와 모든 도구 보드가 올바르게 인식되고 연결 상태로 표시되는지 확인합니다.
Loading...

펌웨어 버전 확인​

모든 MCU 연결을 완료한 후, 펌웨어 버전 호환성을 검증해야 합니다:

  1. Fluidd 인터페이스를 열고 왼쪽 메뉴에서 System을 클릭합니다.
  2. Mcu Information 아래에서 Version 필드를 찾습니다.
  3. 모든 MCU의 펌웨어 버전이 호스트 컴퓨터의 Klipper 버전과 일치하는지 확인합니다.
버전 호환성 설명
  • 사전 구성된 맞춤 장치를 제외하고, 직접 컴파일한 모든 펌웨어는 호스트 컴퓨터의 Klipper 버전과 일치해야 합니다.
  • FAST 시스템의 펌웨어 버전은 시스템 버전과 일치하며, 컴파일된 Klipper 펌웨어도 시스템 버전과 일치합니다.
  • 버전이 다른 펌웨어는 기능 이상, 통신 실패 또는 시스템 불안정을 초래할 수 있습니다.

5단계: 크로스 보드 핀 구성​

여러 도구 보드를 사용할 때 핀을 보드 간에 할당해야 하는 요구 사항이 발생할 수 있습니다. 예: 가열 기능은 첫 번째 도구 보드의 가열 포트를 사용하지만, 온도 센서는 메인보드 또는 두 번째 도구 보드에 연결되어 있습니다.

핵심 원칙

Klipper 다중 MCU 구성에서 모든 구성 섹션의 핀은 <mcu이름>:<핀번호> 형식으로 정의된 모든 MCU의 핀을 직접 참조할 수 있으며, 추가 구성이 필요하지 않습니다. Klipper는 통신 버스(CAN/USB/시리얼)를 통해 자동으로 명령을 해당 MCU로 전송합니다.

일반적인 시나리오: 가열은 도구 보드, 온도 센서는 메인보드​

다음과 같은 시스템 구성을 가정합니다:

  • 메인보드 MCU: 메인보드가 USB로 연결되고, 온도 센서는 메인보드에 연결됩니다.
  • toolboard1: 도구 보드, 가열 봉과 압출기 스테퍼가 도구 보드에 연결됩니다.
예시 핀은 그대로 복사할 수 없음

아래 <step_pin>, <heater_pin>, <sensor_pin> 등은 위치를 나타내는 자리 표시자입니다. 해당 FLY 메인보드 또는 도구 보드의 제품 문서에 따라 실제 핀으로 교체하고, ! 반전 논리가 실제 하드웨어에 적용되는지 확인해야 합니다.

1단계: 모든 MCU 정의

[mcu]
serial: /dev/serial/by-id/usb-Klipper_stm32h723xx_12345-if00

[mcu toolboard1]
canbus_uuid: e51d5c71a901

2단계: 구성에서 직접 크로스 보드 핀 참조

[extruder]
# 스테퍼와 가열은 도구 보드 핀 사용
step_pin: toolboard1:<step_pin>
dir_pin: toolboard1:<dir_pin>
enable_pin: !toolboard1:<enable_pin>
heater_pin: toolboard1:<heater_pin>

# 온도 센서는 메인보드 핀 사용
sensor_type: <sensor_type>
sensor_pin: <sensor_pin>

# rotation_distance, 온도 범위 등 나머지 매개변수는 실제 하드웨어에 따라 구성
핀 명명 규칙
  • 도구 보드 핀 형식은 <mcu이름>:<핀번호>입니다. 예: toolboard1:<heater_pin>.
  • 메인 MCU 핀은 접두사 없이 실제 핀 이름을 직접 작성할 수 있습니다.
  • 동일한 구성 섹션의 핀은 서로 다른 MCU에서 올 수 있으며, Klipper가 크로스 보드 통신을 자동으로 처리합니다.

추가 크로스 보드 구성 예시​

가열 봉은 첫 번째 도구 보드, 온도 센서는 두 번째 도구 보드:

[extruder]
step_pin: toolboard1:<step_pin>
heater_pin: toolboard1:<heater_pin>
sensor_type: <sensor_type>
sensor_pin: toolboard2:<sensor_pin>
주의사항
  • 보드 간 핀을 참조할 때는 해당 MCU가 설정 파일에서 [mcu <이름>]으로 올바르게 정의되어 있는지 확인하세요.
  • MCU 이름의 대소문자는 반드시 일치해야 하며, [mcu ToolBoard]와 toolboard:PA0 참조는 오류를 발생시킵니다.
  • 히터와 온도 센서처럼 기능적으로 밀접한 장치는 가능하면 동일한 툴 보드에 연결하여 최적의 응답 속도와 안정성을 확보하는 것이 좋습니다.

자주 묻는 질문​

문제 증상해결 방향
툴 보드가 온라인 상태가 아님전원을 차단한 후 데이터 케이블 연결을 확인하고, ID가 올바른지 확인하며 Klipper 펌웨어 ID와 플래시 모드 ID를 구분하세요
다중 툴 보드 이름/ID 충돌각 [mcu]의 이름과 ID는 고유해야 합니다. MCU ID 설정 참조
핀 접두사 불일치[mcu toolboard]의 핀 접두사는 toolboard:여야 하며, 이름의 대소문자가 일치해야 합니다
펌웨어 버전 비호환상위 컴퓨터의 Klipper 버전과 일치하도록 펌웨어를 재컴파일하세요
CAN UUID를 찾을 수 없음CAN 네트워크 및 ID 검색 참조
RS232 통신 실패baud: 250000과 restart_method: command가 설정되어 있는지 확인하세요
Loading...