Matrix Keypads

Matrix keypads provide many button positions through row and column wiring. Configure the keypad module first, then use keypad tokens in sequences or behavior.

Add a keypad

1. Open Configuration.
2. Go to Connections.
3. Expand Inputs, Outputs, and Modules.
4. Add a Matrix Keypad module.
5. Set the keypad ID and define quantity of rows and columns.
6. Enter row pins and column pins.
7. Set the key layout with a preset or manually assigning tokens to each key position.
8. Apply I/O Changes to save (board will reboot and page will refresh).
9. Press each key and verify it appears in Live Monitor or Operator page input activity.

Hardware link

The manual’s common keypad module is this Matrix keypad (Paid Link). Confirm the row and column pinout for the exact keypad before saving, because swapped rows or columns will make the wrong tokens appear in Live Monitor.

Keypad controls

Control	What it does
ID	Module name used by behavior and sequence sources
Row pins	Physical pins connected to keypad rows
Column pins	Physical pins connected to keypad columns
Layout	Maps row/column positions to labels such as 1, 2, A, or #

Use a keypad code

1. Go to Configuration > Behavior.
2. Expand Input Sequences.
3. Add Ordered Sequence.
4. Map the buttons to tokens for the Input Sequence identically to standard buttons.
5. Enter the Correct Code.
6. Set timeout and wrong-input behavior.
7. Set success and failure actions.
8. Save and test from the physical keypad.

Direct keypad actions

Use Action Triggers when one key should immediately do something, such as play a beep or light a key. Use Input Sequences when the order matters, you can also combine these methods with Logic Rules to build button press feedback.

Troubleshooting

Symptom	What to check
Wrong key appears	Row/column order or layout mapping
No keys appear	Row pins, column pins, or pinout order
Multiple keys appear	Wiring short or ghosting from unsupported simultaneous presses