Come usare un keypad 3x4 e 4x4 con Arduino: collegamenti e codice

// https://nemiatools.com
#include <Keypad.h> // Importa la libreria necessaria per gestire il keypad a matrice.

const byte ROWS = 4; // Imposta a quattro il numero di righe del keypad.
const byte COLS = 3; // Imposta il numero di colonne del keypad.

char keys[ROWS][COLS] = { // Inizia la mappa dei caratteri corrispondenti ai tasti.
  {'1', '2', '3'}, // Associa i caratteri alla prima riga della tastiera.
  {'4', '5', '6'}, // Associa i caratteri alla seconda riga della tastiera.
  {'7', '8', '9'}, // Associa i caratteri alla terza riga della tastiera.
  {'*', '0', '#'} // Associa i caratteri alla quarta riga della tastiera.
}; // Termina la dichiarazione della matrice dei tasti.

// R1, R2, R3, R4
byte rowPins[ROWS] = {9, 8, 7, 6}; // Collega le righe R1-R4 ai pin digitali 9, 8, 7 e 6.

// C1, C2, C3
byte colPins[COLS] = {5, 4, 3}; // Associa ciascuna colonna ai rispettivi pin Arduino.

Keypad keypad = Keypad( // Inizia la creazione dell’oggetto che gestisce il keypad.
  makeKeymap(keys), // Passa alla libreria la mappa dei caratteri dei tasti.
  rowPins, // Indica i pin Arduino collegati alle righe.
  colPins, // Indica i pin Arduino collegati alle colonne.
  ROWS, // Comunica all’oggetto il numero di righe.
  COLS // Comunica all’oggetto il numero di colonne.
); // Completa la costruzione dell’oggetto keypad.

void setup() {
  Serial.begin(9600); // Avvia la comunicazione seriale a 9600 baud.
  Serial.println("Keypad 3x4 pronto"); // Mostra il messaggio iniziale nel Monitor Seriale.
}

void loop() {
  char key = keypad.getKey(); // Legge un nuovo tasto premuto, se disponibile.

  if (key != NO_KEY) { // Verifica che sia stato rilevato un tasto valido.
    Serial.print("Tasto premuto: "); // Scrive la descrizione prima del carattere rilevato.
    Serial.println(key); // Stampa il carattere premuto e va a capo.
  } // Termina il controllo sulla presenza di un tasto.
}

// https://nemiatools.com
#include <Keypad.h> // Importa la libreria necessaria per gestire il keypad a matrice.

const byte ROWS = 4; // Imposta a quattro il numero di righe del keypad.
const byte COLS = 4; // Imposta il numero di colonne del keypad.

char keys[ROWS][COLS] = { // Inizia la mappa dei caratteri corrispondenti ai tasti.
  {'1', '2', '3', 'A'}, // Associa i caratteri alla prima riga della tastiera.
  {'4', '5', '6', 'B'}, // Associa i caratteri alla seconda riga della tastiera.
  {'7', '8', '9', 'C'}, // Associa i caratteri alla terza riga della tastiera.
  {'*', '0', '#', 'D'} // Associa i caratteri alla quarta riga della tastiera.
}; // Termina la dichiarazione della matrice dei tasti.

// R1, R2, R3, R4
byte rowPins[ROWS] = {9, 8, 7, 6}; // Collega le righe R1-R4 ai pin digitali 9, 8, 7 e 6.

// C1, C2, C3, C4
byte colPins[COLS] = {5, 4, 3, 2}; // Associa ciascuna colonna ai rispettivi pin Arduino.

Keypad keypad = Keypad( // Inizia la creazione dell’oggetto che gestisce il keypad.
  makeKeymap(keys), // Passa alla libreria la mappa dei caratteri dei tasti.
  rowPins, // Indica i pin Arduino collegati alle righe.
  colPins, // Indica i pin Arduino collegati alle colonne.
  ROWS, // Comunica all’oggetto il numero di righe.
  COLS // Comunica all’oggetto il numero di colonne.
); // Completa la costruzione dell’oggetto keypad.

void setup() {
  Serial.begin(9600); // Avvia la comunicazione seriale a 9600 baud.
  Serial.println("Keypad 4x4 pronto"); // Mostra il messaggio iniziale nel Monitor Seriale.
}

void loop() {
  char key = keypad.getKey(); // Legge un nuovo tasto premuto, se disponibile.

  if (key != NO_KEY) { // Verifica che sia stato rilevato un tasto valido.
    Serial.print("Tasto premuto: "); // Scrive la descrizione prima del carattere rilevato.
    Serial.println(key); // Stampa il carattere premuto e va a capo.
  } // Termina il controllo sulla presenza di un tasto.
}

// https://nemiatools.com
#include <Keypad.h> // Importa la libreria necessaria per gestire il keypad a matrice.
#include <string.h> // Importa le funzioni C per confrontare stringhe, incluso strcmp().

