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 specific models below, supplying power via the 3D printer mainboard interface is strictly prohibited
  • Models Supporting Mainboard Power: C8, GEMINI, C5, C5V1.1, C8P
• Risk Notice: Insufficient power supply will lead to unstable device operation and frequent restarts, potentially causing hardware damage over time

Storage Medium Selection

Storage Type	Applicable Devices	Key Notes
TF Card	Full series compatible	Universal solution, requires a standard card reader
M2WE Solid State Card	Non-Lite/MINI-PAD series	Dedicated solution, must use the M2SD burner

TF Card Specification Recommendations:

• Capacity: 16GB-128GB (32GB/64GB recommended)
• Speed Class: Class10 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	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 Burning

---

Device Startup and Connection

SSH Connection Tutorial

Hardware Connection

• Insert the memory card with the system burned 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). The screen increases power consumption, which may cause insufficient power supply, leading to system expansion failure.

If expansion fails, it cannot be repaired by other means; you must re-burn the system.

Serial Terminal Configuration

• Launch 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 system startup completes, configure the Wi-Fi connection via the command line

Network Connection Tutorial

Common Issues and Maintenance Guide

Startup Priority

• Issue: The startup 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 Wi-Fi function 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

• Issue: How beginners should choose the type of storage card
• Solution:
  • Recommended Option: TF card (strong universality, low cost, suitable for beginners)
  • Alternative Option: M2WE card (built-in Wi-Fi function, requires a dedicated burner)
  • Note: The system has mainstream Wi-Fi module drivers pre-installed; both TF cards and M2WE cards can be used directly

M2SD Contact Issues

• Issue: When using the M2SD burner, the M2WE card may be unstable or fail 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 via system commands
• Never disconnect the power directly to avoid system damage

2. System Update

• The system supports two update methods:
  1. Online Update: Completed automatically 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 burning upgrade method is still applicable.

3. Configuration Backup

• Regularly back up the printer configuration files to a local storage device
• Avoid losing configurations 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 memory card again after system burning is complete
• Prevent system file corruption, which can cause the device to fail to start

---

OTA Update Instructions

1. How to Perform an OTA Update

• Access your host'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>, 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 power supply to the device during the update
• Unexpected power loss will cause the update to fail, potentially requiring a system re-burn

4. Handling Custom Code

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

5. Important Reminder: Firmware Update

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

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., if FlyOS is 1.3.0, Klipper displays as 1.3.0)
• The system has undergone targeted optimizations and feature enhancements based on the upstream Klipper version:
  • Stability Optimization: Adaptation and stability tuning for FLY hardware platforms
  • 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, power-off shutdown, etc.

Version Timeliness

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

Screen Display Abnormalities Troubleshooting

Situation 1: Shows LOGO on startup, but no operation interface after booting

Troubleshooting:

1. Connect to the device via SSH and ensure it is connected to the network
2. Enter the system configuration page through a browser
3. Locate the klipper_screen configuration item, change its value from 0 to 1

Loading...

In the image, number ① indicates the screen number, number ② indicates the screen display service switch.