SwitchBot / Home Assistant
38. SwitchBot Tag / NFC Card: Tag NFC Programmabili per Attivazione Rapida Automazioni Domotiche
Sicurezza: interrompi l’alimentazione prima di intervenire su cavi, morsetti o dispositivi a tensione di rete e rivolgiti a un tecnico qualificato se non puoi operare in sicurezza. 1. A cosa serve e Specifiche Tecniche I

1. A cosa serve e Specifiche Tecniche
I Tag NFC SwitchBot consentono di eseguire automazioni domotiche istantanee semplicemente avvicinando lo smartphone al bollino posizionato sul comodino, sul cruscotto dell'auto o vicino alla porta.
📊 Scheda Tecnica e Compatibilità
- 🏷️ Prodotto / Modello: SwitchBot Tag / NFC Card
- ⚙️ Specifiche Hardware: Adesivi NFC impermeabili con strato schermante anti-metallo, Chip NTAG216 alta capacità (888 bytes)
- 🌐 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 Tag / NFC Card 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_NFC_TAG | |
| +---------------------------------+ |
| | |
| ( Segnale BLE 5.0 / Wi-Fi ) |
| v |
| [ HOME ASSISTANT / HUB 2 / BLE PROXY ] |
| |
+-----------------------------------------------------------+ 💡 TRUCCO DA PRO DAL BANCO DI PROVA:
Grazie allo strato schermante interno in ferrite, puoi incollare questi tag direttamente su superfici metalliche (frigoriferi, montanti di porte) senza interferenze.
Non applicare i tag NFC in posizioni accessibili dalla strada esterna per motivi di sicurezza sulla serratura.
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:
- Abbinamento App: Apri l'app SwitchBot, aggiungi il dispositivo e calibra la corsa o le impostazioni di base.
- Aggiornamento Firmware: Assicurati che il firmware del dispositivo sia aggiornato all'ultima versione stabile.
- Rilevamento in HA: Apri Home Assistant -> Impostazioni -> Dispositivi e Servizi. Il dispositivo apparirà automaticamente tra le integrazioni scoperte via Bluetooth.
- Inserimento Chiave: Se richiesto, inserisci la chiave Encryption Key nell'integrazione SwitchBot Bluetooth.
Eventi HA: tag.scanned (tag_id univoco).
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: "NFC - Scansione Comodino Notte"
trigger:
- platform: event
event_type: tag_scanned
event_data:
tag_id: "a3-b4-c5-d6"
action:
- service: scene.turn_on
target:
entity_id: scene.buonanotte Verifica e test operativo
6. Verifica e Test Operativo
Per verificare che l'integrazione ed il dispositivo rispondano correttamente senza ritardi:
- Accedi alla Dashboard Lovelace ed aziona l'entità associata a switchbot_nfc_tag.
- Verifica che il tempo di risposta del dispositivo sia inferiore a 300ms.
- 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 Tag / NFC Card originale al miglior prezzo garantito con spedizione Prime:
👉 Acquista SwitchBot Tag / NFC Card 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.