SwitchBot / Home Assistant
4. SwitchBot AI Hub: Visione Locale Edge, Riconoscimento Gesti ed Automazioni Intelligenti su HA
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 S

1. A cosa serve e Specifiche Tecniche
SwitchBot AI Hub analizza in locale gesti della mano ed eventi visivi per attivare scene domotiche senza inviare alcun flusso video all'esterno, integrandosi nativamente con Home Assistant.
📊 Scheda Tecnica e Compatibilità
- 🏷️ Prodotto / Modello: SwitchBot AI Hub
- ⚙️ Specifiche Hardware: Chip Edge AI NPU, Camera IR locale per Gesture Control, Protocollo Matter, Bluetooth 5.3, Wi-Fi Dual Band
- 🌐 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 AI Hub 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_AI_HUB | |
| +---------------------------------+ |
| | |
| ( Segnale BLE 5.0 / Wi-Fi ) |
| v |
| [ HOME ASSISTANT / HUB 2 / BLE PROXY ] |
| |
+-----------------------------------------------------------+ 💡 TRUCCO DA PRO DAL BANCO DI PROVA:
Configura i gesti della mano (es. palmo aperto per spegnere le luci) all'interno dell'app prima di esportarli come entità event su HA.
Mieni pulita la lente frontale della NPU ed evita di coprire il microfono di calibrazione visiva.
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: event.switchbot_ai_hub_gesture_detected.
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: "AI Hub - Gesture Palmo per Spegnimento Luci"
trigger:
- platform: state
entity_id: event.switchbot_ai_hub_gesture
attribute: gesture_type
to: "palm_open"
action:
- service: light.turn_off
target:
entity_id: light.luci_soggiorno 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_ai_hub.
- 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 AI Hub originale al miglior prezzo garantito con spedizione Prime:
👉 Acquista SwitchBot AI Hub 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.