## General

This digitalSTROM application is used to trigger automatic responses to various system events.
For example, the lights in room B can automatically be turned on when the switch in room A has been pressed. Or the lights in every room on the first floor of a house can be turned off via a long press of the switch in the stairway (similar to a Deep Off press of a leaving home switch).
In addition, the App-Buttons can programmed to carry out various actions in response to events, such as to a quadruple-click, to power consumption levels exceeding certain thresholds or to on/off events of other devices in the system. App-Buttons are Joker buttons, whose color group can assigned or evaluated directly from a Server-App like a scene responder. Power consumption notifications for devices like the inline power adapter can be configured in the Configurator under Hardware / Power Consumption Notifications. The notification will be sent when connected loads are switched on or off. This allows one, for example, to automatically close the blinds when the TV is switched on.
Thus processes can be automated in a simple manner.

## Overview of all Automatic Responders

Automatic responders can be created, edited or deleted. In the list view one can see the save settings (Name, Trigger, Action, Delay and Condition). If the responder is no longer needed, it can be temporarily disabled or deleted. The function 'Test Responder' will immediately call the responder for test purposes. Conditions will not be considered when testing.

## Creating and Editing Responders

First give your responder a name.
In the tab, Trigger, define an action that will trigger the responder. The trigger can be various system events, such as:

- Activity in Room: call a specific preset or one of many in either a specific room or any room.
- Push-button Action: use switch commands from locally-switched devices, like cord switches and lamp switches or clicks of a Server-Button.
- Consumption Event: configure power consumption event from an inline-power-adapter or a black L-module.
- User Defined Actions: Trigger a user-defined action from a device such as a smart phone.
- User Defined States: state change of a user defined state
- Global Actions such as Leaving-Home, Coming-Home or Panic.

A trigger can also consist of multiple different presets or clicks, for example preset 1, 2, 3, 4 and another action can all be a trigger for the same response. One can select multiple presets or clicks simultaneously by Ctrl-clicking the items in the list.
Optional kann bei einem Auslöser eine Verzögerung eingegeben werden, damit die auszuführende Aktivität erst nach Ablauf dieser Zeit ausgeführt wird.Standardmässig wird für jeden Auslöser eine Aktivität nach der definierten Verzögerung ausgeführt. Es besteht aber auch die Möglichkeit, währen der Verzögerungszeit die vorherigen Auslöser zu ignorieren. Damit wird die Aktivität nur einmal ausgeführt, wenn während der Verzögerungszeit kein weiterer Auslöser aufgerufen wurde.

Each response can carry out any number of actions with the following options:

- Activity in room: call a preset in a room or switch a light on or off. 'All-Off' means that all lights including the locally-controlled lights are shut off. 'Off' does not turn the locally-controlled device off.
- Single Device: switch a single device on or off using a preset call.
- User Defined Action: call a user-defined action that one has created in the Server-App 'User Defined Actions'
- Benutzerdefinierter Zustand: wurde ein manuell zu setzender Zustand definiert, kann dieser hier gesetzt resp. zurückgesetzt werden.
- Call URL: this allows the user to make a URL request to another device on their LAN. One can, for example, request a picture from a webcam and send it to a predefined email address.
- Call activities within the whole house related to access (e.g. Leaving home or Door bell), weather (e.g. rain or wind) or security (e.g. panic or alarms).

Choose the desired action and, if necessary, the desired room, the color and the preset. By double-clicking the selection in the last column or clicking "Show all actions", one can view the list of all actions. The "New Action" button opens an empty dialog and with a double-click of an action in the list or through a "Edit Action" one can edit the selected action settings. Use the arrow keys left and right to switch easily between the pre-defined actions. The trash can icon can be used to delete the requirement for a single action. Click "Save" to save the settings and activate the responder.

The execution of initiated activities might be restricted by conditions. For example, a responder might be executed during daylight only. The following conditions can be defined:

- Solar altitude

