Ristretto

_{This plugin is named after the type of coffee. The logo is a sort-of depiction of what it looks like.}

Ristretto is a plugin for Aroma that provides a foundation for smart home automation on the Wii U with a HTTP server. This will allow for other devices to communicate with the Wii U, and can then be used to extend existing home automation sofftware.

Installation

1. Copy the file Ristretto.wps into sd:/wiiu/environments/aroma/plugins.
2. Requires the WiiUPluginLoaderBackend in sd:/wiiu/environments/aroma/modules.
3. Requires the NotificationModule in sd:/wiiu/environments/aroma/modules.

Start the environment and the backend should load the plugin. By default, the port runs on :8572. You'll know the server is working when you open http://(wiiu_ip_address):8572 in your browser and you should see the text "Ristretto".

Building

For building you need:

• wups
• wut

Install them (in this order) according to their README's. Don't forget the dependencies of the libs itself.

Then you should be able to compile via make (with no logging) or make DEBUG=1 (with logging).

Two other libraries, MiniJson and a modified version of tinyhttp are compiled with the source.

Buildflags

Logging

Building via make only logs errors (via OSReport). To enable logging via the LoggingModule set DEBUG to 1 or VERBOSE.

make Logs errors only (via OSReport). make DEBUG=1 Enables information and error logging via LoggingModule. make DEBUG=VERBOSE Enables verbose information and error logging via LoggingModule.

If the LoggingModule is not present, it'll fallback to UDP (Port 4405) and CafeOS logging.

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 ristretto-builder

# make
docker run -it --rm -v ${PWD}:/project ristretto-builder make DEBUG=1

# make clean
docker run -it --rm -v ${PWD}:/project ristretto-builder make clean

Format the code via docker

docker run --rm -v ${PWD}:/src ghcr.io/wiiu-env/clang-format:13.0.0-2 -r ./src -i

Credits

Ristretto is a big project. It explores so many different areas of the Wii U and opens the door to more opportunities when it comes to home automation, homebrew, reverse engineering and so much more.

• Maschell - For everything he has done with the Wii U homebrew scene, and for helping me in general
• Daniel K.O. - Helping in general, debugging, advice with sockets, threading, function hooking
• TraceEntertains - Defining endian functions (e.g. bswap32) for Wii U, config menu, research with title information
• Wish - Original Ristretto logo
• Artisan71 - Current Ristretto logo
• You, for checking out this project.