Installing ASC Automatic Shutter Controller

ASC (Automatic Shutter Controller) is an open-source Python plugin developed for the Domoticz home automation platform. The latest source code and related files are available on GitHub.

ASC Automatic Shutter Controller – GitHub

Requirements

Temperature, light, wind and vibration sensors are optional. If no indoor temperature sensor is configured, the controller assumes a temperature of 22 °C. Presence detection is also optional, but strongly recommended to take full advantage of ASC's functionality.

Installation on OpenWrt

Some versions of the Szélessáv Smart Home firmware may already include ASC. In that case, separate installation may not be necessary; you only need to add and configure the controller in Domoticz.

For other OpenWrt installations, the required files can be downloaded from GitHub.

1. Download the Source Code

Connect to the router via SSH and clone the repository:

cd /tmp
git clone https://github.com/szelessavalapitvany/Domoticz-ASC-Shutter-Controller.git

If Git is not installed, you can download the repository as a ZIP archive using the Code → Download ZIP option on GitHub.

2. Install the Python Plugin

On our OpenWrt system, the plugin directory is:

/etc/domoticz/plugins/ASC_Shutter_Redony/

Create the directory and copy the Python plugin and translation files into it:

mkdir -p /etc/domoticz/plugins/ASC_Shutter_Redony
cp /tmp/Domoticz-ASC-Shutter-Controller/plugin.py /etc/domoticz/plugins/ASC_Shutter_Redony/
cp /tmp/Domoticz-ASC-Shutter-Controller/asc_translate_*.json /etc/domoticz/plugins/ASC_Shutter_Redony/

3. Install the HTML Configuration Interface

ASC includes a dedicated HTML configuration interface that makes it easier to configure all 36 operating states.

The web interface files are located in the repository's viewer directory. On our OpenWrt installation, these files must be copied to the Domoticz web template directory:

mkdir -p /usr/share/domoticz/www/templates
cp /tmp/Domoticz-ASC-Shutter-Controller/viewer/* /usr/share/domoticz/www/templates/

The files include ASC_Shutter_Redony.html, asc_viewer.js and JSON translation files for the supported languages.

4. Restart Domoticz

/etc/init.d/domoticz restart

On other Linux distributions, the Domoticz installation paths and restart command may differ. Use the appropriate directories and service management commands for your system.

Add the ASC Controller to Domoticz

After installation, open Setup → Hardware in Domoticz and select the ASC (Automatic Shutter Controller) hardware type.

Enter a name for the controller, verify the Domoticz IP address and port, and create the hardware instance.

The plugin automatically creates the required virtual devices for configuring temperature limits, light thresholds, automatic operation and protective functions.

HTML Configuration Interface

After creating the hardware instance, the detailed configuration page is accessible from the Domoticz custom menu:

Custom → ASC_Shutter_Redony

Direct route: #/Custom/ASC_Shutter_Redony

On this page, you can assign sensor and shutter device IDs (IDX), configure presence detection and set the desired shutter position for each of the 36 operating states.

Optional Presence Detection

ASC integrates with the OpenWrt Presence module, which provides occupancy information based on Wi-Fi connections and network availability. With presence detection enabled, the controller can prioritize natural daylight and occupant comfort over temperature conservation when someone is at home.

OpenWrt Presence is installed separately. Its source code, installation instructions and documentation are available here:

OpenWrt Presence – GitHub

Updating ASC

New versions of ASC can be downloaded from the GitHub repository. After updating the Python plugin and HTML configuration files, restart Domoticz.

Before updating, it is recommended to back up the Domoticz database and existing plugin files. There is no need to delete the existing hardware instance or previously created devices.

Source Code and Documentation

The complete source code, multilingual documentation and screenshots are available on GitHub:

Domoticz ASC Shutter Controller

 

Installation, Setup, and Configuration