Componenten · 5 min leestijd

Een keypad gebruiken: een 4x4-codeslot met Arduino

Hoe werkt een matrixkeypad? 4x4- en 3x4-keypads aansluiten, rij-kolomscanning, de Keypad-bibliotheek, toetsaanslagen lezen, wachtwoordinvoer en een servo-codeslot, gebruik met een LCD, plus ESP32 en Pico.

Een keypad is een goedkoop invoerapparaat, vergelijkbaar met de toetsen van een telefoon, waarmee je cijfers of letters in je project invoert. Codeslot voor deuren, kluizen, rekenmachines, alarmpanelen en menusystemen worden met keypads gebouwd. De meest gebruikte modellen zijn dunne membraankeypads met een plakrug, in 4x4 (16 toetsen) en 3x4 (12 toetsen).

4x4-membraankeypad
4x4-membraankeypad: de cijfers 0–9, de letters A–D en de toetsen * en #; de flatkabel onderaan heeft 8 pinnen.

Hoe werkt een keypad? De rij-kolommatrix

Als elk van de 16 toetsen een eigen pin had, zou je 16 pinnen nodig hebben. Een keypad rangschikt zijn toetsen daarom in een matrix: er zijn 4 rijen en 4 kolommen, elke toets zit op het kruispunt van een rij en een kolom, en door indrukken verbindt hij die rij met die kolom. De Arduino zet de rijen één voor één LOW en leest de kolommen uit; welke kolom LOW leest terwijl een bepaalde rij LOW is, vertelt je welke toets is ingedrukt. Doordat deze scanning honderden keren per seconde gebeurt, worden 16 toetsen met slechts 8 pinnen uitgelezen.

