12. SwitchBot Keypad / Keypad Touch: Tastierino Biometrico, Codici PIN e Carte NFC per Lock e Lock Pro

1. A cosa serve e Specifiche Tecniche

Keypad Touch è il tastierino esterno resistente alle intemperie (IP65) che consente di aprire la serratura SwitchBot Lock / Lock Pro tramite impronta digitale, codici PIN monouso o card NFC.

📊 Scheda Tecnica e Compatibilità

• 🏷️ Prodotto / Modello: SwitchBot Keypad / Keypad Touch
• ⚙️ Specifiche Hardware: Lettore d'impronte digitali 0.3s, Tastiera retroilluminata IP65, Supporto fino a 100 codici PIN ed NFC, Anti-peeping
• 🌐 Protocolli Supportati: Bluetooth BLE 5.0+, Wi-Fi 2.4GHz / 5GHz, Matter over Bridge / Direct, Infrarossi (IR)
• 🏠 Integrazione Home Assistant: Supportata via BLE Proxy locale, Matter integration o SwitchBot Cloud API

2. Materiali e Prerequisiti Necessari

• Hardware: Modulo SwitchBot Keypad / Keypad Touch in confezione originale.
• Batterie / Alimentazione: Verificare lo stato di carica delle batterie in dotazione o la presenza di un alimentatore USB stabilizzato.
• Connettività: Hub Home Assistant (Raspberry Pi 4 / Mini PC) con Bluetooth integrato o Dongle USB / ESP32 BLE Proxy attivo.
• Smartphone: App SwitchBot ufficiale (iOS / Android) aggiornata all'ultima versione firmware.

Fase 1: procedura originale

3. Fase 1: Preparazione ed Installazione Fisica

Prima di procedere alla configurazione software, effettua l'installazione fisica del dispositivo posizionandolo nel punto strategico della stanza o dell'impianto elettrico.

[SCHEMA GRAFICO INSTALLAZIONE FISICA]
+-----------------------------------------------------------+
|                                                           |
|    [ PARETE / SERRAMENTO / SCATOLA 503 / CILINDRO ]       |
|                            |                              |
|                            v                              |
|           +---------------------------------+             |
|           |   SWITCHBOT_KEYPAD_TOUCH       |             |
|           +---------------------------------+             |
|                            |                              |
|             ( Segnale BLE 5.0 / Wi-Fi )                   |
|                            v                              |
|          [ HOME ASSISTANT / HUB 2 / BLE PROXY ]           |
|                                                           |
+-----------------------------------------------------------+

💡 TRUCCO DA PRO DAL BANCO DI PROVA:

Abilita la funzione Virtual Code (anti-peeping): inserisci cifre casuali prima o dopo il tuo codice PIN reale per impedire che sguardi indiscreti scoprano la password.

Fissa il Keypad con le viti a tassello fornite in dotazione ed attiva l'allarme antimanomissione (Tamper Alarm) dall'app.

Fase 2: procedura originale

4. Fase 2: Configurazione ed Integrazione in Home Assistant

Per integrare il dispositivo in Home Assistant mantenendo la massima velocità di risposta locale ed eliminando la latenza del cloud:

1. Abbinamento App: Apri l'app SwitchBot, aggiungi il dispositivo e calibra la corsa o le impostazioni di base.
2. Aggiornamento Firmware: Assicurati che il firmware del dispositivo sia aggiornato all'ultima versione stabile.
3. Rilevamento in HA: Apri Home Assistant -> Impostazioni -> Dispositivi e Servizi. Il dispositivo apparirà automaticamente tra le integrazioni scoperte via Bluetooth.
4. Inserimento Chiave: Se richiesto, inserisci la chiave Encryption Key nell'integrazione SwitchBot Bluetooth.

Codici temporanei: Gestione codici PIN a scadenza per ospiti e B&B.

Fase 3: procedura originale

5. Fase 3: Automazione Pratica e Codice YAML

