Telepítés és frissítés

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.

1. Szélessáv SmartHome OpenWrt firmware

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.

2. Telepítés saját Domoticz rendszerre

A DSVT forráskódja és a telepítéshez szükséges állományok a GitHubon érhetők el:

DSVT – GitHub repository

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.

3. Telepítés Git használatával

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.

Plugin letöltése

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.

HTML konfigurációs felület telepítése

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

4. Telepítés OpenWrt vagy korlátozott tárhellyel rendelkező rendszeren

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.

5. A Domoticz alapbeállításainak ellenőrzése

A DSVT első indítása előtt néhány Domoticz-beállítást ellenőrizni kell.

Földrajzi koordináták beállítása

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.

Helyi API-hozzáférés engedélyezése

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.

6. A DSVT hardvereszköz létrehozása

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.

7. A HTML konfigurációs felület megnyitása

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:

A Custom menü eléréséhez megfelelő Domoticz felhasználói jogosultság szükséges.

8. Domoticz újraindítása

A plugin telepítése vagy Python-kódjának frissítése után indítsd újra a Domoticz szolgáltatást.

OpenWrt rendszeren

/etc/init.d/domoticz restart

Systemd rendszerű Linuxon

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.

9. A DSVT frissítése

A DSVT fejlesztése és az aktuális verziók közzététele a GitHub repositoryban történik.

Frissítés Git használatával

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.

Frissítés ZIP-archívumból

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.

10. Telepítés ellenőrzése

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.

11. Dokumentáció és hibajelentés

A DSVT forráskódja, frissítései és hibajelentései a GitHub repositoryban találhatók:

DSVT – GitHub

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.

DSVT – Fűtés, hűtés, HMV és puffer: dokumentáció

Az alábbi témakörök segítségével gyorsan megtalálhatók a vezérlés működésével, telepítésével és beállításával kapcsolatos útmutatók.

Vissza a fűtés–hűtés–HMV–puffer áttekintő oldalára

Áttekintés és alapelvek

Működési logika és üzemmódok

Intelligens szabályozási algoritmusok

Beavatkozó eszközök és kiegészítő vezérlések

Telepítés és konfiguráció

Használat és dokumentáció

Verziótörténet