WIZM-JOYSTICK

WIZM-JOYSTICK

WIZM-JOYSTICK is a 2-axis analog rocker joystick module equipped with an integrated push-button switch. Operating at 3.3V, it provides proportional analog voltage outputs for X and Y coordinates along with a digital output for button clicks, enabling directional control and user input for embedded interfaces and robotics.

ADK-Buy Buy now

The WIZM-JOYSTICK is an analog input module based on two perpendicular $10\text{ k}\Omega$ potentiometers (X and Y axes) and an integrated momentary tactile push button. By converting mechanical stick deflection into proportional analog voltages ($0\text{ to }3.3\text{V}$), it provides smooth, multi-directional tracking alongside center-push selection. Dual connection options, a standard 2.54mm pitch header breakout alongside a keyed horizontal locking connector, make it straightforward to integrate into prototyping setups, gaming peripherals, pan-tilt gimbals, and IoT control panels.


Features

  • Dual-Axis Analog Output: Two orthogonal potentiometers provide smooth analog voltage readouts for X and Y position.

  • Integrated Push-Button (KEY): Center tactile switch activates when the joystick is pressed downward.

  • Spring Self-Centering: Returns automatically to the center position when released.

  • Dual Connection Options: Supports standard 2.54mm pitch through-hole headers alongside a keyed horizontal lock connector.

  • Mounting Holes: Corner mounting holes and center clearance cutouts for secure panel or chassis mounting.


Specifications

Parameter

Value

Model

WIZM-JOYSTICK

Revision

1.0

Operating Voltage (VCC)

3.3V DC

Interface Type

Analog (X/Y) + Digital (Push Button)

Connector Pitch

Standard 2.54mm (P1) / Keyed Horizontal (J1)

Pin Count

5 Pins (VRX, VRY, KEY, GND, 3.3V)


Pinout & Hardware Overview

The module provides two parallel pin interfaces: a standard 5-pin 2.54mm pitch breakout (P1) and a 5-pin horizontal keyed connector (J1).

Pin

Type

Description

VRX

Input

X-axis analog voltage output ($0\text{V} - 3.3\text{V}$)

VRY

Input

Y-axis analog voltage output ($0\text{V} - 3.3\text{V}$)

KEY

Input

Integrated push-button switch (Pushed to connect)

GND

Power

Ground supply reference

3.3V

Power

3.3V DC Power Supply

Top View

joysticktopview


Platforms Supported

MicroPython

mpy-logo

Getting Started

Materials Required (excluding joystick module)

  • W55MH32L-Application-KIT

  • 5-pin female-female JST PH-Style Cable

  • USB Type-C Cable

W55H32L-Application-KIT

Hardware Connection

Connect the WIZM-JOYSTICK to an ADC-enabled connector (e.g., J3) on the W55MH32L-Application-KIT using the 5-pin JST cable.

Hardware Connection

Then use a USB Type‑C cable to connect the WIZ‑LINK Port on the W55MH32L‑Application-KIT board to your PC

Sample Code Demo

Software

We will be using Thonny IDE to run the code.

  1. Open Thonny IDE on your PC.

  2. Select the correct COM port for your board.

  3. Set the interpreter to MicroPython (generic).

Refer to the WIZnet documentation page for more detailed instructions at the “Basic Setup” section.

MicroPython

from machine import Pin, ADC
import time

# Configure ADC pins for X and Y axes
# Update pin names to match your board's ADC-capable pins
vrx = ADC(Pin("PA0"))
vry = ADC(Pin("PA1"))

# Configure digital input for the push button with an internal pull-up resistor
key = Pin("PA2", Pin.IN, Pin.PULL_UP)

print("Starting Joystick Read...")

while True:
    # Read 16-bit unsigned ADC values (0 - 65535)
    x_val = vrx.read_u16()
    y_val = vry.read_u16()
    
    # Read button state (0 = pressed when using pull-up)
    button_pressed = (key.value() == 0)

    print(f"X: {x_val:<5} | Y: {y_val:<5} | Pressed: {button_pressed}")
    time.sleep(0.1)

Moving the stick deflects the X and Y ADC readings up or down relative to their center resting values, and pressing down on the stick toggles “Pressed: True”.

Joystick Module Demo