Introduzione
SONOFF presenta OpenEdge, un'architettura local-first per i dispositivi smart di nuova generazione, progettata per offrirti un maggiore controllo locale, un'interoperabilità più ampia e modalità più flessibili per connettere i tuoi dispositivi tra piattaforme ed ecosistemi diversi.
Con OpenEdge, i dispositivi SONOFF supportati possono comunicare localmente tramite interfacce aperte, tra cui HTTP, MQTT e WebSocket.
Per gli utenti di Home Assistant, questo offre maggiore libertà nella scelta delle modalità di integrazione dei dispositivi: puoi connetterli localmente tramite MQTT quando preferisci il controllo locale e un'integrazione flessibile con l'ecosistema, mentre la connettività cloud rimane disponibile quando si adatta meglio alle tue esigenze.
Come funziona l'integrazione MQTT con Home Assistant
Prima di iniziare a configurare MQTT, è utile capire come funziona la connessione.
L'architettura di base è la seguente:
Dispositivo SONOFF compatibile con OpenEdge → Broker MQTT → Home Assistant
- Dispositivo SONOFF compatibile con OpenEdge — si connette al broker come client MQTT, pubblica gli stati e i dati del dispositivo e riceve i comandi di controllo.
- Broker MQTT — riceve e distribuisce i messaggi MQTT tra i client connessi. Nelle configurazioni di Home Assistant, Mosquitto è una scelta comune.
- Home Assistant — si connette allo stesso broker tramite l'integrazione MQTT, riceve gli aggiornamenti del dispositivo, invia comandi e gestisce il dispositivo in Home Assistant.
Configura i dispositivi OpenEdge con Home Assistant tramite MQTT
Ora configuriamo l'integrazione MQTT. Questa guida utilizza SONOFF MINI-1GSP come esempio, mentre lo stesso flusso di lavoro di base può essere utilizzato per altri dispositivi OpenEdge compatibili con il supporto MQTT.
Cosa ti serve
- Un dispositivo SONOFF compatibile con OpenEdge e dotato di supporto MQTT.
- Home Assistant è installato e in esecuzione.
- Un broker MQTT è installato e in esecuzione.
- L'integrazione MQTT è stata aggiunta e connessa al broker in Home Assistant.
Installa e configura un broker MQTT
- Apri Home Assistant.
- Vai a Impostazioni → App (precedentemente chiamate componenti aggiuntivi) → Installa app.
- Cerca broker Mosquitto e fai clic su INSTALLA.
- Una volta installata, avvia l'app broker Mosquitto.
- È consigliato attivare Avvio all'accensione e Watchdog, così il broker si avvia automaticamente insieme a Home Assistant e può essere riavviato se si arresta in modo imprevisto.
- Se necessario, crea un utente Home Assistant dedicato per i dispositivi MQTT in Impostazioni → Persone → Utenti.
Per maggiori dettagli sulla scelta e configurazione di un broker MQTT, consulta la guida ufficiale alla configurazione di un broker di Home Assistant.
Aggiungi l'integrazione MQTT in Home Assistant
- In Home Assistant, vai a Impostazioni → Dispositivi e servizi → Aggiungi integrazione.
- Cerca MQTT e completa la configurazione.
- Vai a Impostazioni → Dispositivi e servizi → MQTT per verificare che l'integrazione sia connessa al broker.
Passaggio 1: accendi il dispositivo
Per MINI-1GSP, il dispositivo entra automaticamente in modalità di associazione alla prima accensione. Quando il LED lampeggia due volte brevemente, seguito da un lampeggio lungo, l'hotspot AP è pronto per la configurazione.
Passaggio 2: accedi alla console Web OpenEdge
Esistono due modi per accedere alla console Web.
Metodo 1: accesso tramite hotspot AP — consigliato per la prima configurazione
- Apri le impostazioni Wi-Fi sul tuo computer desktop, tablet o dispositivo mobile.
- Connettiti all'hotspot del dispositivo: SONOFF_1GSP_xxxx.
- Apri un browser Web e vai a: http://192.168.33.1
- Verrà aperta la pagina di accesso alla console Web. Al primo accesso, crea una password di accesso di almeno 8 caratteri.
Accedi per entrare nella console Web OpenEdge.
Dalla console Web puoi gestire le funzioni locali, tra cui il controllo ON/OFF, i dati storici sull'energia, i timer, l'associazione Matter, le impostazioni di rete, la configurazione AP/Wi-Fi, gli aggiornamenti OTA e le informazioni su OpenEdge.
In Impostazioni di connettività puoi configurare la connettività Cloud , MQTT per Home Assistant, le opzioni TLS e le connessioni WebSocket in uscita per piattaforme di terze parti.
Metodo 2: accesso tramite LAN
Se il dispositivo è già connesso alla rete locale, puoi accedere direttamente alla console Web senza connetterti al suo hotspot AP.
Per MINI-1GSP, apri un browser su un dispositivo che possa raggiungere la stessa LAN e inserisci nel browser uno dei seguenti indirizzi:
- MINI-1GSP.local
- l'indirizzo IP locale del dispositivo.
Passaggio 3: connetti il dispositivo alla rete Wi-Fi
Connetti il dispositivo a una rete Wi-Fi che possa raggiungere sia Home Assistant sia il broker MQTT, in modo che possano comunicare tramite la rete locale.
- Vai a Impostazioni di rete → Impostazioni Wi-Fi.
- Seleziona la rete Wi-Fi a cui puoi accedere da Home Assistant e dal broker MQTT.
- Inserisci la password Wi-Fi.
- Fai clic su Salva.
- Attendi che il dispositivo si connetta.
Una volta che il dispositivo si connette alla rete locale, il router gli assegna in genere un indirizzo IP locale tramite DHCP. Questo indirizzo viene mostrato nelle impostazioni Wi-Fi e può essere utilizzato in seguito per accedere alla console Web tramite LAN, come descritto nel Metodo 2 sopra.
Nota: timeout dell'hotspot AP
MINI-1GSP esce automaticamente dalla modalità di associazione dopo circa 10 minuti. Al termine della modalità di associazione, l'hotspot AP utilizzato per la configurazione iniziale non è più disponibile.
Se l'hotspot AP scompare prima che tu abbia completato la configurazione:
- Se il dispositivo è già connesso alla rete locale, continua la configurazione tramite il metodo di accesso LAN descritto sopra.
- Se devi utilizzare nuovamente l'hotspot AP, tieni premuto il pulsante del dispositivo per 5 secondi per rientrare in modalità di associazione.
- Riconnettiti a SONOFF_1GSP_xxxx, apri http://192.168.33.1 e continua la configurazione.
Suggerimento: tenendo premuto il pulsante del dispositivo per 10 secondi viene eseguito un ripristino delle impostazioni di fabbrica.
Passaggio 4: abilita MQTT e configura i parametri
- Vai a Impostazioni di connettività → MQTT.
- Abilita MQTT.
- Configura i parametri MQTT come mostrato di seguito
- Quando le impostazioni sono complete, fai clic su Salva.
Esempio di configurazione MQTT della console Web del dispositivo:
|
Impostazione |
Cosa inserire |
|
Server |
Indirizzo e porta del broker MQTT, ad es. |
|
Nome utente |
Nome utente del broker MQTT |
|
Password |
Password del broker MQTT |
|
Tipo di connessione |
Seleziona l'opzione TLS corrispondente al tuo broker |
|
Notifiche dello stato RPC tramite MQTT |
Abilita o disabilita secondo necessità |
- Il campo Server deve puntare al tuo broker MQTT. Se Mosquitto Broker è in esecuzione sullo stesso host di Home Assistant, in genere si tratta dell’indirizzo IP dell’host di Home Assistant con la porta MQTT 1883, ad esempio: 192.168.1.242:1883.
- Se utilizzi il Mosquitto Broker ufficiale di Home Assistant e non hai creato credenziali MQTT separate (nome utente e password), puoi usare un nome utente e una password di Home Assistant esistenti.
- Se Mosquitto è già configurato con un nome utente e una password, inserisci lo stesso nome utente e la stessa password nelle impostazioni MQTT della Console Web del dispositivo.
Passaggio 5: verifica e controlla il dispositivo in Home Assistant
- Dopo aver salvato le impostazioni MQTT, riconnetti il computer, il tablet o il dispositivo mobile alla rete locale che può accedere a Home Assistant e al broker MQTT.
- Apri Home Assistant e vai a Impostazioni → Dispositivi e servizi → MQTT
Il dispositivo dovrebbe già comparire nell’elenco dei dispositivi MQTT. I dispositivi SONOFF compatibili con OpenEdge e dotati di supporto MQTT pubblicano nativamente le informazioni di MQTT Discovery di Home Assistant, consentendo a Home Assistant di aggiungere automaticamente il dispositivo e creare le entità supportate senza configurare manualmente topic MQTT o YAML.
-
Apri la pagina del dispositivo per visualizzare i controlli e le entità disponibili. Nell’esempio del MINI-1GSP sono incluse funzioni come:
- Controllo del relè
- Corrente
- Tensione
- Potenza
- Frequenza
- Dati energetici
Puoi quindi aggiungere queste entità alla dashboard di Home Assistant o utilizzarle nelle automazioni e nelle scene.
Dispositivi supportati da OpenEdge
MINI-1GSP è il primo prodotto SONOFF a supportare OpenEdge.
Presto saranno disponibili altri dispositivi compatibili con OpenEdge, tra cui:
- MINI-1GP
- MINI-1GS
- MINI-1GS10
OpenEdge si estenderà gradualmente anche ad altre categorie di prodotti SONOFF, tra cui:
- Interruttori smart — controllo locale e integrazione più flessibili tramite interfacce aperte.
- Prodotti per la gestione dell’energia — elaborazione locale dei dati e monitoraggio dell’energia più trasparente.
- Altri dispositivi smart — connessione a più piattaforme ed ecosistemi grazie alle funzionalità di integrazione aperta di OpenEdge.
Per conoscere i dispositivi supportati più recenti e le funzionalità disponibili dopo l’integrazione con Home Assistant, consulta l’[Elenco del supporto alle funzionalità di Home Assistant per i dispositivi SONOFF OpenEdge].
Conclusione
SONOFF OpenEdge semplifica l’integrazione con Home Assistant, rendendola più locale e flessibile. Grazie alla Console Web integrata e all’API locale standardizzata di OpenEdge tramite MQTT, i dispositivi SONOFF supportati possono essere configurati direttamente da un browser e integrati localmente con Home Assistant, offrendo una configurazione semplice, un controllo locale reattivo e automazioni più flessibili senza affidarsi al cloud per l’integrazione.
Commenta
Nota che i commenti devono essere approvati prima di essere pubblicati.
Questo sito è protetto da hCaptcha e applica le Norme sulla privacy e i Termini di servizio di hCaptcha.