Bevezetés
A SONOFF bemutatja az OpenEdge rendszert, a következő generációs okoseszközökhöz készült, helyi működést előtérbe helyező architektúrát, amelynek célja a nagyobb helyi vezérlés, a szélesebb körű együttműködés és az eszközök különböző platformokhoz és ökoszisztémákhoz való csatlakoztatásának rugalmasabb lehetőségei.
Az OpenEdge révén a támogatott SONOFF-eszközök helyileg, nyílt interfészeken, többek között HTTP-n, MQTT-n és WebSocketen keresztül kommunikálhatnak.
A Home Assistant felhasználói számára ez nagyobb választási szabadságot jelent az eszközök integrálásában: ha helyi vezérlést és rugalmas ökoszisztéma-integrációt szeretne, helyileg, MQTT-n keresztül csatlakoztathatja őket, miközben a felhőkapcsolat továbbra is elérhető, ha az jobban megfelel az igényeinek.
Hogyan működik a Home Assistanttal való MQTT-integráció
Az MQTT konfigurálásának megkezdése előtt érdemes megérteni, hogyan működik a kapcsolat.
Az alapvető felépítés a következő:
OpenEdge-kompatibilis SONOFF-eszköz → MQTT-bróker → Home Assistant
- OpenEdge-kompatibilis SONOFF-eszköz — MQTT-kliensként csatlakozik a brókerhez, közzéteszi az eszköz állapotát és adatait, valamint fogadja a vezérlési parancsokat.
- MQTT-bróker — fogadja és továbbítja az MQTT-üzeneteket a csatlakoztatott kliensek között. Home Assistant-környezetben gyakori választás a Mosquitto.
- Home Assistant — az MQTT-integráción keresztül ugyanahhoz a brókerhez csatlakozik, fogadja az eszközfrissítéseket, parancsokat küld, és kezeli az eszközt a Home Assistantban.
OpenEdge-eszközök beállítása a Home Assistanttal MQTT-n keresztül
Most állítsuk be az MQTT-integrációt. Ebben az útmutatóban a(z) SONOFF MINI-1GSP szolgál példaként, de ugyanez az alapvető munkafolyamat más, MQTT-támogatással rendelkező kompatibilis OpenEdge-eszközöknél is használható.
Amire szüksége lesz
- Egy OpenEdge-kompatibilis, MQTT-támogatással rendelkező SONOFF-eszköz.
- A Home Assistant telepítve van és fut.
- Egy MQTT-broker telepítve van és fut.
- Az MQTT-integrációt hozzáadták a Home Assistanthez, és csatlakoztatták a brokerhez.
MQTT-broker telepítése és beállítása
- Nyissa meg a Home Assistantot.
- Lépjen a Beállítások → Alkalmazások (korábban bővítmények) → Alkalmazás telepítése menübe.
- Keressen rá a Mosquitto brokerre, majd kattintson a TELEPÍTÉS gombra.
- A telepítés után indítsa el a Mosquitto brokeralkalmazást.
- Javasoljuk a Indítás rendszerindításkor és a Watchdog bekapcsolását, hogy a broker automatikusan elinduljon a Home Assistanttal, és újraindítható legyen, ha váratlanul leáll.
- Ha szükséges, hozzon létre külön Home Assistant-felhasználót az MQTT-eszközök számára a Beállítások → Személyek → Felhasználók menüpontban.
Az MQTT-broker kiválasztásáról és konfigurálásáról további részleteket a Home Assistant hivatalos broker beállítási útmutatójában talál.
Az MQTT-integráció hozzáadása a Home Assistanthoz
- A Home Assistantban lépjen a Beállítások → Eszközök és szolgáltatások → Integráció hozzáadása menübe.
- Keressen rá az MQTT-re, és végezze el a beállítást.
- Lépjen a Beállítások → Eszközök és szolgáltatások → MQTT menübe annak ellenőrzéséhez, hogy az integráció csatlakozik-e a brokerhez.
1. lépés: Az eszköz bekapcsolása
A MINI-1GSP az első bekapcsoláskor automatikusan párosítási módba lép. Amikor a LED két rövid felvillanást, majd egy hosszú felvillanást jelez, az AP-hotspot készen áll a beállításra.
2. lépés: Az OpenEdge Web Console elérése
A Web Console elérésének két módja van.
1. módszer: Hozzáférés AP-hotspoton keresztül – első beállításhoz ajánlott
- Nyissa meg az asztali számítógépe, táblagépe vagy mobileszköze Wi-Fi-beállításait.
- Csatlakozzon az eszköz hotspotjához: SONOFF_1GSP_xxxx.
- Nyisson meg egy webböngészőt, és navigáljon ide: http://192.168.33.1
- Megnyílik a Web Console bejelentkezési oldala. Az első megnyitáskor hozzon létre egy legalább 8 karakteres jelszót.
A bejelentkezéshez nyissa meg az OpenEdge Web Consolet.
A webkonzolból kezelheti a helyi funkciókat, többek között a BE/KI vezérlést, az előzményadatokat az energiafogyasztásról, az időzítőket, a Matter-párosítást, a hálózati beállításokat, az AP/Wi-Fi-konfigurációt, az OTA-frissítéseket és az OpenEdge névjegyét.
A Kapcsolati beállítások alatt beállíthatja a felhőszolgáltatási kapcsolatot, a Home Assistanthoz használt MQTT-t, a TLS-beállításokat és a külső platformokhoz létesített kimenő WebSocket-kapcsolatokat.
2. módszer: Elérés LAN-on keresztül
Ha az eszköz már csatlakozik a helyi hálózathoz, közvetlenül elérheti a webkonzolt anélkül, hogy csatlakozna az AP-hotspothoz.
A MINI-1GSP esetén nyisson meg egy böngészőt egy olyan eszközön, amely eléri ugyanazt a LAN-hálózatot, majd írja be a böngészőbe az alábbiak egyikét:
- MINI-1GSP.local
- az eszköz helyi IP-címe.
3. lépés: Csatlakoztassa az eszközt a Wi-Fi-hálózathoz
Csatlakoztassa az eszközt egy olyan Wi-Fi-hálózathoz, amely eléri a Home Assistantot és az MQTT-brókert is, hogy kommunikálhassanak a helyi hálózaton.
- Lépjen a Hálózati beállítások → Wi-Fi-beállítások menübe.
- Válassza ki azt a Wi-Fi-hálózatot, amely elérhető a Home Assistant és az MQTT-bróker számára.
- Adja meg a Wi-Fi-jelszót.
- Kattintson a Mentés gombra.
- Várja meg, amíg az eszköz csatlakozik.
Miután az eszköz csatlakozik a helyi hálózathoz, az útválasztó általában helyi IP-címet oszt ki DHCP-n keresztül. Ez a cím megjelenik a Wi-Fi-beállításokban, és később felhasználható a webkonzol LAN-on keresztüli elérésére, a fent leírt 2. módszer szerint, fent.
Megjegyzés: Az AP-hotspot időkorlátja
A MINI-1GSP körülbelül 10 perc elteltével automatikusan kilép a párosítási módból. A párosítási mód befejeződése után az első beállításhoz használt AP-hotspot már nem érhető el.
Ha az AP-hotspot eltűnik a beállítás befejezése előtt:
- Ha az eszköz már csatlakozik a helyi hálózathoz, folytassa a beállítást a fent leírt LAN-hozzáférési módszerrel.
- Ha ismét használni szeretné az AP-hotspotot, tartsa nyomva az eszköz gombját 5 másodpercig a párosítási mód újbóli aktiválásához.
- Csatlakozzon újra a SONOFF_1GSP_xxxx hálózathoz, nyissa meg a http://192.168.33.1 címet, majd folytassa a beállítást.
Tipp: Az eszköz gombjának 10 másodpercig történő nyomva tartása visszaállítja a gyári beállításokat.
4. lépés: Engedélyezze az MQTT-t, és állítsa be a paramétereket
- Lépjen a Kapcsolati beállítások → MQTT menübe.
- Engedélyezés MQTT.
- Állítsa be az MQTT-paramétereket az alábbiak szerint
- A beállítások elvégzése után kattintson a Mentés gombra.
Példa az eszköz webkonzoljának MQTT-konfigurációjára:
|
Beállítás |
Mit kell megadni |
|
Szerver |
Az MQTT-bróker címe és portja, pl. |
|
Felhasználónév |
Az MQTT-bróker felhasználóneve |
|
Jelszó |
Az MQTT-bróker jelszava |
|
Kapcsolattípus |
Válassza ki a brókerének megfelelő TLS-beállítást |
|
RPC-állapotértesítések MQTT-n keresztül |
Szükség szerint engedélyezze vagy tiltsa le |
- A Server mezőnek az MQTT-brókerre kell mutatnia. Ha a Mosquitto Broker a Home Assistanttal azonos gépen fut, ez általában a Home Assistant-gép IP-címe az 1883-as MQTT-porttal, például: 192.168.1.242:1883.
- Ha a hivatalos Home Assistant Mosquitto Broker szolgáltatást használja, és nem hozott létre külön MQTT-hitelesítő adatokat (felhasználónevet és jelszót), használhatja a meglévő Home Assistant-felhasználónevét és jelszavát.
- Ha a Mosquitto már fel van konfigurálva felhasználónévvel és jelszóval, adja meg ugyanezt a felhasználónevet és jelszót az eszköz Web Console MQTT-beállításaiban.
5. lépés: Az eszköz ellenőrzése és vezérlése a Home Assistantban
- Az MQTT-beállítások mentése után csatlakoztassa újra asztali számítógépét, táblagépét vagy mobileszközét a Home Assistantot és az MQTT-brókert elérő helyi hálózathoz.
- Nyissa meg a Home Assistantot, majd lépjen a Beállítások → Eszközök és szolgáltatások → MQTT menüpontra
Az eszköznek már meg kell jelennie az MQTT-eszközlistában. Az MQTT-támogatással rendelkező, OpenEdge-kompatibilis SONOFF-eszközök natívan közzéteszik a Home Assistant MQTT Discovery-információit, így a Home Assistant automatikusan hozzáadhatja az eszközt, és manuális MQTT-témakör- vagy YAML-konfiguráció nélkül létrehozhatja a támogatott entitásait.
-
Nyissa meg az eszköz oldalát az elérhető vezérlők és entitások megtekintéséhez. A MINI-1GSP példájánál ezek többek között a következő funkciókat foglalják magukban:
- Relévezérlés
- Áramerősség
- Feszültség
- Teljesítmény
- Frekvencia
- Energiaadatok
Ezután hozzáadhatja ezeket az entitásokat a Home Assistant irányítópultjához, illetve automatizálásokban és jelenetekben is használhatja őket.
OpenEdge által támogatott eszközök
A MINI-1GSP az első OpenEdge-támogatással rendelkező SONOFF-termék.
Hamarosan további OpenEdge-kompatibilis eszközök érkeznek, többek között:
- MINI-1GP
- MINI-1GS
- MINI-1GS10
Az OpenEdge fokozatosan további SONOFF-termékkategóriákra is kiterjed, többek között:
- Okoskapcsolók — rugalmasabb helyi vezérlés és integráció nyílt interfészeken keresztül.
- Energiagazdálkodási termékek — helyi adatfeldolgozás és átláthatóbb energi monitorozás biztosítása.
- Egyéb okoseszközök — további platformokhoz és ökoszisztémákhoz való csatlakozás az OpenEdge nyílt integrációs lehetőségein keresztül.
A legújabb támogatott eszközöket, valamint a Home Assistant-integráció után elérhető funkciókat lásd a [SONOFF OpenEdge-eszközök Home Assistant funkciótámogatási listáján].
Összegzés
A SONOFF OpenEdge egyszerűbbé, helyibbé és rugalmasabbá teszi a Home Assistant-integrációt. A beépített Web Console és az OpenEdge szabványos, MQTT-n keresztüli Local API-jának köszönhetően a támogatott SONOFF-eszközök közvetlenül böngészőből konfigurálhatók, és helyben integrálhatók a Home Assistanttal — így egyszerű beállítást, gyors helyi vezérlést és rugalmasabb automatizálást biztosít az integrációs útvonal felhőalapú igénybevétele nélkül.
Hagyjon megjegyzést
Minden hozzászólást moderálnak a közzététel előtt.
Ezt a webhelyet a hCaptcha rendszer védi, és a hCaptcha adatvédelmi szabályzata, valamint szolgáltatási feltételei vonatkoznak rá.