Revision as of 05:10, 27 March 2024

rehid is a rewrite of the 3DS' hid module, to allow for the remapping of buttons or the touch screen.

Installation

rehid
Developer(s)	hax0kartik
Console	Nintendo 3DS
Version	4.0 (July 20, 2023; 3 years ago)
Links
GitHub	hax0kartik/rehid
Download
	Universal-DB; GitHub release;
	v; t; e;

what you need

A working internet connection
Universal Updater installed on your console
Luma3DS updated to 13.0+

instructions

Power on the console
Launch Universal-Updater
Tap the magnifying glass on the bottom screen, then search for rehid
Press A while hovering over rehid from the list of homebrew
Choose rehidhelper.cia
Wait until the app installs
Close Universal-Updater
Launch rehidHelper and select Download Rehid
Wait for it to download and reboot, then press B to exit the app
Power off your Console
While holding SELECT, power on your console to enter Luma3DS configuration
Ensure that "Enable loading external FIRMs and modules" is selected
Press START to save and exit

what you need

the latest release of rehid (the 0004013000001D02.cxi and rehidhelper.cia files)
FBI installed on your console
Luma3DS updated to 13.0+

Instructions

Copy 0004013000001D02.cxi to sd:/luma/sysmodules/
- Create the folder sysmodules if it doesn't exist
Copy rehidhelper.cia to the root of your SD card
Reinsert your SD card into your console
Launch FBI and select SD -> rehidhelper.cia -> Install and delete CIA
Press A and wait for the CIA to install, then exit FBI
Power off your Console
While holding SELECT, power on your console to enter Luma3DS configuration
Ensure that "Enable loading external FIRMs and modules" is selected
Press START to save and exit

Remapping buttons

Go to 3DS Remap Builder to generate your remappings
When finished click on Show as QR code
Power on your console and launch rehidHelper
Select Scan QR Code and scan the generated QR code from the website
Press A to proceed
Select a title from the list for the remap to be applied to, or select global for all titles
Press start to exit

Create a rehid.json file with the remappings you want. for example:
```
{
    "keys":[
        {"get":"R", "press":"ZR"},
        {"get":"L", "press":"ZL"}
    ]
}
```
With the above, any time you press the ZR key, R key would be triggered, and any time you press the ZL key, L key would be triggered.

You can also do custom key combos. For example:
```
{
    "keys":[
        {"get":"R", "press":"X+Y"},
        {"get":"L+R", "press":"SELECT"}
    ]
}
```
With this any time you press X+Y, R key would be triggered, and any time you press the SELECT button, both L and R would be triggered.

Possible Keys are: A, B, X, Y, SELECT, START, ZL, ZR, L, R, LEFT, RIGHT, UP, DOWN, CRIGHT(CPAD), CLEFT(CPAD), CUP(CPAD), CDOWN(CPAD)
Copy rehid.json to a rehid folder on the root of your SD card
- If you want to the remapping to be used for a specific title, copy rehid.json to rihid/(title ID)/ instead. You can find the title ID of your game using 3dsdb

Troubleshooting

An exception occurred

If your console crashes while booting with "an exception occurred" and the "current proccess:" is hid, you may have an old version of rehid thats causing issues. Look for and delete /luma/titles/0004013000001D02 and /luma/titles/0004013000003302. If these don't exist, you may have a more serious hardware issue, join the Nintendo Homebrew Discord and ask, in English, for help.

@@ Line 62: / Line 62: @@
 ==Remapping buttons==
+<tabber>
+|-|Generated=
+<span>
 # Go to [https://mikahjc.github.io/3dsRemapBuilder/config 3DS Remap Builder] to generate your remappings
 # When finished click on '''Show as QR code'''
@@ Line 69: / Line 72: @@
 # Select a title from the list for the remap to be applied to, or select global for all titles
 # Press {{B|start}} to exit
+</span>
+|-|Manual=
+<span>
+<ol>
+<li> Create a <code>rehid.json</code> file with the remappings you want. for example:
+<syntaxhighlight lang="json">{
+    "keys":[
+        {"get":"R", "press":"ZR"},
+        {"get":"L", "press":"ZL"}
+    ]
+}</syntaxhighlight>
+<p>With the above, any time you press the {{B|ZR}} key, {{B|R}} key would be triggered, and any time you press the {{B|ZL}} key, {{B|L}} key would be triggered.</p>
+<p>You can also do custom key combos. For example:</p>
+<syntaxhighlight lang="json">{
+    "keys":[
+        {"get":"R", "press":"X+Y"},
+        {"get":"L+R", "press":"SELECT"}
+    ]
+}</syntaxhighlight>
+<p>With this any time you press {{B|X+Y}}, {{B|R}} key would be triggered, and any time you press the {{B|SELECT}} button, both {{B|L}} and {{B|R}} would be triggered.</p>
+<p>Possible Keys are: <code>A</code>, <code>B</code>, <code>X</code>, <code>Y</code>, <code>SELECT</code>, <code>START</code>, <code>ZL</code>, <code>ZR</code>, <code>L</code>, <code>R</code>, <code>LEFT</code>, <code>RIGHT</code>, <code>UP</code>, <code>DOWN</code>, <code>CRIGHT</code>(CPAD), <code>CLEFT</code>(CPAD), <code>CUP</code>(CPAD), <code>CDOWN</code>(CPAD)</p></li>
+<li>Copy <code>rehid.json</code> to a <code>rehid</code> folder on the root of your SD card
+<ul>
+<li>If you want to the remapping to be used for a specific title, copy <code>rehid.json</code> to <code>rihid/(title ID)/</code> instead. You can find the title ID of your game using [https://3dsdb.com/ 3dsdb]</li></ul>
+</li>
+</ol>
+</span>
+</tabber>
 ==Troubleshooting==