유선 연결 Klipper 설정

주의사항

• STM32F072에 펌웨어를 플래시한 후 Klipper에 연결해야 하며, 그렇지 않으면 유선 연결 작업이 지원되지 않습니다.

컴파일 시작

• 설치된 klipper 서비스가 있는 호스트 컴퓨터를 사용해야 합니다. SSH로 네트워크 연결하기
• 그리고 장치를 호스트 컴퓨터에 연결해 주어야 합니다.
• 참고:树莓派, FLY보드 등 일반적인 호스트 컴퓨터를 사용해 주세요. 만약 변형된 호스트 컴퓨터(예: 와이파이 동글, 홍미 등)를 사용할 경우, 문제가 너무 많아 기술 지원을 받을 수 없습니다.

• 일반 호스트 컴퓨터 펌웨어 컴파일 튜토리얼
• FAST 시스템 펌웨어 컴파일 튜토리얼

경고

*树莓派, FLY보드 등 일반 호스트 컴퓨터 시스템은 이 항목을 참조하세요.

• 이 종류의 호스트 컴퓨터에서는 절대로 ROOT 사용자로 작업하지 마세요.
• 일반 사용자로 작업해 주세요.
• 사용자 전환 방법: FlyOS-Armbian 시스템의 경우 su fly 명령어로 일반 사용자로 전환해 주세요.
• 다른 시스템의 경우 su <귀하의 호스트 컴퓨터 사용자 이름> 명령어로 일반 사용자로 전환해 주세요.

su <귀하의 호스트 컴퓨터 사용자 이름>

경고

• FlyOS-FAST 시스템 주의 사항
  • FAST 시스템의 기본 사용자 이름은 root이고 비밀번호는 mellow입니다.
  • 펌웨어 컴파일 작업은 오직 root 사용자로만 수행해야 합니다.
  • 그리고 FAST 시스템은 오직 ROOT 사용자만 있으며, 사용자 전환을 할 필요가 없습니다!!!

팁

• 상위기기(Up Host)가 정상적으로 네트워크에 연결되어 있는지 확인하세요.
• 펌웨어 컴파일 전에 SSH를 통해 상위기기에 네트워크로 로그인해야 합니다.
• 상위기기에 시리얼 포트(Serial Tool)를 사용하지 마세요.

Klipper 펌웨어 컴파일 및 구성 페이지 작동 설명

팁

키보드 입력 모드를 반각(Half-width) 모드로 설정해 주세요. 즉, 영문 모드입니다.

1. 키보드의 ↑(위쪽 화살표), ↓(아래쪽 화살표)는 메뉴 항목을 선택하기 위해 커서를 위아래로 이동시킵니다.
2. 확인 키 Enter 또는 공백 키 Space는 메뉴를 선택하거나 하위 메뉴로 진입합니다.
3. 종료 키 ESC는 상위 메뉴로 돌아갑니다.
4. Q 키는 Klipper 펌웨어 구성 페이지를 종료합니다.
5. Klipper 펌웨어 구성 페이지를 종료할 때 Y 키를 눌러 구성 파일을 저장할 수 있습니다.

경고

구성 페이지 옵션이 적을 경우, Enable extra low-level configuration options 항목을 선택([ ])하여 일부 숨겨진 옵션을 표시할 수 있습니다.

아래는 펌웨어를 컴파일하는 방법을 소개합니다:

• SSH에 연결한 후 아래 명령어를 입력하고 엔터를 누르세요:

  cd ~/klipper && rm -rf ~/klipper/.config && rm -rf ~/klipper/out && make menuconfig

• 여기서 rm -rf ~/klipper/.config && rm -rf ~/klipper/out는 이전 컴파일 데이터와 펌웨어를 삭제하는 명령입니다.

• make menuconfig는 펌웨어를 컴파일하는 명령으로, 실행 후 아래와 같은 화면이 나타나야 합니다.

  Loading...

• Enable extra low-level configuration options를 선택하고 엔터를 누르세요.

  Loading...

• Micro-controller Architecture 메뉴로 들어가서 STMicroelectronics STM32를 선택하고 엔터를 누르세요.

  Loading...

• Processor model 메뉴로 들어가서 STM32F072를 선택하고 엔터를 누르세요.

  Loading...

• Bootloader offset를 선택하고 **:(No bootloader)**를 선택하세요.

  Loading...

• Communication interface를 선택하고 **USB (on PA11/PA12)**를 선택하세요.

  Loading...

• Q 키를 누르면 Save configuration이 나타납니다. 이때 Y 키를 누릅니다.
  Loading...
• 이제 설정이 저장되고 명령줄 인터페이스로 돌아갔을 것입니다.
• make -j4를 입력하여 컴파일을 시작합니다. 시간이 다소 소요됩니다.
  Loading...
• 마지막에 아래 내용이 출력되면 컴파일이 성공한 것입니다.
• Klipper 버전 문제로 인해 out/klipper.bin이 나타나기만 하면 성공을 의미합니다.

  Linking out/klipper.elf
  Creating bin file out/klipper.bin

플래시 모드 진입

