Skip to content

Inputs, Outputs, and Modules

Inputs, Outputs, and Modules is the hardware source of truth. This is where you can define what you will connect to each of the hardware pins and how it should be interpreted throughout the controller.

UI path

  1. Open Configuration.
  2. Select Connections.
  3. Expand Inputs, Outputs, and Modules.
  4. Add or edit the hardware module(s). You can use the “add multiple” toggle to add multiple modules without having to re-open the window each time.
  5. Set IDs, types, pins, addresses, channels, and bus settings.
  6. Click Apply I/O Changes (This will automatically reboot the controller and refresh the page).

Hardware configured here

HardwareWhat this section defines
Digital inputsButtons, switches, latches, beam breaks, and contact sensors
Analog inputsPotentiometers, sliders, sensors, and variable-level sources
Digital outputsRelays, solenoids, E-magnets, and trigger lines
Matrix keypadsRow/column keypad modules and key layout sources
RFID readersReader modules, bus settings, and reader IDs
Sound modulesAudio hardware, pins, and module IDs
Pixel outputsAddressable LED data outputs and strip IDs
Expansion modulesI2C, SPI, relay boards, GPIO expanders, and similar modules

Some hardware links below are paid affiliate links. As an Amazon Associate, Nexus Workshop may earn commission from qualifying purchases at no extra cost to you.

HardwareSetup note
PCF8575 I2C expander (Paid Link)Add expanders before other modules so their pins are available while assigning hardware
TCA9548A I2C multiplexer (Paid Link)Use when multiple I2C devices have fixed or conflicting addresses
WS2812B addressable pixels (Paid Link)Add as a pixel strip or addressable LED output, then configure layout on the Lighting page
RFID Reader RC522 (Paid Link)Configure the SPI bus, chip-select, reset pin, and reader ID before learning tags
Color Sensor TCS3472 (Paid Link)Configure as an I2C input sensor; multiple sensors usually need a multiplexer
Matrix keypad (Paid Link)Configure rows, columns, and layout tokens before building keypad sequences
7-Segment I2C Display (Paid Link)Configure I2C address and route for compact numeric display output
16x2 I2C LCD (Paid Link)Configure I2C address, columns, and rows for two-line character display output
20x4 I2C LCD (Paid Link)Configure I2C address, columns, and rows for four-line character display output

New supported modules in firmware 1.1

ModuleWhat it is used for
Coin acceptor, CH-926 style pulse inputReads coin pulses and turns them into game inputs or counters
HC-SR04 ultrasonic distance sensorMeasures distance for proximity, placement, or level-style puzzles
Analog joystickReads two-axis analog position for control or aiming interactions
HX711 load cellReads a load cell for weight, pressure, or balance puzzles
INA226 current monitorMonitors current draw for electrical sensing and diagnostics
PCF8574-style I2C matrix keypadAdds keypad input through a compact I2C expander