Bevezetés
A SONOFF bemutatja az OpenEdge technológiát, a következő generációs okoseszközök helyi működést előtérbe helyező architektúráját, amelyet úgy terveztek, hogy nagyobb helyi vezérlést, szélesebb körű együttműködést és rugalmasabb lehetőségeket biztosítson eszközei különböző platformok és ökoszisztémák közötti csatlakoztatásához.
Az OpenEdge segítségével a támogatott SONOFF-eszközök helyileg, nyílt interfészeken, például HTTP-n, MQTT-n és WebSocketen keresztül kommunikálhatnak.
A Home Assistant felhasználói számára ez nagyobb választási lehetőséget jelent az eszközök integrálásában: helyi vezérlés és rugalmas ökoszisztéma-integráció érdekében helyileg, MQTT-n keresztül csatlakoztathatja őket, miközben a felhőkapcsolat továbbra is elérhető marad, amikor az jobban megfelel az igényeinek.
Hogyan működik az MQTT-integráció a Home Assistanttal?
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-broker → Home Assistant
- OpenEdge-kompatibilis SONOFF-eszköz — MQTT-kliensként csatlakozik a brokerhez, közzéteszi az eszköz állapotát és adatait, valamint vezérlési parancsokat fogad.
- MQTT-broker — fogadja és továbbítja az MQTT-üzeneteket a csatlakoztatott kliensek között. Home Assistant-beállításokban a Mosquitto gyakori választás.
- Home Assistant — az MQTT-integráción keresztül ugyanahhoz a brokerhez 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. Ez az útmutató a SONOFF MINI-1GSP eszközt használja példaként, de az alapvető munkafolyamat más, MQTT-támogatással rendelkező kompatibilis OpenEdge-eszközök esetében is alkalmazható.
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ó hozzá lett adva a Home Assistanthez, és csatlakozott 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üpontra.
- Keressen rá a Mosquitto brokerre, majd kattintson az TELEPÍTÉS gombra.
- A telepítés után indítsa el a Mosquitto broker alkalmazást.
- Javasoljuk a Indítás rendszerindításkor és a Watchdog engedélyezését, hogy a broker automatikusan elinduljon a Home Assistanttal együtt, é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ával és beállításával kapcsolatos további részletekért tekintse meg a Home Assistant hivatalos broker beállítási útmutatóját.
Az MQTT-integráció hozzáadása a Home Assistantban
- A Home Assistantban lépjen a Beállítások → Eszközök és szolgáltatások → Integráció hozzáadása menüpontra.
- 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üpontra annak megerősítéséhez, hogy az integráció csatlakozik 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 villanást, majd egy hosszú villaná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 kétféleképpen érhető el.
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épén, táblagépén vagy mobileszközén a Wi-Fi-beállításokat.
- 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ő hozzáféréskor hozzon létre egy legalább 8 karakterből álló.
jelszót. Jelentkezzen be az OpenEdge Web Console-ba.
A Web Console-ból kezelheti a helyi funkciókat, többek között a BE/KI vezérlést, az előzményeket tartalmazó energiaadatokat, 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ással való kapcsolatot, a Home Assistanthez használt MQTT-t, a TLS-beállításokat és a harmadik féltől származó platformokhoz létrehozott kimenő WebSocket-kapcsolatokat.
2. módszer: Hozzáférés LAN-on keresztül
Ha az eszköz már csatlakozik a helyi hálózathoz, közvetlenül is elérheti a Web Console-t anélkül, hogy csatlakozna az AP-hotspotjához.
A MINI-1GSP esetében 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: Az eszköz csatlakoztatása 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üpontra.
- Válassza ki azt a Wi-Fi-hálózatot, amelyet a Home Assistant és az MQTT-bróker is elér.
- Adja meg a Wi-Fi-jelszót.
- Kattintson a Mentés gombra.
- Várjon, 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 a Wi-Fi-beállításokban jelenik meg, és későbbi LAN-hozzáférésre használható a Web Console-hoz, a fent ismertetett 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, mielőtt befejezné a beállítást:
- Ha az eszköz már csatlakozik a helyi hálózathoz, folytassa a beállítást a fent ismertetett LAN-hozzáférési módszerrel.
- Ha ismét használnia kell az AP-hotspotot, tartsa lenyomva az eszköz gombját 5 másodpercig, hogy újra párosítási módba lépjen.
- 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ő lenyomása gyári visszaállítást hajt végre.
4. lépés: Az MQTT engedélyezése és a paraméterek beállítása
- Lépjen a Kapcsolati beállítások → MQTT menüpontra.
- Engedélyezés MQTT.
- Állítsa be az MQTT-paramétereket az alábbiak szerint
- A beállítások befejezése után kattintson a Mentés gombra.
Példa az eszköz Web Console MQTT-konfigurációjára:
|
Beállítás |
Mit kell megadni |
|
Szerver |
MQTT-bróker címe és portja, pl. |
|
Felhasználónév |
MQTT-bróker felhasználóneve |
|
Jelszó |
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 Szerver mezőnek az Ön MQTT-brókerére kell mutatnia. Ha a Mosquitto Broker ugyanazon a gépen fut, mint a Home Assistant, ez általában a Home Assistantot futtató 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álhat egy meglévő Home Assistant-felhasználónevet és -jelszót.
- Ha a Mosquitto már be van állítva felhasználónévvel és jelszóval, adja meg ugyanazt 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 adatait, így a Home Assistant automatikusan hozzáadhatja az eszközt, és létrehozhatja a támogatott entitásokat manuális MQTT-téma- vagy YAML-konfiguráció nélkül.
-
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 ezek többek között a következő funkciókat tartalmazzák:
- Relévezérlés
- Áramerősség
- Feszültség
- Teljesítmény
- Frekvencia
- Energiaadatok
Ezeket az entitásokat ezután hozzáadhatja 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 következő SONOFF-termékek jelenleg támogatják az OpenEdge-et:
Hamarosan további OpenEdge-kompatibilis eszközök érkeznek, többek között:
- 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ést és integrációt tesznek lehetővé nyílt interfészeken keresztül.
- Energiagazdálkodási termékek — helyi adatfeldolgozás és átláthatóbb energiafelügyelet 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ökről és a Home Assistant-integráció után elérhető funkciókról lásd a SONOFF OpenEdge-eszközök Home Assistant-funkcióinak támogatási listája.
Összegzés
A SONOFF OpenEdge egyszerűbbé, helyibbé és rugalmasabbá teszi a Home Assistant-integrációt. A beépített Web Console-on és az OpenEdge MQTT-n keresztüli szabványosított Local API-ján keresztül a támogatott SONOFF-eszközök közvetlenül böngészőből konfigurálhatók, és helyileg integrálhatók a Home Assistanttal — egyszerű beállítást, gyors helyi vezérlést és rugalmasabb automatizálást biztosítva anélkül, hogy az integrációs folyamathoz felhőre kellene támaszkodni.
GYIK
K: Szükség van felhőre az OpenEdge használatához?
Nem feltétlenül. Az OpenEdge helyi elsőbbségű architektúrára épül, amely lehetővé teszi a támogatott eszközök konfigurálását, vezérlését és integrálását a helyi Web Console-on és a szabványosított Local API-n keresztül, a helyi hálózaton.
A helyi funkciókhoz nincs szükség felhőkapcsolatra, de opcionális kiegészítésként továbbra is elérhető az olyan funkciókhoz és szolgáltatásokhoz, amelyeknek előnyös a felhőhozzáférés.
K: Működnek a SONOFF OpenEdge-eszközök a Home Assistanttal, ha az internet nem érhető el?
Igen. Az útmutatóban ismertetett Home Assistant MQTT-beállításhoz a SONOFF-eszköznek, az MQTT-brókernek és a Home Assistantnak elérhetőnek kell maradnia a helyi hálózaton.
Amíg a LAN és az MQTT-bróker elérhető marad, az eszköz aktív internetkapcsolat nélkül is folytathatja a helyi kommunikációt a Home Assistanttal.
K: Szükségem van az eWeLink alkalmazásra vagy eWeLink-fiókra ahhoz, hogy beállítsam az MQTT-t a Home Assistanttal?
Nem. Az útmutatóban ismertetett helyi MQTT-integrációhoz közvetlenül böngészőből érheti el az OpenEdge Web Console-t, az eWeLink alkalmazás vagy eWeLink-fiók használata nélkül.
A kezdeti beállításhoz az eszköz AP-hotspotján keresztül érheti el a Web Console-t. Miután az eszköz csatlakozott a helyi hálózathoz, a LAN-on keresztül is elérheti a helyi gépnevével vagy IP-címével.
A Web Consoleból közvetlenül konfigurálhatja az eszköz hálózatát és MQTT-kapcsolatát. Az eWeLink felhőkapcsolata külön továbbra is elérhető, ha használni szeretné.
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á.