System Configuration Modification
Important Notice
- The settings in the
partof the configuration file will only take effect on the first system startup after burning. - Therefore, please modify the configuration file
config.txtin the removable diskFlyOS-Confafter burning, and then insert the card into the board to start the system.
Attention
- Try not to use the built-in Notepad of Windows system to edit the configuration file; you can use VSCode or other professional text editors.
- Avoid entering Chinese or special characters in the configuration file.
- After modifying the configuration file, the system needs to be restarted for the changes to take effect.
Warning
- Do not modify the content below
######### PLEASE DO NOT EDIT THE FOLLOWING #########in the configuration file.
How to Modify the Configuration File
Modify the Configuration File After Burning is Completed
- The configuration items that only take effect on the
first startupmust be modified by using a professional text editor to open the configuration fileconfig.txtin the removable diskFlyOS-Confafter burning.
Online Configuration Modification When the System is Already Running
-
If it is an ordinary configuration item, modifications made through the system web configuration page will take effect after restarting the system.
- Open the device IP address in the browser, for example:
http://192.168.1.2/ - For fluidd, uncheck as shown on the left in the figure ->
Filter and hide files and folders. - For mainsail, check as shown on the right in the figure ->
Show hidden files.
- At this point, the
.flyos-configfolder can be seen. Enter this folder to have thesys-config.conffile. - The
sys-config.conffile is a soft link to the configuration fileconfig.txtin the removable diskFlyOS-Conf.
- Open the
sys-config.conffile, modify the required configuration items, save and close it.
- Note: The format of the configuration items in the
sys-config.conffile iskey=value, do not modify it tokey: value. - After saving the modification, restart the system for the changes to take effect.
- Open the device IP address in the browser, for example:
Configuration Items
Wireless Network Configuration
- The following configuration items will take effect every time the system starts.
| Configuration Item | Default Value | Usable Values | Description |
|---|---|---|---|
WIFI_SSID | empty | Any WIFI name | WIFI name. If filled in, the system will prioritize connecting to this WIFI when starting. |
WIFI_PASS | empty | Leave blank if no password | WIFI password. If filled in, the system will connect to the WIFI using the password. |
Printer Default Configuration
tip
- The following configuration items only take effect on the
first startup.
| Configuration Item | Default Value | Usable Values | Description |
|---|---|---|---|
language | zh-CN | Click to expand detailszh-CN, zh-HK, en, de, cz, es, hu, ja, nl, pt, se, uk, da, fr, it, ko, pl, ru, tr | Set the default language for fluidd and mainsail during the first startup. |
printer_name | empty | Any string | Set the default printer name for fluidd and mainsail during the first startup. |
System Configuration
- The following configuration items will take effect every time the system starts.
| Configuration Item | Default Value | Usable Values | Description |
|---|---|---|---|
console | serial | serial, both | This configuration item should not be modified. Only serial is effective. |
board | H5: fly-pi-v2H3: fly-lite2.1 | Click to expand H5 seriesfly-pi, fly-pi-v2, fly-gemini-v1, fly-gemini-v2, fly-gemini-v3, fly-c8Click to expand H3 seriesfly-lite2, fly-lite2.1, fly-minipad | Mainboard model, mainly used for automatic firmware burning, etc. |
shutdown_pin_state | 1 | 0, 1 | Set the voltage level state of the power-off button. 1: Triggered by low level 0: Triggered by high level |
shutdown_pin | none | PA21, PA4... | Set the trigger pin of the power-off button. By default, none means it is not enabled. |
spidev | spidev0.0 spidev1.0 | spidev0.0, spidev0.1, spidev1.0, spidev1.1 | Set the SPI ports to enable. Use a space to separate multiple ports if needed. |
localtime | Asia/Shanghai | World Time Zone Table | Set the system's default time zone. The system will automatically adjust the time after connecting to the network. |
canbus_bitrate | 1000000 | 1000000, 500000, 250000 | Set the default rate of all CAN devices in the system. The default is 1M. |
Printer Type Configuration
- The following configuration items will take effect every time the system starts.
| Configuration Item | Default Value | Usable Values | Description |
|---|---|---|---|
printer | klipper | klipper, rrf | Configure which service to start the system.klipper: klipper, moonraker services, etc.rrf: RRF DSF, DWC services, etc. |
Display Configuration
- The following configuration items will take effect every time the system starts.
| Configuration Item | Default Value | Usable Values | Description |
|---|---|---|---|
screen | hdmi | Click to expand H5 seriesnone, hdmi, fly-tft-v1, fly-tft-v2-r, fly-tft-v2-cClick to expand H3 seriesnone, hdmi, fly-tft-v1, fly-minipad-r, fly-minipad-c, fly-tft-v2-r, fly-tft-v2-c | Set the screen. If set to none, all displays will be turned off. |
rotate | 90 | 0, 90, 180, 270 | Set the rotation angle of FLY-TFT. It is invalid for HDMI. |
Klipper Related Configuration
- The following configuration items will take effect every time the system starts.
| Configuration Item | Default Value | Usable Values | Description |
|---|---|---|---|
klipper_screen | 0 | 0, 1 | Set whether to enable KlipperScreen. 1: Enable 0: Disable Valid when printer=klipper. |
moon2uart | 0 | 0, 1 | Set whether to enable moon2uart. 1: Enable 0: Disable Valid when printer=klipper. |
m2u_port | /dev/ttyS1 | Valid serial port | Serial port of moon2uart, valid when moon2uart=1. |
m2u_baud | 115200 | Valid baud rate | Baud rate of moon2uart, valid when moon2uart=1. |
klipper_webui | fluidd | fluidd, mainsail | Set the default Klipper front-end UI. Does not affect the online one-click switching function. Valid when printer=klipper. |
RRF Related Configuration
- The following configuration items will take effect every time the system starts.
| Configuration Item | Default Value | Usable Values | Description |
|---|---|---|---|
rrf2uart | 0 | 0, 1 | Temporarily invalid. Functionality will be provided in future versions. |
Other Settings
- The following configuration items will take effect every time the system starts.
| Configuration Item | Default Value | Usable Values | Description |
|---|---|---|---|
crowsnest | 0 | 0, 1 | Set whether to enable Crowsnest. 1: Enable 0: Disable Applicable to both Klipper and RRF modes. |
tip
- The following configuration items only take effect on the
first startup.
| Configuration Item | Default Value | Usable Values | Description |
|---|---|---|---|
firmware | empty | Valid firmware file path | Set the firmware to be burned at startup. Currently only valid for C8 and Gemini-V3. |
dangerous
- Do not modify the content below
######### PLEASE DO NOT EDIT THE FOLLOWING #########in the configuration file.