본문으로 건너뛰기

펌웨어 컴파일 설명

중요 안전 안내

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

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

펌웨어 유형 설명​

  • Katapult / HID 모드

    • 기능: 두 모드는 기능이 동일하며, 무접촉 플래싱을 구현할 수 있습니다(메모리 카드를 삽입/제거하지 않고 상위 컴퓨터를 통해 직접 펌웨어 업데이트).
    • 설명: HID는 FLY 온보드 상위 컴퓨터에서 사용하는 부트로더로, 그 본질은 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 시리즈: 핀 번호는 대문자여야 합니다(예: !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 모드로 진입하여 플래시하지 않는 한, 메인 펌웨어를 잘못 플래시하더라도 이들은 덮어쓰여지지 않으므로 메인보드가 "벽돌"이 되지 않습니다.
  • 플래싱 완료 후 필수 작업: 모든 펌웨어 플래싱이 완료된 후에는 반드시 하위 컴퓨터의 전원을 완전히 차단(전원 케이블 제거)한 다음 다시 전원을 켜서 새 펌웨어가 올바르게 로드되어 안정적으로 실행되도록 하십시오.

펌웨어 플래싱 설명​

플래싱 전 주의 사항
  • 장치 식별: 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...