← Work

PS2 Dashboard

A PlayStation 2 launcher in C that scans storage devices, decodes native PS2 icons, plays hardware-looped music, and chain-loads ELF programs, all from a single self-contained ELF.

  1. Self-contained boot

    one ELF
    • IOP modules embedded in the binary
    • Loaded with SifExecModuleBuffer
    • No dependency on host: or a modules folder
  2. Device manager

    device_mgr.c
    • USB, memory card, HDD, disc, network
    • Disc detection via SYSTEM.CNF
    • Removed-storage detection
  3. Icon pipeline

    ps2_icon.c → icon_cache.c
    • Parses icon.sys and 3D icon models
    • Caches decoded thumbnails
    • Fallback badges for apps with none
  4. UI + launch

    dashboard_ui.c
    • Home, Library and System screens
    • Ring-buffer logger and debug overlay
    • Chain-loads the chosen ELF

Based on the repository's source layout and commit messages.

What it is

A launcher and dashboard for the PlayStation 2, written in C against the open PS2 SDK. It finds programs on the storage devices that are attached, shows them with their own icons, and starts them. The interface is built from original code; the visual style takes loose cues from the console’s own menu system and is not affiliated with or endorsed by its maker.

Problems that were worth solving

  • A real boot failure. Loading drivers from a host: path worked until a launch configuration mapped host: somewhere else; fileXioInit() then hung before the first frame. I replaced every file-based driver load with modules embedded in the ELF, which removes that dependency.
  • A subtle audio trap. Two PS2 audio-encoder tools produce similar-looking files, but only one matches what the audio library expects; the other plays as silence. I identified the correct official encoder, uploaded the looping music into SPU2’s own memory so the hardware loops it, and chunked the menu blip across frames. Reading the audio server’s IOP source showed that “stop” only clears a flag that gates the drain thread, so stopping while data was in flight froze the ring buffer for good. The fix is never to stop with unsent data.
  • Failure handling as a feature. A systematic error-handling pass closed real gaps: unchecked VRAM allocations (the console’s 4 MB ceiling is measured, not assumed), silent launch failures, undetected controller disconnects, and a ring-buffer logger that writes to the memory card only when switched on, to avoid wear.
  • Disc handling. Disc-swap detection watched the wrong signal and could read stale SYSTEM.CNF data from the previous disc; it was rewritten.

Status

Experimental. It was iterated in PCSX2, including a boot test of the final embedded-module build. Network and SMB support were added on a best-effort basis, and the commit history records a real driver-load failure found with Ethernet enabled. The repository has no license file yet, so it should be treated as all rights reserved until one is added.

How it was built

The commits carry an AI-assistant co-author trailer. I note that here so the credit is accurate.