본문으로 건너뛰기

유선 연결용 Klipper 설정

주의사항
  • STM32F072에 펌웨어를 업로드한 후 Klipper에 연결해야 하며, 그렇지 않으면 유선 연결 기능이 지원되지 않습니다.

컴파일 시작​

펌웨어 컴파일 간단 가이드​

주의사항​

  • 네트워크: 상위 컴퓨터(라즈베리파이 등)가 인터넷에 연결되어 있는지 확인하세요.
  • 로그인 방식: 반드시 SSH를 통해 네트워크로 로그인하고, 시리얼 포트는 비활성화하세요.
  • 입력기: 키보드를 영문 반각 모드로 유지하세요.

SSH 로그인 및 사용자 전환​

MobaXterm, PuTTY 등의 도구를 사용하여 상위 컴퓨터에 SSH로 로그인하세요.

사용자 전환:​

  • 일반 시스템(라즈베리파이 공식 시스템 등)
    root 사용을 금지하며, 일반 사용자로 전환해야 합니다: 
    su <사용자명>
  • FLY 상위 컴퓨터(FlyOS-FAST 시스템)
    root 사용자 로그인만 지원합니다(비밀번호: mellow).

펌웨어 컴파일 작업 가이드​

Klipper 펌웨어 구성 인터페이스에서는 키보드 조작만 지원하며, 마우스는 사용할 수 없습니다.

키기능
↑ / ↓커서를 위아래로 이동하여 메뉴 항목 선택
Enter / 스페이스바선택 확인, 옵션 체크 또는 하위 메뉴 진입
ESC상위 메뉴로 돌아가기
Q구성 인터페이스 종료
Y종료 시 메시지가 나타나면 Y를 눌러 구성 저장

펌웨어 컴파일 시작하기​

아래에서는 펌웨어를 컴파일하는 방법을 설명합니다:

  1. SSH에 연결한 후 다음 명령어를 입력하고 Enter 키를 누릅니다:

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

    여기서 rm -rf ~/klipper/.config && rm -rf ~/klipper/out은 이전 컴파일 구성과 펌웨어를 삭제하는 데 사용됩니다; make menuconfig는 Klipper 펌웨어 구성 인터페이스를 여는 데 사용됩니다.

  2. 아래 순서대로 항목별로 설정하며, 각 항목을 완료한 후 다음 항목을 진행합니다.

    1启用 Enable extra low-level configuration options
    (Top)
    Klipper Firmware Configuration
    [*] Enable extra low-level configuration options
    2Micro-controller Architecture 选择 STMicroelectronics STM32
    (Top)
    Klipper Firmware Configuration
    [*] Enable extra low-level configuration options
    Micro-controller Architecture (STMicroelectronics STM32) --->
    3Processor model 选择 STM32F072
    (Top)
    Klipper Firmware Configuration
    [*] Enable extra low-level configuration options
    Micro-controller Architecture (STMicroelectronics STM32) --->
    Processor model (STM32F072) --->
    4Bootloader offset 选择 No bootloader
    (Top)
    Klipper Firmware Configuration
    [*] Enable extra low-level configuration options
    Micro-controller Architecture (STMicroelectronics STM32) --->
    Processor model (STM32F072) --->
    Bootloader offset (No bootloader) --->
    5Clock Reference 选择 8 MHz crystal
    (Top)
    Klipper Firmware Configuration
    [*] Enable extra low-level configuration options
    Micro-controller Architecture (STMicroelectronics STM32) --->
    Processor model (STM32F072) --->
    Bootloader offset (No bootloader) --->
    Clock Reference (8 MHz crystal) --->
    6Communication interface 选择 USB (on PA11/PA12)
    (Top)
    Klipper Firmware Configuration
    [*] Enable extra low-level configuration options
    Micro-controller Architecture (STMicroelectronics STM32) --->
    Processor model (STM32F072) --->
    Bootloader offset (No bootloader) --->
    Clock Reference (8 MHz crystal) --->
    Communication interface (USB (on PA11/PA12)) --->
    7启用 Optimize stepper code for 'step on both edges'
    (Top)
    Klipper Firmware Configuration
    [*] Enable extra low-level configuration options
    Micro-controller Architecture (STMicroelectronics STM32) --->
    Processor model (STM32F072) --->
    Bootloader offset (No bootloader) --->
    Clock Reference (8 MHz crystal) --->
    Communication interface (USB (on PA11/PA12)) --->
    USB ids --->
    [*] Optimize stepper code for 'step on both edges'
    8按 Q 键退出配置界面
    (Top)
    Klipper Firmware Configuration
    [*] Enable extra low-level configuration options
    Micro-controller Architecture (STMicroelectronics STM32) --->
    Processor model (STM32F072) --->
    Bootloader offset (No bootloader) --->
    Clock Reference (8 MHz crystal) --->
    Communication interface (USB (on PA11/PA12)) --->
    USB ids --->
    [*] Optimize stepper code for 'step on both edges'
    () GPIO pins to set at micro-controller startup
    9出现 Save configuration 时按 Y 保存配置
    Quit
    Save configuration?
    (Y)es(N)o(C)ancel

  3. 위의 마지막 두 단계를 완료한 후 Q를 눌러 구성 인터페이스를 종료하고, Y를 눌러 구성을 저장합니다.

  4. 명령줄로 돌아간 후 다음 명령어를 입력하고 Enter 키를 눌러 컴파일을 시작합니다:

    make -j4
    root@flyos-11e5f8 ~/klipper # make -j4
    Compiling out/src/stm32/stm32f0_adc.o
    Compiling out/src/stm32/spi.o
    Compiling out/src/stm32/stm32f0_i2c.o
    Compiling out/src/stm32/usbfs.o
    Compiling out/src/stm32/chipid.o
    Compiling out/src/generic/usb_cdc.o
    Compiling out/src/stm32/hard_pwm.o
    Preprocessing out/src/generic/armcm_link.ld
    Building out/compile_time_request.o
    Version: XXXX
    Linking out/klipper.elf
    Creating bin file out/klipper.bin

    终端末尾出现 Linking out/klipper.elf 和 Creating bin file out/klipper.bin，即表示编译成功。 实际编译时，部分 Compiling 行和 Version 会随 Klipper 与系统版本变化。

