Installation and Updates

DSVT (Dual Smart Virtual Thermostat) is an open-source Python plugin for Domoticz. It provides heating, cooling, domestic hot water (DHW), and buffer tank control, as well as support for up to 12 independent temperature control zones.

DSVT can be used as part of the Szélessáv SmartHome OpenWrt firmware or installed on a suitably configured existing Domoticz system.

1. Szélessáv SmartHome OpenWrt Firmware

If you are using our Szélessáv SmartHome OpenWrt firmware, no separate installation is required because the DSVT plugin and its web-based configuration interface are already included in the system.

However, during the initial Domoticz configuration, you may still need to configure the geographical coordinates, local API access, and the DSVT hardware device.

2. Installing DSVT on Your Own Domoticz System

The DSVT source code and installation files are available on GitHub:

DSVT – GitHub Repository

The repository contains the Python plugin, web configuration interface files, language translations, and program components required for weather data processing.

Installation requires a working Domoticz environment with Python plugin support.

The exact directory locations may vary depending on the operating system, Domoticz package, and installation method.

3. Installation Using Git

If sufficient storage space is available and Git is installed, the DSVT repository can be cloned directly into the Domoticz plugins directory.

The following example uses the directory structure of the Szélessáv OpenWrt system.

Downloading the Plugin

cd /etc/domoticz/plugins git clone https://github.com/szelessavalapitvany/Domoticz-DSVT.git DSVT_HMV_ZONE_12

This command creates the following directory:

/etc/domoticz/plugins/DSVT_HMV_ZONE_12/

This directory contains the Python files and other components required for the plugin to operate.

Installing the HTML Configuration Interface

DSVT has its own HTML-based configuration interface. The required files must be copied into the Domoticz templates directory.

cp -r /etc/domoticz/plugins/DSVT_HMV_ZONE_12/viewer/* /usr/share/domoticz/www/templates/

This command copies the contents of the repository's viewer directory into the Domoticz web templates directory.

Important: without installing the HTML configuration interface, the plugin's detailed setup page will not be available or function correctly.

4. Installation on OpenWrt or Systems with Limited Storage

On OpenWrt or other systems with limited available storage, cloning the entire Git repository may not be the most practical approach.

Git also creates a .git directory containing version control history and additional metadata.

For these systems, downloading the current DSVT version as a ZIP archive from GitHub may be preferable.

The ZIP archive is available at:

Download DSVT ZIP Archive (main branch)

If the repository's default branch is not main, use GitHub's Code → Download ZIP option instead.

After downloading, extract the archive and copy the files required for operation into the appropriate Domoticz directories.

The typical plugin directory is:

/etc/domoticz/plugins/DSVT_HMV_ZONE_12/

The typical HTML configuration interface directory is:

/usr/share/domoticz/www/templates/

ZIP-based installation avoids storing Git version history on the device and can therefore significantly reduce storage requirements.

5. Checking the Basic Domoticz Settings

Before starting DSVT for the first time, several Domoticz settings should be checked.

Configuring Geographical Coordinates

Open the following Domoticz menu:

Setup → Settings → System

Enter the actual latitude and longitude of the installation location.

DSVT uses these coordinates when requesting location-specific weather forecasts.

If the coordinates are missing or incorrect, weather-dependent control may produce inaccurate results or weather data retrieval may fail.

Enabling Local API Access

DSVT also communicates with Domoticz through its HTTP API.

If the plugin and Domoticz are running on the same device, the following local address can be used:

127.0.0.1

The required local access must be permitted in the Domoticz security settings.

Open:

Setup → Settings → Security → Trusted Networks

Add the following address:

127.0.0.1

Trusted network access should be restricted to addresses that are genuinely trusted.

If Domoticz and DSVT operate in different network environments, or if local API access requires authentication, configure the plugin connection parameters accordingly.

6. Creating the DSVT Hardware Device

After installing the plugin files and restarting Domoticz, open:

Setup → Hardware

Create a new hardware device and select the following plugin:

DSVT + HMV (DHW) + 12 ZONE

During initial setup, leave the detailed configuration fields empty except for the required operating and connection parameters.

Enter the appropriate Domoticz IP address and port for your installation.

For example, on a local installation:

IP Address: 127.0.0.1 Port: 8080

If Domoticz uses a different port, enter that port instead.

After the hardware device is created, DSVT automatically creates the virtual devices required for its operation.

Important: detailed configuration of zones, heat sources, sensors, mixing valves, and other operating parameters should not be performed through the conventional Domoticz hardware configuration fields.

7. Opening the HTML Configuration Interface

After creating the DSVT hardware device, the plugin's web-based configuration interface becomes available through the Domoticz Custom menu.

Open:

Custom → HTML setup!

This interface allows you to configure:

If the Custom menu or HTML setup page does not appear, check the following:

Appropriate Domoticz user permissions are required to access the Custom menu.

8. Restarting Domoticz

After installing the plugin or updating its Python code, restart the Domoticz service.

On OpenWrt

/etc/init.d/domoticz restart

On Linux Systems Using systemd

sudo systemctl restart domoticz

The service name and restart procedure may differ depending on the installation.

After restarting, refresh the Domoticz interface in your web browser.

If the HTML configuration interface or translations do not update immediately, perform a forced browser refresh or open Domoticz in a new private browsing window.

This may be necessary because older JavaScript, HTML, or other static files may still be loaded from the browser cache.

9. Updating DSVT

DSVT development and new versions are published through the GitHub repository.

Updating an Installation Using Git

If DSVT was installed using Git, open the plugin directory:

cd /etc/domoticz/plugins/DSVT_HMV_ZONE_12 git pull

After updating, copy the web configuration interface files again:

cp -r /etc/domoticz/plugins/DSVT_HMV_ZONE_12/viewer/* /usr/share/domoticz/www/templates/

Then restart the Domoticz service.

If you have previously modified files in the local repository, git pull may report conflicts. In that case, save or resolve your local changes before updating.

Updating from a ZIP Archive

On systems with limited storage, DSVT can also be updated by downloading a newer ZIP archive from GitHub.

Extract the archive and copy the required plugin and HTML configuration interface files into their respective target directories, replacing the previous versions.

In addition to updating the Python plugin, the contents of the viewer directory should also be updated, particularly when the configuration interface or its translations have changed.

After replacing the files, restarting Domoticz and refreshing the browser cache are recommended.

10. Verifying the Installation

You can verify that DSVT has been installed successfully by checking the following:

If the plugin does not start, first check the Domoticz log. Python exceptions, missing files, and API connection problems are generally reported there.

11. Documentation and Bug Reports

The DSVT source code, updates, and issue tracker are available on GitHub:

DSVT – GitHub

When reporting a bug or compatibility issue, please include the Domoticz version, operating system, DSVT version, relevant log messages, and the affected configuration details.

A properly configured Domoticz environment and following the recommended installation sequence can significantly simplify the initial DSVT setup and future updates.

DSVT – Documentation and Guides

Browse installation instructions, configuration steps and detailed explanations of the control functions.

Heating, Cooling, DHW and Buffer Control – Overview

Overview and principles

Operational logic and operating modes

Intelligent control algorithms

Actuating devices and auxiliary controls

Installation and configuration

Usage and documentation

Version history