Joystick Adapter

The joystick adapter translates movements of an analog joystick into menu commands. It allows navigating the menu with just a simple analog stick.

The horizontal axis is mapped to BACK and RIGHT while the vertical axis controls UP and DOWN. The joystick’s button can be handled separately using a ButtonAdapter. All axis commands can be customised when creating the adapter, and the centre value can be adjusted from its default of 512 if necessary.

Include the adapter header and create an instance:

#include <Button.h>
#include <input/ButtonAdapter.h>
#include <input/JoystickAdapter.h>

Button pressBtn(2);
JoystickAdapter joystick(&menu, A0, A1);
ButtonAdapter pressAdapter(&menu, &pressBtn, ENTER);

A0 and A1 are the analog pins for the horizontal and vertical axes. The joystick button can be handled separately using a ButtonAdapter as shown. In loop() simply call joystick.observe() and pressAdapter.observe().

void loop() {
    joystick.observe();
    pressAdapter.observe();
}

The adapter handles the dead zone around the centre value so only distinct movements generate commands. The centre value defaults to 512 but can be set explicitly along with the margin. You can also override the command mapping when creating the adapter:

// use A2/A3 as axes and map horizontal movement to BACK/ENTER
JoystickAdapter custom(
    &menu,
    A2,
    A3,
    600,   // custom centre value
    100,
    BACK,
    ENTER,
    UP,
    DOWN);