hid_to_vpad/README.md

4.6 KiB

Current Stable Release | Nightly builds | Issue Tracker | Support Thread

HID to VPAD (WUPS plugin) Build Status

This is a plugin for the Wii U Plugin System (WUPS) that let you use a HID device on the WiiU.
It's based on the controller_patcher engine.

Wii U Plugin System

This is a plugin for the Wii U Plugin System (WUPS). 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.

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 repository for more details.

You can find deep information for creating own config files, the default mapping, in the controller patcher wiki

Default button mapping:

In combination with the Network Client, more controllers are supported. You can find more information here.

FAQ

What about XBOX controllers?

Xbox controllers are not HID devices. But it can be used in combination with the Network Client!

Is my controller supported?

Take a look at this repo

???

Do you have another question? First take a look at:

If you don't find an anwser, please open an issue.

Building

In order to build this application you need serval libs:

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 dimok 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 FIX94 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.)