TypeToetsenPinnenTypisch gebruik
4x4-membraan16 (0–9, A–D, *, #)8Wachtwoorden, menu's, rekenmachines
3x4-membraan12 (0–9, *, #)7Cijferinvoer zoals op een telefoontoetsenbord
1x4-membraan45Eenvoudige menu's en keuzetoetsen

Pinout en bedrading van het keypad

Met de toetsen naar je toe zijn de pinnen van de flatkabel meestal, van links naar rechts, R1, R2, R3, R4, C1, C2, C3, C4: de eerste vier zijn rijen en de laatste vier kolommen. Extra weerstanden zijn niet nodig; de bibliotheek gebruikt de interne pull-upweerstanden van de Arduino voor de kolommen.

Keypad-pinFunctieArduino Uno
1R1 (1, 2, 3, A)D9
2R2 (4, 5, 6, B)D8
3R3 (7, 8, 9, C)D7
4R4 (*, 0, #, D)D6
5C1 (1, 4, 7, *)D5
6C2 (2, 5, 8, 0)D4
7C3 (3, 6, 9, #)D3
8C4 (A, B, C, D)D2
Als je bij 1 een D krijgt en bij 4 een C, is de volgorde van rijen en kolommen omgedraaid. Je hoeft niet om te bedraden: draai gewoon de volgorde van de arrays rowPins en colPins in de code om.

Toetsen lezen met de Keypad-bibliotheek

Zoek in de Library Manager naar Keypad en installeer de bibliotheek van Mark Stanley en Alexander Brevig. De code hieronder print elke toets die je indrukt in de Serial Monitor:

C++ (Arduino IDE)
1#include <Keypad.h>
2
3const byte ROWS = 4, COLS = 4;
4char keys[ROWS][COLS] = {
5  {'1', '2', '3', 'A'},
6  {'4', '5', '6', 'B'},
7  {'7', '8', '9', 'C'},
8  {'*', '0', '#', 'D'}
9};
10byte rowPins[ROWS] = {9, 8, 7, 6};     // R1–R4
11byte colPins[COLS] = {5, 4, 3, 2};     // C1–C4
12Keypad keypad = Keypad(makeKeymap(keys), rowPins, colPins, ROWS, COLS);
13
14void setup() {
15  Serial.begin(9600);
16}
17
18void loop() {
19  char key = keypad.getKey();          // tuş yoksa 0 döner / returns 0 if no key
20  if (key) {
21    Serial.println(key);
22  }
23}

getKey() blokkeert je programma niet: als er op dat moment geen toets is ingedrukt, geeft de functie meteen 0 terug, zodat je in loop() ander werk kunt doen. De bibliotheek handelt contactdender zelf af en meldt elke aanslag maar één keer. Wil je wachten tot er een toets wordt ingedrukt, gebruik dan waitForKey().

Een codeslot bouwen

Nu verzamelen we de ingedrukte toetsen in een string en vergelijken we ze met een opgeslagen wachtwoord. De toets * wist de invoer en de toets # bevestigt hem. Is het wachtwoord goed, dan opent een servomotor het slot gedurende 3 seconden. Voor de bedrading van de servo, zie Wat is een servomotor?

C++ (Arduino IDE)
1#include <Keypad.h>
2#include <Servo.h>
3
4const byte ROWS = 4, COLS = 4;
5char keys[ROWS][COLS] = {
6  {'1', '2', '3', 'A'},
7  {'4', '5', '6', 'B'},
8  {'7', '8', '9', 'C'},
9  {'*', '0', '#', 'D'}
10};
11byte rowPins[ROWS] = {9, 8, 7, 6};
12byte colPins[COLS] = {5, 4, 3, 2};
13Keypad keypad = Keypad(makeKeymap(keys), rowPins, colPins, ROWS, COLS);
14
15Servo lock;
16const String PASSWORD = "1234";
17String input = "";
18
19void setup() {
20  Serial.begin(9600);
21  lock.attach(10);
22  lock.write(0);                        // kilitli / locked
23}
24
25void loop() {
26  char key = keypad.getKey();
27  if (!key) return;
28  if (key == '*') {                     // temizle / clear
29    input = "";
30  } else if (key == '#') {              // onayla / confirm
31    if (input == PASSWORD) {
32      Serial.println("Doğru, açılıyor / correct, opening");
33      lock.write(90);
34      delay(3000);
35      lock.write(0);
36    } else {
37      Serial.println("Yanlış şifre / wrong code");
38    }
39    input = "";
40  } else if (input.length() < 8) {
41    input += key;
42    Serial.print('*');                  // tuşu gizle / hide the key
43  }
44}
Dit slot is bedoeld voor leerprojecten en hobbyprojecten. Voor een echte deur voeg je na een paar foute pogingen een blokkeertijd toe, sla je het wachtwoord op in EEPROM in plaats van als leesbare tekst in de code, en plaats je de elektronica waar niemand er van buitenaf bij kan.

Gebruik met een LCD

Een display maakt het veel makkelijker om te zien wat je doet tijdens het invoeren van een wachtwoord. Een I2C-LCD gebruikt alleen de pinnen A4 en A5 en blijft dus van de 8 digitale pinnen van het keypad af. Print bij elke toetsaanslag een sterretje op de onderste regel van de LCD en toon na bevestiging "Open" of "Fout" op de bovenste regel. De bedrading en commando's van het display staan in Een I2C-LCD-display gebruiken.

Minder pinnen: I2C- en analoge keypads

Een keypad alleen neemt al 8 van de 20 pinnen van de Uno in beslag. Als je pinnen tekortkomt, zijn er twee oplossingen: een I2C-keypadadapter op basis van de PCF8574 brengt het keypad terug tot slechts twee draden en deelt de bus met een LCD. Bij analoge keypads geeft elke toets een andere weerstand en wordt het hele keypad via één analoge pin uitgelezen; dat vraagt minder draden, maar herkent niet twee tegelijk ingedrukte toetsen.

Keypads met de ESP32 en de Raspberry Pi Pico

De Keypad-bibliotheek werkt ook op de ESP32. Omdat de rijpinnen als uitgang worden gebruikt en de kolompinnen als ingang met pull-up, vermijd je GPIO 34–39, die geen uitgang kunnen zijn en geen pull-upweerstanden hebben; kies bijvoorbeeld 13, 12, 14 en 27 voor de rijen en 26, 25, 33 en 32 voor de kolommen. Op de Pico met MicroPython kun je de scanning zelf in een paar regels schrijven:

MicroPython
1from machine import Pin
2import time
3
4KEYS = ["123A", "456B", "789C", "*0#D"]
5rows = [Pin(n, Pin.OUT, value=1) for n in (2, 3, 4, 5)]        # R1–R4
6cols = [Pin(n, Pin.IN, Pin.PULL_UP) for n in (6, 7, 8, 9)]     # C1–C4
7
8def scan():
9    for r, row in enumerate(rows):
10        row.value(0)                         # bu satırı etkinleştir / activate this row
11        for c, col in enumerate(cols):
12            if col.value() == 0:             # tuş basılı / key pressed
13                row.value(1)
14                return KEYS[r][c]
15        row.value(1)
16    return None
17
18last = None
19while True:
20    key = scan()
21    if key and key != last:                  # her basışı bir kez yaz / print each press once
22        print(key)
23    last = key
24    time.sleep_ms(50)

Projectideeën met een keypad

  • Codekluis: een doos die opengaat zodra de code is ingevoerd, met een servomotor, een LCD en een buzzer.
  • Rekenmachine: gebruik de toetsen A–D als de vier bewerkingen en toon het resultaat op een LCD.
  • Kleurkiezer: verander de kleur van een RGB-led op basis van het ingevoerde getal.
  • Alarmpaneel: schakel met een code een alarm met een PIR-sensor in en uit.
  • Getallenraadspel: vind het getal dat de Arduino heeft gekozen met de hints "hoger" en "lager".
  • Sneltoetsenbord: maak van elke toets een sneltoets voor je computer met een Arduino Leonardo.

Veelgemaakte fouten en hoe je ze oplost

  • Er wordt een andere toets gelezen dan je indrukt: de volgorde van rijen en kolommen is omgedraaid; draai de volgorde van de arrays rowPins en colPins om.
  • Er wordt helemaal geen toets gelezen: de flatkabel zit één pin verschoven, of de rij- en kolompinnen verschillen van die in de code.
  • Sommige toetsen werken nooit: een rij- of kolomdraad heeft een slecht contact; vallen alle toetsen in één rij of kolom uit, dan is dat het teken.
  • Pinnen 0 en 1 gebruiken: deze pinnen zijn voor USB-seriële communicatie; code uploaden terwijl het keypad is aangesloten kan mislukken.
  • Sommige kolommen lijken op de ESP32 steeds ingedrukt: er worden GPIO 34–39 gebruikt, die geen pull-ups hebben; ga over op andere pinnen.
  • Herhaling verwachten bij lang indrukken: getKey() meldt elke aanslag één keer; gebruik de HOLD-status van de bibliotheek om een vastgehouden toets te herkennen.

Een keypad is eigenlijk gewoon een stel knoppen in een matrix; de logica van knoppen vind je in Een drukknop op Arduino aansluiten. In de BlueGrays-app vind je de basis van 3x4- en 4x4-keypads, een LCD-wachtwoordapp, een slimme elektronische kluis, een I2C-rekenmachine en een RGB-led-besturing met keypad, met schakelschema's en code.

Veelgestelde vragen

Hoeveel pinnen gebruikt een 4x4-keypad?

Een 4x4-keypad gebruikt 8 pinnen: 4 rijen en 4 kolommen. Een 3x4-keypad gebruikt 7 pinnen en een 1x4-keypad 5. Als je pinnen tekortkomt, kun je met een I2C-keypadadapter terug naar 2 draden, of met een analoog keypad naar één analoge pin.

Heeft een keypad weerstanden nodig?

Nee. De Keypad-bibliotheek schakelt de interne pull-upweerstanden van de Arduino in op de kolompinnen, dus je hoeft geen weerstanden toe te voegen. Je kunt het keypad direct op digitale pinnen aansluiten.

Op welke pinnen sluit je een keypad aan?

Op elke 8 digitale pinnen; analoge pinnen kunnen ook als digitaal worden gebruikt. Vermijd op de Uno de pinnen 0 en 1, die voor USB-seriële communicatie dienen. Gebruik op de ESP32 niet GPIO 34–39, die geen uitgang kunnen zijn en geen pull-upweerstanden hebben.

Kan ik twee tegelijk ingedrukte toetsen herkennen?

Ja, de functie getKeys() van de Keypad-bibliotheek herkent maximaal 10 tegelijk ingedrukte toetsen. Bij membraankeypads zonder diodes kunnen sommige combinaties van drie toetsen er echter voor zorgen dat een toets ingedrukt lijkt terwijl dat niet zo is (ghosting).

Als ik het wachtwoord wijzig, is het dan weg na een stroomuitval?

Een wachtwoord in een variabele keert terug naar de standaardwaarde in de code wanneer de Arduino opnieuw opstart. Wil je dat een nieuw wachtwoord blijft bestaan, sla het dan op in EEPROM en lees het bij het opstarten weer uit EEPROM.

Hoe duurzaam is een membraankeypad?

Membraankeypads gaan meestal ongeveer 1 miljoen aanslagen per toets mee en omdat ze dun en licht zijn, plak je ze eenvoudig op een doos of deksel. Ze zijn niet volledig beschermd tegen water en stof; buiten verdienen keypads met metalen of siliconen toetsen de voorkeur.

Alle projecten bekijken
3x4-keypad gebruiken
AR-61Beginner

3x4-keypad gebruiken

De Arduino weet direct welke toets je indrukt op een keypad met 12 toetsen dat op het toetsenbord van een telefoon lijkt, en schrijft die op het scherm van je computer.

4.5(24)
32
Leds bedienen met een 3x4-keypad
AR-62Gemiddeld
Premium

Leds bedienen met een 3x4-keypad

Met een keypad zoals op een telefoon bedien je drie aparte lampjes. Toets 1, 2 en 3 zetten de groene, blauwe en gele led aan, toets 4, 5 en 6 zetten dezelfde lampjes uit, de sterretoets zet ze alle…

4.6(29)
38
4x4-keypad gebruiken
AR-63Beginner
Premium

4x4-keypad gebruiken

Op het 4x4-keypad, dat veel lijkt op de toetsen van een telefoon, weet de Arduino direct welke toets je indrukt en schrijft die op je computerscherm.

4.5(27)
35
Codeslot met 4x4-keypad en LCD
AR-64Gevorderd
Premium

Codeslot met 4x4-keypad en LCD

Een klein elektronisch deurslot dat iedereen buiten houdt die de code niet kent.

4.8(59)
75
Arduino-ontwikkaarstoetsenbord
AR-65Gemiddeld
Premium

Arduino-ontwikkaarstoetsenbord

Als je het zat bent om tijdens het programmeren steeds dezelfde regels te typen, wordt dit kleine keypad je sneltoetsenbord.

4.7(40)
52
Slimme elektronische kluis
AR-92Gevorderd
Premium

Slimme elektronische kluis

Een kleine kluis voor je waardevolle spullen die opent met een code. Je tikt je viercijferige code in op het toetsenbord; klopt hij, dan opent de servomotor het slot, gaat het groene lampje aan en…

4.7(42)
63
Arduino I2C-rekenmachine
AR-94Gemiddeld
Premium

Arduino I2C-rekenmachine

Een rekenmachineproject op basis van Arduino dat optellen, aftrekken, vermenigvuldigen en delen doet met een 4x4-membraantoetsenbord en een 16x2 I2C-LCD. Dankzij I2C sluit je het display aan met slechts 2 draden, zodat er minder kabelwirwar is en meer pins vrij blijven. Ook decimale getallen en negatieve getallen worden ondersteund.

5.0(31)
43