DomotiCasa

La tua guida alla casa intelligente

SwitchBot integrazione avanzata su Home Assistant

SwitchBot Home Assistant: integrazione avanzata su oltre 45 dispositivi

Giovanni Provenzano018 mins

SwitchBot, uno dei brand più innovativi nel panorama della smart home, ha compiuto un passo storico annunciando l’integrazione ufficiale di oltre 45 dispositivi con Home Assistant nella prima metà del 2025. Questa mossa rappresenta un cambio di paradigma per l’azienda giapponese, che abbraccia definitivamente la filosofia open-source e il controllo locale, rispondendo alle esigenze di una community in costante crescita.

Perché l’integrazione ufficiale è importante

Fino a poco tempo fa, gli utenti di Home Assistant dovevano affidarsi a integrazioni custom sviluppate dalla community per controllare i dispositivi SwitchBot. Queste soluzioni, seppur funzionali, erano vulnerabili a modifiche software non documentate da parte del produttore e richiedevano manutenzione costante. Con l’integrazione ufficiale, SwitchBot garantisce stabilità, aggiornamenti regolari e supporto tecnico diretto, eliminando i problemi di compatibilità che affliggevano le implementazioni non ufficiali.

Home Assistant è una delle piattaforme open-source più apprezzate nel settore della domotica, grazie alla possibilità di controllare i dispositivi localmente e creare automazioni avanzate senza dipendere da servizi cloud. SwitchBot ha riconosciuto il valore di questa community e sta lavorando attivamente per semplificare l’integrazione dei propri dispositivi, offrendo nuove modalità di connessione e ampliando continuamente il catalogo di prodotti compatibili.

Le tre modalità di integrazione

L’espansione del supporto a Home Assistant prevede tre diverse modalità di connessione, a seconda della tipologia di dispositivo e delle esigenze dell’utente:

1. Connessione diretta via Bluetooth

I dispositivi SwitchBot più popolari possono integrarsi direttamente con Home Assistant utilizzando la connettività Bluetooth. Questa modalità garantisce il massimo livello di privacy e funzionamento offline, ideale per chi desidera un controllo completamente locale senza dipendenze da internet.

Tra i dispositivi compatibili con connessione Bluetooth diretta troviamo:

Per utilizzare questa modalità è necessario disporre di un adattatore Bluetooth integrato o USB collegato al dispositivo che esegue Home Assistant. In alternativa, è possibile implementare dei Bluetooth Proxy basati su ESP32 per estendere la portata del segnale in tutta l’abitazione.​

2. Integrazione tramite SwitchBot Hub e Cloud

I dispositivi controllati tramite SwitchBot Hub, come elettrodomestici a infrarossi e robot aspirapolvere, possono essere gestiti attraverso Home Assistant grazie alla connessione cloud e all’utilizzo dell’API pubblica di SwitchBot.​

Questa modalità richiede uno degli hub SwitchBot:

Tramite hub e cloud API è possibile controllare:

  • Robot Vacuum K10 Plus Pro e K20 Pro: robot aspirapolvere con stazione di svuotamento automatico

  • Air Purifier Serie: purificatori d’aria con filtri HEPA

  • Universal Remote: telecomando universale per controllare dispositivi IR illimitati

  • Elettrodomestici controllati tramite infrarossi (condizionatori, TV, decoder, ventilatori)

3. Compatibilità con Matter

SwitchBot sta investendo massicciamente nel supporto allo standard Matter, il protocollo universale per smart home che permette di connettere dispositivi di diversi produttori senza necessità di gateway aggiuntivi. Matter garantisce l’interoperabilità con Home Assistant e altri ecosistemi domotici come Apple Home, Google Home e Amazon Alexa.

I dispositivi SwitchBot compatibili Matter includono:

  • SwitchBot Lock Pro: serratura intelligente con certificazione Matter nativa

  • Robot K20 e K20 Pro: aspirapolvere con pairing via QR code Matter

  • Hub Mini Matter Enabled: che rende compatibili Matter anche i dispositivi Bluetooth e IR di SwitchBot

Un numero crescente di prodotti SwitchBot sarà aggiornato per supportare Matter nei prossimi mesi, migliorando ulteriormente l’interoperabilità.​

Installazione dell’integrazione SwitchBot in Home Assistant

Requisiti hardware

Prima di procedere con l’integrazione, verifica di avere l’hardware necessario in base alla modalità di connessione desiderata:

Per dispositivi Bluetooth:

  • Home Assistant installato su qualsiasi piattaforma (Home Assistant OS, Container, Core)

  • Adattatore Bluetooth USB o Bluetooth integrato nel dispositivo host

  • Opzionale: ESP32 configurato come Bluetooth Proxy per estendere la portata

Per dispositivi Matter:

  • Home Assistant OS (OBBLIGATORIO – i container Docker non supportano Matter)

  • SwitchBot Hub 2 o Hub Mini Matter Enabled per dispositivi hub-based

  • Router WiFi 2.4GHz per dispositivi standalone Matter

Per dispositivi Cloud/Hub:

  • Account SwitchBot attivo

  • SwitchBot Hub 2, Hub Mini o Hub 3

  • Connessione internet stabile

  • Token API SwitchBot (ottenibile dall’app mobile)

Installazione passo-passo: Dispositivi Bluetooth

  1. Verifica Bluetooth: vai su Impostazioni > Sistema > Hardware e assicurati che Home Assistant rilevi correttamente l’adattatore Bluetooth

  2. Aggiungi integrazione: vai su Impostazioni > Dispositivi e Servizi > Aggiungi Integrazione

  3. Cerca SwitchBot: digita “SwitchBot” nella barra di ricerca e seleziona l’integrazione ufficiale

  4. Modalità rilevamento: seleziona “Bluetooth” come metodo di connessione

  5. Scansione dispositivi: Home Assistant cercherà automaticamente i dispositivi SwitchBot nelle vicinanze. Assicurati che siano accesi e nel raggio di 10 metri

  6. Accoppiamento: per dispositivi come Lock Ultra potrebbe essere richiesto di premere il pulsante di pairing fisico sul dispositivo

  7. Configurazione: una volta rilevato, il dispositivo apparirà nella dashboard Dispositivi e Servizi con tutte le entità associate

Installazione passo-passo: Dispositivi Matter

  1. Verifica sistema: assicurati di utilizzare Home Assistant OS (non Supervised o Container)

  2. Abilita Matter: vai su Impostazioni > Dispositivi e Servizi > Matter

  3. Aggiungi dispositivo Matter: clicca su “Aggiungi dispositivo” e scegli “Matter”

  4. Scansione QR code: utilizza la fotocamera del computer o smartphone per scannerizzare il codice QR presente sulla confezione del dispositivo SwitchBot

  5. Pairing automatico: Home Assistant configurerà automaticamente il dispositivo e lo renderà disponibile per automazioni

  6. Verifica funzionamento: testa il controllo del dispositivo dalla dashboard Lovelace

Installazione passo-passo: Dispositivi Cloud/Hub

  1. Ottieni API Token: apri l’app SwitchBot, vai su Profilo > Preferenze > App Version (tocca 10 volte per abilitare modalità sviluppatore) > Token

  2. Aggiungi integrazione Cloud: vai su Impostazioni > Dispositivi e Servizi > Aggiungi Integrazione > SwitchBot

  3. Modalità Cloud: seleziona “Cloud API” come metodo di connessione

  4. Inserisci credenziali: incolla il Token e il Secret ottenuti dall’app

  5. Importazione dispositivi: Home Assistant importerà automaticamente tutti i dispositivi associati all’account SwitchBot

  6. Configurazione avanzata: per ogni dispositivo potrai personalizzare le opzioni di polling e timeout

Esempi pratici di automazioni

Automazione 1: Apertura tende all’alba

automation:
  - alias: "Apertura tende automatica alba"
    trigger:
      - platform: sun
        event: sunrise
        offset: "+00:15:00"
    condition:
      - condition: state
        entity_id: binary_sensor.workday_sensor
        state: "on"
    action:
      - service: cover.open_cover
        target:
          entity_id: cover.switchbot_curtain_3_soggiorno

Automazione 2: Chiusura porta intelligente quando esci

automation:
  - alias: "Blocco porta quando esco"
    trigger:
      - platform: state
        entity_id: person.mario_rossi
        from: "home"
        to: "not_home"
        for: "00:02:00"
    action:
      - service: lock.lock
        target:
          entity_id: lock.switchbot_lock_ultra
      - service: notify.mobile_app
        data:
          message: "Porta d'ingresso bloccata automaticamente"

Automazione 3: Controllo temperatura con Bot

automation:
  - alias: "Accendi riscaldamento se temperatura bassa"
    trigger:
      - platform: numeric_state
        entity_id: sensor.switchbot_hub_2_temperature
        below: 18
    action:
      - service: switch.turn_on
        target:
          entity_id: switch.switchbot_bot_termosifone

Automazione 4: Allarme perdite d’acqua

