OTA 시스템 업데이트 가이드
이 문서는 FlyOS-Fast 시스템의 OTA(Over-The-Air) 업데이트 기능을 자세히介绍하며, 안전하고 편리하게 시스템을 업그레이드할 수 있도록 도와드립니다.
버전 지원 설명
- V1.3.0 이상: OTA 온라인 업데이트 기능 지원
- V1.3.3 이상: USB 드라이브를 통한 시스템 업데이트 방식 추가
- V1.3.10 이상: 업그레이드 패키지에 MCU 펌웨어 동기화가 필요한 경우, OTA 후 최초 부팅 단계에서 지원되는 메인보드의 USB 펌웨어를 자동으로 업데이트할 수 있습니다.
사전 설치 서비스 버전 설명
FlyOS-Fast 시스템에는 Klipper, RRF, Mainsail, Fluidd, Moonraker, KlipperScreen 등의 주요 서비스가 내장되어 있으며, 이러한 서비스는 시스템 패키징 시 다음 버전 관리 전략을 따릅니다.
맞춤형 최적화
당사는 Klipper, Mainsail, Fluidd, Moonraker, KlipperScreen 등 핵심 서비스에 대해 맞춤형 최적화를 수행하여 시스템 안정성과 인쇄 성능을 향상시켰습니다.
이러한 서비스를 수동으로 업그레이드하거나 교체하지 마십시오. 수동으로 전환하면 맞춤형 최적화가失效되어 시스템 안정성과 기능 호환성에 영향을 줄 수 있습니다. 업데이트가 필요한 경우 공식 OTA 방식을 통해 최신 버전을获取하십시오.
업데이트 전략
시스템 OTA 패키지는 검증되고 테스트된 시스템 구성 요소를 함께 제공합니다. 릴리스 버전은 각 업스트림 프로젝트의 최신 커밋과 완전히 일치한다고 보장하지 않으며, FlyOS-Fast 업데이트 로그에 명시된 내용을 기준으로 합니다.
주의 사항
시스템 구성 요소 간에는 연동 관계가 있으므로 OTA 외에 Klipper, Moonraker, 웹 인터페이스 또는 화면 서비스를 개별적으로 교체하지 마십시오. 특정 버전 요구 사항이 있는 경우 기술 지원에 문의하십시오.
업데이트 방식 선택
- 네트워크 온라인 업데이트
- 수동 업데이트
- USB 드라이브 오프라인 업데이트
네트워크 업데이트 조건
- 기기가 인터넷에 연결되어 있어야 합니다
- 시스템 버전이
V1.3.0이상이어야 합니다
작업 단계
- 브라우저에서 접속:
http://[기기 IP 주소]:9998 - 시스템이 자동으로 사용 가능한 업데이트를 확인합니다
- 새 버전이 있으면 "업데이트" 버튼을 클릭하여 업그레이드를 시작합니다
- 시스템이 자동으로 다운로드 및 설치를 완료할 때까지 기다립니다
팁: 업데이트 중에는 전원을 끄거나 프린팅 작업을 하지 마세요
로컬 업그레이드 패키지 업로드
기기가 온라인 업데이트 소스에서 버전을 가져올 수 없는 경우, OTA 관리 페이지에서 로컬 업그레이드 패키지를 업로드할 수도 있습니다:
- 브라우저에서
http://[기기 IP 주소]:9998에 접속합니다. - 수동 업그레이드 패키지 업로드 영역을 찾아 업그레이드 패키지를 업로드 상자에 드래그하거나 파일 찾아보기를 클릭하여 파일을 선택합니다.
.full.fup또는.diff.fup로 끝나는 업그레이드 패키지를 선택합니다. 다른 확장자는 페이지에서 거부됩니다.- 페이지에서 파일 검증 및 업로드가 완료될 때까지 기다리고, 파일 이름, 기기 모델, 버전 정보가 올바른지 확인합니다.
- 업로드 및 업그레이드를 클릭하고 확인 메시지 후 업데이트를 시작합니다.
- 업로드, 검증, 쓰기 및 재부팅이 모두 완료될 때까지 기다린 후 웹페이지에 다시 접속합니다.
.full.fup는 전체 시스템 패키지로, 일반적으로 버전 간 업그레이드 또는 시스템 복구에 사용됩니다..diff.fup는 차등 업그레이드 패키지로, 명시적으로 지원하는 소스 버전에만 사용할 수 있습니다.- 업그레이드 패키지는 기기 모델 및 시스템 파티션과 일치해야 합니다. 다른 기기의 파일을 업로드하지 마세요.
- 업로드 및 쓰기 중에는 안정적인 전원을 유지하고, 페이지를 닫거나 네트워크를 끊거나 USB 드라이브를 뽑거나 기기를 수동으로 재부팅하지 마세요.
준비 작업
USB 드라이브 업데이트 조건
- 시스템 버전이
V1.3.3이상이어야 합니다
USB 드라이브 요구사항
- 인터페이스 유형: 반드시 USB 2.0 USB 드라이브 또는 카드 리더기를 사용해야 합니다
- 저장 용량: 최소 8GB의 사용 가능한 공간
- 호환성 안내: USB 3.0 기기(파란색 인터페이스)는 업그레이드가 느려질 수 있습니다
시스템 패키지 다운로드
기기 모델에 맞는 시스템 전체 업그레이드 패키지를 다운로드하세요:
다운로드 페이지로 이동업데이트流程
첫 번째 단계: 업그레이드 파일 준비
- 시스템 다운로드 페이지에서 해당 기기의 업그레이드 패키지를 가져옵니다
- 다운로드한
.full.fup파일을 USB 드라이브 루트 디렉토리에 복사합니다
- 업그레이드 패키지가 기기 모델과 완전히 일치하는지 확인하세요
- 파일이 일치하지 않으면 USB 드라이브를 삽입해도 시스템에서 아무런 알림이 표시되지 않습니다
두 번째 단계: 업데이트 트리거
- 준비된 USB 드라이브를 기기의 USB 인터페이스에 삽입합니다
- 시스템이 업데이트 파일을 감지하면 자동으로 업데이트 알림이 팝업됩니다
알림 표시 위치:
- 웹 관리 인터페이스: Mainsail / Fluidd 인터페이스
- WiScreen 7인치 화면: 전용 시리얼 화면
- KlipperScreen: 업데이트 알림이 표시되지 않으므로 웹 인터페이스를 사용하세요
세 번째 단계: 업데이트 실행
업데이트 알림이 나타난 인터페이스에서 "업데이트 시작" 버튼을 클릭하면 시스템이 전체 업그레이드 과정을 자동으로 완료합니다.
업데이트 주의 사항
일반 안전 안내
- 업데이트 전에 모든 인쇄 작업을 일시 중지하십시오.
- 장치 전원 공급이 안정적인지 확인하고 예기치 않은 정전을 방지하십시오.
- 중요한 구성 파일은 사전에 백업하는 것이 좋습니다.
업데이트 후 작업
- 페이지 안내에 따라 시스템이 업데이트 및 재부팅을 완료할 때까지 기다리십시오. 업그레이드 패키지에 MCU 업데이트가 필요한 경우 시스템은 지원되는 메인보드의 USB 펌웨어만 자동으로 처리합니다.
- 업데이트 중에는 전원 공급을 안정적으로 유지하고 장치를 끄거나 인쇄를 시작하거나 수동으로 재부팅하지 마십시오.
- 웹 페이지에 다시 접속한 후 시스템 버전과 Klipper, Moonraker 연결 상태를 확인하십시오.
- 자동 업데이트 지원 범위에 포함되지 않는 메인보드와 펌웨어는 해당 제품 튜토리얼에 따라 수동으로 업데이트해야 합니다.
OTA 후 MCU 펌웨어 자동 업데이트
OTA의 MCU 펌웨어 자동 업데이트 기능은 다음 메인보드만 지원합니다:
- FLY-C8
- FLY-C5
- FLY-C8P
- FLY-GEMINI V3
위 메인보드는 반드시 USB 통신 펌웨어를 사용해야 합니다. 다른 메인보드, CAN 펌웨어, USB-투-CAN 펌웨어, CAN 툴보드 및 기타 외부 MCU는 OTA 자동 펌웨어 업데이트를 지원하지 않습니다.
지원 범위에 포함되지 않는 장치는 해당 제품 문서에 따라 펌웨어를 수동으로 컴파일하고 플래시하십시오.
업그레이드 패키지에 지원되는 메인보드의 MCU 펌웨어 업데이트가 필요한 경우, 시스템은 OTA 후 최초 부팅 단계에서 자동으로 처리합니다. OTA를 시작하기 전에 메인보드의 USB 연결이 정상인지 확인하고, 업데이트 완료 후 Klipper가 정상적으로 연결되는지 확인하십시오.
MCU를 자동으로 업데이트하는 동안 전원을 차단하거나 재부팅하거나 인쇄를 시작하거나 USB 케이블을 분리/삽입하지 마십시오. 플래시가 중단되면 MCU에 연결할 수 없게 될 수 있으며, 해당 메인보드의 펌웨어 플래시 튜토리얼에 따라 수동으로 복구해야 합니다.
위 단계를 통해 FlyOS-Fast 시스템의 OTA 업데이트를 쉽게 완료할 수 있습니다.