
A DSVT (Dual Smart Virtual Thermostat) nyílt forráskódú Python plugin a Domoticz rendszerhez. A plugin fűtési, hűtési, használati melegvíz- és puffertartály-vezérlési funkciókat, valamint legfeljebb 12 független hőmérsékleti zóna kezelését biztosítja.
A DSVT használható a Szélessáv SmartHome OpenWrt firmware részeként, illetve megfelelően előkészített, saját Domoticz telepítéseken is.
Ha az általunk készített Szélessáv SmartHome OpenWrt firmware-t használod, nincs szükség külön telepítésre, mert a DSVT plugin és a hozzá tartozó webes konfigurációs felület a rendszer részeként előre telepítve van.
A Domoticz első konfigurálásakor azonban ebben az esetben is szükség lehet a földrajzi koordináták, a helyi API-hozzáférés és a DSVT hardvereszköz beállítására.
A DSVT forráskódja és a telepítéshez szükséges állományok a GitHubon érhetők el:
A repository tartalmazza a Python plugint, a webes konfigurációs felület fájljait, a nyelvi fordításokat és az időjárási adatok kezeléséhez szükséges programrészeket.
A telepítéshez működő, Python pluginokat támogató Domoticz környezet szükséges.
A könyvtárak pontos helye az alkalmazott operációs rendszertől, Domoticz-csomagtól és telepítési módtól függően eltérhet.
Ha a rendszeren rendelkezésre áll elegendő szabad tárhely, és telepítve van a Git, a DSVT repository közvetlenül a Domoticz plugin könyvtárába klónozható.
Az alábbi példa a Szélessáv OpenWrt rendszerben használt könyvtárstruktúrát követi.
cd /etc/domoticz/plugins git clone https://github.com/szelessavalapitvany/Domoticz-DSVT.git DSVT_HMV_ZONE_12
A parancs létrehozza a következő könyvtárat:
/etc/domoticz/plugins/DSVT_HMV_ZONE_12/
Ebben találhatók a plugin működéséhez szükséges Python- és egyéb fájlok.
A DSVT saját HTML-alapú konfigurációs felülettel rendelkezik. A működéséhez szükséges állományokat a Domoticz templates könyvtárába kell másolni.
cp -r /etc/domoticz/plugins/DSVT_HMV_ZONE_12/viewer/* /usr/share/domoticz/www/templates/
A parancs a repository viewer könyvtárának tartalmát másolja a Domoticz webes sablonkönyvtárába.
Fontos: a HTML konfigurációs felület telepítése nélkül a plugin részletes beállítóoldala nem lesz megfelelően használható.
OpenWrt vagy más, kevés szabad tárhellyel rendelkező rendszeren nem mindig célszerű a teljes Git repository klónozása.
A Git ugyanis létrehozza a .git könyvtárat is, amely a verziókezelési előzményeket és további adatokat tárol.
Az ilyen rendszereken célszerűbb lehet a GitHubról ZIP-archívumként letölteni a DSVT aktuális verzióját.
A ZIP-fájl a következő címen érhető el:
DSVT – GitHub ZIP letöltés (main ág)
Ha a repository alapértelmezett ága eltér a main ágtól, a GitHub Code → Download ZIP lehetőségét használd.
A letöltött archívumot ki kell csomagolni, majd a működéshez szükséges fájlokat a megfelelő Domoticz könyvtárakba kell másolni.
A plugin célkönyvtára jellemzően:
/etc/domoticz/plugins/DSVT_HMV_ZONE_12/
A HTML konfigurációs felület célkönyvtára jellemzően:
/usr/share/domoticz/www/templates/
A ZIP-alapú telepítés előnye, hogy a rendszer nem tárolja a Git verziókezelési előzményeit, így kevesebb tárhelyet igényelhet.
A DSVT első indítása előtt néhány Domoticz-beállítást ellenőrizni kell.
Nyisd meg a Domoticz következő menüpontját:
Beállítások → Beállítások → Rendszer
Add meg a telepítés tényleges földrajzi szélességét és hosszúságát.
A DSVT ezeket az adatokat használja a földrajzi helyhez kötött időjárási előrejelzések lekéréséhez.
Hiányzó vagy hibás koordináták esetén az időjárásfüggő szabályozás pontatlanul működhet, vagy az időjárási adatok lekérése sikertelen lehet.
A DSVT a Domoticz HTTP API-ján keresztül is kommunikál a rendszerrel.
Ha a plugin és a Domoticz ugyanazon az eszközön fut, a következő helyi cím használható:
127.0.0.1
A Domoticz biztonsági beállításainál a szükséges helyi hozzáférést engedélyezni kell.
Nyisd meg:
Beállítások → Beállítások → Biztonság → Megbízható hálózatok (Trusted Networks)
Add hozzá a következő címet:
127.0.0.1
A megbízható hálózatok beállítása kizárólag a valóban megbízható helyi címekre korlátozódjon.
Ha a Domoticz és a DSVT eltérő hálózati környezetben működik, vagy a helyi API-hozzáférés hitelesítést igényel, a plugin kapcsolódási paramétereit ennek megfelelően kell konfigurálni.
A plugin fájljainak telepítése és a Domoticz újraindítása után nyisd meg:
Beállítások → Hardver
Hozz létre egy új hardvereszközt, és válaszd ki a következő plugint:
DSVT + HMV (DHW) + 12 ZONE
Az első létrehozáskor a részletes konfigurációs mezőket hagyd üresen, kivéve a kötelező működési és kapcsolódási paramétereket.
A Domoticz IP-címét és portját a saját telepítésednek megfelelően add meg.
Helyi telepítésnél például:
IP Address: 127.0.0.1 Port: 8080
Ha a Domoticz más porton működik, azt kell megadni.
A hardvereszköz létrehozása után a DSVT automatikusan létrehozza a működéséhez szükséges virtuális eszközöket.
Fontos: a zónák, hőforrások, érzékelők, keverőszelepek és egyéb működési paraméterek részletes beállítását nem a Domoticz hagyományos hardverkonfigurációs mezőiben kell elvégezni.
A DSVT hardvereszköz létrehozását követően a Domoticz Custom menüjében elérhetővé válik a plugin webes konfigurációs felülete.
Nyisd meg a következő menüpontot:
Custom → HTML setup!
Ezen a felületen konfigurálhatók többek között:
Ha a Custom menü vagy a HTML setup oldal nem jelenik meg, ellenőrizd:
viewer fájlok megfelelő másolását.A Custom menü eléréséhez megfelelő Domoticz felhasználói jogosultság szükséges.
A plugin telepítése vagy Python-kódjának frissítése után indítsd újra a Domoticz szolgáltatást.
/etc/init.d/domoticz restart
sudo systemctl restart domoticz
A szolgáltatás neve és az újraindítás módja az adott telepítéstől függően eltérhet.
Ezután frissítsd a Domoticz kezelőfelületét a webböngészőben.
Ha a HTML konfigurációs felület vagy a fordítások nem frissülnek azonnal, használj kényszerített oldalfrissítést, vagy nyisd meg a Domoticz felületét új privát böngészőablakban.
Erre azért lehet szükség, mert a böngésző gyorsítótárából a korábbi JavaScript-, HTML- vagy más statikus fájlok töltődhetnek be.
A DSVT fejlesztése és az aktuális verziók közzététele a GitHub repositoryban történik.
Ha a telepítés Git klónozással történt, a frissítéshez nyisd meg a plugin könyvtárát:
cd /etc/domoticz/plugins/DSVT_HMV_ZONE_12 git pull
A frissítés után a webes konfigurációs felület fájljait is másold újra:
cp -r /etc/domoticz/plugins/DSVT_HMV_ZONE_12/viewer/* /usr/share/domoticz/www/templates/
Ezt követően indítsd újra a Domoticz szolgáltatást.
Ha a plugin helyi fájljait korábban módosítottad, a git pull ütközést jelezhet. Ilyenkor a helyi módosításokat a frissítés előtt menteni vagy rendezni kell.
Korlátozott tárhellyel rendelkező rendszeren a frissítés a repository újabb ZIP-változatának letöltésével is elvégezhető.
A kicsomagolt állományokból a plugin és a HTML konfigurációs felület szükséges fájljait a megfelelő célkönyvtárakba kell másolni.
A Python plugin frissítése mellett a viewer könyvtár tartalmát is frissíteni kell, különösen akkor, ha a konfigurációs felület vagy annak fordításai módosultak.
A fájlok cseréjét követően a Domoticz újraindítása és a böngésző gyorsítótárának frissítése ajánlott.
A telepítés sikerességét a következőkkel ellenőrizheted:
Ha a plugin nem indul, célszerű először a Domoticz naplóját ellenőrizni, mert a Python-hibák, a hiányzó fájlok és az API-kapcsolódási problémák általában ott jelennek meg.
A DSVT forráskódja, frissítései és hibajelentései a GitHub repositoryban találhatók:
Hibajelentés vagy kompatibilitási probléma esetén célszerű megadni a Domoticz verzióját, az operációs rendszert, a DSVT verzióját, a releváns naplóbejegyzéseket és az érintett konfigurációs részleteket.
A megfelelően előkészített Domoticz környezet és a telepítési sorrend betartása jelentősen megkönnyíti a DSVT első konfigurálását és későbbi frissítését.