USB 펌웨어 컴파일

:::팁

USB 가속계는 USB 연결의 Katapult 펌웨어를 출하 시 미리 플래시합니다.
플래시되지 않은 경우 스스로 플래시할 수 있습니다.
Katapult 펌웨어 플래시

:::

컴파일 시작

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를 선택하고 16KiB bootloader를 선택합니다:
Communication interface를 선택하고 USBSERIAL을 선택합니다:

마이크로컨트롤러 시작 시 설정할 GPIO 핀 선택, 입력: gpio24
Q 키 누르면 설정 저장이 나타나고, 그 후 Y 키 누릅니다

이제 설정이 저장되었고 명령줄 화면으로 돌아왔습니다
make -j4 입력하여 컴파일 시작, 시간이 꽤 걸립니다

마지막에 아래 내용이 출력되면 컴파일 성공입니다
```
Linking out/klipper.elf
Creating hex file out/klipper.bin
```

장치 검색

상위 컴퓨터가 정상적으로 연결될 수 있도록 하며, 하위 컴퓨터와 연결된 데이터선이 데이터 전송 기능을 가지고 있는지 확인하세요.
상위 컴퓨터에 SSH로 연결한 후 lsusb를 입력하고 Enter 키를 누릅니다. 아래 이미지에서 동그라미 표시된 정보가 나타나면 다음 단계로 진행할 수 있습니다.
- 아무런 정보도 반응이 없으면, 이는 상위 컴퓨터의 시스템 문제입니다. 여기서는 해결할 수 없으므로, 정상적인 시스템으로 교체하거나 상위 컴퓨터를 교체해야 합니다.
- lsusb 명령이 없다고 표시되면 다음 명령어를 실행하여 설치할 수 있습니다.
```
sudo apt-get install usbutils
```
1d50:614e는 이번에 사용할 장치입니다. OpenMoko, Inc. stm32f407xx라는 후缀은 일정 부분 참고 가치가 있지만, 판단 기준은 아닙니다.
- 일부 상위 컴퓨터는 시스템 문제로 인해 장치 정보가 완전히 표시되지 않거나 표시되지 않을 수 있습니다.
- 만약 lsusb 명령어를 입력하면 장치가 표시되지만 1d50:614e가 보이지 않는 경우, 데이터선을 교체하거나 메인보드를 상위 컴퓨터의 다른 USB 포트에 연결해 보세요.
이전에 위 단계를 수행했으며 Klipper 펌웨어를 성공적으로 번역하고 메인보드가 정상적으로 작동하는 경우, Klipper 펌웨어를 업데이트하려면 본 페이지 오른쪽 메뉴바의 펌웨어 업데이트 섹션을 참조하세요.

주의사항

하나 이상의 1d50:614e 장치를 찾은 후에만 다음 단계로 진행할 수 있습니다.

펌웨어 플래시

::: tip

플래시 플러그인 설치 시 인터넷 연결이 필요합니다. 상위 컴퓨터가 정상적으로 인터넷에 연결되어 있는지 확인하시기 바랍니다.
이미 설치된 경우 다시 설치할 필요는 없습니다. :::

번역하기

::: warning 경고

Fly이외의 상위 컴퓨터 사용 시 아래 명령어를 반드시 실행하여 펌웨어 플래시 의존 패키지를 설치해야 합니다! 그렇지 않으면 펌웨어를 플래시할 수 없습니다!

cd && git clone https://github.com/Arksine/katapult.git

:::

아래 명령어를 사용하여 장치 ID를 검색하고, 아래 그림과 같은 ID가 나타나야 합니다 (참고: 그림에서 보여지는 ID는 예시이며, 각 보드의 ID는 다릅니다).
```
ls /dev/serial/by-id/*
```
펌웨어 플래시 시 아래 명령어를 사용합니다. 펌웨어가 정상적으로 컴파일되었는지 확인한 후, <보드 ID> 를 이전 단계에서 찾은 ID로 대체* 하십시오.
```
~/klippy-env/bin/python ~/katapult/scripts/flashtool.py -d /dev/serial/by-id/<보드 ID>
```
참고 사항
플래시 완료 사례

펌웨어 업데이트

USB 펌웨어 업데이트

아래 명령어를 사용하여 보드 ID를 검색하고, 아래 그림과 같은 ID가 나타나야 합니다 (참고: 그림에서 보여지는 ID는 예시이며, 각 보드의 ID는 다릅니다).

ls /dev/serial/by-id/*

::: tip 주의 아래 그림에서 /dev/serial/by-id/usb-katapult_rp2040_E662549553642032-if00가 보드의 ID입니다. :::

USB 펌웨어 업데이트는 최신 펌웨어를 컴파일한 후 아래 명령어를 입력하여 진행해야 합니다. <보드 ID> 를 이전 단계에서 찾은 ID로 대체* 하십시오.

cd ~/klipper/ && make flash FLASH_DEVICE=<보드 ID>

잘못된 펌웨어 플래시 문제 해결 방법

보드 전원을 끈 후 다시 전원을 켜고, 두 번 빠르게 리셋 버튼을 누르면 됩니다.
또는 WINDOWS에서 펌웨어를 지우고 BL을 다시 플래시하세요

펌웨어 정상 작동 확인

펌웨어가 정상적으로 시작되면 LED가 켜집니다

컴파일 시작​

Klipper固件编译和配置页面操作说明​

장치 검색​

펌웨어 플래시​

번역하기​

펌웨어 업데이트​

잘못된 펌웨어 플래시 문제 해결 방법​

펌웨어 정상 작동 확인​