/Ardwiino

Wii accessories as native game controller

Primary LanguageC++GNU General Public License v3.0GPL-3.0

Ardwiino - Wii accessories as native game controller

This sketch allow you to use any Wii accessory, such as the Nunchuck, Classic controller or Guitar Hero guitar. It was initally made to play Clone Hero.

Currently the sketch defaults to the Guitar Hero, but other controllers are being implemented.

For the Guitar hero guitar the input is as follows:

  • 5 fret buttons
  • strum up/down: POV hat up/down
  • starpower button
  • start button
  • joystick: POV hat
  • Whammy: joystick axis

Joystick mapping:

Joystick mapping

Screenshot in Windows:

Screenshot in Windows

Needed hardware

This project can be built with a Arduino Leonardo and a Nunchuck breakout board. My personal version was built with the 5V version of the Arduino Leonardo Micro, but the Wii nunchuck accessories are 3.3V, so I added a logic level converter and a LM1117 Low-Dropout Linear Regulator. Normally if you buy the 3.3V version of the Leonardo, you would only need the breakout board as well.

I bought mine on Aliexpress

5V Parts list:

Soldering schematics are coming soon™, but it's not too hard. You connect 3.3V to the + and the groun to - of the breakout board, then the clock to D3 and data to D2.

This is my version that I soldered on a protoboard:

Protoboard

Uploading the code

First install the Arduino IDE, you can download it here.

Then download and install the following libraries:

This guide can help you to install the libraries.

If all that is done (you go man!), then you can start the Arduino IDE and load the Ardwiino.ino sketch, select Tools -> board -> Arduino Leonardo. Then select the COM port in Tools -> port. It should look something like COM19 (Arduino Leonardo), but the number will be different.

Now you just click the upload button and presto, your software is loaded!

Change controller name

The default name is "Arduino Leonardo", but you can change that to something cooler like, I don't know Ardwiino.

In order to do that, you have to follow instructions here, but I copied them for ease of use.

Special thanks

Special thanks go out to the members of the Clone Hero discord, especially KubaF2K, dizzy, jaysonTM, Yuri™ shall conquer the earth!, Extended sustain tap Open notes, Josh and probably others I haven't mentioned. They helped a lot with debugging and information about all the other guitars. Thanks guys!