Open Hardware & RISC-V

New firmware toolkit enables custom game launcher for My Arcade Contra Pocket

Key Takeaway

A new automated build pipeline allows users to replace the stock launcher on the Rockchip-based Contra Pocket with a custom MiniGUI application.

Summary

Developer Rob Simon has released a firmware modding toolkit on GitHub designed specifically for the My Arcade Contra Pocket handheld. The device, which is powered by a Rockchip RK3128 SoC, typically runs a restricted stock environment that limits user control over game selection.

The toolkit provides an automated way to swap the original launcher for a custom MiniGUI application that scans for ROM zip files and presents a scrollable menu. By utilizing a Docker-based Buildroot environment, the project ensures that developers can rebuild the device's squashfs rootfs with the correct glibc and library versions required by the ARM Cortex-A7 architecture.

Technical implementation and hardware constraints

  • Hardware Architecture: The device utilizes a Rockchip RK3128 quad-core ARM Cortex-A7 SoC with Mali400 MP2 graphics and 128 MB of SPI NAND flash.
  • Build Environment: The toolkit uses a Docker image containing a Buildroot 2018.02.12 cross-compiler to maintain compatibility with the device's specific library versions.
  • Storage Management: Due to the 128 MB NAND limit, the rootfs partition is restricted to 65 MiB, leaving approximately 15 MiB of available space for the custom launcher and ROM files after accounting for the 50 MiB stock firmware.
  • Flashing and Emulation: Firmware is deployed via rkflashtool in RockUSB Mask ROM mode, while the launcher utilizes the FBAlpha libretro core for game emulation.
  • Filesystem Handling: The pipeline includes specialized tools to pack and unpack squashfs images to prevent case-sensitive symlink corruption on macOS systems.

Why it matters

This project demonstrates how community-driven firmware toolkits can extend the lifecycle and utility of closed-source handheld hardware. It provides a blueprint for developers looking to perform low-level modifications on Rockchip-based embedded devices with highly constrained storage.

Original reference: blog.adafruit.com →