본문으로 건너뛰기

펌웨어 컴파일 설명

중요 안내

시스템 안정적인 작동을 보장하기 위해 반드시 다음 펌웨어 사용 원칙을 준수하십시오:

  • 펌웨어 컴파일 일관성: Klipper 펌웨어는 반드시 현재 사용 중인 상위 컴퓨터에서 컴파일해야 합니다. 타인이 컴파일하거나 버전이 일치하지 않는 펌웨어를 사용하면 예측할 수 없는 시스템 오류가 발생할 수 있습니다.
  • 하드웨어 플랫폼 규정: 표준 상위 컴퓨터 하드웨어 사용을 강력히 권장합니다. 비공식 개조 장치(예: 일부 셋톱박스, WiFi 동글 또는 특정 Redmi 기기)는 호환성 및 안정성 문제가 있을 수 있으므로 사용을 피하십시오.
  • 가상화 환경 제한: 상위 컴퓨터 시스템을 가상 머신에서 실행하는 것은 권장되지 않습니다. 이는 성능 및 실시간성 간섭을 유발하여 출력 품질에 영향을 줄 수 있습니다.

펌웨어 유형 설명​

  • Katapult / HID 모드

    • 기능: 이 두 모드는 기능이 동일하며, 무접촉 업로드(메모리 카드를 빼지 않고 상위 컴퓨터를 통해 직접 펌웨어 업데이트)를 구현할 수 있습니다.
    • 설명: HID는 FLY 온보드 상위 컴퓨터에서 사용하는 Bootloader로, 본질은 Katapult와 동일합니다.
    • 중요 사항: Katapult 사용 시 잘못된 펌웨어를 업로드하여 메인보드가 응답하지 않는 경우, 메인보드의 리셋 버튼을 찾아 빠르게 두 번 누르면 Katapult 모드로 다시 진입하여 재업로드할 수 있습니다.

  • Bootloader 모드

    • 기능: 전통적인 메모리 카드를 통한 업로드 방식입니다.
    • 장점: 이 방식은 오류 허용 범위가 넓어, 잘못 업로드해도 메모리 카드를 다시 업로드하여 재시도할 수 있으므로 메인보드가 "벽돌"이 될 걱정이 없습니다.

펌웨어 컴파일 가이드​

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

시작 핀 구성 (GPIO pins to set at micro-controller startup)​

중요 사항
  • 이 옵션은 마이크로컨트롤러 시작 시 특정 GPIO 핀의 전압 레벨 상태를 강제로 설정하는 데 사용됩니다.
  • 펌웨어 컴파일을 위해 영어 입력 모드로 전환해야 합니다.

  • 구성 문법:

    • 핀 앞에 !를 추가하면 시작 시 해당 핀을 LOW(저전압)로 설정하고, !를 추가하지 않으면 HIGH(고전압)로 설정합니다.
    • STM32 시리즈: 핀 번호는 대문자 형식으로 사용해야 하며, 실제 메인보드 문서에 따라 입력하십시오.
    • RP2040 시리즈: 핀 번호는 소문자 형식으로 사용해야 하며, 실제 메인보드 문서에 따라 입력하십시오.

  • 다중 핀 구성: 여러 핀을 구성해야 하는 경우 영어 쉼표 ,로 구분하십시오.

    • 예시: !<pin_a>,!<pin_b>,<pin_c>는 시작 시 처음 두 핀을 LOW로 설정하고 세 번째 핀을 HIGH로 설정함을 의미합니다.
안전성 설명

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

업로드 실패 복구 및 일반 보호
  • 잘못된 펌웨어 업로드 보호: Katapult, HID 및 Bootloader 세 가지 펌웨어 자체에는 보호 메커니즘이 있습니다. 특수 DFU 모드로 업로드하지 않는 한, 메인 펌웨어를 잘못 업로드해도 이들은 덮어쓰이지 않으며 메인보드가 "벽돌"이 되지 않습니다.
  • 업로드 완료 후 필수 작업: 펌웨어 업로드가 완료된 후에는 반드시 하위 컴퓨터의 전원을 완전히 차단(전원 케이블 분리)한 후 다시 전원을 연결하여 새 펌웨어가 올바르게 로드되고 안정적으로 실행되도록 하십시오.

펌웨어 업로드 설명​

업로드 전 필수 사항
  • 장치 인식: Katapult로 업로드할 때 상위 컴퓨터가 장치를 인식할 수 있는지 확인하십시오. 장치를 찾을 수 없는 경우 메인보드의 리셋 버튼을 빠르게 두 번 눌러 업로드 모드로 다시 진입하십시오. 또는 메인보드의 BL 펌웨어를 다시 업로드하십시오.
  • 규정 준수: 공식 튜토리얼의 업로드 방법을 엄격히 준수하십시오. 검증되지 않은 다른 방법을 사용하면 장치가 손상될 수 있습니다.
  • 컴파일 확인: 업로드 전에 펌웨어에 컴파일 오류가 없는지 반드시 확인하십시오. 잘못된 펌웨어 파일은 업로드 실패 또는 장치 작동 불능을 초래합니다.

Katapult 펌웨어 업로드 오류 복구​

  1. 메인보드의 물리적 리셋 버튼을 찾아 빠르게 두 번 누릅니다.
  2. 정상적으로 작동하는 경우, Fly 메인보드에서 LED 표시등이 깜빡이기 시작하여 Katapult 모드에 진입했음을 나타냅니다.
  3. 이제 Katapult 모드로 진입하여 올바른 Klipper 펌웨어를 다시 업로드할 수 있습니다.

Bootloader 펌웨어 업로드 오류 복구​

  1. 올바른 펌웨어가 저장된 TF 카드를 메인보드에 다시 삽입합니다.
  2. 업로드가 불가능하면 전원을 완전히 차단한 후 TF 카드를 삽입하고 다시 전원을 연결합니다.
  3. 약 5초 동안 전원을 유지하면 자동 업로드가 완료됩니다.

Katapult 설치 및 업로드 종속성​

중요
  • Fly 공식 상위 컴퓨터가 아닌 경우 반드시 다음 명령어를 실행하여 펌웨어 업로드 종속성 패키지를 설치하십시오!
  • 아래 저장소 중 하나를 선택하면 됩니다.
  • github 저장소 
    cd && git clone https://github.com/Arksine/katapult.git
  • 중국 지역 미러 저장소 
    cd && git clone https://cnb.cool/3dmellow/public/katapult
Loading...
Loading...