
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.
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.
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.
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.
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.
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.
Each indoor temperature range uses the same sequence of 12 operating states.
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.
The Mode6 field contains four comma-separated parameters:
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.
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.
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.
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.