Skip to main content

Fly Host Machine Installation and Usage Guide

I. Preparation​

1. Power Requirements​

  • Power 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: C8, GEMINI, C5, C5V1.1, C8P
  • Risk Notice: Insufficient power supply will lead to unstable device operation, frequent restarts, and may cause hardware damage over time

2. Storage Medium Selection​

Storage TypeCompatible DevicesKey Notes
TF CardFull series compatibleUniversal solution, requires a standard card reader
M2WE Solid State CardNon-Lite/MINI-PAD seriesDedicated solution, must be used with an M2SD programmer

TF Card Specifications Recommendation:

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

3. Programming Tool Preparation​

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

4. System Image Matching​

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

Main Control ChipCompatible Device Models
H618C8P, C5, C5-V1.1, PI-V3
H5PI, PI-V2, GEMINI series, C8
H3Lite2 series, MINI-PAD series

Image Download: FlyOS System Image Download Site

5. Supporting Resources​

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

II. System Installation Process​

  • Due to the lengthy tutorial, please refer to the link below
  • System Flashing

III. Device Startup and Connection​

  • SSH Connection Tutorial

1. Hardware Connection​

  • Insert the storage card with the system flashed
  • Connect the independent power adapter
  • Connect the Type-C data cable to the computer
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 lead to insufficient power supply, causing the system expansion to fail.

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

2. Serial Terminal Configuration​

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

3. System Startup Verification​

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

4. Network Configuration​

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

  • Network Connection Tutorial

IV. Frequently Asked Questions and Maintenance Guide​

Boot Priority​

  • Problem: The boot sequence when both a TF card and an M2WE card are inserted
  • Explanation: The system always boots from the TF card first, but the M2WE card's WiFi function remains unaffected after booting
  • Solution: It is recommended to use only a single system card for daily use to avoid confusion

Storage Card Selection​

  • Problem: How beginners should choose the type of storage card
  • Solution:
    • Recommended Solution: TF Card (strong versatility, low cost, suitable for beginners)
    • Alternative Solution: M2WE Card (has built-in WiFi function, requires a dedicated programmer)
    • Explanation: The system comes with pre-installed drivers for mainstream WiFi modules, allowing both TF cards and M2WE cards to be used directly

M2SD Contact Issues​

  • Problem: M2WE card recognition is unstable or fails to boot when using the M2SD programmer
  • Solution:
    • Temporary Fix: Use a rubber band to reinforce the connection between the card body and the slot
    • Long-term Solution: Install dedicated fixing components
    • Fixing Components Download:
      Loading...

Device Maintenance Guide​

1. Shutdown Procedure

  • Always perform a normal shutdown using system commands
  • Do not disconnect the power directly, as this may damage the system

2. System Update

  • The system supports two update methods:
    1. Online Update: Performed automatically in the system background.
    2. Manual Update: After downloading the update package locally, upload and install it via the system interface.
  • Please note that the traditional method of flashing the entire FAST system is still applicable.

3. Configuration Backup

  • Regularly backup your printer configuration files to local storage
  • 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 reformat the storage card after system flashing
  • Prevent system file damage that could cause the device to fail to boot

OTA Update Instructions​

1. How to Perform OTA Update

  • Access your host machine's IP address in the browser and add the port number :9998 to access the OTA update interface.
    • Example: If your host machine's IP is 192.168.1.100, access http://192.168.1.100:9998

2. Configuration File Safety

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

3. Precautions During Update

  • Ensure stable power supply to the device during the update
  • An unexpected power failure will cause the update to fail, potentially requiring a system re-flash in severe cases

4. Custom Code Handling

  • If you have modified Klipper configuration files or installed custom plugins
  • During OTA updates, relevant files will be automatically skipped, ensuring your modifications are preserved

5. Important Reminder: Firmware Update

  • After each OTA update, be sure to manually compile the Klipper firmware, then re-flash the lower-level device 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 required

Klipper Version Description​

Version Correspondence
  • The Klipper built into the FlyOS system will automatically use the system version number as its own version (e.g., FlyOS 1.3.0 will show Klipper as 1.3.0)
  • The system provides targeted optimizations and feature enhancements based on the upstream Klipper version:
    • Stability Optimization: Adaptation and stability tuning for FLY hardware platforms
    • Power Loss Recovery: Supports resuming print tasks after an unexpected power failure
    • USB Printing: Supports sending G-code directly via USB for printing
    • Other Enhancements: FLY-specific features such as filament jam detection, power-off shutdown, etc.
Version Timeliness
  • The system image locks the Klipper version at the time of packaging
  • For example: A system released on May 13, 2026, its Klipper includes at least upstream features from May 10, 2026 (testing and verification time required)
  • To obtain the latest Klipper features, perform an OTA update or manual compilation

Screen Display Abnormalities Troubleshooting​

Situation 1: Logo appears on boot, but no operation interface after startup

Solution:

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

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

Loading...