펌웨어 컴파일 설명

중요한 안전 안내

시스템이 안정적으로 작동하도록 하기 위해 다음 펌웨어 사용 원칙을 반드시 준수하십시오:

• 펌웨어 컴파일 일관성: Klipper 펌웨어는 현재 사용 중인 호스트 컴퓨터에서 컴파일되어야 합니다. 다른 사람이 컴파일한 펌웨어 또는 버전이 맞지 않는 펌웨어를 사용하면 예상치 못한 시스템 오류가 발생할 수 있습니다.
• 하드웨어 플랫폼 사양: 표준 호스트 컴퓨터의 사용을 강력히 권장합니다. 공식이 아닌 수정이 가해진 장치(예: 특정 셋톱박스, 와이파이 동글 또는 특정 레드미 기종 등)는 호환성 및 안정성 문제가 있을 수 있으므로 사용을 피하십시오.
• 가상화 환경 제한: 호스트 컴퓨터 시스템을 가상 머신에서 실행하는 것은 권장하지 않습니다. 이는 성능 및 실시간성 간섭을 유발하여 프린팅 품질에 영향을 줄 수 있습니다.

펌웨어 유형 설명

• Katapult / HID 모드

  • 기능: 두 모드의 기능은 동일하며, 접촉 없이 펌웨어를 플래싱(메모리 카드의 삽입/제거 없이 호스트 컴퓨터를 통해 직접 펌웨어 업데이트)할 수 있습니다.
  • 설명: HID는 FLY 보드에 내장된 호스트 컴퓨터에서 사용하는 부트로더이며, 본질적으로 Katapult와 같습니다.
  • 중요 안내: Katapult 모드를 사용할 때 잘못된 펌웨어를 플래싱하여 메인보드가 응답하지 않는 경우, 메인보드의 리셋 버튼을 빠르게 두 번 클릭하면 Katapult 모드로 다시 진입하여 재플래싱할 수 있습니다.

• Bootloader 모드

  • 기능: 기존 방식인 메모리 카드를 통한 플래싱 방법입니다.
  • 장점: 이 방법은 오류에 대한 내성이 강합니다. 실수로 잘못된 펌웨어를 플래싱하더라도 메모리 카드에 다시 펌웨어를 플래싱하면 되므로 메인보드가 '브릭'(brick) 상태가 될 걱정이 없습니다.

펌웨어 컴파일 가이드

컴파일 준비 및 권장 사항

• 컴파일 성공 가능성을 최대한 높이기 위해 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를 낮은 전위로, gpio24는 높은 전위로 설정한다는 의미입니다.

보안 설명

설정하신 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초 동안 전원을 유지하면 자동으로 플래싱이 완료됩니다.