OTA System Update Guide

This document details the OTA (Over-The-Air) update feature of the FlyOS-Fast system, helping you upgrade the system safely and conveniently.

Version Support Notes

• V1.3.0 and above: Supports OTA online update functionality
• V1.3.3 and above: Adds USB drive system update method
• V1.3.10 and above: When the upgrade package requires syncing MCU firmware, the USB firmware of supported motherboards can be automatically updated during the first startup phase after OTA

Pre-installed Service Version Notes

The FlyOS-Fast system comes with mainstream services such as Klipper, RRF, Mainsail, Fluidd, Moonraker, and KlipperScreen. These services follow the following version management strategy during system packaging:

Targeted Optimizations

We have made specific targeted optimizations for core services such as Klipper, Mainsail, Fluidd, Moonraker, and KlipperScreen to enhance system stability and printing performance.

Important Warning

Do not manually upgrade or replace these services. Manual switching will render the targeted optimizations ineffective and may affect system stability and functional compatibility. If updates are needed, please obtain the latest version through official OTA methods.

Update Strategy

System OTA packages provide system components that have been adapted and tested. Release versions do not guarantee complete alignment with the latest commits of each upstream project. Please refer to the contents listed in the FlyOS-Fast changelog.

Notes

Due to the interdependent relationships between system components, do not separately replace Klipper, Moonraker, web interfaces, or screen services outside of OTA. If you have specific version requirements, please contact technical support.

Update Method Selection

• Network Online Update
• Manual Update
• USB Drive Offline Update

Network Update Requirements

• The device is connected to the internet
• System version is V1.3.0 or higher

Procedure

1. Access in a browser: http://[device IP address]:9998
2. The system will automatically check for available updates
3. If a new version is available, click the "Update" button to start the upgrade
4. Wait for the system to automatically download and install the update

Tip: Do not power off or perform printing operations during the update

Uploading a Local Upgrade Package

If the device cannot obtain a version from the online update source, you can also upload a local upgrade package on the OTA management page:

1. Access http://[device IP address]:9998 in a browser.
2. Find the Manual Upload Upgrade Package area, drag the upgrade package into the upload box, or click Browse Files to select a file.
3. Select an upgrade package ending with .full.fup or .diff.fup. The page will reject other extensions.
4. Wait for the page to complete file verification and upload, and confirm that the file name, device model, and version information are correct.
5. Click Upload and Upgrade, confirm the prompt, and start the update.
6. Wait for the upload, verification, writing, and restart to all complete, then access the web page again.

Local Upgrade Package Requirements

• .full.fup is a complete system package, typically used for cross-version upgrades or system recovery.
• .diff.fup is a differential upgrade package and can only be used for the source versions it explicitly supports.
• The upgrade package must match the device model and system partition; do not upload files from other devices.
• Maintain a stable power supply during upload and writing. Do not close the page, disconnect the network, remove the USB drive, or manually restart the device.

Preparation

USB Drive Update Requirements

• System version is V1.3.3 or higher

USB Drive Requirements

• Interface type: A USB 2.0 USB drive or card reader must be used
• Storage capacity: At least 8GB of available space
• Compatibility tip: USB 3.0 devices (blue interface) may cause slow upgrades

System Package Download

Please download the corresponding full system upgrade package based on the device model:

Go to Download Page

Update Process

Step 1: Prepare the Upgrade File

1. Go to the system download page to obtain the upgrade package for the corresponding device
2. Copy the downloaded .full.fup file to the root directory of the USB drive

File Matching Verification

• Ensure that the upgrade package fully matches the device model
• If the file does not match, the system will not display any prompt after the USB drive is inserted

Step 2: Trigger the Update

1. Insert the prepared USB drive into the device's USB port
2. After the system detects the update file, an update prompt will automatically pop up

Locations where the prompt is displayed:

• 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 outages
• It is recommended to back up important configuration files in advance

Operations After Update

• Follow the on-screen prompts to wait for the system to complete the update and reboot; if the upgrade package requires updating the MCU, the system will only automatically handle USB firmware on supported motherboards
• Maintain stable power during the update, do not power off the device, start printing, or manually reboot
• After re-entering the web interface, check the system version and the connection status of Klipper and Moonraker
• Motherboards and firmware not covered by automatic update support need to be manually updated according to the corresponding product tutorials

Automatic MCU Firmware Update After OTA

Only the following motherboards are supported

The OTA MCU firmware automatic update feature only supports the following motherboards:

• FLY-C8
• FLY-C5
• FLY-C8P
• FLY-GEMINI V3

The above motherboards must use USB communication firmware. Other motherboards, CAN firmware, USB-to-CAN firmware, CAN tool boards, and other external MCUs do not support automatic firmware updates via OTA.

For devices not within the supported range, please manually compile and flash the firmware according to the corresponding product documentation.

If the upgrade package requires updating the MCU firmware of supported motherboards, the system will handle it automatically during the first startup phase after OTA. Before starting OTA, confirm that the motherboard's USB connection is normal, and after the update is complete, check whether Klipper can connect properly.

Do not operate the device during the update

During automatic MCU updates, do not power off, reboot, start printing, or unplug/plug USB cables. Interrupting the flashing process may cause the MCU to become unreachable, requiring manual recovery by following the corresponding motherboard's firmware flashing tutorial.

---

With the steps above, you can easily complete the OTA update for the FlyOS-Fast system.