본문으로 건너뛰기

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 등급 이상이어야 합니다. 샌디스크 등 브랜드의 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...