Linux ARM SBC Handhelds (PortMaster)

Download gen1recomp-*-sbc-portmaster.zip from the Gen1Recomp releases. This build targets 64-bit Linux ARM handhelds with PortMaster, including compatible H700 devices.

Install

Unzip the release. It contains gen1recomp-sbc.sh and a gen1recomp-sbc/ folder.
Copy both as siblings into your device's PortMaster ports directory, commonly Roms/Ports (PORTS)/ or Roms/PORTS/.
Install PortMaster for your firmware and refresh the Ports list.
Copy your legally owned canonical US Red or Blue .gb file into gen1recomp-sbc/lovegame/.
Launch gen1recomp-sbc from Ports and choose the ROM.

The pack includes portable.txt, so saves and ROM-derived cache remain beside the game on the SD card. The build never ships ROM-derived bytes.

Canonical US cart SHA-1 values:

Red: ea9bcae617fdf159b045185467ae58b2e4a48b9a
Blue: d7037c83e1ae5b39bde3c30787637ba1d4c48ce2

Controls

Input	Action
D-pad	Move cursor
A	Click / confirm
L1 / R1	Switch tabs
Start / Select	Play or choose ROM

In-game controls use the normal PortMaster/SDL mapping and can be rebound in OPTIONS → CONTROLS.

Runtime and suspend

The package bundles PortMaster's LÖVE 11.5 aarch64 runtime. The launcher sources control.txt, calls get_controls, applies an optional CFW override, invokes pm_platform_helper, and calls pm_finish on exit. Paths are relative to the launcher, allowing different firmware mount points.

Suspend/resume uses the existing LÖVE focus/visibility lifecycle: input is reset on focus loss and the game resumes when the window becomes visible again. Exact power-button behavior remains firmware-dependent; hardware validation has been performed on the TrimUI Brick, not every SBC or H700 device.

Power and Performance Tuning

The handheld build applies several optimizations to reduce power draw and ensure smooth 60 FPS frame pacing on low-power ARM SoCs:

KMSDRM / EGL Vsync Fix: Handheld builds disable driver vsync (vsync = 0) to prevent GPU driver busy-wait spinloops in eglSwapBuffers, allowing nanosleep() and dropping idle CPU usage from ~25% to ~4%.
Idle Render Governor: Drops presentation rate when a static screen (menus, text dialogs, stationary scenes) receives no input, cutting compositing work ~6x while preserving full 60 Hz game and audio clocks. Any button press restores full framerate immediately.
Sample Rate Scaling: Audio synthesis is tuned to 22.05 kHz by default (POKEPORT_AUDIO_RATE=22050), halving synthesis CPU overhead on Cortex-A53 cores with no audible quality loss on handheld speakers.
Dynamic CPU Governor: Defaults to schedutil instead of pinning performance on all cores, reducing thermals and extending battery life.

Environment variables for fine-tuning (configured in gen1recomp-sbc.sh):

Variable	Default	Description
`POKEPORT_IDLE_AFTER`	`10`	Seconds without input before an idle screen drops presentation rate
`POKEPORT_IDLE_FPS`	`6`	Framerate while idle
`POKEPORT_AUDIO_RATE`	`22050`	Chip-synth sample rate (set to `44100` for full rate)
`POKEPORT_CPU_GOVERNOR`	`schedutil`	CPU scaling governor (`schedutil`, `performance`, `ondemand`)

Building

Release workflows build this automatically. Standalone builds resolve the latest published Gen1Recomp release by default:

./build-linux-arm-sbc.sh --version 0.1.75

For development, package a local checkout explicitly:

GEN1RECOMP_SOURCE_DIR="$PWD" ./build-linux-arm-sbc.sh --version 0.1.0
# or: ./build-linux-arm-sbc.sh --source "$PWD" --version 0.1.0

The generated port.json records the source release tag. install-linux-arm-sbc.sh is a macOS helper for copying a built pack to a mounted SD card.

PortMaster device support and runtime integration are maintained in the PortMaster ecosystem.

4.0 KiB Raw Blame History