본문으로 건너뛰기

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
Loading...
  • 마지막으로 아래 내용이 출력되면 컴파일 성공입니다
  • Klipper 버전 문제로 out/klipper.bin만 나타나도 성공을 의미합니다 
    Linking out/klipper.elf
    Creating bin file out/klipper.bin

펌웨어 플래싱​

준비 작업​

  • 펌웨어를 굽기 전에 먼저 네트워크를 통해 SSH 연결 사용
  • 저가형 메모리 카드는 굽기 실패를 유발할 수 있으므로, 가능하면 아래 권장 메모리 카드를 사용하여 펌웨어를 업데이트하세요.
  • 용량이 32G를 초과하지 않는 TF 카드가 필요하며, TF 카드의 전송 속도는 class10 등급 이상이어야 합니다. SanDisk 등 브랜드의 TF 카드를 권장합니다.

펌웨어 다운로드​

  1. 미리 준비한 TF 카드 사용

  2. SDFormatter를 사용하여 포맷

    Loading...

  3. MobaXterm_Personal의 왼쪽 파일 디렉토리에서 klipper를 찾아 선택한 후 out을 열어서 확인

    주의
    • 일반 시스템 주의사항
      • 라즈베리파이, FLY파이 등 일반 상위 시스템은 모두 이 유형에 해당합니다.
      • 컴파일 완료된 펌웨어는 /home/<사용자 이름>/klipper/out/ 디렉토리에 있습니다.
      Loading...

  4. klipper.bin을 TF 카드에 다운로드하고 이름을 firmware.bin으로 변경합니다.

    firmware.bin
    Loading...

  5. 메인보드 전원을 차단하고 TF 카드를 메인보드에 삽입합니다.

  6. 메인보드에 전원을 공급하고 10초간 기다립니다.

  7. TF 카드를 분리하여 컴퓨터에 삽입합니다. SD 카드의 firmware.bin이 사라지고 FLY.CUR가 나타나면 굽기가 성공한 것입니다.

    Loading...
Loading...