Skip to content

Handtop v0.3.5: Switch Controller mode

Choose a tag to compare

@junsulee119 junsulee119 released this 29 Oct 12:56
· 87 commits to main since this release

Handtop v0.3.5

Switch Controller mode (USB and Bluetooth), a Battery saver for External Controller, Bluetooth LE mice and keyboards, the newer screen panel detected automatically, and a fix for the vibration freeze.

⚠️ Known issue (still open): Bluetooth is sometimes missing on the first boot after flashing (the Bluetooth icon shows it off and External Controller → Bluetooth can't start). Restart once (Power → Restart); it works from then on.

Which image do I need?

  • Most RG35XX H units: handtop-20261029-v0.3.5.img.xz
  • If that image does nothing at power-on (no LED at all), your unit has DDR3 RAM: handtop-20261029-v0.3.5-DDR3.img.xz

Flash with balenaEtcher or Rufus, boot from the TF1 (left) slot. Login rg / rg35xxh; SSH is off until Apps → Enable SSH.

Newer screen panel (rev6): nothing to copy any more. Handtop reads which screen your unit has at every start and picks the right device tree by itself (it may restart once on the first boot).

File SHA-256
handtop-20261029-v0.3.5.img.xz 1c934d0ad2378b7be0e0b87d2c2a9bfb930af72e9b387c8cbe511813d366cb5e
handtop-20261029-v0.3.5-DDR3.img.xz 153777f5a4c6a5c1ab22d9269a150756defd1af285dfc8d36afaec4406cf96b7

What's new in v0.3.5

Switch Controller mode

  • USB cable: Switch. The handheld becomes a wired Switch controller (it poses as HORI's licensed wired pad, so no setup on the Switch). Right USB-C port → the dock's USB-A port, or a USB-C OTG adapter without the dock. F = Home (hold for quick settings), F + Select = Capture. No vibration (that pad type has none).
  • Bluetooth: Switch (experimental). Pairs as a Pro Controller (Controllers → Change Grip/Order the first time; it reconnects by itself afterwards). Same controls, and vibration works. While it is on, other Bluetooth devices disconnect (the app lists them and asks first).
  • Both tested with Ryujinx on a PC (Mario Kart 8 DX, Smash), not on a real Switch yet: please report how it goes! In Ryujinx pick Pro Controller and rebind A/B/X/Y once.
  • The External Controller app keeps its two cards, each split into Xbox and Switch.

External Controller

  • Battery saver (switch in the app, off by default): the screen turns off 30 s after the other device connects and the status screen draws much less. Vol+/- or Power shows it for 10 s. About half the CPU use in Bluetooth modes (70 % → 33 % in Xbox mode), plus no display or backlight.
  • Xbox: better compatibility (Bluetooth card): for PC Bluetooth adapters that won't pair with the Xbox mode, especially cheap clone dongles. The handheld then pairs as an Xbox One S controller over classic Bluetooth (pair again on the PC). Tested with an iPhone so far; Windows reports welcome.
  • Clearer names on the other device: "Handtop (Xbox)" / "Handtop (Switch)" (Bluetooth Switch mode has to be "Pro Controller"). An existing Windows pairing keeps the old name until you pair again; it works either way.

Fixes

  • The handheld could freeze with the motor buzzing when a game's vibration kept changing strength. The cause was a locking bug in ROCKNIX's gamepad driver; Handtop now ships a fixed build. Every kernel-level difference from ROCKNIX is listed in docs/kernel.md.
  • Bluetooth LE mice and keyboards work (they paired but did nothing: ROCKNIX's kernel lacks the uhid driver BlueZ needs; Handtop adds it).
  • Newer screen panel (rev6) detected automatically, and its device tree now has hardware video decoding too. If it ever picks wrong, write rev6 or regular in panel.txt on the boot partition.

Known limitations

  • Switch modes not yet tested on a real Switch.
  • Better compatibility mode not yet tested on Windows.
  • Bluetooth sometimes missing on the first boot (see the note at the top).

Disclaimer

Handtop is an unofficial hobby project, not affiliated with Anbernic, ROCKNIX, Microsoft or Nintendo. Use at your own risk; see the Disclaimer section in the README.

Thanks

  • u/Boldiatti for the Bluetooth dongle reports and tests that led to Better compatibility mode.
  • Everyone on Reddit who reported the rev6 screen and USB hub behaviour.

Full history in CHANGELOG.md.