System Configuration Modification

Important Notes

Must Read

• Settings in the configuration file will only take effect the first time the system starts after flashing.
• As the configuration process is relatively complicated, it is highly recommended to connect to the device via network and then configure through a browser.
• This tutorial only provides modifiable options.

Note

• It is recommended to use either mainsail or fluidd web interfaces for configuration changes.
• Please do not enable browser translation, as the system may fail to start after saving.
• It is better not to enter Chinese or special characters in the configuration file.
• Changes to the configuration file will take effect only after restarting the system.

dangerous

• Do not modify any content below ######### PLEASE DO NOT EDIT THE FOLLOWING ######### in the configuration file.

How to Modify the Configuration File

Modifying the Configuration File After Flashing

• Configuration options that only take effect on the first boot must be modified by using a professional text editor to open the config.txt configuration file located in the FlyOS-Conf removable disk immediately after flashing.

Online Configuration Modification After System Startup

• For general configuration options, you can modify them via the web configuration interface of the system and the changes will take effect after restarting the system.

  • Open the device's IP address in your browser, for example: 192.168.1.2/
  • In fluidd, uncheck the option as shown in the left image below -> Hide hidden files and folders.
  • In mainsail, check the option as shown in the right image below -> Show hidden files.
  • You will now see the .flyos-config folder. Inside this folder there is a file named sys-config.conf.
  
  • The sys-config.conf file is a symbolic link to the config.txt configuration file located in the FlyOS-Conf removable disk.
  

  • Open the sys-config.conf file, modify the required configuration items, then Save -> Close and restart the system.

  • Note: The format of configuration items in the sys-config.conf file is key=value. Do not change it to key: value.

  • After saving modifications, restart the system for the changes to take effect.

Configuration Items

🛠️ System Configuration Guide

Welcome to the system configuration guide! This document will help you easily set up your device.

📶 Wireless Network Settings

These settings take effect automatically on each boot

Configuration Item	Default Value	Optional Values	Description
WIFI_SSID	Empty	Your WiFi name	After filling, the device will automatically connect to this WiFi network on boot
WIFI_PASS	Empty	Your WiFi password	If the WiFi has a password, enter it here

💡 Tip: Both fields must be filled to successfully connect to WiFi

---

🖨️ Printer Basic Settings

✨ Important Note: These settings only take effect on the first boot, and any subsequent changes will have no effect

Configuration Item	Default Value	Optional Values	Description
language	zh-CN(Chinese)	Chinese, English, Japanese, German, and 18 other languages zh-CN, zh-HK, en, de, cz, es, hu, ja, nl, pt, se, uk, da, fr, it, ko, pl, ru, tr	Set the display language of the web control interface
printer_name	Empty	Any name (e.g., "My 3D Printer")	Name your printer for easy identification

---

⚙️ System Basic Configuration

These settings take effect automatically on each boot

Configuration Item	Default Value	Optional Values	Description
board	fly-pi-v2	The values you can set are as follows Click to expand fly-pi, fly-pi-v2, fly-gemini-v1, fly-gemini-v2, fly-gemini-v3, fly-c8	Please do not set to other values, otherwise the system may fail to boot
localtime	Asia/Shanghai	Global time zones	Set your time zone; time will be automatically synchronized after connecting to the network
canbus_bitrate	1000000	1000000(recommended) 500000 250000	Set the communication speed of CAN bus devices, usually leave as default

---

🖥️ Display Settings

The following settings will apply automatically on each boot

Configuration Item	Default Value	Optional Values	Description
screen	hdmi	none: Disable all display hdmi: HDMI interface display fly-tft-v1: FLY-TFT V1 resistive touchscreen fly-tft-v2-r: FLY-TFT V2 resistive touchscreen fly-tft-v2-c: FLY-TFT V2 capacitive touchscreen	Select the screen type matching your hardware
rotate	90	0: No rotation 90: Rotate 90 degrees clockwise 180: Rotate 180 degrees 270: Rotate 270 degrees clockwise	Adjust the display orientation of FLY-TFT touchscreen This setting has no effect on HDMI screens
klipper_screen	0	0: Disabled 1: Enabled	Whether to enable KlipperScreen touch interface After enabled, the printer can be operated directly via the touchscreen
moon2uart	0	0: Disabled 1: Enabled	Whether to enable the FLY serial screen function This function must be used with the FLY-WiScreen 7-inch screen

---

🔧 Klipper-related Settings

These settings take effect automatically on each boot

Configuration Item	Default Value	Optional Values	Description
klipper_webui	fluidd	fluidd mainsail	Choose the web control interface for Klipper
crowsnest	0	0: Disabled 1: Enabled	Whether to enable camera monitoring

---

🖨️ Printer Type Selection

These settings take effect automatically on each boot

Configuration Item	Default Value	Optional Values	Description
printer	klipper	klipper、rrf	Select printer control system - klipper: commonly used 3D printer system - rrf: another control system

---

🔌 Power Failure Protection and Shutdown Settings

The following settings will apply automatically on each boot

⚠️ Important Function Description

• Power Failure Resume Printing: After unexpected power loss, printing can continue after power is restored
• Power Failure Shutdown: Automatically and safely shut down the system when power loss is detected
• Conflict Between the Two: If Power Failure Resume Printing is needed, the Power Failure Shutdown function must be disabled
• Note that the Gemini motherboard does not support this feature

Configuration Item	Default Value	Optional Values	Description	Corresponding Hardware Pin
shutdown_pin_state	0	0: High level trigger 1: Low level trigger	Set the electrical detection method for the shutdown button	1
shutdown_pin	none	Specific GPIO pin none(disable feature)	Set the hardware pin connected to the shutdown button	PA21

---

⚠️ Important Reminder

🛑 Do Not Modify the Following Content: In the configuration file, do not modify anything under the line ######### PLEASE DO NOT EDIT THE FOLLOWING #########, otherwise the system may not function properly.