Retroid Pocket Mini V2 - 2026-07-18

Warning

Early preview for Retroid Pocket Mini V2 (SM8250). Built on top of
upstream virtudude/armada; many
things work well after a day of live testing on real hardware, but see
Known issues below before flashing.

Built from this repo's main @ 5ea9775, kernel/DTS + InputPlumber patch from
Ga1dz1/armada-packages @ 8680ef5.

Working

• SM8250 kernel + device tree support for Retroid Pocket Mini V2 (and the
  original Mini), vendored/adapted from ROCKNIX.
• Working GRUB boot menu, auto-enabled and built dynamically from
  whatever sm8250-retroidpocket-* device trees exist - no manual flag
  needed, and any future device in the family gets a menu entry for free.
• Gamepad: full button mapping, gyroscope.
• Sleep/wake: fake-suspend fixed (the power button whitelist didn't match
  this SoC's actual pm8941_pwrkey device name, so wake presses never
  reached it).
• No more ghost/duplicate controller in Steam.
• Reactive stick lighting actually works now (traced to an InputPlumber
  bug where passthrough: true was only ever wired up for keyboard source
  devices, never gamepad ones - patched upstream InputPlumber itself).
• RGB stick lighting, ten modes (Static, Breathing, Battery,
  Battery+Breathing, Rainbow, Chase, Alternating, Reactive, Multidot,
  Ambilight), each with relevant Speed/Intensity/Size sliders, per-button
  flash colors in Reactive mode, and a "follow screen brightness" toggle.
  See the README's Stick RGB lighting
  section for details.
• Steam UI scale fix that actually survives a restart. Root-caused live:
  Steam keeps two structures per display in config.vdf - one it recomputes
  from scratch on every launch (not worth patching), and a named per-display
  cache that's the real persisted override. Previous attempts only patched
  the former.

Known issues

• No audio after resume from sleep, sometimes for the rest of the
  session. A same-day fix attempt (restarting the audio server on resume)
  made this worse (silence instead of just distorted audio) and was
  reverted - still open.
• Ambilight (screen-color-reactive lighting) is validated on real
  hardware but not yet play-tested over long sessions; resource cost at
  scale is unconfirmed.
• GRUB menu only lists Mini and Mini V2 - device trees for other
  SM8250 Retroid models aren't in this repo yet, so they won't appear even
  though the menu itself is now built to pick up any that are added.
• General upstream armada known issues also apply (see the
  README).

Collaboration

This fork intends to work with upstream virtudude/armada for exchanging
and merging work, not permanently diverge - expect this device support to
move upstream over time.