Jelenlét Kapcsoló – Domoticz plugin

Műszaki leírás

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.

Működési elv

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.

Telepítés

A Jelenlét Kapcsoló nyílt forráskódú program, amely a GitHubon szabadon elérhető.

Domoticz-JEK-Presence-Switch – GitHub

1. A plugin letöltése

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.

2. Futtatási jogosultság

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

3. HTML kezelőfelület

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ó.

4. A Domoticz újraindítása

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

5. A plugin hozzáadása

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.

Konfigurálás

Domoticz kapcsolat

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.

Jelenléti csoport kiválasztása

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.

Eszközök kapcsolása

A plugin négy egymástól független eszközlistát kezel:

BeállításMű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.

Naplózási szint

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ó.

Üzemmódok

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.

HTML kezelőfelület

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.

Felhasználási lehetőségek

A jelenlét alapú automatizálás számos okosotthon-feladatra alkalmazható.

Rendszerkövetelmények

Felhőfüggetlen működés

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.

Forráskód és frissítések

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.