프로그래밍 모드 진입​

  • AirClick의 전원을 끈 상태에서 STM32의 BOOT 버튼을 누른 채로 STM32의 프로그래밍 포트를 Type-C를 통해 상위 컴퓨터와 연결합니다.
    Loading...

펌웨어 프로그래밍​

1. 플래싱 도구 설치​

  • FLY 상위 컴퓨터는 플래싱 도구를 설치할 필요가 없습니다.
  • 설치가 필요한 경우, 상위 컴퓨터가 정상적으로 인터넷에 연결되어 있어야 합니다.
  • 이미 설치한 경우 중복 설치할 필요가 없습니다.
sudo apt update
sudo apt install dfu-util -y

2. 장치가 DFU에 진입했는지 확인​

lsusb
  • DFU 장치가 없다면 플래싱 모드로 다시 진입하십시오.
  • 시스템 버전에 따라 장치 이름이 다를 수 있습니다. 0483:df11이 보이면 DFU에 진입한 것입니다.
Loading...

3. (선택 사항) 전체 칩 소거​

전체 칩 소거는 Bootloader를 삭제합니다

mass-erase는 Katapult / Bootloader를 포함한 MCU의 전체 Flash를 지우며, 장치를 정상적으로 플래싱할 수 없어 완전히 복구해야 하는 경우에만 사용합니다. 일반 펌웨어 업그레이드 시에는 실행하지 마십시오. 소거 후에는 반드시 Bootloader를 다시 플래싱한 다음 애플리케이션 펌웨어를 플래싱해야 합니다.

전체 칩 소거가 필요하다고 확인된 경우 실행하십시오:

sudo dfu-util -a 0 -d 0483:df11 -s 0x08000000:mass-erase:force

이 명령은 소거만 하고 펌웨어를 쓰지 않으며, 완료 후 다음 단계를 계속 진행하십시오.

4. 펌웨어 플래싱​

아래 명령을 실행하여 플래싱을 시작하십시오. <펌웨어 파일 전체 경로>를 실제 펌웨어 파일 경로로 바꾸십시오:

