Applications
Built-in applications
Section titled “Built-in 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.
Optional applications
Section titled “Optional applications”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.
fplinux-brightness-ui.fplinux-showcase.quake.ffmpeg.Image tools
Section titled “Image tools”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.
fplinux-rotate.fplinux-jpeg, fplinux-jpeg-cpu.fplinux-present.Where the applications work
Section titled “Where the applications work”See the application comparison for a quick overview and phone support status for each phone’s requirements and limitations.
Install an optional application
Section titled “Install an optional application”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.
Start an application
Section titled “Start an application”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.
Choose a renderer
Section titled “Choose a renderer”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 softwareuses the CPU and works without Mesa installed.--renderer gpurequires 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.
Command-line behavior
Section titled “Command-line behavior”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.
-
-hor--helpprints the usage and every option, then exits with status0. It does not open a device or start any work. -
An option value can follow a space or an equals sign:
--output FILEand--output=FILEare 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 rgbfplinux-present: --mode must be nv16 or cpu-rgb565Try '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.
Where to keep files
Section titled “Where to keep files”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.