USB 펌웨어 컴파일
컴파일 시작
klipper
서비스가 설치된 상위기기를 사용해야 합니다. 네트워크를 통해 SSH 연결하기- 그리고 장치를 상위기에 잘 연결해야 합니다.
- 주의: 일반적인 상위기기를 사용하십시오. 예를 들어 라즈베리 파이 FLY 패 등입니다. WiFi 스틱, 홍미폰 등의 모modified 상위기는 지원 문제가 많아 기술 지원을 제공할 수 없습니다.
ROOT
사용자를 일반 사용자로 전환하려면 아래 명령어를 입력할 수 있습니다.ROOT
사용자는 사용하지 마십시오.- fly 사용자는 다음을 입력할 수 있습니다:
su fly
. fly 사용자가 아닌 경우<상위기기 사용자 이름>
을 상위기기의 사용자 이름으로 바꾸십시오!
su <상위기기 사용자 이름>
- 请确保上位机可以正常联网
- 固件编译前需要使用SSH通过网络登录上位机
- 请不要使用串口工具登录上位机
Klipper固件编译和配置页面操作说明
请确保键盘输入法为半角模式,即英文模式
- 键盘上键
↑
,下键↓
,用于上下移动光标来选中菜单项 - 确认键
Enter
或 空格键Space
,用于勾选菜单或进入子菜单 - 退出键
ESC
,用于返回上一级菜单 Q
键,用于退出Klipper固件配置页面Y
键,在退出Klipper固件配置页面时,如果有提示,则点击Y
键保存配置文件
如果配置页面选项比较少,请先勾选[ ] Enable extra low-level configuration options
,用于显示部分隐藏选项
아래는 펌웨어를 컴파일하는 방법을 소개합니다:
-
SSH에 연결한 후 다음 명령어를 입력하고 Enter 키를 누릅니다:
cd ~/klipper && rm -rf ~/klipper/.config && rm -rf ~/klipper/out && make menuconfig
-
여기서
rm -rf ~/klipper/.config && rm -rf ~/klipper/out
은 이전에 컴파일된 데이터와 펌웨어를 삭제하며make menuconfig
는 펌웨어를 컴파일합니다. 실행 후 아래와 같은 화면이 나타나야 합니다. -
Enable extra low-level configuration options를 선택하고 Enter 키를 누릅니다
-
Micro-controller Architecture 메뉴로 들어가 Raspberry Pi RP2040를 선택하고 Enter 키를 누릅니다
-
Bootloader offset를 선택하고: NO bootloader를 선택합니다
-
Communication interface를 선택하고: USBSERIAL을 선택합니다
Q
키를 누르고 Save configuration이 나타날 때까지 기다린 후Y
키를 누릅니다.
- 이제 설정이 저장되었으며 명령줄 인터페이스로 돌아왔습니다.
make -j4
를 입력하여 컴파일을 시작합니다. 시간이 다소 걸릴 수 있습니다.

-
아래 내용이 출력되면 컴파일이 성공적으로 완료되었습니다.
Linking out/klipper.elf
Creating hex file out/klipper.bin
플래싱 모드 확인
- 상위 컴퓨터가 정상적으로 네트워크에 연결되어 있는지 확인하고, 하위 컴퓨터와 데이터 전송 기능이 있는 데이터 케이블이 상위 컴퓨터에 연결되어 있는지 확인하십시오.
- 상위 컴퓨터에 SSH 연결 후
lsusb
를 입력하고 Enter 키를 누릅니다. 아래 이미지에서 빨간색으로 표시된 정보가 나타나면 다음 단계로 진행할 수 있습니다.- 아무런 정보도 반환되지 않는 경우, 이는 상위 컴퓨터 시스템의 문제입니다. 해결 방법은 없으므로 정상적인 시스템으로 교체하거나 상위 컴퓨터를 교체해야 합니다.
lsusb
명령이 없다는 메시지가 표시되면 다음 명령어를 실행하여 설치할 수 있습니다.sudo apt-get install usbutils
- 빨간색 사각형 내부에 표시된 ID는 참고용이며 고정된 값은 아닙니다.
OpenMoko, Inc. rp2040
이후의 접미사XX
는 가변적입니다.- 일부 상위 컴퓨터는 시스템 문제로 인해 정보가 제대로 표시되지 않을 수 있습니다.
펌웨어 플래싱
:::팁
- 플러그인 설치 시 인터넷 연결이 필요합니다. 상위 컴퓨터가 정상적으로 인터넷에 연결되어 있는지 확인하시기 바랍니다.
- 이미 설치된 경우 다시 설치할 필요가 없습니다. :::
번영 시작하기
:::주의
- 비-Fly 상위 컴퓨터는 아래의 코드를 반드시 실행하여 펌웨어 번영 의존 패키지를 설치해야 합니다! 그렇지 않으면 펌웨어를 번영할 수 없습니다!
cd && git clone https://github.com/Arksine/katapult.git
- 국내 사용자는 다음 명령어로 설치
cd && git clone https://gitee.com/MrCakeFuck/katapult.git