Di seguito il codice YAML di esempio pronto da copiare ed incollare nel tuo file automations.yaml su Home Assistant per sfruttare al massimo il dispositivo:

alias: "Allarme Manomissione Keypad Touch"
trigger:
  - platform: state
    entity_id: binary_sensor.keypad_touch_tamper
    to: "on"
action:
  - service: notify.mobile_app
    data:
      title: "🚨 ALLARME TASTIERINO"
      message: "Rilevato tentativo di manomissione fisica del Keypad Touch!"

Verifica e test operativo

6. Verifica e Test Operativo

Per verificare che l'integrazione ed il dispositivo rispondano correttamente senza ritardi:

1. Accedi alla Dashboard Lovelace ed aziona l'entità associata a switchbot_keypad_touch.
2. Verifica che il tempo di risposta del dispositivo sia inferiore a 300ms.
3. Pressione fisica / Trigger: Aziona il sensore o pulsante fisicamente e controlla che l'evento venga registrato immediatamente nei log di Home Assistant (Registro Attività).

Cosa fare se qualcosa non funziona

7. Troubleshooting ed Isolamento Locale

Se il dispositivo risulta "Non Disponibile" o risponde con latenza:

• Disconnessioni BLE: Aggiungi un ESP32 BLE Proxy economico nella stessa stanza del dispositivo per estendere la copertura Bluetooth di Home Assistant.
• Batteria scarica: Se la percentuale della batteria scende sotto il 15%, la potenza del modulo radio BLE si riduce significativamente causando perdite di pacchetti.
• Integrazione Cloud: Se utilizzi le API Cloud, verifica che il token API generato nell'app SwitchBot non sia scaduto.

8. Sicurezza, Privacy e Manutenzione

• Operatività Locale: Prediligi l'integrazione Bluetooth BLE locale o Matter over Thread per fare in modo che le automazioni funzionino anche in assenza di connessione Internet.
• Manutenzione: Sostituisci le batterie utilizzandone esclusivamente di tipo alcalino o al litio di alta qualità (Panasonic, Duracell) ed evita batterie ricaricabili NiMH con tensione a 1.2V per prevenire letture errate.

9. Requisiti e Risorse Ufficiali

• Sito Ufficiale: Documentazione e Firmware Ufficiale SwitchBot
• Repository HA: Integrazione SwitchBot Bluetooth Home Assistant

🛒 Acquista su Amazon in Offerta:

Per acquistare SwitchBot Keypad / Keypad Touch originale al miglior prezzo garantito con spedizione Prime:

👉 Acquista SwitchBot Keypad / Keypad Touch su Amazon.it (Link Affiliato Ufficiale RisparmioHub)

Controlli editoriali prima di iniziare

Annota modello, revisione hardware e versione firmware visibili nell’app prima di modificare qualsiasi impostazione. Conserva anche il nome delle entità già presenti in Home Assistant: questo riferimento permette di riconoscere subito duplicati o variazioni dopo il nuovo abbinamento.

Se il dispositivo partecipa a un’automazione esistente, disattivala temporaneamente dall’interfaccia grafica e salva una copia della configurazione. Esegui una sola modifica per volta, quindi attendi l’aggiornamento dello stato prima di passare al controllo successivo.

Verifica copertura Bluetooth, Wi-Fi o Thread nel punto di installazione senza spostare contemporaneamente hub e accessorio. Un test vicino al gateway distingue un problema radio da un errore di configurazione e rende più semplice ripristinare la situazione iniziale.

Al termine confronta comando nell’app, stato mostrato in Home Assistant e risposta fisica del dispositivo. Se uno dei tre risultati non coincide, interrompi la prova, consulta i messaggi del registro e ripeti soltanto il passaggio coinvolto.

Prima dell’uso quotidiano controlla infine autorizzazioni dell’account, aggiornamenti disponibili e funzionamento locale in assenza temporanea di Internet. Registra l’esito e la data del test: saranno utili per distinguere un futuro guasto da un cambiamento introdotto da firmware, integrazione o rete domestica.