USB 펌웨어 컴파일

컴파일 시작

펌웨어 컴파일 간단 가이드

주의사항

• 네트워크: 상위 컴퓨터(라즈베리파이 등)가 인터넷에 연결되어 있는지 확인하세요.
• 로그인 방식: 반드시 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

   [Space/Enter] Toggle/enter[?] Help[/] Search

   [Q] Quit (prompts for save)[Esc] Leave menu

   2Micro-controller Architecture 选择 Raspberry Pi RP2040/RP235x

   (Top)

   Klipper Firmware Configuration

   [*] Enable extra low-level configuration options

   Micro-controller Architecture (Raspberry Pi RP2040/RP235x) --->

   [Space/Enter] Toggle/enter[?] Help[/] Search

   [Q] Quit (prompts for save)[Esc] Leave menu

   3Processor model 选择 rp2040

   (Top)

   Klipper Firmware Configuration

   [*] Enable extra low-level configuration options

   Micro-controller Architecture (Raspberry Pi RP2040/RP235x) --->

   Processor model (rp2040) --->

   [Space/Enter] Toggle/enter[?] Help[/] Search

   [Q] Quit (prompts for save)[Esc] Leave menu

   4Bootloader offset 选择 16KiB bootloader

   (Top)

   Klipper Firmware Configuration

   [*] Enable extra low-level configuration options

   Micro-controller Architecture (Raspberry Pi RP2040/RP235x) --->

   Processor model (rp2040) --->

   Bootloader offset (16KiB bootloader) --->

   [Space/Enter] Toggle/enter[?] Help[/] Search

   [Q] Quit (prompts for save)[Esc] Leave menu

   5Communication Interface 选择 USBSERIAL

   (Top)

   Klipper Firmware Configuration

   [*] Enable extra low-level configuration options

   Micro-controller Architecture (Raspberry Pi RP2040/RP235x) --->

   Processor model (rp2040) --->

   Bootloader offset (16KiB bootloader) --->

   Communication Interface (USBSERIAL) --->

   [Space/Enter] Toggle/enter[?] Help[/] Search

   [Q] Quit (prompts for save)[Esc] Leave menu

   6启用 Optimize stepper code for 'step on both edges'

   (Top)

   Klipper Firmware Configuration

   [*] Enable extra low-level configuration options

   Micro-controller Architecture (Raspberry Pi RP2040/RP235x) --->

   Processor model (rp2040) --->

   Bootloader offset (16KiB bootloader) --->

   Communication Interface (USBSERIAL) --->

   USB ids --->

   [*] Optimize stepper code for 'step on both edges'

   [Space/Enter] Toggle/enter[?] Help[/] Search

   [Q] Quit (prompts for save)[Esc] Leave menu

   7按 Q 键退出配置界面

   (Top)

   Klipper Firmware Configuration

   [*] Enable extra low-level configuration options

   Micro-controller Architecture (Raspberry Pi RP2040/RP235x) --->

   Processor model (rp2040) --->

   Bootloader offset (16KiB bootloader) --->

   Communication Interface (USBSERIAL) --->

   USB ids --->

   [*] Optimize stepper code for 'step on both edges'

   () GPIO pins to set at micro-controller startup

   [Space/Enter] Toggle/enter[?] Help[/] Search

   [Q] Quit (prompts for save)[Esc] Leave menu

   GPIO 状态说明：GPIO state at micro-controller startup 是 FLYOS-Klipper 的扩展功能，本页面仅作说明。普通固件编译请保持 Not set，无需进入或修改；如需了解全部 GPIO 启动状态，请查看 GPIO 启动状态使用说明。

   8出现 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/rp2040/bootrom.o

   Compiling out/src/rp2040/usbserial.o

   Compiling out/src/generic/usb_cdc.o

   Compiling out/src/rp2040/chipid.o

   Compiling out/src/rp2040/hard_pwm.o

   Compiling out/src/rp2040/spi.o

   Compiling out/src/rp2040/i2c.o

   Preprocessing out/src/rp2040/rpxxxx_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 与系统版本变化。

번programing 모드 진입 확인

전원 차단 조치

시작하기 전에 프린터의 전원을 완전히 끄고 전원 공급을 중단해 주세요. 전원이 켜진 상태에서는 케이블을 연결하거나 분리하거나, 선을 정리하거나 단자를 만지지 마십시오.

• Type-C 데이터 케이블을 사용하여 메인보드를 상위 컴퓨터에 연결한 후, reset 버튼을 두 번 클릭하면 메인보드의 LED 램프가 깜박일 것입니다.

경고

• LED 램프가 깜박이지 않는 경우, Katapult 펌웨어를 다시 번programing해 주세요: Katapult 펌웨어 번programing
• LED 램프가 깜박이지 않는 경우, Katapult 펌웨어 번programing이 완료된 후 다음 단계를 진행해 주세요.

펌웨어 번programing

플래싱 시작

기기의 현재 상태에 따라 플래싱 방식을 선택하십시오:

您的下位机现在是什么状态

일반적인 실패 원인

현상	가능한 원인	처리
usb-katapult_를 검색할 수 없음	Katapult에 진입하지 않음, 데이터 케이블이 충전 전용이거나 USB 포트 이상	RST를 더블 클릭; lsusb로 1d50:6177 확인; 데이터 케이블과 USB 포트 교체
Invalid firmware path '...'	-f 경로가 존재하지 않거나 아직 컴파일되지 않음	컴파일 단계로 돌아가 ~/klipper/out/klipper.bin 존재 확인
Unable to open serial port	Klipper 서비스가 시리얼 포트를 점유 중	sudo systemctl stop klipper 실행 후 재시도
Device is not Katapult, exiting...	장치가 Katapult 모드가 아님	RST를 더블 클릭하여 재진입; 여전히无效한 경우 현재 제품의 Bootloader 복구 문서 참고
Flash Tool Error 와 Traceback 동반	케이블, 전원 공급 또는 펌웨어 유형 불일치	전체 출력을 보관하고 USB / USB 브리지 CAN 펌웨어를 잘못 플래시했는지 확인
플래시 성공했으나 Klipper 연결 불가	펌웨어 유형과 배선 불일치, 또는 [mcu] 미업데이트	usb-Klipper_ 또는 canbus_uuid 가 나타나야 하는지 확인하고 [mcu] 수정
RST 더블 클릭 시 불이 들어오지 않고 항상 1d50:6177 없음	Katapult가 손상되었을 가능성	현재 제품의 Bootloader(Katapult) 복구 문서 참고

번programing 후 USB ID 검색

펌웨어 번programing이 완료되고 메인보드에 다시 전원이 공급된 후에는 USB ID를 계속 검색해 주세요.

USB ID 확인 방법 보기