- Day: execute from sunrise till sunset
- Night: execute from sunset till sunrise
- Bright: execute from dawn till dusk
- Dark: execute from dusk till dawn

- Daytime: define a time range in which the activity is performed. This allows the execution of activities being limited to a certain period of time.
- Wochentag: beschränkt die Ausführung auf definierte Wochentage.
- Datum: führt die Aktivität nur in einem bestimmten Datums-Bereich aus.
- Schaltsensor-Meldung: führ die Aktivität nur aus, wenn ein Sensor auf dem definierten Wert steh.
- Geräte Zustand: gewisse Geräte bieten einen Betriebszustand, der als Bedingung für die Ausführung der Aktivität verwendet werden kann.
- Benutzerdefinierter Zustand: führt die Aktivität nur aus, wenn der benutzerdefinierte Zustand den gewünschten Wert einnimmt.
- Presence: executes the activity either when you're absent or present
- Presence simulation: executes the activities either if the presence simulation is active or inactive
- Wetter: führt die Aktivität nur aus, wenn die gewählte Wetter-Bedingung zutrifft.
- Sicherheit: führt die Aktivität nur aus, wenn die gewählte Sicherheits-Bedingung zutrifft.
- Room state: the activities are carried out only if the defined preset is active in a room. As an example, a motion detector might switch off the light in a room only if it was switched on automatically, but not by using a push-button in the room.
- Heizungs-System: führt die Aktivität nur aus, wenn die Heizung entweder ein- oder ausgeschaltet ist.

Responders will be executed only if all defined conditions are met.

- Conditions are optional.
- Click 'Save' to save the settings and activate the responder.

Notes
If a preset is called on a single device, the room status is not changed. If, for example, a lamp with a timer is turned on and a click of a switch sets the room where the lamp is located to preset 1, the lamp will not shut off regardless of whether it's normally off when preset 1 is called.

Are shutters, blinds or awnings moved using a responder, it is up to the user to ensure that the automatic opening or closing do not cause any danger.

## Items shown in red in the list of actions to be performed are invalid and cannot be created or edited in this version of the app. For example, directly setting output values of devices or rooms or calling a global action, like doorbell, in a single room. These commands must be replaced by a preset. To do this, delete the old responder and replace it.

- These actions will continue running.
- Example of using a single button to control all blinds/shutters
- Rot markierte Einträge in der Liste der Auszuführenden Aktivitäten sind ungültig und können in dieser Version der App nicht mehr erstellt oder bearbeitet werden. So ist z.B. das direkte Setzen von Ausgangswerten für Geräte und Räume oder das Aufrufen einer globalen Aktivität wie 'Klingeln' in einem einzelnen Raum nicht mehr möglich. Diese Befehle müssen durch eine Stimmung ersetzt werden. Löschen Sie dazu den alten Automaten und erstellen Sie diesen neu.
  Now create a new responder and define the activity 'Close' in this room (eg front hallway) as a trigger. Within 'Initiated Activities' select the shade activity 'Close' for 'All Rooms'. Alternatively, you can select individual rooms, for example if one only wants to control rooms on the first floor. After saving the settings, one can use the 'Close' button to close shutters in all rooms.

## One can use the same definition for the activity Open and Stop. Stop is needed in case the movement must be stopped centrally.

A possible application is a central push button for all shutters and blinds. For this purpose, use a 2-way push button that is either set in a separate room or a room without shutters (e.g. hallway).

Now create a new responder and define in this room (e.g. hallway) the atmosphere 'Closed' as a trigger for shade. Under Initiated activities select 'all rooms' and the atmosphere 'Closed'for shade. Alternatively, you can select individual rooms if, for example, you only want to control the shutters in the rooms on the 1st floor. After saving these settings, you can close the shutters in all rooms with the 'Down' push button.

Now also create the same definition for the 'Up' atmosphere and for 'Stop'. 'Stop' is needed so that the movement can also be stopped centrally if necessary.