본문으로 건너뛰기

USB 펌웨어 컴파일

컴파일 시작​

  • klipper 서비스가 설치된 상위 기기를 사용해야 합니다 네트워크를 통해 SSH 연결

    • 그리고 장치를 상위 기기와 연결해야 합니다
    • 주의: 일반적인 상위 기기를 사용하세요, 예를 들어 라즈베리 파이, FLY파이 등, 만약 커스텀 상위 기기라면 문제가 너무 많아서 여기서는 많은 도움을 제공할 수 없습니다
    주의사항
    • ROOT 사용자를 사용하지 마세요
팁
  • 请确保上位机可以正常联网
  • 固件编译前需要使用SSH通过网络登录上位机
  • 请不要使用串口工具登录上位机

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

팁

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

  1. 键盘上键↑，下键↓，用于上下移动光标来选中菜单项
  2. 确认键Enter 或 空格键Space，用于勾选菜单或进入子菜单
  3. 退出键ESC，用于返回上一级菜单
  4. Q键，用于退出Klipper固件配置页面
  5. 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을 선택합니다.

  • Q 키를 누르면 Save configuration이 나타나고, 이때 Y 키를 누릅니다.
  • 이제 설정이 저장되고 명령줄 인터페이스로 돌아갑니다.
  • make -j4를 입력하여 컴파일을 시작합니다. 시간이 좀 걸립니다.

  • 마지막으로 아래의 내용이 출력되면 컴파일이 성공한 것입니다.

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

장치 검색​

  • 상위 컴퓨터가 정상적으로 네트워크에 연결되어 있는지 확인하세요

  • 하위 컴퓨터와 상위 컴퓨터의 데이터 케이블이 데이터 전송 기능을 갖추고 있는지 확인하세요

  • SSH로 상위 컴퓨터에 연결 후 lsusb를 입력하고 엔터를 누르면 아래 세 가지 상황이 발생할 수 있습니다

    • 인식된 USB 장치가 표시됩니다
    • ls 명령어가 없다는 메시지가 나오면 다음 명령어를 실행하여 설치할 수 있습니다 
      sudo apt-get install usbutils
    • 오류가 없고 다른 정보도 없을 경우(시스템 문제로 시스템을 교체해야 합니다)

  • lsusb를 입력 후 아무 반응이 없다면, 이는 시스템 문제로 여기서는 해결할 수 없습니다. 정상적인 시스템으로 교체해야 합니다

  • 아래 이미지에서 동그라미 친 정보가 나타나면 다음 단계로 진행할 수 있습니다

  • 1d50:6177는 이번에 사용할 장치에 속합니다. 이후의 안내는 무시해도 되며, 시스템 문제로 인해 완전히 표시되지 않거나 아예 표시되지 않을 수 있습니다

  • 만약 없다면, 데이터 케이블이 제대로 연결되었는지 또는 메인보드가 Katapult 모드(원래 이름 CANBOOT)인지 확인하세요

  • Katapult를 사용하여 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을 다시 플래시하세요.