Fly Host Installation and Usage Guide

Preparation

Power Requirements

• Power Supply Standard: Must use an independent power adapter of 5V / 2A or higher
• Prohibited Actions: Except for the specific models listed below, powering via the 3D printer motherboard interface is strictly prohibited
  • Models Supporting Motherboard Power Supply: C8, GEMINI, C5, C5V1.1, C8P
• Risk Warning: Insufficient power will cause unstable device operation and frequent restarts; long-term use may result in hardware damage

Storage Media Selection

Storage Type	Applicable Devices	Key Instructions
TF Card	Full series compatible	General solution, requires use with a standard card reader
M2WE Solid State Card	Non-Lite/MINI-PAD series	Dedicated solution, must be used with the M2SD programmer

TF Card Specification Recommendations:

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

Programmer Tool Preparation

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

System Image Matching

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

Main Control Chip	Applicable 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

Supporting Resources

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

---

System Installation Process

As the tutorial is lengthy, please refer to the link below:

System Flashing

---

Device Startup and Connection

SSH Connection Tutorial

Hardware Connection

• Insert the storage card with the system flashed onto it
• Connect the independent power adapter
• Connect the computer using a Type-C data cable

Power Supply Precautions

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

If expansion fails, it cannot be fixed by other means; the system must be re-flashed.

Serial Terminal Configuration

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

System Startup Verification

• Observe the terminal log output after powering 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 starts up completely, configure the Wi-Fi connection via the command line

Network Connection Tutorial

Frequently Asked Questions and Maintenance Guide

Startup Priority

• Question: Boot order when both a TF card and an M2WE card are inserted simultaneously
• Explanation: The system always boots from the TF card first, but this does not affect the WiFi functionality of the M2WE card after startup
• Solution: It is recommended to only insert a single system card during daily use to avoid confusion

Storage Card Selection

• Question: How to choose the type of storage card as a beginner?
• Solution:
  • Recommended Solution: TF card (highly versatile, low cost, suitable for beginners)
  • Alternative Solution: M2WE card (has built-in WiFi function, requires a dedicated programmer)
  • Explanation: The system has mainstream WiFi module drivers pre-installed; both TF and M2WE cards can be used directly

M2SD Contact Issues

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

---

Device Maintenance Guide

1. Shutdown Process

• Always perform a normal shutdown via system commands
• Never disconnect power directly to avoid system damage

2. System Update

• The system supports two update methods:
  1. Online Update: Automatically performed in the system backend.
  2. Manual Update: Download the update package locally, then upload and install it via the system interface.
• Please note that the traditional FAST system full-disk flash update method is still applicable.

3. Configuration Backup

• Regularly back up printer configuration files to local storage
• Prevent configuration loss due to system issues

4. Power Management

• Must use an independent power supply
• Avoid power interference affecting stable device operation

5. Storage Card Protection

• Do not format the storage card again after the system is flashed
• Prevent system file corruption leading to device boot failure

---

OTA Update Instructions

1. How to Perform an OTA Update

• Access your host device's IP address in a browser, and append the port number :9998 to access the OTA update interface.
  • Example: If the host IP is <device_ip>, then access http://<device_ip>:9998

2. Configuration File Safety

• The OTA update is specially designed not to overwrite or modify your personal configuration files

3. Precautions During Update Process

• Ensure stable power supply to the device during the update
• Unexpected power loss will cause the update to fail; in severe cases, the system may need to be re-flashed

4. Handling Custom Code

• If you have modified the Klipper configuration file or installed custom plugins
• The OTA update will automatically skip relevant files, ensuring your modifications are preserved

5. Important Reminder: Firmware Update

• After each OTA update, you must manually compile the klipper firmware, then re-flash the lower computer firmware
• If you are using a C8P, C5, or C8 motherboard, you can directly update the firmware with one click via the system's built-in function, no manual compilation needed

Klipper Version Description

Version Correspondence

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

Version Timeliness

• The Klipper version is locked in at the time the system image is packaged.
• For example: A system released on May 13, 2026, will contain Klipper features from the upstream as of at least May 10, 2026 (testing and validation take time).
• To get the latest Klipper features, perform an OTA update or compile manually.

Screen Display Anomaly Troubleshooting

Scenario 1: Shows LOGO on boot, but no operating interface after startup

Solutions:

1. Connect to the device via SSH and ensure it is connected to the network
2. Enter the system configuration page via a 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, the system defaults to using KlipperScreen.

Loading...

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