:::
-
아래 명령어를 사용하여 장치 ID를 검색하고, 아래 그림과 같은 ID가 나타나야 합니다 (참고: 그림에 표시된 ID는 예시이며, 각 보드의 ID는 다릅니다)
ls /dev/serial/by-id/*
-
펌웨어를 번영하기 위해 아래 코드를 사용하십시오. 컴파일된 펌웨어가 준비되었는지 확인한 후,
<your_board_id>
를 이전 단계에서 검색한 ID로 대체하십시오.~/klippy-env/bin/python ~/katapult/scripts/flashtool.py -d /dev/serial/by-id/<your_board_id>
fast
시스템은 이 명령어를 사용하여 번영, <your_board_id>
를 이전 단계에서 검색한 ID로 대체하십시오.
python ~/katapult/scripts/flashtool.py -d /dev/serial/by-id/<your_board_id>
-
참고 자료
-
번영 완료 후 참고
펌웨어 업데이트
- USB 펌웨어 업데이트
- CAN 버스 브리지 펌웨어 업데이트
-
아래 명령어를 사용하여 보드 ID를 검색하고, 아래 그림과 같은 ID가 나타나야 합니다 (참고: 그림에 표시된 ID는 예시이며, 각 보드의 ID는 다릅니다)
ls /dev/serial/by-id/*
:::팁
아래 그림에서 /dev/serial/by-id/usb-katapult_rp2040_E662549553642032-if00
가 보드의 ID입니다
:::

-
USB 펌웨어를 업데이트하려면 최신 펌웨어를 컴파일한 후 아래 명령어를 입력하여 업데이트하십시오,
<your_board_id>
를 이전 단계에서 검색한 ID로 대체하십시오cd ~/klipper/ && make flash FLASH_DEVICE=<your_board_id>
-
CAN 버스 브리지 펌웨어를 업데이트하려면 최신 펌웨어를 컴파일한 후 아래 명령어를 입력하여 Katapult로 재설정하십시오. (아래 그림 참조, 그림의 ID는 예시이며, 실제로는 구성 파일의 ID를 사용하십시오) :::팁
<your_CANBUS_UUID>
는 printer.cfg 구성 파일에서 보드의 CANBUS UUID입니다 :::
~/klippy-env/bin/python3 ~/katapult/scripts/flashtool.py -i can0 -r -u <your_CANBUS_UUID>
fast
시스템은 이 명령어를 사용하여 번영, <your_board_id>
를 이전 단계에서 검색한 ID로 대체하십시오.
python3 ~/katapult/scripts/flashtool.py -i can0 -r -u <your_CANBUS_UUID>
:::팁
- 아래 그림에서
f95cee90e1f9
가 보드의 CANBUS UUID입니다 :::

-
Katapult로 재설정한 후, 아래 명령어를 사용하여 보드 ID를 검색하고, 아래 그림과 같은 ID가 나타나야 합니다 (참고: 그림에 표시된 ID는 예시이며, 각 보드의 ID는 다릅니다)
ls /dev/serial/by-id/*
:::팁
아래 그림에서 /dev/serial/by-id/usb-Klipper_stm32f072xb_43002C000951324757373520-if00
가 보드의 ID입니다
:::

-
새 펌웨어를 컴파일한 후 실행하여 번영을 수행하십시오.
<your_board_id>
를 이전 단계에서 검색한 ID로 대체하십시오.cd ~/klipper/ && make flash FLASH_DEVICE=<your_board_id>
잘못된 펌웨어 번영 해결 방법
- 보드가 전원을 끈 후 다시 전원을 켜고, 리셋 버튼을 빠르게 두 번 클릭하면 다시 번영 모드로 들어갈 수 있습니다.
- 또는 Windows/상위 컴퓨터를 사용하여 katapult 펌웨어를 다시 번영하십시오.katapult 펌웨어 번영