OTA System Update Guide
This document details the OTA (Over-The-Air) update functionality of the FlyOS-Fast system, helping you upgrade your system safely and conveniently.
Version Support Notes
- V1.3.0 and above: Supports OTA online update function
- V1.3.3 and above: Adds USB drive system update method
Built-in Service Version Notes
The FlyOS-Fast system includes built-in mainstream services such as Klipper, RRF, Mainsail, Fluidd, Moonraker, and KlipperScreen. These services follow the following version management strategy during system packaging:
Targeted Optimization
We have performed specific targeted optimizations on core services such as Klipper, Mainsail, Fluidd, Moonraker, and KlipperScreen to enhance system stability and printing performance.
Do not manually upgrade or replace these services. Manual changes will invalidate the targeted optimizations, potentially affecting system stability and feature compatibility. For updates, please obtain the latest version through the official OTA method.
Version Timeliness Guarantee
All service components integrated during system packaging are the latest official versions at the time of build, with a version delay controlled within 48 hours.
Update Strategy
During the system image compilation phase, the latest stable versions are pulled from each service's official repository for integration. An intelligent update strategy is adopted: Any files or repositories that have been modified will skip the update and retain the existing version.
Precautions
Due to the time required for system build and testing processes, the service versions integrated in the actual released system image may differ from the latest official version by up to two days. This is normal. If you have specific version requirements or questions, please contact technical support.
Update Method Selection
- Network Online Update
- USB Drive Offline Update
Network Update Requirements
- Device is connected to the internet
- System version is
V1.3.0or higher
Steps
- Access in browser:
http://[Device IP Address]:9998 - The system will automatically check for available updates
- If a new version is available, click the "Update" button to start the upgrade
- Wait for the system to automatically download and install the update
Note: Do not power off or perform printing operations during the update process.
Preparation
USB Drive Update Requirements
- System version is
V1.3.3or higher
USB Drive Requirements
- Interface Type: Must use a USB 2.0 flash drive or card reader
- Storage Capacity: At least 8GB of available space
- Compatibility Note: USB 3.0 devices (blue interface) may cause slow upgrades
System Package Download
Download the corresponding full system upgrade package based on your device model:
Go to Download PageUpdate Process
Step 1: Prepare the Upgrade File
- Go to the system download page to get the upgrade package for your device
- Copy the downloaded
.full.fupfile to the root directory of the USB drive
- Ensure the upgrade package exactly matches the device model
- If the files do not match, the system will not display any prompts after inserting the USB drive.
Step 2: Trigger the Update
- Insert the prepared USB drive into the device's USB port
- The system will automatically detect the update file and display an update prompt
Prompt Display Locations:
- Web Management Interface: Mainsail / Fluidd interface
- WiScreen 7-inch Screen: Dedicated serial screen
- KlipperScreen: Does not display update prompts; please use the web interface
Step 3: Execute the Update
On the interface where the update prompt appears, click the "Start Update" button, and the system will automatically complete the entire upgrade process.
Update Precautions
General Safety Tips
- Pause all printing tasks before updating
- Ensure stable device power supply to avoid unexpected power loss
- It is recommended to back up important configuration files in advance
Post-Update Actions
- After completing the OTA update, please recompile the Klipper firmware
- It is recommended to restart the device to ensure all services load correctly
By following the steps above, you can easily complete the OTA update for the FlyOS-Fast system. For any questions, please contact our technical support team.