Skip to content

Applications

Open these applications from the phone interface’s catalog:

Application What it does
Settings Brightness, screen timeout, locking, theme, date, languages and system information
Notes Write and save one note
Files Browse folders, manage files and open them with installed applications
Calculator Calculate with the keypad
Clocks Alarms, timer, stopwatch and world clocks
Snake Play with the D-pad or digit keys
Terminal Run shell commands and read their output
API Demos Explore supported interface controls and application APIs

The Phone interface guide owns shared navigation, text input, task switching and saving. To write an application, start with Your first application.

These are optional packages that you install when you want them; see Install an optional application. The packages supplied by a build and their supported uses depend on its platform (UMS9117 or SC9820E) and phone.

UMS9117 images include the rotation, JPEG and presentation tools. On the SC9820E Xiaomi Qin 1s+, fplinux-present is an optional package and uses --mode cpu-rgb565; the UMS9117 ROTA and JPEG interfaces do not apply.

See the application comparison for a quick overview and phone support status for each phone’s requirements and limitations.

Install the APK as described in Packages. In a RAM boot, an installed application lasts until the phone shuts down. On a microSD system card, it stays installed until you remove it. No optional application starts by itself. Exit an application before you remove its package.

Open graphical applications from the application catalog. Open Java and MRE programs by selecting their files in Files. For command-line tools, run their commands in the USB shell; --exec returns when the command exits and shows its output.

Brightness control, ARMADA, TyrQuake, fplinux-present and the fplinux-rotate preview use the display directly. Follow the direct-display procedure to stop the graphical session before starting them and restart it afterwards. Exiting one of these applications does not restart Home.

The application pages name the phone keys as follows.

Phone key names 1 2 3 4 5 6 7 8 9 * 0 # Left soft Right soft Centre D-pad Up, Down, Left, Right Dial Red
Phone keys

ARMADA and TyrQuake accept --renderer auto|software|gpu. The default, auto, uses the installed GPU add-on when a supported hardware context is available and falls back to software when the add-on is absent or GPU initialization fails. The selected renderer is printed at startup. A rendering error after startup ends the application.

  • --renderer software uses the CPU and works without Mesa installed.
  • --renderer gpu requires the hardware renderer and reports an error when it cannot start.

GPU rendering is available on Xiaomi Qin 1s+. Its optional packages include fplinux-showcase-gpu and fplinux-tyrquake-gpu; install the matching add-on with the application to use GPU mode. Choose a renderer for the application you use; GPU mode does not guarantee a higher frame rate. Other supported phones use software rendering.

The FPLinux image tools, brightness application, ARMADA and Quake launcher follow these command-line rules. FFmpeg uses its own syntax; see ffmpeg -h for help.

  • -h or --help prints the usage and every option, then exits with status 0. It does not open a device or start any work.

  • An option value can follow a space or an equals sign: --output FILE and --output=FILE are the same. Values cannot be empty.

  • The image tools accept a repeated value option and use its last value. Every occurrence must still be valid. The other applications reject a repeated option.

  • A command-line error prints the command name and the problem, followed by a hint, and exits with status 2:

    Phone
    $ fplinux-present --input /run/frame.nv16 --mode rgb
    fplinux-present: --mode must be nv16 or cpu-rgb565
    Try 'fplinux-present --help' for more information.
  • A failure after the command line has been accepted exits with another nonzero status and reports the cause on standard error.

The Files application provides My files in /home/fplinux/Files. Files in the home directory last until power-off in a RAM boot; a microSD system card keeps them across boots. /run and /tmp remain temporary RAM storage in every profile. Copy files between the PC and the phone as described in Connect from a PC. A supported microSD data card also keeps files across boots.