본문으로 건너뛰기

펌웨어 컴파일 설명

중요 안전 경고

시스템 안정적인 작동을 위해, 반드시 다음 펌웨어 사용 원칙을 준수하세요:

  • 펌웨어 컴파일 일관성: Klipper 펌웨어는 반드시 현재 사용 중인 호스트 머신에서 컴파일해야 합니다. 타인이 컴파일한 펌웨어나 버전이 일치하지 않는 펌웨어를 사용하면 예측 불가능한 시스템 장애가 발생할 수 있습니다.
  • 하드웨어 플랫폼 규정: 표준 호스트 머신 하드웨어 사용을 강력히 권장합니다. 비공식적으로 개조된 장치(예: 일부 셋톱박스, WiFi 동글 또는 특정 모델의 레드미 장치 등)는 호환성 및 안정성 위험이 있을 수 있으므로 사용을 피하세요.
  • 가상화 환경 제한: 가상 머신에서 호스트 머신 시스템을 실행하는 것은 성능과 실시간성에 간섭을 일으켜 출력 품질에 영향을 줄 수 있으므로 권장하지 않습니다.

펌웨어 유형 설명​

  • Katapult / HID 모드

    • 기능: 이 두 모드는 기능이 동일하며, 모두 비접촉식 펌웨어 업데이트(메모리 카드 분리 없이 호스트 머신을 통해 직접 펌웨어 업데이트)를 구현할 수 있습니다.
    • 설명: HID는 FLY 보드 내장 호스트 머신이 사용하는 Bootloader로, 본질적으로 Katapult와 동일합니다.
    • 중요 안내: Katapult 사용 시, 잘못된 펌웨어를 플래싱하여 메인보드가 응답하지 않게 되면, 메인보드의 리셋 버튼을 찾아 빠르게 두 번 연타하면 Katapult 모드로 다시 진입하여 재플래싱할 수 있습니다.

  • Bootloader 모드

    • 기능: 전통적인 메모리 카드를 통한 펌웨어 업데이트 방식입니다.
    • 장점: 이 방식은 오류 허용 범위가 넓습니다. 실수로 잘못 플래싱하더라도 메모리 카드를 다시 플래싱하여 재시도할 수 있으며, 메인보드가 "벽돌(brick)"이 될 걱정이 없습니다.

펌웨어 컴파일 가이드​

컴파일 준비 및 권장사항
  • 컴파일 성공률을 극대화하기 위해, MobaXterm 을 SSH 클라이언트로 사용하는 것을 권장합니다. 사용자 피드백에 따르면 일부 SSH 도구는 알 수 없는 컴파일 오류를 유발할 수 있습니다.
  • 중요 설정 항목: 컴파일 설정 화면에서 반드시 Enable extra low-level configuration options 옵션을 체크하세요. 그렇지 않으면 일부 고급 설정이 표시되지 않습니다.

시작 핀 설정 (GPIO pins to set at micro-controller startup)​

중요 안내
  • 이 옵션은 마이크로 컨트롤러 시작 시 특정 GPIO 핀의 전압 레벨을 강제로 설정하는 데 사용됩니다.
  • 영어 입력법으로 전환해야 합니다. 그렇지 않으면 펌웨어를 컴파일할 수 없습니다.

  • 설정 구문:

    • 핀 번호 앞에 !를 추가하면 시작 시 해당 핀을 LOW(낮은 전압)로 설정하고, !를 추가하지 않으면 HIGH(높은 전압)로 설정합니다.
    • STM32 시리즈: 핀 번호는 반드시 대문자여야 합니다(예: !PF8 또는 PF8).
    • RP2040 시리즈: 핀 번호는 반드시 소문자여야 합니다(예: !gpio5 또는 gpio5).

  • 다중 핀 설정: 여러 핀을 설정해야 하는 경우, 영어 쉼표 ,로 구분하세요.

    • 예시: !gpio5,!gpio19,gpio24는 시작 시 gpio5와 gpio19를 LOW로, 동시에 gpio24를 HIGH로 설정함을 의미합니다.
안전성 설명

GPIO pins to set at micro-controller startup에서 설정한 내용은 Klipper 시작 연결 전에만 유효합니다. Klipper가 연결을 완료하고 정상적으로 실행되면, 이 설정은 핀의 다른 모든 동작에 영향을 미치지 않으므로 안전하게 사용할 수 있습니다.

플래싱 실패 복구 및 일반 보호
  • 잘못된 펌웨어 플래싱 보호: Katapult, HID, Bootloader 이 세 가지 펌웨어 자체에 보호 메커니즘이 있습니다. 특별한 DFU 모드로 진입하여 플래싱하지 않는 한, 메인 펌웨어를 잘못 플래싱하더라도 이들은 덮어쓰여지지 않으며, 메인보드가 "벽돌(brick)"이 되지 않습니다.
  • 플래싱 완료 후 필수 작업: 모든 펌웨어 플래싱이 완료된 후, 반드시 하위 기기를 완전히 한 번 전원을 차단(전원 코드를 뽑음)한 후 다시 전원을 켜서 새 펌웨어가 올바르게 로드되고 안정적으로 실행되도록 하세요.

펌웨어 플래싱 설명​

플래싱 전 필독
  • 장치 인식: Katapult를 사용하여 플래싱할 때, 호스트 머신이 장치를 인식하는지 확인하세요. 장치를 찾을 수 없는 경우, 메인보드의 리셋 버튼을 빠르게 두 번 연타하여 플래싱 모드로 다시 진입하세요.
  • 규범 준수: 공식 튜토리얼의 플래싱 방법을 엄격히 따르세요. 검증되지 않은 다른 방법을 사용하면 장치 손상이 발생할 수 있습니다.
  • 컴파일 확인: 플래싱 전, 반드시 펌웨어에 컴파일 오류가 없는지 확인하세요. 오류가 있는 펌웨어 파일은 플래싱 실패나 장치 작동 불능을 초래합니다.

Katapult 펌웨어 잘못 플래싱 복구​

  1. 메인보드의 물리적 리셋 버튼을 찾아 빠르게 두 번 연타합니다.
  2. 정상적으로는 Fly 메인보드에 LED 표시등이 깜빡이기 시작하며, 이는 Katapult 모드에 성공적으로 진입했음을 나타냅니다.
  3. 이때 메인보드의 잘못된 펌웨어를 지우고 올바른 Klipper 펌웨어를 다시 플래싱할 수 있습니다.

Bootloader 펌웨어 잘못 플래싱 복구​

  1. 올바른 펌웨어가 저장된 TF 카드를 메인보드에 다시 삽입합니다.
  2. 플래싱이 되지 않으면, 먼저 완전히 전원을 차단하고, TF 카드를 삽입한 후 다시 전원을 켭니다.
  3. 약 5초 동안 전원을 유지하면 자동 플래싱이 완료됩니다.

Katapult 설치 및 플래싱 의존성​

⚠️ 중요
  • Fly 공식 호스트 머신이 아닌 경우, 반드시 다음 명령어를 실행하여 펌웨어 플래싱 의존성 패키지를 설치하세요!
  • 아래 저장소 중 하나만 선택하면 됩니다.
  • git 저장소 
    cd && git clone https://github.com/Arksine/katapult.git
  • gitee 저장소 
    cd && git clone https://gitee.com/MrCakeFuck/katapult.git
Loading...
Loading...