• AirClick의 전원이 꺼진 상태에서 STM32의 BOOT 버튼을 누른 채로 STM32의 플래시 포트를 Type-C 케이블로 호스트 컴퓨터에 연결합니다.
  Loading...

플래시 모드 진입 확인

• 상위 기기의 정상적인 네트워크 연결을 확인하십시오

• 하위 기기의 상위 기기와 연결된 데이터선이 데이터 전송 기능을 가지고 있는지 확인하십시오

• SSH로 상위 기기에 연결한 후 lsusb를 입력하고 Enter를 누르면 아래 세 가지 경우 중 하나가 나타날 수 있습니다

  • 이미 인식된 USB 장치가 표시됩니다
  • ls 명령어가 없어서 이 명령어를 실행하여 설치할 수 있습니다

    sudo apt-get install usbutils

  • 오류가 없고 다른 정보도 없습니다 (시스템 문제로 인해 시스템을 변경해야 합니다)

• lsusb를 입력한 후 아무런 반응도 없는 경우 시스템 문제로 여기서는 도움을 드릴 수 없습니다. 정상적인 시스템을 사용해야 합니다

• 아래 그림에서 둘러싼 정보가 나타나면 다음 단계로 진행할 수 있습니다

  Loading...

• 0843:df11은 이번에 사용해야 하는 장치입니다. 나머지 팁은 시스템 문제로 인해 일부만 표시되거나 아예 표시되지 않을 수 있으므로 무시하십시오

• 없으면 데이터선이 제대로 연결되었는지 또는 메인보드에 DFU가 들어갔는지 스스로 확인하십시오

주의사항

0483:df11이 있을 때만 다음 단계로 진행하십시오

펌웨어 플래시

1. 프로그래밍 도구 설치

• FLY 상위기기에서는 프로그래밍 도구 설치가 필요하지 않습니다.
• 설치가 필요한 경우 주의하세요: 상위기기는 인터넷에 연결되어 있어야 정상적으로 설치할 수 있습니다.
• 이미 설치된 경우 다시 설치할 필요가 없습니다.

sudo apt update
sudo apt install dfu-util -y

2. 다음 명령을 실행하여 연결이 성공했는지 확인하세요.

lsusb

• DFU 장치가 없으면 다시 프로그래밍 모드로 진입해보세요.

• 시스템 버전 문제로 다른 이름이 표시될 수 있습니다. 0483:df11이 표시되면 프로그래밍 모드에 진입한 것입니다.

  Loading...

3. 펌웨어 프로그래밍

• 아래 코드를 실행하여 프로그래밍을 시작하세요.

sudo dfu-util -a 0 -d 0483:df11 --dfuse-address 0x08000000 -D ~/klipper/out/klipper.bin

4. 아래 그림 화살표 부분에 표시된 내용 File downloaded successfully이 나타나면 프로그래밍이 성공한 것입니다.

Loading...

팁

프로그래밍이 완료되면, 메인보드에 완전히 전원을 차단해야 합니다.

USBID 검색

• AirClick의 플래시 포트를 호스트 컴퓨터의 USB 포트에 연결해야 합니다. BOOT 버튼을 누르고 있지 마세요. 그렇지 않으면 ID를 검색할 수 없습니다.
  Loading...

주의사항

중요 안내

• 반드시 SSH를 통해 상위 기기에 연결하세요. 네트워크 로그인 방식을 사용하여 상위 기기(라즈베리 파이 등 장치)에 연결하십시오.
• 작업 전에 메인보드에 USB 펌웨어가 구워져 있는지 확인하세요.
• 본 튜토리얼은 메인보드 ID 검색에만 적용되며, 툴보드 ID 검색에는 적용되지 않습니다.
• 메인보드가 TYPEC 케이블을 통해 상위 기기의 USB 포트에 연결되어 있는지 확인하세요.
• 툴보드 ID를 확인하려면 해당 제품 디렉토리에서 관련 튜토리얼을 참조하세요.

작업 단계

USB 장치 ID 검색

• 다음 명령어를 실행하여 모든 USB 시리얼 장치 ID를 나열하세요:

  ls /dev/serial/by-id/*

⚠️ 중요 안내: 사용 불가능한 ID

명령어 실행 후, 다음 두 가지 유형의 ID를 식별하고 사용하지 마세요:

ID 특징	원인 설명	예시
usb-1a86_USB_Serial-if00-port0	이는 CH340 등 범용 시리얼 칩의 기본 이름으로, 설정에 사용할 수 없습니다.	/dev/serial/by-id/usb-1a86_USB_Serial-if00-port0
katapult 문자열 포함	장치가 플래싱 모드에 있음을 나타내며, Klipper 펌웨어를 먼저 구워야 사용할 수 있습니다.	/dev/serial/by-id/usb-katapult_xxxxxxxxxxxx

실행 결과 설명:

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

여러 개의 ID 처리

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

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

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

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

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

USB ID 입력하기

• [mcu] 섹션을 찾아서 내용을 교체하세요.

안내

• 설정 파일에서 다음을 수행하세요:
• canbus_uuid:는 설정하지 마세요.

[mcu]
serial: <여기에 방금 조회한 ID로 교체하세요>

• 참고 예시

fluidd 참고 예시 Loading...

mainsail 참고 예시 Loading...

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