mirror of
https://github.com/Maschell/hid_to_vpad.git
synced 2024-12-03 19:14:14 +01:00
85 lines
4.6 KiB
Markdown
85 lines
4.6 KiB
Markdown
[Current Stable Release](https://github.com/Maschell/hid_to_vpad/releases/latest) | [Nightly builds](https://github.com/Maschell/hid_to_vpad/releases) | [Issue Tracker](https://github.com/Maschell/hid_to_vpad/issues) | [Support Thread](https://gbatemp.net/threads/hid-to-vpad.424127/)
|
|
# HID to VPAD (WUPS plugin) [](https://travis-ci.org/Maschell/hid_to_vpad)
|
|
|
|
|
|
This is a plugin for the [Wii U Plugin System (WUPS)](https://github.com/Maschell/WiiUPluginSystem/) that let you use a HID device on the WiiU. <br />
|
|
It's based on the [controller_patcher](https://github.com/Maschell/controller_patcher/tree/wut) engine.
|
|
|
|
# Wii U Plugin System
|
|
This is a plugin for the [Wii U Plugin System (WUPS)](https://github.com/Maschell/WiiUPluginSystem/). To be able to use this plugin you have to place the resulting `.mod` file in to the following folder:
|
|
|
|
```
|
|
sd:/wiiu/plugins
|
|
```
|
|
When the file is placed on the SDCard you can load it with [plugin loader](https://github.com/Maschell/WiiUPluginSystem/).
|
|
|
|
## Usage
|
|
Start place the .mod file into the WUPS plugin folder `sd:/wiiu/plugins` and start the plugin loader.
|
|
|
|
Place the config files into the following folder:
|
|
```
|
|
sd:/wiiu/controller
|
|
```
|
|
|
|
To set the controller mapping you need to open the WUPS configuration menu. When the plugin is loaded and active, you can open the menu via the button combo **L, DPAD DOWN and MINUS**.
|
|
(Note: The config menu only opens at places where the home menu is allowed).
|
|
|
|
## Supported devices
|
|
The official GC Adapter, PS3/PS4 Pad, Mouse, Keyboard have built in support. Other devices can be added when a valid config file in provided.
|
|
Check out the [controller_patcher](https://github.com/Maschell/controller_patcher) repository for more details.
|
|
|
|
You can find deep information for creating own config files, the default mapping, in the [controller patcher wiki](https://github.com/Maschell/controller_patcher/wiki)
|
|
|
|
Default button mapping:
|
|
- [Mouse](https://github.com/Maschell/controller_patcher/wiki/3.-Mouses#default-configuration)
|
|
- [Keyboard](https://github.com/Maschell/controller_patcher/wiki/4.-Keyboards#default-configuration)
|
|
- [GameCube](https://github.com/Maschell/controller_patcher/wiki/5.a-Controller-%7C-Configurate-the-GameCube-controller#default-button-mapping)
|
|
- [Dualshock 3](https://github.com/Maschell/controller_patcher/wiki/5.b-Controller-%7C-Configurate-the-Dualshock-3-controller#default-button-mapping)
|
|
- [Dualshock 4](https://github.com/Maschell/controller_patcher/wiki/5.c-Controller-%7C-Configurate-the-Dualshock-4-controller#default-button-mapping)
|
|
|
|
In combination with the Network Client, more controllers are supported. You can find more information [here](http://gbatemp.net/threads/hid-to-vpad-network-client.466150/).
|
|
|
|
# FAQ
|
|
|
|
### What about XBOX controllers?
|
|
Xbox controllers are not HID devices. But it can be used in combination with the [Network Client](http://gbatemp.net/threads/hid-to-vpad-network-client.466150/)!
|
|
|
|
### Is my controller supported?
|
|
Take a look at this [repo](https://github.com/Maschell/controller_patcher_configs)
|
|
|
|
### ???
|
|
Do you have another question? First take a look at:
|
|
- the [controller_patcher repo](https://github.com/Maschell/controller_patcher)
|
|
- the thread on [gbatemp](http://gbatemp.net/threads/hid-to-vpad.424127/)
|
|
- the [wiki](https://github.com/Maschell/controller_patcher/wiki)
|
|
|
|
If you don't find an anwser, please open an issue.
|
|
|
|
# Building
|
|
In order to build this application you need serval libs:
|
|
|
|
- [wut](https://github.com/decaf-emu/wut)
|
|
- [libutilswut](https://github.com/Maschell/libutils/tree/wut) for common functions.
|
|
- [lcontrollerpatcherwut](https://github.com/Maschell/controller_patcher/tree/wut) to emulate the controllers.
|
|
|
|
Install them (in this order) according to their README's. Don't forget the dependencies of the libs itself.
|
|
|
|
### Building using the Dockerfile
|
|
It's possible to use a docker image for building. This way you don't need anything installed on your host system.
|
|
|
|
```
|
|
# Build docker image (only needed once
|
|
docker build . -t hidtovpadwups-builder
|
|
|
|
# make
|
|
docker run -it --rm -v ${PWD}:/project hidtovpadwups-builder make
|
|
|
|
# make clean
|
|
docker run -it --rm -v ${PWD}:/project hidtovpadwups-builder make clean
|
|
```
|
|
|
|
# Credits
|
|
- A big thanks goes out to <b>dimok</b> for creating the HBL, the dynamic libs and every stuff he made. The "environment" of this app is copied from ddd, turned out to be a "hello world" with useful extra stuff.
|
|
- Also huge thanks to <b>FIX94</b> who initally created his gc-to-vpad. Helped me a lot! Thanks!
|
|
- And of course big thanks to everyone who has helped me testing! (dimok, dibas, EclipseSin,FunThomas,n1ghty etc.)
|