Skip to main content

🚀 Quick Start

🎯 Goal of this guide: Within 30 minutes, complete the system deployment and firmware flashing for the Fly-Gemini mainboard, bringing it to a state where it can connect to Klipper and perform basic tests.
✅ Completion indicator: Access the Klipper interface via a web browser and successfully connect to the Fly-Gemini mainboard.

📍 Important Notes
  • 📦 Required Accessories: Fly-Gemini must be used with Fly-M2WE or a TF card, otherwise the system will not boot.
  • ⚡ Power Requirements: Input voltage range is 12V-24V. Do not exceed this range.
  • 🔌 Safe Operation: Always disconnect power before performing any wiring operations! When flashing firmware, please follow the guide's instructions.
  • 🔧 Tool Preparation: Prepare basic tools like screwdrivers and data cables in advance.

📦 Step 1: Prepare Tools & Resources

Loading...


📝 Contents Included
  • MobaXterm (for connecting to the host computer)
  • CH340 (serial port driver for system connection)
  • Panasonic_SDFormatter (for formatting TF cards)
  • SetupSTM32CubeProgrammer (for flashing the lower computer firmware)

🖥️ Step 2: Install System & Basic Configuration

1. System Image Flashing

2. System Basic Configuration

3. Network & Remote Connection

4. Display Device Configuration



📝 Notes for this Step
  • Ensure the TF card or M2WE is correctly formatted before flashing the image.
  • The first system boot may take 3-5 minutes; please be patient.
  • Default SSH credentials: username: root, password: mellow.
  • Screen configuration is only needed if you have a screen device.

🔌 Step 3: Flash Firmware & Device Identification

Why is this step needed? The previous step installed the operating system for the host computer (computing module). This step is to flash the Klipper firmware onto the lower computer (the Fly-Gemini control board itself). Both need to be paired to work.

1. Firmware Explanation & DIP Switch Selection

2. Flash USB Firmware or CAN Bridge Firmware

  • Choose to flash the corresponding firmware based on your connection method.
📝 Notes for this Step
  • Ensure the mainboard's DIP switch is set to the correct position before flashing firmware, otherwise the device may not be recognized.
  • The Device ID is essential information for Klipper configuration; please obtain it correctly.
  • If flashing fails, try flashing the BL firmware first, then flash the main firmware.

🛠️ Step 4: Hardware Connection & Interface Configuration

1. Basic Hardware Connections

2. Klipper Reference Configuration

3. External Driver Connection & Configuration (Optional Feature)

4. Mainboard Precautions

📝 Notes for this Step
  • Strongly Recommended: Ensure power is completely disconnected before performing any wiring operations.
  • Confirm power polarity is correct; reversing it may damage the mainboard.
  • Refer to your printer frame diagram for motor wiring sequence.
  • Check thermocouple connections before heating the heated bed and hotend.

📈 Step 5: Extended Features & Advanced Configuration (Optional)

The following features can be configured step-by-step as needed after completing the basic setup and ensuring the printer operates normally:

📝 Extended Features & Advanced Configuration

Camera Usage

External Toolboard

Resource Download


  • It is recommended to configure and test extended features one by one to avoid changing too many parameters simultaneously.
  • Camera configuration requires an additional USB camera device.
  • Resonance compensation requires an accelerometer sensor.
  • Toolboard connection is suitable for multi-toolhead 3D printers.

Loading...