Fly Host Installation and Usage Guide

Preparation

Power Requirements

• Power Standard: An independent power adapter of 5V / 2A or higher is required
• Prohibited: Except for the specific models listed below, powering via the 3D printer motherboard port is strictly forbidden
  • Supported motherboard-powered models: C8, GEMINI, C5, C5V1.1, C8P
• Risk Warning: Insufficient power will lead to unstable device operation, frequent restarts, and may cause hardware damage in the long term

Storage Medium Selection

Storage Type	Compatible Devices	Key Notes
TF Card	Compatible with all series	Universal solution, requires a standard card reader
M2WE Solid-State Card	Non-Lite/MINI-PAD series	Dedicated solution, must be used with the M2SD burner

TF Card Specifications Recommendations:

• Capacity: 16GB-128GB (32GB/64GB recommended)
• Speed Class: Class 10 or U1/U3
• Recommended Brands: SanDisk, Samsung, and other well-known brands

Burning Tool Preparation

• TF Card: Standard TF card reader
• M2WE Card: Dedicated M2SD burner (required)

System Image Matching

Select the corresponding system image based on the device's main control chip:

Main Control Chip	Compatible Device Models
H618	C8P, C5, C5-V1.1, PI-V3
H5	PI, PI-V2, GEMINI series, C8
H3	Lite2 series, MINI-PAD series

Image Download: FlyOS System Image Download Site

Companion Resources

• Hardware: Type-C cable supporting data transmission
• Software Toolkit: Includes terminal tools, drivers, formatting tools, etc.
  Loading...

---

System Installation Process

As the tutorial is quite long, please refer to the link below:

System Flashing

---

Device Startup and Connection

SSH Connection Tutorial

Hardware Connection

• Insert the storage card with the flashed system
• Connect the independent power adapter
• Use a Type-C data cable to connect to the computer

Power Supply Precautions

When starting the system for the first time, do not connect a screen (TFT or HDMI). A screen will increase power consumption, which may cause insufficient power and lead to system expansion failure.

If expansion fails, there is no way to repair it through other means; the system must be re-flashed.

Serial Terminal Configuration

• Launch MobaXterm software
• Create a new Serial session
• Select the CH340 serial port, baud rate 115200

System Startup Verification

• Observe the terminal log output after power-on
• Normal startup will display system operation information
• If there is no output, try pressing the Enter key to wake it up

Network Configuration

After the system startup is complete, configure the Wi-Fi connection via the command line

Network Connection Tutorial

Common Issues and Maintenance Guide

Startup Priority

• Issue: Boot order when both a TF card and an M2WE card are inserted
• Explanation: The system always boots from the TF card first, but this does not affect the M2WE card's Wi-Fi functionality after boot
• Solution: It is recommended to insert only one system card during daily use to avoid confusion

Storage Card Selection

• Issue: How beginners should choose the type of storage card
• Solution:
  • Recommended Option: TF card (high versatility, low cost, suitable for entry-level use)
  • Alternative Option: M2WE card (built-in Wi-Fi functionality, requires a dedicated burner)
  • Explanation: The system comes with pre-installed drivers for mainstream Wi-Fi modules; both TF cards and M2WE cards can be used directly

M2SD Contact Issues

• Issue: When using the M2SD burner, the M2WE card is unstable or fails to start
• Solution:
  • Temporary solution: Use a rubber band to reinforce the connection between the card body and the slot
  • Long-term solution: Install a dedicated fixing bracket
  • Fixing bracket download address:
    Loading...

---

Device Maintenance Guide

1. Shutdown Procedure

• Always perform a normal shutdown through system commands
• Directly disconnecting the power is strictly forbidden to prevent system damage

2. System Updates

• The system supports two update methods:
  1. Online Update: Completed automatically in the system background.
  2. Manual Update: Download the update package locally, then upload and install it through the system interface.
• Please note that the traditional FAST system full-disk flashing upgrade method remains applicable.

3. Configuration Backup

• Please regularly back up your printer configuration files to local storage devices
• Avoid configuration loss due to system issues

4. Power Management

• An independent power supply must be used
• Avoid power interference that may affect stable device operation

5. Storage Card Protection

• Do not format the storage card again after the system flashing is complete
• Prevent system file corruption that could prevent the device from booting

---

OTA Update Instructions

1. How to Perform an OTA Update

• Please access your host IP address in your browser and add the port number :9998 after it to access the OTA update interface.
  • Example: If the host IP is <device_ip>, then access http://<device_ip>:9998

2. Configuration File Safety

• OTA updates are specially designed not to overwrite or modify your personal configuration files

3. Precautions During the Update Process

• Ensure stable device power supply during the update
• An unexpected power outage will cause the update to fail, and in severe cases, the system may need to be re-flashed

4. Custom Code Handling

• If you have modified Klipper configuration files or installed custom plugins
• OTA updates will automatically skip related files, ensuring your modifications are preserved

5. Important Reminder: Firmware Update

• After each OTA update, be sure to manually compile the Klipper firmware and then re-flash the microcontroller firmware
• If you are using a C8P, C5, or C8 motherboard, you can directly use the system's built-in feature to update the firmware with one click, without manual compilation

Klipper Version Description

Version Correspondence

• The Klipper built into the FlyOS system automatically uses the system version number as its own version (e.g., FlyOS 1.3.0 means Klipper displays 1.3.0)
• The system has been specifically optimized and enhanced based on the upstream Klipper version:
  • Stability Optimization: Adapted and tuned for stability on the FLY hardware platform
  • Power Loss Resume: Supports resuming print tasks after an unexpected power outage
  • USB Printing: Supports sending G-code directly via USB for printing
  • Other Enhancements: FLY-specific features such as clog detection and power-off shutdown

Version Timeliness

• The Klipper version is locked at the time the system image is packaged
• For example: a system released on May 13, 2026, includes upstream features from at least May 10, 2026 (testing and verification take time)
• To obtain the latest Klipper features, you can update via OTA or compile manually

Screen Display Anomaly Resolution

Scenario One: The LOGO appears during boot, but there is no operation interface after startup

Solution:

1. Connect to the device via SSH and ensure it is connected to the network
2. Access the system configuration page through the browser
3. If using FLY Screen, find the fly_screen configuration item, change its value from 0 to 1, and set klipper_screen=0. If you need to use KlipperScreen, you can set klipper_screen to 1; when both klipper_screen=1 and fly_screen=1 are enabled simultaneously, the system defaults to KlipperScreen.

Loading...

In the figure, item ① is the screen number, and item ② is the screen display service switch.