Skip to content

oakMOSS v0.3.0-beta.1

Choose a tag to compare

@CatalyticArkun CatalyticArkun released this 25 Sep 01:23
· 29 commits to main since this release

oakMOSS v0.3.0-beta.1

System card (SD1) images for three MagicX handhelds. This beta moves screen rotation into the kernel on the Zero 28 and XU20, so everything is drawn the right way up without each app rotating on its own, and puts all three on one button convention.

Downloads

Device Image
MagicX Mini Zero 28 oakmoss-zero28-v0.3.0-beta.1-sd1.img.xz
MagicX Zero 40 oakmoss-zero40-v0.3.0-beta.1-sd1.img.xz
XU RETRO / MagicX XU20 V32 oakmoss-xu20-v0.3.0-beta.1-sd1.img.xz

Before you start

  • Back up your stock system card. A full image of it is the only way back to stock.
  • You need a spruceOS build with the MagicX rotation change on a second card, formatted FAT32 (exFAT won't mount). With an older spruceOS, A/B and X/Y are swapped on all three, and on the Zero 28 and XU20 the picture comes out rotated twice.

Install

  1. Write the image to the system card with Raspberry Pi Imager or a similar tool (in Imager: "Use custom", then pick the .img.xz). Leave verification on.
  2. Once the card is ejected, put it straight into the device. On Windows, don't plug it back into the PC first: Windows can rewrite the card's partition table so it no longer boots. If that happens, write it again.
  3. The system card goes in the slot your stock system card came from, and the spruceOS card in the other slot.
  4. Power on.

What's new

  • The kernel rotates the screen on the Zero 28 and XU20. Menus, RetroArch, PortMaster and ports all come out the right way up, with no per-app setting.
  • All three: the face buttons report their positions the way the TrimUI A133P devices do, so A, B, X and Y mean the same thing in every app.
  • XU20: touch follows the rotated screen.
  • Zero 28: the boot logo stays in place when the system takes over the screen.
  • Zero 28: fewer dropped frames. The kernel no longer writes every log line to the serial port.
  • All three: debugging tools on the system card: strace, gdbserver, htop, i2c-tools, trace-cmd, memtester, stress-ng, iperf3, tcpdump, ethtool, and more BusyBox commands (base64, od, taskset, devmem, nproc).

Known limitations

  • Sleep turns the screen off and pauses the game. Full suspend isn't supported on these devices.
  • Beta: tested on one unit of each device.

Checksums

sha256sum -c SHA256SUMS checks the downloads. Each *-BUILD-INFO.txt lists exactly what went into its image.

SHA-256 of the decompressed images
341025310eabde99bca6cf556f502df093838bba60420a92daaef8651c8d7894  oakmoss-zero28-v0.3.0-beta.1-sd1.img
c650f456ac3a41b992041493080b26aa46fc3a9fbc027f5387a488e4627a382f  oakmoss-zero40-v0.3.0-beta.1-sd1.img
aeb6aa698db827b92f60ee8c7abfdcf36fa6a8f4b08abfb1e87d45745588c8f2  oakmoss-xu20-v0.3.0-beta.1-sd1.img