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

Save and restart the system for the configuration to take effect.

System Configuration Entry: FlyOS-Fast System Configuration Guide

OTA System Upgrade

Systems upgraded via OTA may not have the fly_screen configuration item in sys-config.conf. To enable FLY Screen, manually add the following 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.
  • To use FLY Screen, set klipper_screen to 0.
  • If both klipper_screen=1 and fly_screen=1 are enabled, the system defaults to KlipperScreen.
  • If using the Fly-WiScreen 7-inch serial screen, 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 Hosts/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; language files are located in the language directory of the FlyScreen project
font_pathHarmonyOS_SansSC_Medium.ttfSets the interface font file; font files are located in the fonts directory of the FlyScreen project
reverse_buttonfalseSets whether to reverse the display or operation direction of buttons; usually left as default
about_developer_labelEmptyCustomizes the developer description on the "About" page; when commented or left empty, the program uses the built-in description

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

about_developer_label=Maintained by XXX

Save and restart the FlyScreen service:

sudo systemctl restart FlyScreen.service

Frequently Asked Questions​

System boots with a LOGO but does not enter the operation interface​

  1. Enter the FlyOS-FAST system configuration page.
  2. Select FLY Screen or KlipperScreen according to your 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 screens are enabled​

This is expected priority behavior. When both klipper_screen=1 and fly_screen=1 are enabled, the system defaults to KlipperScreen. 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 the serial screen configuration is:

moon2uart=1
klipper_screen=0
fly_screen=0

WiScreen 7 Documentation: Fly-WiScreen 7-inch Screen

Loading...