USB 펌웨어 빌드
빌드 시작하기
펌웨어 컴파일 간단 가이드
주의사항
- 네트워크: 상위 기기(라즈베리 파이 등)가 인터넷에 연결되어 있는지 확인하세요.
- 로그인 방식: 반드시 SSH를 통해 네트워크로 로그인하고, 시리얼 포트는 비활성화하세요.
- 입력기: 키보드를 영문 반각 모드로 유지하세요.
SSH 로그인 및 사용자 전환
MobaXterm, PuTTY 등의 도구를 사용하여 SSH로 상위 기기에 로그인하세요.
사용자 전환:
- 일반 시스템(라즈베리 파이 공식 시스템 등)
root사용을 금지하며, 일반 사용자로 전환해야 합니다:su <사용자명> - FLY 상위 기기(FlyOS-FAST 시스템)
root사용자 로그인만 지원됩니다(비밀번호:mellow)
펌웨어 컴파일 작업 가이드
Klipper 펌웨어 구성 화면에서는 키보드 조작만 지원되며, 마우스를 사용할 수 없습니다.
| 키 | 기능 |
|---|---|
| ↑ / ↓ | 커서를 위아래로 이동하여 메뉴 항목 선택 |
| Enter / 스페이스바 | 선택 확인, 옵션 체크 또는 하위 메뉴 진입 |
| ESC | 이전 메뉴로 돌아가기 |
| Q | 구성 화면 종료 |
| Y | 종료 시, 저장하라는 메시지가 나타나면 Y를 눌러 구성 저장 |
아래는 펌웨어를 컴파일하는 방법을 설명합니다:
-
SSH에 연결한 후 아래 명령어를 입력하고
Enter 키를 누르세요:cd ~/klipper && rm -rf ~/klipper/.config && rm -rf ~/klipper/out && make menuconfig -
여기서
rm -rf ~/klipper/.config && rm -rf ~/klipper/out는 이전 컴파일 데이터와 펌웨어를 삭제하는 것이고,make menuconfig는 펌웨어를 컴파일하는 것입니다. 실행 후 아래와 같은 화면이 나타나야 합니다.Loading... -
Enable extra low-level configuration options를 선택하고Enter 키를 누르세요.Loading... -
Micro-controller Architecture메뉴로 들어가서STMicroelectronics STM32를 선택하고Enter 키를 누르세요.Loading... -
Processor model메뉴로 들어가서STM32H723을 선택하고 Enter 키를 누르세요.Loading... -
Bootloader offset를 선택하고128KiB bootloader를 선택하세요.Loading... -
Clock Reference (8 MHz crystal)를 선택하고25 MHz crystal을 선택하세요.Loading... -
Communication interface를 선택하고USB (on PA11/PA12)를 선택하세요.Loading...
Q키를 누르면 Save configuration이 나타납니다. 이때Y키를 누르세요.Loading...- 이제 설정이 저장되고 명령줄 인터페이스로 돌아갔을 것입니다.
- 아래 명령어를 입력하여 컴파일을 시작하세요. 시간이 조금 걸립니다.
make -j4
- 마지막으로 아래 내용이 출력되면 컴파일이 성공한 것입니다.
- Klipper 버전 문제로 인해
out/klipper.bin이 나타나기만 하면 성공을 의미합니다.Linking out/klipper.elf
Creating bin file out/klipper.bin
펌웨어 플래싱하기
준비 작업
- 펌웨어 플래싱을 시작하기 전에 네트워크 연결 SSH 사용을 먼저 하십시오.
- 알려지지 않은 브랜드의 메모리 카드는 플래싱 실패를 초래할 수 있으므로, 가능하면 아래 추천 메모리 카드를 사용하여 펌웨어를 업데이트하십시오.
32G이하 용량의 TF 카드를 준비해야 하며, TF 카드의 전송 속도는 반드시class10등급 이상이어야 합니다. 샌디스크 등 브랜드의 TF 카드 사용을 권장합니다.
펌웨어 다운로드
-
미리 준비한 TF 카드를 사용합니다.
-
SDFormatter로 포맷합니다.Loading... -
MobaXterm_Personal 왼쪽 파일 디렉토리에서
klipper를 찾고,out을 엽니다.- 일반 시스템 펌웨어 다운로드 디렉토리
- FlyOS-FAST 시스템 펌웨어 다운로드 디렉토리
경고- 일반 시스템 주의사항
- 라즈베리 파이, FLY 파이 등 일반 상위 시스템은 이 항목을 참조하십시오.
- 컴파일 완료된 펌웨어는
/home/<사용자 이름>/klipper/out/디렉토리에 있습니다.
Loading...
경고FlyOS-FAST시스템 주의사항FAST 시스템의 펌웨어 디렉토리- 컴파일 완료된 펌웨어는
/data/klipper/out/디렉토리에 있습니다.
Loading...
-
klipper.bin을 TF 카드에 다운로드하고, 이름을firmware.bin으로 변경합니다.firmware.binLoading... -
메인보드 전원을 끄고, TF 카드를 메인보드에 삽입합니다.
-
메인보드 전원을 켜고, 10초간 기다립니다.
-
TF 카드를 빼서 컴퓨터에 삽입했을 때 SD 카드의
firmware.bin파일이 사라지고FLY.CUR파일이 나타나면 플래싱이 성공한 것입니다.Loading...