sudo dfu-util -a 0 -d 0483:df11 --dfuse-address 0x08000000 -D <펌웨어 파일 전체 경로>

5. 플래싱 결과 확인​

File downloaded successfully가 나타나면 플래싱 성공입니다:

Loading...
팁

플래싱 완료 후 메인보드의 전원을 한 번 완전히 차단해야 합니다.

USBID 검색​

  • AirClick의 프로그래밍 포트를 상위 컴퓨터의 USB 포트에 연결해야 하며, BOOT 버튼은 누르지 않아야 ID를 검색할 수 있습니다.
    Loading...

메인보드 USB ID 획득​

주의사항​

전원 차단 작업

메인보드 USB 케이블을 연결하거나 다시 꽂아야 할 경우, 먼저 프린터 전원을 완전히 끄고 전원 공급을 차단하세요. 전원이 켜진 상태에서 케이블을 꽂거나 빼지 마십시오.

사용 범위
  • SSH로 상위 컴퓨터에 로그인한 후 검색 명령을 실행해야 합니다.
  • 작업 전에 메인보드에 USB 펌웨어가 플래시되었는지 확인하고, Type-C 데이터 케이블로 상위 컴퓨터의 USB 포트에 연결하세요.
  • 본 튜토리얼은 메인보드 USB ID 검색에만 적용되며, 툴보드 ID 검색에는 적용되지 않습니다.
  • 툴보드 장치는 해당 제품 문서의 USB 또는 CAN ID 획득 튜토리얼을 사용하세요.

작업 단계​

USB 장치 ID 검색​

SSH로 상위 컴퓨터에 로그인한 후 다음 명령어를 실행하여 모든 USB 직렬 장치 ID를 나열합니다:

ls /dev/serial/by-id/*
사용할 수 없는 ID​

명령어 실행 후 다음 두 가지 유형의 ID는 사용하지 마세요:

ID 특징원인 설명예시
usb-1a86_USB_Serial-if00-port0CH340 등 범용 직렬 칩의 기본 이름으로, Klipper 메인보드 연결 주소로 사용할 수 없음/dev/serial/by-id/usb-1a86_USB_Serial-if00-port0
katapult 포함장치가 Katapult 플래시 모드에 있으므로 먼저 Klipper 펌웨어를 플래시해야 함/dev/serial/by-id/usb-katapult_xxxxxxxxxxxx
검색 결과​

정상적인 경우 터미널에 아래 그림과 유사한 장치 경로가 표시됩니다. 그림 속 ID는 형식 예시일 뿐입니다.

Loading...

사용 가능한 ID를 찾지 못한 경우: 장치 펌웨어 및 연결 문제 해결 보기

여러 ID가 표시되는 경우

명령어가 여러 개의 사용 가능한 ID를 반환하는 경우, 메인보드 MCU 모델 및 케이블을 꽂고 뺄 때의 장치 목록 변화를 함께 확인하여 메인보드에 해당하는 전체 장치 경로를 확인하세요.

USB ID를 설정 파일에 입력​

Fluidd 또는 Mainsail에서 printer.cfg를 엽니다:

Fluidd: 왼쪽의 {…} 아이콘을 클릭한 후 printer.cfg를 엽니다.

Loading...

Mainsail: 왼쪽의 "머신"을 클릭한 후 printer.cfg를 엽니다.

Loading...
ID는 반드시 실제 검색 결과를 사용해야 함

문서의 장치 경로는 모두 예시입니다. 각 메인보드의 USB ID는 다를 수 있으므로, SSH 명령어로 반환된 실제 경로를 전체 복사하세요.

[mcu] 설정 섹션을 찾아 serial을 방금 조회한 전체 장치 경로로 수정합니다:

[mcu]
serial: /dev/serial/by-id/usb-Klipper_xxxxxxxxxxxx

USB 펌웨어를 사용할 때는 serial을 설정해야 하며, 동일한 [mcu] 설정 섹션에 canbus_uuid를 함께 입력하지 마세요.

설정 위치는 아래 그림을 참고하세요:

Fluidd 설정 예시
Loading...
Mainsail 설정 예시
Loading...

수정 완료 후, 오른쪽 상단의 SAVE & RESTART를 클릭하여 설정을 저장하고 Klipper를 재시작합니다.

Loading...