본문으로 건너뛰기

USB 펌웨어 컴파일

컴파일 시작​

  • klipper 서비스가 설치된 상위기기를 사용해야 합니다. 네트워크를 통해 SSH 연결하기
  • 그리고 장치를 상위기에 잘 연결해야 합니다.
  • 주의: 일반적인 상위기기를 사용하십시오. 예를 들어 라즈베리 파이 FLY 패 등입니다. WiFi 스틱, 홍미폰 등의 모modified 상위기는 지원 문제가 많아 기술 지원을 제공할 수 없습니다.
경고
  • ROOT 사용자를 일반 사용자로 전환하려면 아래 명령어를 입력할 수 있습니다.
  • ROOT 사용자는 사용하지 마십시오.
  • fly 사용자는 다음을 입력할 수 있습니다: su fly. fly 사용자가 아닌 경우 <상위기기 사용자 이름>을 상위기기의 사용자 이름으로 바꾸십시오!
su <상위기기 사용자 이름>
팁
  • 请确保上位机可以正常联网
  • 固件编译前需要使用SSH通过网络登录上位机
  • 请不要使用串口工具登录上位机

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

팁

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

  1. 键盘上键↑，下键↓，用于上下移动光标来选中菜单项
  2. 确认键Enter 或 空格键Space，用于勾选菜单或进入子菜单
  3. 退出键ESC，用于返回上一级菜单
  4. Q键，用于退出Klipper固件配置页面
  5. 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 메뉴로 들어가서 STMicroelectronics STM32를 선택하고 Enter를 누릅니다.

  • Processor model 메뉴로 들어가서 STM32F072를 선택하고 Enter를 누릅니다.

  • Bootloader offset를 선택하고 8KiB bootloader를 선택합니다.

  • Communication interface를 선택하고 **USB (on PA11/PA12)**를 선택합니다.

  • 다음 그림과 일치하는지 확인하고, 일치하면 다음 단계로 진행하세요.

  • Q 키를 누르면 Save configuration 메시지가 나타나고, 이때 Y 키를 누릅니다.

  • 이제 설정이 저장되었으며 명령줄 화면으로 돌아왔습니다.

  • make -j4 명령을 입력하여 컴파일을 시작합니다. 시간이 다소 걸립니다.

  • 마지막에 아래 내용이 출력되면 컴파일 성공입니다.

    Linking out/klipper.elf
    Creating hex file out/klipper.bin

부트로더 모드 진입​

:::팁 2024년 9월 1일 이후 출廠된 D7 모델은 이미 Katapult 펌웨어로 업데이트되어 있습니다. :::

  • 메인보드를 상위 기계에 TypeC 데이터선으로 연결한 후, 리셋 버튼을 두 번 클릭합니다. 이때 메인보드의 LED가 깜빡입니다. :::경고
    • 만약 LED가 깜빡이지 않는다면 Katapult 펌웨어를 다시 써야 합니다: Katapult 펌웨어 쓰기
    • LED가 깜빡하지 않으면 Katapult 펌웨어 쓰기를 완료한 후 다음 단계를 진행하십시오. :::

부트로더 모드 진입 확인​

  • 상위 기계가 정상적으로 네트워크에 연결되어 있는지 확인하고, 하위 기계와 연결된 데이터선이 데이터 전송 기능을 수행하는지 확인하십시오.
  • SSH로 상위 기계에 연결한 후 lsusb 명령을 입력하고 Enter를 누릅니다. 아래 그림에서 빨간색으로 표시된 정보가 나타나면 다음 단계로 진행할 수 있습니다.
    • 아무런 정보도 반환되지 않으면 상위 기계 시스템 문제이며 해결 방법이 없습니다. 정상적인 시스템으로 교체하거나 상위 기계를 바꿔보십시오.
    • lsusb 명령이 없는 경우 다음 명령어로 설치할 수 있습니다. 
      sudo apt-get install usbutils
  • 빨간색으로 표시된 ID는 참고용이지만 고정된 값은 아니며, OpenMoko, Inc. stm32f072xx의 후缀에 있는 XX는 가변적인 의미입니다.
    • 일부 상위 기계는 시스템 문제로 인해 정보가 완전히 표시되지 않거나 표시되지 않을 수 있습니다.

펌웨어 쓰기​

:::팁

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

번영 시작하기​

:::주의

  • 비-Fly 상위 컴퓨터는 아래의 코드를 반드시 실행하여 펌웨어 번영 의존 패키지를 설치해야 합니다! 그렇지 않으면 펌웨어를 번영할 수 없습니다! 
      cd && git clone https://github.com/Arksine/katapult.git
  • 국내 사용자는 다음 명령어로 설치
  cd && git clone https://gitee.com/MrCakeFuck/katapult.git

:::

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

    ls /dev/serial/by-id/*

  • 펌웨어를 번영하기 위해 아래 코드를 사용하십시오. 컴파일된 펌웨어가 준비되었는지 확인한 후, <your_board_id>를 이전 단계에서 검색한 ID로 대체하십시오.

    ~/klippy-env/bin/python ~/katapult/scripts/flashtool.py -d /dev/serial/by-id/<your_board_id>

fast 시스템은 이 명령어를 사용하여 번영, <your_board_id>를 이전 단계에서 검색한 ID로 대체하십시오.

python ~/katapult/scripts/flashtool.py -d /dev/serial/by-id/<your_board_id>

  • 참고 자료

  • 번영 완료 후 참고

펌웨어 업데이트​

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

    ls /dev/serial/by-id/*

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

  • USB 펌웨어를 업데이트하려면 최신 펌웨어를 컴파일한 후 아래 명령어를 입력하여 업데이트하십시오, <your_board_id>를 이전 단계에서 검색한 ID로 대체하십시오

    cd ~/klipper/ && make flash FLASH_DEVICE=<your_board_id>

잘못된 펌웨어 번영 해결 방법​

  • 보드가 전원을 끈 후 다시 전원을 켜고, 리셋 버튼을 빠르게 두 번 클릭하면 다시 번영 모드로 들어갈 수 있습니다.
  • 또는 Windows/상위 컴퓨터를 사용하여 katapult 펌웨어를 다시 번영하십시오.katapult 펌웨어 번영