const byte ROWS = 4; // Definisce le quattro righe della tastiera.
const byte COLS = 4; // Definisce le quattro colonne della tastiera.

char keys[ROWS][COLS] = { // Inizia la mappa dei caratteri del keypad 4x4.
  {'1', '2', '3', 'A'}, // Mappa i tasti della prima riga: 1, 2, 3 e A.
  {'4', '5', '6', 'B'}, // Mappa i tasti della seconda riga: 4, 5, 6 e B.
  {'7', '8', '9', 'C'}, // Mappa i tasti della terza riga: 7, 8, 9 e C.
  {'*', '0', '#', 'D'} // Mappa i tasti della quarta riga: *, 0, # e D.
}; // Termina la mappa bidimensionale dei caratteri.

byte rowPins[ROWS] = {9, 8, 7, 6}; // Collega le righe R1-R4 ai pin digitali 9, 8, 7 e 6.
byte colPins[COLS] = {5, 4, 3, 2}; // Collega le colonne C1-C4 ai pin digitali 5, 4, 3 e 2.

Keypad keypad = Keypad( // Inizia la costruzione dell’oggetto keypad.
  makeKeymap(keys), // Fornisce la disposizione dei caratteri alla libreria.
  rowPins, // Passa l’elenco dei pin collegati alle righe.
  colPins, // Passa l’elenco dei pin collegati alle colonne.
  ROWS, // Specifica il numero di righe della matrice.
  COLS // Specifica il numero di colonne della matrice.
); // Conclude la creazione dell’oggetto Keypad.

const char correctCode[] = "2580"; // Definisce il PIN corretto, fissato qui a 2580.
char enteredCode[9]; // Riserva nove caratteri: fino a otto cifre più il terminatore.
byte enteredLength = 0; // Inizializza a zero il numero delle cifre inserite.

void clearCode() {
  enteredLength = 0; // Azzera il conteggio delle cifre memorizzate.
  enteredCode[0] = '\0'; // Inserisce il terminatore per rendere vuota la stringa.
} // Conclude la funzione che cancella il codice inserito.

void setup() {
  Serial.begin(9600); // Attiva la porta seriale a 9600 baud.
  pinMode(LED_BUILTIN, OUTPUT); // Configura il LED integrato di Arduino come uscita.

  keypad.setDebounceTime(25); // Imposta il filtro antirimbalzo a 25 millisecondi.

  Serial.println("Inserisci il codice"); // Invita l’utente a digitare il codice.
  Serial.println("* = cancella, # = conferma"); // Spiega che * cancella e # conferma il codice.
}

void loop() {
  char key = keypad.getKey(); // Legge il tasto premuto in questa iterazione.

  if (key == NO_KEY) { // Controlla se nessun nuovo tasto è stato rilevato.
    return; // Esce subito dal ciclo corrente se non ci sono tasti.
  } // Conclude il controllo sul tasto assente.

  if (key == '*') { // Verifica se è stato premuto il tasto * di cancellazione.
    clearCode(); // Elimina tutte le cifre precedentemente inserite.
    Serial.println("\nCodice cancellato"); // Comunica che l’inserimento è stato cancellato.
  } // Termina la gestione del tasto di cancellazione.
  else if (key == '#') { // In alternativa, verifica se # conferma il codice.
    enteredCode[enteredLength] = '\0'; // Chiude la stringa inserita con il terminatore nullo.

    if (strcmp(enteredCode, correctCode) == 0) { // Confronta il codice inserito con il PIN previsto.
      Serial.println("\nCodice corretto"); // Segnala che il PIN corrisponde a quello corretto.

      digitalWrite(LED_BUILTIN, HIGH); // Accende il LED integrato per segnalare l’esito positivo.
      delay(1000); // Mantiene il LED acceso per 1000 millisecondi.
      digitalWrite(LED_BUILTIN, LOW); // Spegne il LED dopo la segnalazione.
    } // Conclude il ramo eseguito quando il PIN è corretto.
    else { // Gestisce il caso in cui il PIN non corrisponda.
      Serial.println("\nCodice errato"); // Mostra il messaggio relativo al PIN errato.
    } // Conclude il ramo del PIN errato.

    clearCode(); // Svuota l’inserimento dopo ogni conferma.
  } // Conclude la gestione del tasto #.
  else if (key >= '0' && key <= '9') { // Accetta solo caratteri numerici compresi tra 0 e 9.
    if (enteredLength < sizeof(enteredCode) - 1) { // Controlla di lasciare spazio al terminatore di stringa.
      enteredCode[enteredLength] = key; // Memorizza la cifra nella posizione corrente.
      enteredLength++; // Incrementa il numero di cifre inserite.
      enteredCode[enteredLength] = '\0'; // Mantiene la stringa terminata dopo l’ultima cifra.

      Serial.print('*'); // Mostra un asterisco invece della cifra inserita.
    } // Conclude la verifica dello spazio disponibile.
  } // Conclude la gestione di una cifra numerica.
}