mirror of
https://github.com/bryanthaboi/gen1recomp.git
synced 2026-08-27 08:51:27 +02:00
Shane McGovern
74 lines
4.0 KiB
Markdown
74 lines
4.0 KiB
Markdown
# Linux ARM SBC Handhelds (PortMaster)
|
|
|
|
Download `gen1recomp-*-sbc-portmaster.zip` from the [Gen1Recomp releases](https://github.com/bryanthaboi/gen1recomp/releases). This build targets 64-bit Linux ARM handhelds with PortMaster, including compatible H700 devices.
|
|
|
|
## Install
|
|
|
|
1. Unzip the release. It contains `gen1recomp-sbc.sh` and a `gen1recomp-sbc/` folder.
|
|
2. Copy both as siblings into your device's PortMaster ports directory, commonly `Roms/Ports (PORTS)/` or `Roms/PORTS/`.
|
|
3. Install PortMaster for your firmware and refresh the Ports list.
|
|
4. Copy your legally owned canonical US Red or Blue `.gb` file into `gen1recomp-sbc/lovegame/`.
|
|
5. 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:
|
|
|
|
```sh
|
|
./build-linux-arm-sbc.sh --version 0.1.75
|
|
```
|
|
|
|
For development, package a local checkout explicitly:
|
|
|
|
```sh
|
|
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](https://github.com/PortsMaster/PortMaster-New) ecosystem.
|