Documentation
Timer Variable
The "Timer Variable" module enables the implementation of a timer based on a variable. After activating the timer, the remaining time until the timer is triggered is counted down.
data points input
| Name | Description |
|---|---|
| Active | Activation of the timer, if TRUE the timer is activated and triggers the logic script again after a certain time. |
| Reset | Deactivation of the timer; if TRUE, an active timer can be canceled. |
| Time (seconds) | Time in seconds after which the timer should be triggered. |
data points output
| Name | Description |
|---|---|
| Value | This data point of the module must be connected to a variable of type integer. The variable realizes the display of the remaining timer time. |
| Triggering | Data point of the module that returns TRUE when the module has triggered. This occurs every second when the timer is active. The subsequent branch of the logic script is only executed when the timer has been triggered. |
| No triggering | Data point of the module that returns TRUE if the module has not triggered. The subsequent branch of the logic script is only executed if the timer has not been triggered. |
| Done | Data point of the module that returns TRUE if the timer has ended. The following branch of the logic script is only executed if the timer has ended. |
application example
Given are 1 Homematic button, 1 Homematic actuator for switching a light and a variable for displaying the remaining time of a staircase timer (normal variable of type integer, which has a profile with suffix "Sec" assigned).
A logic script is now to be created in Logic Scripts that switches on a light when the push-button is triggered and switches it off again after one minute. In addition, the remaining time in seconds should also be visualized
You can implement this requirement by using a Timer Variable module; predefined instance modules for the push-button or activating the light can be found in the object tree of the Logic Script Designer.
How it works:
- The PRESS_SHORT variable of a Homematic push-button always has the value TRUE; when the push-button is pressed, the value of the variable is updated and only the date/time of the variable is updated. This update can be evaluated with the On update module and used to control other modules.
- In the current example, when the PRESS_SHORT variable is updated, the light is switched on and at the same time a timer with 60 seconds is triggered by setting the "Active" input in the Timer Variable module, which uses the "Remaining time" variable to count down the seconds.
- The logic script script is executed by this timer every second and updates the value in the "Remaining time" variable.
- Once the timer has reached the value 0, the lamp is switched off again via the "Done" output and a non-module.