Wiring guide

How to wire a 4x4 keypad to a Raspberry Pi Pico

To wire a 4x4 keypad to a Raspberry Pi Pico, connect R1, R2, R3, R4 to GP2 (physical pin 4), GP3 (physical pin 5), GP6 (physical pin 9), GP7 (physical pin 10); and C1, C2, C3, C4 to GP8 (physical pin 11), GP9 (physical pin 12), GP10 (physical pin 14), GP11 (physical pin 15). A membrane keypad is sixteen switches with no power pin, so nothing on it can exceed the Raspberry Pi Pico’s own 3.3 V levels and nothing needs shifting. The sketch below uses the Keypad (Keypad.h) library. It scans the rows and columns and prints each key you press.

  • 3.3 V logic
  • Library: Keypad.h
  • 8 wires
Raspberry Pi Pico · 4x4 keypadlive0.000 s 0.00x
Click to open it in the editor
The circuit itself, running on the simulator with the sketch below. Press what can be pressed; click anything else to open it in the editor.
Pin to pin

4x4 keypad to Raspberry Pi Pico wiring table

Every wire in the circuit above, with the part’s pin names and the board’s own labels. The wire colors are the ones the circuit uses; on a real bench any colors work.

4x4 keypad pinRaspberry Pi Pico pinWire colorWhy
R1, R2, R3, R4GP2 (physical pin 4), GP3 (physical pin 5), GP6 (physical pin 9), GP7 (physical pin 10)amberThe rows: the library drives one low at a time.
C1, C2, C3, C4GP8 (physical pin 11), GP9 (physical pin 12), GP10 (physical pin 14), GP11 (physical pin 15)greenThe columns: inputs with pull-ups, read for each row.
Voltage

Power and logic levels for 4x4 keypad and Raspberry Pi Pico

Logic level

The Raspberry Pi Pico’s GPIO pins are 3.3 V logic and are not 5 V tolerant. Nothing wired to a pin may go above 3.3 V.

This pair

A membrane keypad has no power pin: it is sixteen switches at the crossings of four row wires and four column wires. Eight pins of the Raspberry Pi Pico scan it, using the chip’s internal pull-ups, so no resistors are needed.

Pins to leave alone

The numbers in the code are GP numbers, not the physical pin numbers printed beside the header: GP15 is pin 20. GP23 to GP25 are used on the board itself, and GP25 is the LED.

The sketch

The working code for the Raspberry Pi Pico

Library: Keypad (Keypad.h). This is the sketch the circuit above runs.

4x4 keypad on Raspberry Pi Pico
#include <Keypad.h>

const byte ROWS = 4;
const byte COLS = 4;
char keys[ROWS][COLS] = {
  {'1', '2', '3', 'A'},
  {'4', '5', '6', 'B'},
  {'7', '8', '9', 'C'},
  {'*', '0', '#', 'D'},
};
byte rowPins[ROWS] = {2, 3, 6, 7};   // R1 to R4
byte colPins[COLS] = {8, 9, 10, 11};   // C1 to C4

Keypad keypad = Keypad(makeKeymap(keys), rowPins, colPins, ROWS, COLS);

void setup() {
  Serial.begin(115200);
  Serial.println("Press a key");
}

void loop() {
  char key = keypad.getKey();   // 0 when nothing new was pressed
  if (key) {
    Serial.print("Key: ");
    Serial.println(key);
  }
}
Output

What you should see

Open the serial monitor at 115200 baud. The sketch prints Press a key and then a Key line with the character of each key you press. The library debounces the keys itself.

If the wrong characters come out, the rows and columns are swapped: R1 to R4 must go to the row pins in the sketch, C1 to C4 to the column pins.

The serial monitor prints this, recorded from the circuit above with the 5 key pressed after 300 ms:

Press a key
Key: 5
Pitfalls

Common mistakes wiring a 4x4 keypad to a Raspberry Pi Pico

Rows and columns swapped

Swap the two arrays and every key prints its mirror across the diagonal, so 2 prints 4. If the wrong keys come out in a pattern, swap rowPins and colPins.

Pins listed in the wrong order

The connector order is R1 to R4 then C1 to C4 on most keypads, left to right with the keys facing you. List the pins in exactly that order or keys move around.

Running out of pins

A 4x4 keypad takes eight pins, which on the Raspberry Pi Pico leaves little room. An I2C port expander such as the PCF8574 scans it over two wires instead.

Build your own 4x4 keypad project

Open this circuit in the editor, change the wiring or the code, and keep your version in a free account.