Skip to main content

Enable Configuration

Configuration Method​

Modify the following configuration items through the FlyOS-FAST system configuration page or sys-config.conf:

###########################
# Klipper Screen: 0: no screen, 1: open screen
klipper_screen=0

###########################
# Fly Screen: 0: no screen, 1: open screen
fly_screen=1

After saving, restart the system for the configuration to take effect.

System Configuration Entry: FlyOS-Fast System Configuration Guide

OTA Upgrade

For old systems upgraded via OTA, the sys-config.conf file may not contain the fly_screen configuration item. To enable FLY Screen, manually add the following content near the screen display configuration:

###########################
# Fly Screen: 0: no screen, 1: open screen
fly_screen=1

Configuration Description​

  • klipper_screen=1 enables KlipperScreen.
  • fly_screen=1 enables FLY Screen.
  • If you need to use FLY Screen, set klipper_screen to 0.
  • If both klipper_screen=1 and fly_screen=1 are enabled at the same time, the system enables KlipperScreen by default.
  • If you are using the Fly-WiScreen 7-inch serial screen, please enable moon2uart=1 according to the WiScreen documentation, and do not use fly_screen as a substitute for the serial screen service.

FlyScreen.conf Configuration​

After installation, FlyScreen reads the FlyScreen.conf configuration file.

SystemConfiguration File Path
FlyOS-FAST/usr/share/printer_data/config/FlyScreen.conf
Other host machines/home/<username>/printer_data/config/FlyScreen.conf

Default configuration example:

[FlyScreen]
language=zh_CN.json
font_path=HarmonyOS_SansSC_Medium.ttf
reverse_button=false
# about_developer_label=
Configuration ItemDefault ValueDescription
languagezh_CN.jsonSets the interface language file, located in the language directory of the FlyScreen project
font_pathHarmonyOS_SansSC_Medium.ttfSets the interface font file, located in the fonts directory of the FlyScreen project
reverse_buttonfalseSets whether to reverse the button display or operation direction, usually kept at default
about_developer_labelEmptyCustomizes the developer description in the "About" page; keep commented or blank to use the built-in program description

To customize the About page text, remove the preceding # and fill in the content:

about_developer_label=Maintained by XXX

After saving, restart the FlyScreen service:

sudo systemctl restart FlyScreen.service

FAQ​

There is a LOGO at boot, but the interface does not appear​

  1. Enter the FlyOS-FAST system configuration page.
  2. Select FLY Screen or KlipperScreen according to your actual needs.
  3. When using FLY Screen, confirm:
klipper_screen=0
fly_screen=1
  1. Save the configuration and restart the system.

FLY Screen is not displayed when both are enabled​

This is normal priority behavior. When klipper_screen=1 and fly_screen=1 are enabled simultaneously, the system enables KlipperScreen by default. To display FLY Screen, disable KlipperScreen:

klipper_screen=0
fly_screen=1

WiScreen 7 serial screen has no display​

The WiScreen 7 serial screen uses moon2uart. Please refer to the WiScreen 7 configuration and update documentation, and confirm that the serial screen is configured as:

moon2uart=1
klipper_screen=0
fly_screen=0

WiScreen 7 Documentation: Fly-WiScreen 7-inch Screen

Loading...