USB 펌웨어 컴파일

팁

ERCF는 출하 시 CAN 연결 Katapult 펌웨어가 사전에 설치되어 있습니다.
USB 펌웨어 번인을 위해 USB의 Katapult 펌웨어가 필요합니다.
한 번 번인 후에는 다시 번인할 필요가 없습니다.
Katapult 펌웨어 번인

컴파일 시작

klipper 서비스가 설치된 상위 컴퓨터를 사용해야 합니다. 네트워크를 통해 SSH 연결
그리고 장비를 상위 컴퓨터에 연결해야 합니다.
주의: 일반적인 상위 컴퓨터를 사용하세요. 예를 들어 라즈베리 파이, FLY 파이 등입니다. 만약 마개조된 상위 컴퓨터(예를 들어 WiFi 막대기, 홍미 등)라면, 이런 상위 컴퓨터는 문제가 너무 많아 기술 지원을 제공할 수 없습니다.

주의 사항

ROOT 사용자를 사용하지 마세요.

사용자 전환 명령

 su fly

팁

请确保上位机可以正常联网
固件编译前需要使用SSH通过网络登录上位机
请不要使用串口工具登录上位机

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

팁

请确保键盘输入法为半角模式，即英文模式

键盘上键↑，下键↓，用于上下移动光标来选中菜单项
确认键Enter 或空格键Space，用于勾选菜单或进入子菜单
退出键ESC，用于返回上一级菜单
Q键，用于退出Klipper固件配置页面
Y键，在退出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는 펌웨어를 컴파일하는 것입니다. 실행 후 아래와 같은 화면이 나타나야 합니다.
추가적인 저수준 설정 옵션 활성화를 선택하고 엔터를 누릅니다.
마이크로컨트롤러 아키텍처 메뉴로 들어가 Raspberry Pi RP2040를 선택하고 엔터를 누릅니다.
부트로더 오프셋을 선택하고, 16KiB 부트로더를 선택합니다.
통신 인터페이스를 선택하고, USBSERIAL을 선택합니다.

마이크로 컨트롤러 시작 시 설정할 GPIO 핀 선택, 입력: gpio17
Q 키를 누르면 Save configuration이 나타납니다. 이때 Y 키를 누릅니다.
이제 설정이 저장되고 명령 줄 인터페이스로 돌아갔을 것입니다.
make -j4를 입력하여 컴파일을 시작합니다. 시간이 조금 걸립니다.
마지막으로 아래 내용이 출력되면 컴파일이 성공적으로 완료된 것입니다.
```
Linking out/klipper.elf
Creating hex file out/klipper.bin
```

번인 모드 진입 확인

상위 컴퓨터가 정상적으로 인터넷에 연결될 수 있도록 확인하고 하위 컴퓨터가 상위 컴퓨터에 연결된 데이터선이 데이터 전송 기능을 가지고 있는지 확인하세요.
SSH 연결로 상위 컴퓨터에 연결한 후 lsusb를 입력하고 엔터를 누르세요. 아래 사진에서 동그라미로 표시된 정보가 나타나면 다음 단계로 진행할 수 있습니다.
- 어떠한 정보도 반환되지 않는다면, 이는 상위 컴퓨터의 시스템 문제이며, 이쪽에서는 어쩔 수 없습니다. 정상인 시스템으로 교체하거나 상위 컴퓨터를 교체해야 합니다.
- lsusb 명령이 없다는 메시지가 나오면, 다음 명령을 실행하여 설치할 수 있습니다.
```
sudo apt-get install usbutils
```
1d50:6177는 이번에 사용해야 할 장치입니다. OpenMoko, Inc. stm32f407xx 접미사는 어느 정도 참고 가치가 있지만 판단 근거로 삼지 않습니다.
- 일부 상위 컴퓨터는 시스템 문제로 인해 정보가 완전히 표시되지 않거나 표시되지 않을 수 있습니다.
- lsusb 명령을 입력하여 장치가 표시되지만 1d50:6177가 없다면 데이터선을 교체하거나 메인보드를 상위 컴퓨터의 다른 USB 포트에 연결해보세요.
만약 이전에 위의 단계를 수행했고 Klipper 펌웨어를 성공적으로 플래싱하여 메인보드가 정상적으로 작동하고 단지 Klipper 펌웨어를 업데이트하려는 경우, 이 페이지 오른쪽 메뉴바의 펌웨어 업데이트 챕터를 직접 확인하세요.

주의 사항

1d50:6177 장치를 조회한 후에만 다음 단계를 진행할 수 있습니다.

펌웨어 번인

팁

Katapult 펌웨어를 사용하면 나중에 SSH를 통해 펌웨어를 직접 업데이트할 수 있으며, DFU 모드로 펌웨어를 다시 플래시할 필요가 없습니다.

설치 및 플래시 플러그인

팁

플래시 플러그인을 설치하려면 상위 컴퓨터가 인터넷에 연결되어야 합니다. 이미 설치한 경우 다시 설치할 필요가 없습니다.

설치 pip install pyserial
```
pip install pyserial
```
-bash: pip: command not found가 표시되면 실행하세요
```
sudo apt-get install pip
```
아래와 같은 오류가 발생하면 실행하세요
```
pip install pyserial --break-system-packages
```

펌웨어 플래시 시작

아래 명령어를 사용하여 장치의 시리얼 포트 주소를 검색하세요
```
ls /dev/serial/by-id/*
```
아래는 참고입니다
펌웨어 플래시를 위해서는 아래 코드를 사용하세요. 펌웨어를 이미 컴파일했는지 확인하세요. = 뒤에 공백이 없어야 합니다.
klipper 디렉토리에서 펌웨어를 플래시할 수 있습니다.
```
make flash FLASH_DEVICE=
```
아래는 참고입니다
플래시 완료 참고

펌웨어 업데이트 방법

USB 펌웨어 업데이트는 최신 펌웨어를 컴파일한 후 아래 명령을 입력하여 업데이트할 수 있습니다. = 뒤에 공백이 없어야 합니다.
```
make flash FLASH_DEVICE=
```
USB 브리징 CAN 펌웨어 업데이트는 최신 펌웨어를 컴파일한 후 아래 명령을 입력하여 Katapult로 리셋합니다.
USB 브리징 CAN의 klipper 펌웨어에만 실행 가능하며, 다른 펌웨어는 오류를 발생시킵니다.
```
~/klippy-env/bin/python3 ~/katapult/scripts/flashtool.py -i can0 -r -u <MCU ID>
```
Katapult로 리셋 후 아래 명령을 실행하여 펌웨어를 업데이트하세요.
```
make flash FLASH_DEVICE=<장치의 시리얼 포트 주소>
```

잘못된 펌웨어 해결 방법

메인보드 전원을 껐다가 다시 켠 후, 메인보드 리셋 버튼을 빠르게 두 번 클릭하세요.
또는 WINDOWS를 사용하여 펌웨어를 지운 후 BL을 다시 플래시하세요.

펌웨어가 정상적으로 시작했는지 확인

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

컴파일 시작​

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

번인 모드 진입 확인​

펌웨어 번인​

설치 및 플래시 플러그인​

펌웨어 플래시 시작​

펌웨어 업데이트 방법​

잘못된 펌웨어 해결 방법​

펌웨어가 정상적으로 시작했는지 확인​