ASC Shutter Controller – Configuration and Initial Setup

After installing ASC (Automatic Shutter Controller), you can create an automatic shutter controller through the Domoticz hardware settings. The initial configuration can be entered directly in the hardware parameters, while the detailed 36-state control matrix can also be edited using the dedicated HTML configuration interface.

1. Creating the Shutter Controller

Open Setup → Hardware in Domoticz, enter a name for the controller, and select Redöny vezérlő (ASC (Automatic Shutter Controller)) from the hardware type list.

A single ASC hardware instance can control multiple shutters. For rooms with different orientations or usage requirements, creating separate controller instances is recommended, allowing each area to use different control settings.

2. Connection Settings

The first four hardware parameters contain the connection information required to access the Domoticz API:

If Domoticz runs on the same router and the local API is accessible, the default address and port are usually appropriate.

Important: ASC also uses the host specified in the Address field to access the optional OpenWrt presence detection HTTP endpoints. When presence detection is enabled, both the Domoticz API and the OpenWrt Presence service must therefore be accessible through the configured address.

3. Configuring Sensors – Mode1

In the Mode1 field, enter the Domoticz device IDs (IDX) of the sensors you want to use, with the appropriate prefixes.

For example, if the indoor temperature sensor has IDX 101, the outdoor temperature sensor has IDX 102, and the light sensor has IDX 103, enter:

K:102,B:101,F:103

Multiple sensors of the same type can also be configured. The controller can calculate an average from their valid measurements.

An indoor temperature sensor is not mandatory. If none is configured, ASC assumes a fixed indoor temperature of 22 °C. This allows applications such as terrace shading, although the controller cannot respond to changes in the actual indoor temperature.

Outdoor temperature and light sensors are also optional. If they are unavailable, ASC can use estimated values derived from hourly Open-Meteo weather forecasts, interpolated for the current time.

Physical sensors are recommended whenever possible because forecast estimates cannot reproduce local conditions or rapid changes as accurately as direct measurements.

4. Assigning Shutters – Mode2

In the Mode2 field, enter the Domoticz IDX values of the motorized shutters or shading devices to be controlled, separated by commas.

For example, to control three shutters:

201,202,203

The ASC instance applies the same control logic to all configured shutters and sends the same percentage-based position command to each one.

The shutter devices must support percentage-based position control. During installation, verify what 0% and 100% represent for each actuator and which direction the shutter moves.

5. The 36-State Control Matrix – Mode3, Mode4 and Mode5

ASC uses three configuration fields, each containing 12 percentage values. These numbers specify the desired shutter positions between 0% and 100%.

The default indoor temperature target range is 20–25 °C. Both limits can be modified using the virtual devices created by the plugin in Domoticz.

The three fields provide a total of 36 independently configurable shutter positions.

Order of the 12 Matrix Values

Each indoor temperature range uses the same sequence of 12 operating states.

Outdoor Temperature Is Lower Than Indoor Temperature

  1. Dark: light intensity is below the opening threshold, no presence detected.
  2. Normal daylight: light intensity is between the opening and strong-light thresholds, no presence detected.
  3. Strong sunshine: light intensity is above the strong-light threshold, no presence detected.
  4. Dark, with presence: the same lighting conditions as state 1, but presence is detected.
  5. Normal daylight, with presence: the same lighting conditions as state 2, but presence is detected.
  6. Strong sunshine, with presence: the same lighting conditions as state 3, but presence is detected.

Outdoor Temperature Is Higher Than or Equal to Indoor Temperature

  1. Dark: light intensity is below the opening threshold, no presence detected.
  2. Normal daylight: light intensity is between the opening and strong-light thresholds, no presence detected.
  3. Strong sunshine: light intensity is above the strong-light threshold, no presence detected.
  4. Dark, with presence: the same lighting conditions as state 7, but presence is detected.
  5. Normal daylight, with presence: the same lighting conditions as state 8, but presence is detected.
  6. Strong sunshine, with presence: the same lighting conditions as state 9, but presence is detected.

Each matrix value represents a shutter position between 0% and 100%. The controller selects the corresponding value based on the indoor temperature range, the relationship between indoor and outdoor temperatures, light intensity and presence information.

This makes it possible to balance energy efficiency and occupant comfort. For example, when someone is present, the shutters can be configured to admit more natural daylight, even when stronger shading would otherwise be preferable for energy conservation.

6. Additional Parameters – Mode6

The Mode6 field contains four comma-separated parameters:

  1. Python logging verbosity level.
  2. Control update interval in minutes.
  3. Name of the OpenWrt Presence detection group.
  4. An additional text parameter stored in the plugin configuration.

For example, the default configuration is:

0,5,Telefon,emailcim

In this example, the logging level is 0, the update interval is 5 minutes, and the presence detection group is named Telefon.

Presence detection is optional but strongly recommended if you want to configure different shading behavior for energy efficiency and occupant comfort.

The OpenWrt Presence module can be installed and configured separately. See OpenWrt Presence – GitHub.

7. Light Thresholds and Hysteresis

ASC uses two main light intensity thresholds: the opening threshold and the strong-light threshold.

The opening threshold is calculated by adding a configurable offset to a value derived from minimum illuminance measurements over previous days. The strong-light threshold is calculated as a configurable percentage of a value derived from previous maximum illuminance measurements.

The number of days used for the calculations and the threshold adjustments can be configured through the virtual control devices created in Domoticz.

Hysteresis helps prevent unnecessary shutter movements caused by small temperature or light intensity fluctuations.

Suitable threshold values depend on building orientation, window size, sensor placement and how the room is used. It is therefore advisable to fine-tune the initial settings after observing the system for several days.

8. Using the HTML Configuration Interface

Instead of editing all 36 matrix values directly in the hardware settings, you can use ASC's dedicated HTML configuration interface, accessible from the Domoticz custom menu:

Custom → ASC_Shutter_Redony

Direct route: #/Custom/ASC_Shutter_Redony

The interface displays the current indoor and outdoor temperatures, illuminance, and the complete control matrix.

The currently active operating state is highlighted, making it easy to see which control rule is being applied under the present conditions.

Shutter positions can be adjusted and saved. When Automatic mode is enabled, the controller applies the updated settings during the next control cycle. Changes therefore do not necessarily result in immediate shutter movement.

9. Initial Startup and Verification

After creating the hardware instance, the plugin automatically creates the virtual Domoticz devices required for configuration and status monitoring.

Before using the controller, check the following:

Automatic operation can be enabled using the Shutter mode selector created by ASC in Domoticz. The controller supports Off, Automatic and manually selected percentage-based positions.

The complete source code and multilingual documentation are available in the Domoticz ASC Shutter Controller GitHub repository.

 

Installation, Setup, and Configuration