SwitchBot / Home Assistant
5. SwitchBot Bot: Il Premipulsante Meccanico Smart per Interruttori e Macchine del Caffè
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 Bot è un piccolo braccio meccanico programmabile che preme pulsanti fisici, interruttori a parete o tasti di elettrodomestici (macchine da caffè, citofoni, PC) rendendoli domotici senza modifiche cablate.
📊 Scheda Tecnica e Compatibilità
- 🏷️ Prodotto / Modello: SwitchBot Bot
- ⚙️ Specifiche Hardware: Motore passo-passo ad alta coppia (up to 1.2kgf), Bluetooth BLE 4.2/5.0, Batteria CR2 sostituibile (600 giorni)
- 🌐 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 Bot 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_BOT | |
| +---------------------------------+ |
| | |
| ( Segnale BLE 5.0 / Wi-Fi ) |
| v |
| [ HOME ASSISTANT / HUB 2 / BLE PROXY ] |
| |
+-----------------------------------------------------------+ 💡 TRUCCO DA PRO DAL BANCO DI PROVA:
Utilizza la modalità Add-on (gancetto adesivo con biadesivo 3M) per consentire al Bot sia di premere che di tirare la levetta dell'interruttore.
Pulisci accuratamente la superficie di plastica con alcool isopropilico prima di incollare l'adesivo 3M per evitare che il Bot si stacchi sotto sforzo.
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.
Modalità operativa: Switch Mode (interruttore) o Press Mode (impulso con Hold Time da 1 a 60 secondi).
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: "Caffè Mattutino - Pressione Bot Macchina Caffè"
trigger:
- platform: time
at: "07:15:00"
action:
- service: switch.turn_on
target:
entity_id: switch.switchbot_bot_macchina_caffe 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_bot.
- 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 Bot originale al miglior prezzo garantito con spedizione Prime:
👉 Acquista SwitchBot Bot 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.