HomePlus Mod - Documentation, Examples & Dev Notes

This repo is dedicated to the improvement of the HomePlus Mod, either by me, the community or the Retroid Team.

What does the HomePlus Mod actually do?

Temporary mounts the system partition as rewritable to allow the various modifications
It then removes the default RP2+ key layout file (/system/usr/keylayout/Vendor_2020_Product_0111.kl) from the RP2+
Since the default key layout file is now "missing", the device will automatically assign the universal key layout (Generic.kl) to the RP2+
It then changes the value of the HOME button to the obscure modifier (META_LEFT) in the universal key layout (key 102 META_LEFT)
Lastly, it copies the modified universal layout to the designed folder (/system/usr/keylayout/) & gives it the required permissions (644)
The rest of the script just verifies that all files are present when installing / removing the HomePlus Mod, that's about it!

Dev / Testing Area

Requirements

PC / Laptop

ADB & Universal Drivers Installed : https://forum.xda-developers.com/t/tool-windows-adb-fastboot-may-2022.3944288/

RP2+

USB Debugging Enabled

Settings > System > About RP2+ > Tap on the Build number x5 > Back to System > Developer Options > USB Debugging

HomePlus Mod: https://github.com/acatone-git/HomePlus_Mod
Automate: https://llamalab.com/automate/
Terminal Emulator: https://github.com/jackpal/Android-Terminal-Emulator

Available Inputs Log

Here's a log of all the available / usable inputs on the RP2+, everything else will be ignored / discarded by the device: Available_Inputs.txt

Input Values / Function Table

Here's a companion table that explains what those available / usable input in the log do: Values_Functions.txt

Simulate Keys Press Syntax

To open the shell / connection between the PC & the RP2+ and send commands to the device use the command: adb shell

L3 Stuck Down Command Sequence:

sendevent /dev/input/event5 1 317 1; sendevent /dev/input/event5 0 0 0;

L3 Stuck Up Command Sequence:

sendevent /dev/input/event5 1 317 0; sendevent /dev/input/event5 0 0 0;

L3 Press & Release (adb) :

_{sendevent /dev/input/event5 1 317 1; sendevent /dev/input/event5 0 0 0; sendevent /dev/input/event5 1 317 0; sendevent /dev/input/event5 0 0 0;}

Hold / Clear Inputs Queue Command:

sleep 0.3

This can be modified at wish, if you need to hold down a key for 3 seconds or more, just replace 0.3 to 3 or whatever.

L3 Press & Release (HomePlus Mod)

_{sleep 0.3 ; sendevent /dev/input/event5 1 317 1; sendevent /dev/input/event5 0 0 0; sleep 0.3 ; sendevent /dev/input/event5 1 317 0; sendevent /dev/input/event5 0 0 0;}

Other Useful Commands

"getevent" - Live Input Capture
"dumpsys" - Shows which layout file (.kl) is being assigned to the available inputs
"stat -c "%A %a %N" *" - Shows the file permissions assigned to each file in a folder
"chmod 644 FILE_NAME" - Gives "rw-rw-r--" permission to a file
"input text "YOUR_TEXT" - Sends texts from the PC to the device

Automate Examples

Simply download these examples, import them in Automate (Three Dots Icon (Top Right)) > Import) & play around with them.

Please share your custom creations with the community, I'm curious to see what's possible!

Dev Notes

Creating a modified key layout file called "Vendor_0001_Product_0001.kl" in "/system/usr/keylayout/" splits, at least software wise, the volume + power board (gpio-keys) from the main board (Retro Station Controller / Xbox Controller) (see screenshot / try it, "split.kl" assignes L3/R3 to the volume keys), this might be useful for hardware mods.
The default folder contains a backup of all the default layouts present on the RP2+ (Firmware 1.0.0.9)

acatone-git/HomePlus_Mod_Dev