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
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 pin | Raspberry Pi Pico pin | Wire color | Why |
|---|---|---|---|
| R1, R2, R3, R4 | GP2 (physical pin 4), GP3 (physical pin 5), GP6 (physical pin 9), GP7 (physical pin 10) | amber | The rows: the library drives one low at a time. |
| C1, C2, C3, C4 | GP8 (physical pin 11), GP9 (physical pin 12), GP10 (physical pin 14), GP11 (physical pin 15) | green | The columns: inputs with pull-ups, read for each row. |
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 working code for the Raspberry Pi Pico
Library: Keypad (Keypad.h). This is the sketch the circuit above runs.
#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);
}
}
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: 5Common 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.