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

  • Title-Bar — all title bar icons, their functions and active colours
  • main-menu — main menu layout and available entries
  • Main-Controls — common controls: frequency field, step size, bandwidth, gain
  • Text-Entry — the on-screen keyboard used for text input
  • Screenshots — how to capture and save screenshots
  • Sleep-mode — display sleep and backlight auto-timeout
  • Stealth-Mode — automatic backlight-off during transmission
  • SD-Card-Content — SD card folder structure used by the firmware