3Input - A System Module Input Monitor

3Input is an input viewer that works behind the scenes on your 3DS. Much like HorizonMod, the goal is to run as a daemoized process/system module, which you can then use a client to connect to and read your inputs. This is essentially an inverse to InputRedirection in Luma/Rosalina.

Features

Launch the Launcher, write down the IP address and port that is presented to you, press A, and then connect to the 3DS IP with a client, such as the example viewer (this viewer does not require the port, only the IP).

The current implementation sends a JSON Object per defined frequency. The JSON object also contains escape sequences so an application can properly decode them. Here is an example as to what the JSON being sent looks like:

'{\n\t"btn":268435456,\n\t"cp_x":134,\n\t"cp_y":-68,\n\t"tp_x":0,\n\t"tp_y":0,\n\t"ir_btn":14,\n\t"cpp_x":14,\n\t"cpp_y":14\n}\n'

You can then use an application to parse it, to make it more readable like so:

{
    "btn":268435456,
    "cp_x":134,
    "cp_y":-68,
    "tp_x":0,
    "tp_y":0,
    "ir_btn":14,
    "cpp_x":14,
    "cpp_y":14
}

Why?

Currently, the only way to view inputs for the 3DS is either using a handcam, or via the use of NTR and coNTRoller-overlay. NTR can be rather buggy, and also uses a lot more resources than necessary to just show inputs. The aim is to replace it with something less buggy, and that can run on both new and old 3DS'.

Contributors/Credit

• N3rds for the entirety of the old codebase. Since then I've been going through and documenting as much as I can to get a further understanding of the codebase itself.
• leoetlino for helping with allocation heap and helping with the sysmodule.
• MarcusD for HorizonMod. Some code was graciously borrowed within the heap allocation, and a decent reference for running a system module.
• hax0kartik for his rehid work and helping me out getting the RST services working!

Building

• Install devkitPro 3DS tools.
• make
• bannertool on your PATH.
• makerom on your PATH.

Run make in both the Launcher directory, and the root directory. Install both CIAs on your 3DS, make sure you're connected to a Wifi Access Point and launch the Launcher! Now connect with a client (such as 3SharpView ). Alternatively, check the Releases tab for the files.

Installing

In order to install, you must install both CIA files, and then place the code.ips file in the same structure in the release. /luma/titles/0004013000003302/code.ips. This patch is to allow multiple hooks into the RST service. Once both CIAs are installed, run the launcher, write your IP and port down, and then press A to launch!

Changing Sending Frequency

The main thread of the module is also reading inputs. If you wish to exit, you can press SEL+START to close the application and destroy anything created by it. The following will change the send rate of the inputs:

• SEL+X - 140 per second.
• SEL+Y - 60 per second. (Default)
• SEL+A - 10 per second.
• SEL+B - 1 per second.
• SEL+START - Exits the module.

Viewing the Output

In order to view the output, please consider using a tool such as 3SharpView

TODO

There's a few more things in the TODO pile, and these can be found mainly in the code, which will be ported over to the Issues/Project section in GitHub. Most of it is quality of life (i.e. WiFi issues).

License

This project is licensed under GNU GENERAL PUBLIC LICENSE V3. Feel free to distribute, contribute, and make changes! Pull requests to improve functionality is always welcome!