User interface - portapack-mayhem/mayhem-firmware GitHub Wiki

User Interface

The PortaPack display is 240×320 pixels. The screen is divided into three horizontal bands that are always present:

┌─────────────────────────────┐  ← 16 px  Title bar
│                             │
│       App content area      │  ← 288 px
│                             │
├─────────────────────────────┤  ← 16 px  Information bar

Title bar

The top 16 pixels form the Title-Bar. It contains:

  • Navigation controls (back arrow, app name) on the left
  • Configurable status icons and quick-action buttons on the right

App content area

The middle 288 pixels are used by the currently running app. On the main-menu this shows the 2-column button grid. Inside apps it shows the app's own controls and display.

Information bar

The bottom 16 pixels always show:

  • Left: Firmware version string (e.g. n_250606). If a firmware checksum error is detected at boot, this shows FLASH ERR in red instead.
  • Right: Live UTC clock, updated every second. Date display can be enabled via Settings → User Interface.

Splash screen

A splash screen is shown on each boot before the main menu appears. Tap the screen or press any button to skip it immediately.

By default a random image is selected from the SPLASH/ folder on the SD card. If a file named splash.bmp exists in the SD card root, that file is used instead and the random selection is skipped.

Splash display can be enabled or disabled under Settings → Display. See Create-a-custom-splash-screen for image format requirements.

Sub-pages