
A Jelenlét Kapcsoló (JEK) egy Domoticz rendszerhez készült Python plugin, amely az OpenWrt router Okosotthon szekciójában beállított jelenlétfigyelés alapján automatikusan vezérli a kiválasztott Domoticz eszközöket.
A plugin segítségével különböző elektromos berendezések, világítások és egyéb kapcsolható eszközök vezérelhetők attól függően, hogy a megadott jelenléti csoporthoz tartozó felhasználók otthon tartózkodnak-e, vagy távol vannak.
A jelenlét érzékelését az OpenWrt router végzi, a Domoticz plugin pedig a kapott információ alapján hajtja végre a kapcsolási műveleteket. A rendszer helyi hálózaton működik, külső felhőszolgáltatás használata nélkül.
A plugin rendszeresen lekérdezi az OpenWrt router jelenlétfigyelő szolgáltatását, és ellenőrzi a beállított jelenléti csoport állapotát.
A kapott információ alapján két állapotot különböztet meg:
Mindkét állapothoz külön meghatározhatjuk, hogy mely Domoticz eszközök kapcsoljanak be, illetve melyek kapcsoljanak ki.
A plugin ellenőrzi a vezérelni kívánt eszközök aktuális állapotát, és csak akkor küld kapcsolási parancsot, ha az eszköz nincs a kívánt állapotban.
Automatikus üzemmódban az ellenőrzés a Domoticz plugin időszakos futásához igazodva történik. Így a rendszer szükség esetén visszaállíthatja az eszközök jelenléti állapothoz rendelt beállításait.
A Jelenlét Kapcsoló nyílt forráskódú program, amely a GitHubon szabadon elérhető.
Domoticz-JEK-Presence-Switch – GitHub
Lépjünk be a Domoticz rendszer plugin könyvtárába. Ennek pontos helye a Domoticz telepítésétől függ.
Az alábbi paranccsal tölthetjük le a projektet:
git clone https://github.com/szelessavalapitvany/Domoticz-JEK-Presence-Switch.git JEK
A parancs létrehoz egy JEK nevű könyvtárat, amelybe letölti a projekt fájljait.
A Python plugin fájljának az alábbi könyvtárszerkezetben kell elhelyezkednie:
domoticz/plugins/JEK/plugin.py
A kiegészítő fájlokat, köztük a nyelvi állományokat, a projekt könyvtárszerkezetének megtartásával kell telepíteni.
Linux rendszerben szükség esetén állítsuk be a Python fájl futtatási jogosultságát:
cd JEK chmod +x plugin.py
A pluginhoz külön HTML-alapú kezelőfelület tartozik. A felülethez szükséges állományokat a Domoticz egyedi webes felületeinek megfelelő könyvtárában kell elhelyezni.
A kezelőfelület a Domoticz rendszerben az alábbi útvonalon érhető el:
#/Custom/JEK_Jelenlet_kapcsolo_Show_switch
A HTML kezelőfelület csak egy már létrehozott pluginpéldányhoz használható.
A plugin telepítése után indítsuk újra a Domoticz szolgáltatást.
Systemd rendszer esetén:
sudo systemctl restart domoticz.service
OpenWrt rendszerben:
/etc/init.d/domoticz restart
Nyissuk meg a Domoticz kezelőfelületét, majd lépjünk a Beállítások → Hardver menüpontba.
Az új hardver hozzáadásánál válasszuk ki a Jelenlét Kapcsoló plugint, majd adjunk neki egy tetszőleges nevet.
Állítsuk be a kapcsolatparamétereket, a jelenléti csoport nevét és a vezérelni kívánt eszközöket, majd adjuk hozzá a hardvert.
A plugin létrehozza a működéséhez szükséges Domoticz eszközöket, köztük a Jelenlét alapú kapcsoló nevű választókapcsolót.
A konfigurációban az alábbi kapcsolatparaméterek adhatók meg:
Alapértelmezés szerint a plugin a 192.168.1.1 IP-címet és a 8080 portot használja. Ezeket a saját rendszerünknek megfelelően kell beállítani.
A Jelenlét neve mezőben az OpenWrt router jelenlétfigyelő szolgáltatásában korábban létrehozott csoport nevét kell megadni.
A jelenléti csoport létrehozását és a jelenlétfigyelés beállítását az OpenWrt router Okosotthon szekciójában kell elvégezni.
A plugin nem végez önálló jelenlétérzékelést, hanem a router által szolgáltatott eredményt használja.
A plugin négy egymástól független eszközlistát kezel:
| Beállítás | Működés |
|---|---|
| Érkezéskor ON | Jelenlét esetén bekapcsolandó eszközök |
| Érkezéskor OFF | Jelenlét esetén kikapcsolandó eszközök |
| Távozáskor ON | Távollét esetén bekapcsolandó eszközök |
| Távozáskor OFF | Távollét esetén kikapcsolandó eszközök |
Az eszközöket a Domoticz rendszerben használt egyedi azonosítójukkal (IDX) kell megadni.
Egy listában több eszköz is szerepelhet, azonosítóikat vesszővel elválasztva:
1051,617,1054
Az egyes listák üresen hagyhatók, ha az adott művelethez nem kívánunk eszközt rendelni.
Ügyeljünk arra, hogy ugyanazt az eszközt ne adjuk meg egyszerre az azonos jelenléti állapothoz tartozó be- és kikapcsolási listában.
A Logging Level beállítással meghatározhatjuk a plugin naplózásának részletességét.
Normál használathoz a Normal beállítás ajánlott. Hibakereséshez a Verbose vagy valamelyik Debug üzemmód használható.
A plugin telepítését követően a Domoticz rendszerben létrejön egy Jelenlét alapú kapcsoló nevű választókapcsoló.
A kapcsoló két üzemmódot biztosít:
Kikapcsolt üzemmódban az eszközök az utoljára beállított állapotukban maradnak. A plugin nem kapcsolja ki őket automatikusan.
Automatikus üzemmódban a plugin rendszeresen ellenőrzi a kapcsolók állapotát, és szükség esetén visszaállítja a jelenléti állapothoz rendelt beállításokat.
A pluginhoz külön HTML-alapú kezelőfelület tartozik, amely a Domoticz egyedi menüpontjából érhető el.
A kezelőfelület a plugin beállításainak áttekintésére és kezelésére szolgál.
A felület a plugin hardverbeállításainál található HTML setup! hivatkozással is megnyitható.
A HTML kezelőfelület csak akkor használható, ha a pluginhoz tartozó hardvert már létrehoztuk a Domoticz rendszerben.
A jelenlét alapú automatizálás számos okosotthon-feladatra alkalmazható.
A Jelenlét Kapcsoló a Szélessáv Okos Otthon helyi vezérlésre épülő megoldásainak része. A jelenlét ellenőrzése és az eszközök kapcsolása a helyi hálózaton történik.
A működéshez nincs szükség külső felhőszolgáltatásra vagy internetkapcsolatra, amennyiben a helyi hálózat és a szükséges szolgáltatások elérhetők.
A Jelenlét Kapcsoló forráskódja nyilvánosan elérhető a Szélessáv Közhasznú Alapítvány GitHub-tárolójában.
Domoticz-JEK-Presence-Switch – Forráskód és letöltés
A GitHubról telepített változat a plugin könyvtárában az alábbi paranccsal frissíthető:
git pull
Frissítés előtt célszerű biztonsági másolatot készíteni. A frissítés után szükség lehet a Domoticz újraindítására.