automation:
  - alias: "Notifica perdita acqua"
    trigger:
      - platform: state
        entity_id: binary_sensor.switchbot_leak_detector_bathroom
        to: "on"
    action:
      - service: notify.telegram
        data:
          message: "⚠️ ALLARME: Rilevata perdita d'acqua in bagno!"
      - service: light.turn_on
        target:
          entity_id: light.tutte_luci
        data:
          flash: long

Risoluzione problemi comuni

Il dispositivo Bluetooth non viene rilevato

  • Soluzione 1: Verifica che il dispositivo SwitchBot sia sufficientemente carico. Molti dispositivi entrano in modalità risparmio energetico quando la batteria scende sotto il 20%.
  • Soluzione 2: Rimuovi eventuali ostacoli metallici tra Home Assistant e il dispositivo. Il Bluetooth ha portata limitata e soffre di interferenze.
  • Soluzione 3: Implementa un Bluetooth Proxy ESP32. Posizionalo strategicamente per coprire aree lontane dal server Home Assistant.

Matter non funziona su Home Assistant

Matter richiede obbligatoriamente Home Assistant OS. Se stai utilizzando Home Assistant Container o Supervised, dovrai migrare a HAOS o utilizzare la connessione Bluetooth/Cloud.

Token API non funziona

Assicurati di aver abilitato la modalità sviluppatore toccando 10 volte sulla versione app. Il token ha validità illimitata ma viene rigenerato se disinstalli l’app SwitchBot.

Ritardo nelle risposte Cloud

L’integrazione cloud ha latenza maggiore rispetto a Bluetooth e Matter poiché i comandi transitano sui server SwitchBot. Per dispositivi critici come serrature, preferisci sempre la connessione diretta Bluetooth o Matter.

Lock Ultra non si sblocca

Verifica che le batterie siano cariche (minimo 30%). Controlla anche che la calibrazione della serratura sia corretta dall’app SwitchBot prima di integrarla in Home Assistant.​

Vantaggi dell’ecosistema SwitchBot su Home Assistant

L’integrazione ufficiale di SwitchBot porta numerosi vantaggi concreti:

  • Controllo locale completo: i dispositivi Bluetooth e Matter funzionano anche senza connessione internet, garantendo massima privacy e affidabilità.
  • Nessuna modifica strutturale: prodotti come Bot, Curtain e Lock si installano senza forare muri o sostituire interruttori esistenti, ideale per abitazioni in affitto.
  • Ecosistema unificato: oltre 45 dispositivi controllabili da un’unica piattaforma, con automazioni cross-device senza limiti.
  • Supporto Matter: interoperabilità garantita con Apple Home, Google Home, Amazon Alexa e Samsung SmartThings contemporaneamente.
  • Aggiornamenti costanti: SwitchBot ha promesso rilasci regolari per estendere il supporto ad altri dispositivi nei prossimi mesi.
  • Costo accessibile: i dispositivi SwitchBot hanno prezzi competitivi rispetto ad alternative premium, rendendo la smart home accessibile a tutti.

Dispositivi SwitchBot più popolari per Home Assistant

  • SwitchBot Lock Ultra: la serratura intelligente di ultima generazione con installazione semplificata, batteria che dura 6 mesi e supporto Bluetooth nativo.​
  • SwitchBot Curtain 3: motore per tende con rilevamento automatico della posizione, silenziosissimo e compatibile con qualsiasi tipo di binario.
  • SwitchBot Hub 2: il centro di controllo definitivo con display LED per temperatura/umidità, controllo IR per condizionatori/TV e compatibilità Matter.
  • Robot Vacuum K10 Plus Pro: robot aspirapolvere compatto con stazione di svuotamento automatico e mappatura laser avanzata.
  • SwitchBot Bot: l’attuatore meccanico più versatile per trasformare qualsiasi interruttore in dispositivo smart in 3 secondi.

L’impegno di SwitchBot verso Home Assistant segna una svolta nel panorama della smart home open-source. Con oltre 45 dispositivi ufficialmente supportati tramite Bluetooth, Matter e Cloud API, gli utenti possono finalmente costruire un ecosistema domotico completo, affidabile e privacy-first senza compromessi.

L’installazione è accessibile anche agli utenti meno esperti grazie alle procedure guidate, mentre le automazioni avanzate soddisfano le esigenze dei power user più esigenti. La roadmap di SwitchBot prevede l’espansione continua del supporto nei prossimi mesi, rendendo questa integrazione un investimento solido per il futuro della tua casa intelligente.

Titoli Correlati