Extended Features
If the steps so far are not sufficient, you can adapt your evonHOME with further functions.
Alarm System
The app “alarm system” lets you create a personal alarm system for your evonHOME. The alarm system is divided into a central alarm system and one or more alarm groups. Alarm groups divide the alarm system into several areas.
The app “alarm system” is located under “all apps” – “alarm system”.
Operate
If the alarm system or one or more alarm groups have been activated, the defined activation delay for each alarm group must first expire before the alarm can be triggered. Once the activation delay has expired, if a movement detector is triggered then a trigger delay is activated. During this time, the alarm system can be de-activated without an alarm being triggered. Once the trigger delay has expired, the silent alarm is triggered and a notification is sent. Once the silent alarm time has expired, the actual alarm is triggered and a further notification is sent and the outputs linked to the alarm system are switched.
Activation time is necessary for the following situation: you want to leave the house and activate the alarm before you go. To make sure that you do not inadvertently trigger the alarm yourself, you need the activation delay.
If you want to activate the alarm system, you can either do this via the app by opening the alarm system (“all apps” –“alarm system”) and select the button “activate” in the operator panel for the alarm system, or you define a button to activate the alarm and you use this button (how you do this is described in the chapter configuration). Deactivating the alarm is done the same way via the app, only that you have to enter a password. Deactivation via a button works identically to activation.
Warning, since the alarm system can be deactivated without a password using a button, you need to select a button that is not immediately visible!
Configuration
Duration of silent alarm
Enter the time for silent alarm here.
Automatically deactivate alarm after
Automatically deactivates the alarm after expiration of this time. This is important if you are holiday and something triggers the alarm. If this option was not available, the alarm would never switch off and your neighbours would not be too pleased with you.
Duration of patrol
This is the time the alarm should be deactivated for while you make a patrol.
Button to activate the alarm system
Select a button to activate the alarm system.
Button to deactivate the alarm system
Use the button “add” to select a button to deactivate the alarm system. Warning! This button can deactivate the alarm system without a password. Consider the use of such a button carefully.
Button to start patrol
Select a button to let you start a patrol.
Button to end patrol
Select a button to tell the system you have completed your patrol.
Status light
Select a light that will flash twice when the alarm system has been activated and once when deactivated.
Actions when alarm triggers
Use the button “add” to select all the actions you wish to happen when an alarm is triggered (e.g. switch lights on, activate siren, etc.).
Actions when alarm stops
Select what should happen when the alarm is deactivated. Caution! Do not forget to deactivate the actions started when the alarm was triggered.
Change password
Change the password to deactivate your alarm system.
Alarm Group
Bathroom Heating
“Bathroom heating” lets you configure suitable heating systems and control their times.
These functions are located under “all apps” – “bathroom heating”.
Operation
To add a new bathroom heater, click on the element “add”. First allocate a name to your bathroom heater in the parameter panel, then you can continue with the configuration (described below).
Configuration
You can determine what time each of your bathroom heaters should be on. You do this by defining the operating times in the operator panel. You can define one or more time intervals where your heater should heat for each weekday.
Apart from the operating times, you can also define a button to activate each bathroom heater, where it is connected and whether it should be switched into maintenance mode.
Additional trigger
Select the trigger and the duration for which the bathroom heater should additionally be activated for a short period of time.
Select socket
This lets you define which socket your bathroom heater is connected to.
Maintenance mode
This lets you permanently switch the maintenance mode for the bathroom heater on or off.
Camera
The app “Camera” lets you integrate your evonCAM into your system.
The Camera app is located under “all apps” – “Camera”.
Create
In order to create a camera, click on the box “add new evonCAM” inside the app.
All found evonCams including a preview image will now be listed in the popup which appears. Once your camera shows up on this list you can select it and it will be added to your system and is ready to be used.
If your camera ist not immediately found in your network, you have the option to restart the search or to configure it yourself. In this case a camera will be added for which you have to add the required settings (IP address, username, password).
Configuration
To correctly configure the camera, enter the IP address of the camera into your browser.
If you followed the steps to integrate your evonCAM and the camera was found and added to your system, no further configuration is required.
In case you chose the manual configuration (e.g. because the camera was not automatically found in your network), you can change or adapt the required settings at any time in the ParameterPanel of the camera.
This can also be necessary, when you make changes to the standard username/password or the IP address.
If you change the settings (username/password) of the camera (via its webinterface) the app or browser may ask you to enter the new credentials.
After you did this, it is important to go to the ParameterPanel of the camera and update those settings there, otherwise you will regularly be asked to enter the new credentials.
Operation
The camera panel supports two different sizes. If you hold down your finger (cursor+left mouse button) on the panel for some seconds a bar will appear on the bottom of your screen, which gives you the ability to change the size from small to large.
The large size supports displaying the current camera video inside the panel. Like most other panels, you can add this to your favorites on the start screen which will allow you to always see the current camera image.
With the icon located on the top right corner of the camera image, you can open a popup with bigger view of the video stream, which is well suited for bigger screen sizes like tablets.
The camera OperatorPanel displays the current video/image if the correct credentials are added in the settings. You can also open a popup containing a bigger sized version of the camera image by clicking the icon in the top right corner of the image.
If you did not enter a name for the camera yet, the associated input field will also appear here.
Circulation Pump
“Circulation pump” lets you configure and control the times for suitable pump systems.
These functions are located under “all apps” – “circulation pump”.
Operation
To add a new circulation pump, click on the element “add circulation pump”. The next step is to allocate a name for your circulation pump in the parameter panel. Then you can continue with the configuration (described below).
Configuration
You can define the operation times for each one of your circulation pumps. This is done by defining the operating times in the operator panel. You can define one or more time intervals for each weekday when you wish the circulation pump to be in operation.
In addition to the operating times, you can also define intervals within the operating times, which trigger activates them, where they are connected and whether they should be put into maintenance mode.
Active interval during operating time
Define the intervals within the operating time you wish to circulation pump to be active.
Additional trigger
Select the trigger and the duration for which the circulation pump should be additional active for a short period of time.
Select socket
Define which socket the circulation pump is connected to.
Maintenance
Switch the circulation pump permanently on or off for maintenance purposes.
Clock
The clock lets you create an alarm clock, a timer or a weekly programme. The next chapters explain how to use them.
The clock is located under “all apps” – “clock”.
To create an alarm clock, a timer or a weekly programme, simply open the app “clock” and select “add clock”. A window then opens offering you a selection of elements you can create.
Alarm Clock
The app “alarm clock” lets you create an alarm clock that goes off at the time you define and is shut off after a certain time. An alarm clock is intended to be used with a scene to react to the alarm and the end of the alarm.
Using With A Scene
In order to use this alarm with a scene, it must first be named and then you can click on “add” in the scene’s “IF” and select the app “Clock”, unfold the alarm clock and select either “alarm triggered” or “alarm ended”.
Configuration
To define the alarm time, simply click on the currently defined time and select the time you wish for the alarm. You must also activate this alarm via the option “activate”.
The item “repeat” lets you select which on weekdays should the alarm be repeated. If you only want the alarm to go off once, select the option “just once”.
The length of time the alarm is active can be set under “extended” by activating the option “activate extended settings”. You will need the active alarm time if you want the alarm to last for a specific time. For example, if you have activated the alarm for 8pm with an active time of 10 minutes, then the alarm is active from 8 pm till 8:10 pm and then switches itself off. If you haven’t activated this option then the alarm stops directly after the trigger.
Timer
The app “timer” lets you define a countdown that, once the defined time has expired, can invoke a scene. You can also allocate a signal light to this timer that signals when the time has expired.
Operation
To adjust the time, click on the currently defined timer for this timer in the operator panel under “operation” and change it as you require.
The button “start” is used to start the timer and “reset” to reset the start time. The button “pause” stops the timer and you can continue the timer by pressing “start”.
Using With A Scene
In order to be able to use this timer with a scene, it must have a name. Then you can select the trigger “time expired” in the scene under “IF” and the appropriate action to be carried out when the timer has expired. You can also use the timer in the scene for the “THEN”. This lets you start, stop or reset a timer via a scene.
Configuration
Once you have allocated this timer a name and optionally a room, you can begin with the configuration.
You can add as many lights as you want in the item “signal light” using the button “add”. These lights are intended to flash on and off and the number of flashes can be set via the option “number of flashes”. The duration of each flash can be set via the “duration of signal flash”.
Weekly Program
The app “weekly program” lets you define up to 3 time periods per day in which you can execute actions. In order to be able to carry out an action, a scene must react to the activation and de-activation of the weekly program.
Using With A Scene
In order to be able to use this weekly program, you must give it a name. Once done, you can select the triggers “activated” and “de-activated” in the scene’s “IF” statement. For example, if a time from 9 am to 10 am has been defined for each Monday, then “activated” is invoked at 9 am and “de-activated” is invoked at 10 am. Furthermore you can use the weekly program in the scene for “THEN” by selecting “switch on once” (“switch on once” is explained in the chapter “configuration”).
Creating And Editing Entries
To create an entry in the weekly program, click on “+” for the desired day. This opens a window where you can configure the entry. You have the following possibilities:
Day
The weekday for which this entry is to be created.
No end time
If you only want to define a start point then activate this option. If a point has no end time, then the weekly program is activated after the time for the “runtime for additional trigger” has expired (located in the parameter panel).
From
This is the start point for your entry
Until
This is the end point for your entry
To edit an entry, click on the previously created entry (in the operator panel) and then proceed the same as for creating the entry.
Configuration
Runtime for additional trigger
If the weekly program is activated once via the additional trigger, then the weekly program remains active for the defined time. If you have an entry without end point, then the weekly program also remains active for this time after the defined time has expired.
Additional trigger
You can add as many additional triggers as you wish that trigger the weekly program once.
Counter
This app is used when you connect a counter to a digital input. With it's help you can react to the signals send form the counter unit and evaluate them. For example, you can record a power consumption in kW, set various value limits and react to them later in scenes.
The Counter ist located under “all apps” – “Counter”.
The minimum pulse length for a counter connected to a digital module is 100ms. For faster counters, please use the input located on the cpu module.
Create
To use a counter in combination with the corresponding app, you will have to connect it to a digital input of your evonHOME (DI1 - DI4 on the CPU or 'evonHOME Digital 1180' or 'evonHOME Digital 1344'). Then follow these steps:
If you find not create a counter in your evonHOME system yet, you have to convert a digital input into one.
Navigate to te digital inputs in 'All Apps' - 'Digital Inputs', select the desired input and open the ParameterPanel.
In the settings for mode, choose 'Counter'. The digital input will now be converted into a Counter an will be listed in the Counter app.
Configuration
Every Counter allow you to change certain settings, which determine what will be counted (e.g. kWh) and what limits exists.
Pulse value
Choose the significance of the impulse which gets received by the counter. The necessary settings for this are usually listed on the counter device.
Settings
Inverted
If this option is activated, only falling edges will be counted instead of rising edges.
Reserve
Hides this counter from the visualization.
Color
Changes the color of the visible graphs.
Edit count
Here, you can set the current count to a desired value
Show statistics
Choose the graph/chart, which will be displayed in the OperatorPanel.
Limits
You can choose various limits (and according delays) here, which you can then link in scenes. Linkable values are: 'current consumption - upper limit', 'current consumption - lower limit' and 'daily consumption - limit'.
Mode
With this setting you can convert/revert a counter to a digital input or switch
Operation
Once a Counter has been created, you can add additional visual panels. Those grant you an overview about the evaluated values.
To add such a panel, use the button "add panel".
In the popup which will appear, you can choose between several graphs/charts. To do so, you have to select the corresponding Counter under 'choose counter' and then one of the desired charts.
The OperatorPanel gives you an overview about the measured values. The following sections exist:
Status
Gives you information about the total, daily and current consumption. In addition, you can also reset the counter.
Statistic
The graphs/charts which you can activate in the ParamterPanel will be shown here. The statistics which are shown here can also be reset with the corresponding button.
Denon
This section contains information on using connected DENON devices.
Denon lets you play music throughout your house, whether from a USB stick, music server, Internet radio, iPod, AUX or online music.
The Denon app is located under “all apps” -“Denon”.
Currently, only the DENON DRA-N4 amplifier is supported by evonHOME.
Operation
Volume
You can change the volume via the “+” and “-“ buttons, or use the slider.
Source
Use this to determine where your music is to come from and see the Denon display below it. Navigate around your Denon using the 4 arrows and the enter button.
Favourites
Add the current programme to your favourites list using the button “add to favourites” so that you can find it again quickly. All your favourites are displayed in a list below this.
ON/OFF
Switch your Denon on an off.
Status
Shows which music source is currently active, Internet music, iPod etc. and shows the current IP address.
In the parameter panel, you can also define whether this Denon is to be switched with the universal scenes or not “remove from universal scene”) and how loud the Denon can be allowed to be.
Linking
You can link the Denon to a scene. You have several possibilities.
Use the following if the IF statement
Pause
The scene is invoked when the sound is paused.
Play
The scene is invoked when the music begins, i.e. when the play button has been pressed.
The “THEN” can have the following triggers:
Switch off
The Denon is switched off as soon as the scene is invoked.
Switch on
The Denon is switched on as soon as the scene is invoked.
PlayMusic
The Denon begins play music at the start volume which then increases to the define target volume. The ramp-up time defines how long it takes to reach the target volume. The favourite number lets you choose which favourite you wish to play.
Detector
The Detector app allows you to use a digital input for alarms/notifications. This can be useful in cases like when you want to connect a fire alarm to your evonHOME.
The Detector app is located under “all apps” – “Detector”.
Create
To create a Detector, you will need a digital module ("evonHOME Digital 1180" or "evonHOME Digital 1344") with an digital input. Then, follow these steps:
Navigate to the app 'Digital Inputs', which you can find under 'All Apps'.
Select the desired digital input, which you want to use as a Detector.
Navigate to the settings of the chosen digital input and change its mode to 'Detector'.
The Digital Input changed into a Detector and can now be found in the 'Detector' app.
Operation
After you changed a Digital Input into a Detector, it will react to incoming signals and trigger an alarm, depending on its configuration.
A detector will display if his input is currently active and if it is triggering an alarm.
Configuration
Each Detector allows you to configure the triggered alarms. Here you will find the description about all available options.
Type
This are pre configured settings for different use cases. Each one comes with a predefined notification text, settings and specific icon.
Alarm after
Defines the timespan for which a signal has to be active on the digital input to trigger an alarm.
Notification
Here you can choose to receive a notification once an alarm gets triggered.
Notification text
Set the text you want to see in the notification.
Alarm must be acknowledged
If this option is active, an active alarm has to be manually terminated instead of ending once the input signal stops.
Reserve (hide in visualization)
Once active, the Detector will be hidden in the visualization.
Icon
Defines which image should be used for this Detector.
Alarm Output
You can choose a digital output, which will be triggered in case of an alarm, here.
Mode
Here, the Digital Input which is used for this Detector can be switched back to another mode.
Simulation on
Activates the simulation and allows you to set a value via the setting 'Simulation Value'. Attention: If the simulation is active, real values are ignored!
Simulation Value
Change the simulated value with this setting.
Door
The app “door” lets you create a door for your evonHOME. You can link a camera, a bellring button, a bellring and a door opener contact to such a door.
The app “door” is located under “all apps” – “door”.
Operation
If you open the operator panel for your door, then you can see the camera image (if a camera is linked to this door) and a button “open door” that lets you open this door (if a door open contact has been selected).
As soon as someone rings the bell for this door, you will receive a notification and a photo is taken of the moment the bell was rung that you can see when you open the notification.
Configuration
Camera
This field lets you select a camera for this door. The camera image is then always displayed on the operator panel.
Bellpush
Use the button “add” to add one or more buttons you wish to use to ring the doorbell.
Doorbell
Select the digital output that is connected with the doorbell.
Door opener
Select the digital output connected to the door opener using the button “add”.
Signal light
If you in a room where it is not possible to hear the doorbell, you can select a light in this room that will flash when someone rings the doorbell
Number of flashes
Define the number of times the signal light is to flash when someone rings the doorbell.
Signal light on time
Defines how long the signal flash is to be.
Door open time
Defines how long the door remains open, if you open it via the app.
Doorbell time
Defines how long the digital output for the doorbell is to remain active.
Melody
If you want a melody to play on your smartphone, or tablet etc. when someone rings the doorbell, then you can choose here between two melodies.
Simulate
You can simulate the doorbell button press using the button “ring” to test whether you have satisfactorily configured all options according to your requirements. This has the same effect as if someone had really pressed the doorbell.
Fronius
The "Fronius" app allows you to integrate your Fronius system into your evonHOME.
The Fronius app ist located under 'all apps' - 'Fronius'.
All limits, which can be configured in the Fronius app, can also be used as triggers for scenes.
Create
To integrate your Fronius system, please follow the steps below.
(You will need the IP Adress of your PV-system for this)
Open the Fronius app an choose 'add'.
Enter the IP address of your PV system in the now appearing popup.
Confirm it with the button 'add'.
Once entered successfully, all installed elements of your PV system will be shown.
Elements
If you integrate a Fronius system, every installed element (which is supported by evonHOME) of your PV system will be displayed.
Additionally the Dashboard of the Fronius app can be extended with more panels.
Once a PV system is integrated, you can choose to add additional panels by using the 'add' button.
You can choose between 'My Fronius', an overview about the current energy flow in your system, "Efficiency" (of the inverter), “Energy“, "Supply" and "Phase Distribution".
There is also a dynamic diagram available, which can be customized by the user. It allows you to choose between different values and diagram types.
All panels can be added to the home screen by selecting them with a long click/press.
Inverter
Operation
The most important values are displayed in the first part of the detail view (Operator Panel).
Additionally, the utilization and energy values for year, month and week will be shown in a diagram.
Configuration
The second part of the detail view (Parameter Panel) allows you to view detailed values and and adjust limits. Three power limits can be set which will trigger an event once exceeded or below the set value.
Detail values
Lists values which can be used by an inverter in the system.
Scenes
The inverter offers an event for the power limits 1,2 and 3 in case they are exceeded (above/below).
Smart Meter
Operation
The operator panel of the Smart Meter displays the current feed-in/supply to or from the power grid and presents them in an area diagram.
Configuration
The parameter panel displays the phase distribution in a bar chart and allows you to adjust feed-in/supply limits for he power grid, which will throw an event once exceed (below/above). In addition, all detail values of the Smart Meter are displayed.
Detail values
Shows values which can be used by a Smart Meter in the system.
Scenes
The Smart Meter offers events for feed-in/supply to or from the power grid in case they are exceeded (above/below).
Battery
Operation
The operator panel displays the current charging/discharging rate (in watt) and the current battery power level.
Configuration
The parameter panel allows you to adjust the minimum charging level, which will trigger an event in case it is exceed (above/below), and to view the detail values of the battery.
Detail values
Shows values which can be used by a battery in the system.
Scenes
The battery offers events for exceeding (above/below) the minimum charging limit.
House Status
The “house status” displays the current status of your house and lets you change it.
The “house status” is located under “all apps” – “house status”.
Usage
If you want to activate a status via the visualization, you can do this either in the left-hand area of the corresponding object panel or via the operator panel using the button “execute”.
The status that is currently active is displayed both in the object panel and in the house status panel. If you drag the house status to your favourites, then the current active status is displayed there too.
The house status panel not only displays the current status of your house, but also if dawn/dusk, rain or wind are active. You can configure where this information comes from in the “global settings”.
Create
You can easily add a new status for your evonHOME. To add a new house status, click on the element “create status”. The operator panel opens and lets you first allocate a name to your house status. Once named, you can then continue with the configuration (described below).
Each status can be given a name and an icon that is displayed in your evonHOME.
Configuration
For each of your created house stati, you can define which button activates it and should happen if the status changes.
Button to activate this status
Select the button here that allows you to activate the corresponding status
Action when activated
Select here the action that is to be invoked when the corresponding house status is activated.
Action when de-activated
Select here the action that is to be invoked when the corresponding house status is de-activated
Internet Weather Station
The Internet weather app lets you call up data for a specified region and use it for your evonHOME.
The app “Internet weather” is located under “all apps” – “Internet weather”.
Create
Click on the element “add weather station” to add a new weather station. This opens the operator panel where you need to define a name for your weather station. Enter the API key and your location in the item “weather underground API key”. This is provided by WeatherUnderground (http://www.wunderground.com) once you have registered there. Once you have done this successfully, you will receive weather data for the specified location.
If you want the use this weather station for your evonHOME, then drag this weather station to the first position for wind, rain, outside temperature and daylight in the app “global priorities”. (For example, if you only want to use the outside temperature of this station, then only drag the weather station to the first position for the outside temperature).
Configuration
Wind alarm settings
This is where you define the wind speed that you wish to trigger an alarm. If you also wish to define hysteresis and a delay, then activate the option “extended settings” and select hysteresis and delay. If the wind speed exceeds the value defined for wind alarm, then the alarm is triggered. Now the wind speed must fall below the defined hysteresis value (below the wind speed alarm value) for the alarm to be reset. The delay defines how the wind speed must be above the defined limit for the alarm to be triggered.
Offset
If you are not satisfied with the time for sunset and sunrise, you can change then by activating the option “change sunrise and sunset times” and changing the times accordingly.
Logic
The logic app enables you to execute complex operations for which there is no app. For example, this could be controlling the ventilation of the WC, controlling a light transformer etc. If you wish to use logic, then you should already have a basic understanding. If you are new to the area of logic, exercise caution when using this feature.
The logic app is located under “all apps” – “logic”.
Logic Program
To create a logic sequence, you first need a logic program. This is comparable to a network in PLC programming. A program contains logic elements that you can use for your controller. For example, if you have a controller for the WC ventilation and one for a light transformer, then you can create an individual program for every controller.
Create
To create a logic program, open “logic” and select “add program”. This opens the operator panel for the logic program. You must first allocate a name to your program and optionally a room for it.
Parameter
The operator panel for the logic program contains an item “parameter” where all parameters available to rapidly configure the program are listed (parameters are described in the chapter data elements). The values of these parameters are not lost if a controller fails.
Status
The item “status” displays a diagram that shows you the time required to execute this program.
Control Command And Status Text
Every logic program can contain a control command and a status text. You can select a data element of type bool for the control command and a data element of type string (text). To do this, go to the parameter panel and select “choose control command and status text”.
The control command is intended to activate and deactivate the logic program via the object panel. You can toggle the control command via the icon on the left-hand side of the object panel.
The status text is displayed in the object panel under the name of the program. An example would be “ventilation will be switched off in 2 mins”.
Edit Logic
If you want to edit the logic in this program, click on the button “edit” in the parameter panel under the item “logic”.
Import/export
If you wish to save the logic program, you can do this via the button “export” in the parameter panel under the item “import/export”.
To import a logic program, click on the button “import” (directly under the “export” button). Note that any existing logic is overwritten by the logic in the imported program. Furthermore, if logic elements were linked across programs prior to export, after importing, the links no longer exist.
Color And Icon
You can allocate a colour and icon to your logic program. Do this in the parameter panel under the item “settings” by clicking on the current colour or icon.
Logic Elements
Elements are all logic elements that you can add to a logic program (AND, OR, etc.)
Create
To create a logic element, you must first be located in the logic program. If not, open the logic program and select the item “edit logic” in the parameter panel. Then add new logic elements to the program using “add function”. To do this, click on the corresponding element.
Element Colour
If a logic element has an error, or if it is simply not activated, then you can recognize this due to the colour of the element.
Green
The element is working fine.
Orange
The output of this element is being simulated.
Grey
The element does not have a fault, but it is deactivated.
Red
The element has a fault: either an input has no value, or the output it is linked to no longer exists.
Connecting Elements
The operator panels for each logic element (except for data elements) are all constructed using the same principle. The first item is the setting (if available), then the inputs, then the output.
This shows you the selection of an input.
The button “select” lets you select the output of a different logic element that you wish to connect to this input.
The checkbox under “invert” lets you invert the input (if it is of type bool).
The checkbox under “fixed value” lets you allocate a fixed value to the input. This means that if you activate this checkbox, the type bool displays a checkbox in the centre with the text “value”. The state of the input can be controlled using this value. If you activate this checkbox for an input of data type number or string, then an input field appears where you can enter the desired value.
Data Elements
Data elements are intermediate stores for values. This means that data elements can be described by other logic elements by selecting this data element at the output (however only if both are of the same type). Data elements can also be linked with inputs of other logic elements. Every data element has the option “parameter” in the operator panel. If you have activated this option, then you can see this data element in the operator panel of the corresponding logic group and you can change it from there. This has the advantage that you do not always have to have the logic program open to change a value. Parameters also means that the value of a data element remains even if the controller were to fail.
You can change the value of any data element via the object panel. You can do this on the left-hand side of the object panel for types bool and number, and on the right-hand side via the input field for type string.
AND
The element “AND” is a classical AND operator. This means the output is set to true as soon as ALL inputs are true. This element can have between 2 and 6 inputs. The number of inputs can be changed via the operator panel using the buttons “add pin” and “remove pin”.
OR
The element “OR” is a classical OR operator. This means the output is true as soon as at least one input is true. This element can have between 2 and 6 inputs. The number of inputs can be changed in the operator panel using the buttons “add pin” and “remove pin”.
Compare
The compare function works by comparing the values present at the two inputs and switches the output accordingly.
You can change the following settings in the operator panel:
Type
Select the type of comparison
Hysteresis
If you require hysteresis, you can define it here.
Sample time
This is the time for which the comparison must be fulfilled for the output to be switched to true.
Time Relay
The time relay lets you delay an output switching on or off, or leave it switched on for a certain time.
The time relay has two types that you can configure under “select used times”.
Delay switching on/off
If the input is true, the output is only set to true after the selected ON time delay. If the input jumps from true to false, the output is set to false after the selected OFF time delay.
Switch on delay and duration
This enables the option “input as flank”. If you have not activated this option, then the input must be true for at least the switch on delay time in order for the output to be set true for the defined duration and after this duration (independently of the input) reset to false. If you have activated this option then a flank is sufficient on the input and the output is set to true for the defined duration and then reset to false.
Time Measurement
Time measurement is represented by a stopwatch. Time measurement can be started, stopped and reset via inputs “activated” and “reset”.
If the input “activated” moves from false to true, the stopwatch starts. If the input “activated” moves from true to false, the stopwatch stops, if “auto reset” was NOT activated.
If “auto reset” is activated, then the stopwatch is reset when the input “activated” moves from true to false.
The input “reset” resets the stopwatch. This only works if “auto reset” has not been activated.
Value Allocation
Mit der Wertzuweisung kann ein beliebiger Wert dem Ausgang zugewiesen werden.
The value on the input E1 is written unchanged to the output if “activated” is true.
Counter
The counter can increase, decrease or reset a numerical value to 0.
The input “up” increments the counter by one when the input changes from false to true, the input “down” decrements the counter by one and “reset” resets the counter to 0.
Flank Recognition
Flank recognition allows rising and falling edges to be evaluated. This means that if the selected flank appears on the input, then the output is set to true for one cycle and then reset to false.
The type of flank can be selected in the operator panel under the item “settings”.
Function Generator
The function generator enables periodic square wave signals to be generated.
As soon as the input “activated” is true, the function generator is started and generates a periodic square wave signal on the output.
“TOn” can be used to adjust how long the square wave signal is true and “TOff” how long it is false.
Function
A function element is used to carry out mathematical calculations. “A1” must contain the desired calculation.
The variables E1 to E6 can be used for the calculation, e.g. A1 = 2*E1 + E2.
As soon as the input “activated” is active, the calculation will be carried out. The buttons “add pin” and “remove pin” can be used to add up to 6 inputs. The following shows link shows you which operations are possible:
Documentation- Functions(https://developer.mozilla.org/de/docs/Web/JavaScript/Reference/Global_Objects/Math)
Reset
For as long as the input is true, the output of the reset element will be set to false.
Set
For as long as the input is true, the output of the set element will be set to true.
SR Flip Flop
The SR flip flop is used to set and reset an output. If the input “set” is true, then the output is true. If the input “reset” is true, the output is false. If both inputs are true, then the output is false. If both inputs are false, the output is stored, meaning it remains in this state until the input is true again.
Text Block
The text block is used to create any text string you want.
1 to 6 inputs (E1 – E6) can be created using the buttons “add pin” and “remove pin” and the text from these inputs are then strung together.
For example, if the text for E1 is “It is now ” and the text for E2 is the current time (use the button “select” and under “system” then “time”), then the following text string will be created “It is now 17:00”.
PI Controller
This is a clocked PI controller where you supply demand value, actual value and clock.
The settings for the PI controller are located in the parameter panel.
Examples
WC Ventilation
Task
If the light in the WC is switched on, then the ventilation should be switched on 15 seconds later (the ventilator must be connected to a digital output) and run for one minute after the light has been switched off. If the light is switched off before the ventilator is switched on, the ventilator should not be activated.
Solution
First open the app “logic” and create a logic program via “add program”.
Give the logic program the name WC-ventilation and select the room WC.
Open the logic program via the button “edit”. Use the “add function” to add the function time relay. This relay is red, meaning that it isn’t yet working, because there are no inputs.
Now open the time relay. Since the output should be switched on after 15 seconds, you will need a delay of 15 seconds. Change the switch on delay to a fixed value and enter the value 15. Do the same for the switch off delay, except instead of 15, use the value 60, since the ventilation is only meant to run for 1 minute (= 60 seconds) after the light has been switched off.
Now you need to link inputs and outputs. Select input E1 using the button “select” and navigate to the lights, select the WC light and select “light on”. In the object panel of the time delay, you can now see the current value of the light and how it changes when the light is switched on and off. Now all you need to do is connect the output of the time relay with the digital output. To do this, click on “select” under “output” and navigate to the digital outputs. Once there, select the desired output and click on “set value”.
Now you can test your WC ventilation and see if everything is working fine.
Light Transformer
Task
There are 4 lights and 1 light transformer available. The light transformer is connected to a digital input. As soon as at least one light is switched on, the light transformer must be switched on. If no lights are switched on, the light transformer must also be switched off.
Solution
The first thing to do is open the app “logic” and create a logic program via “add program”.
Give this logic program a name “light-trans”.
Next, open the logic program using the button “edit”. Use the button “add function” to add an OR. This OR is red meaning that it is not currently functioning, because it has no inputs.
Now open the OR and add two inputs using the button “add pin”. These four inputs must now be linked with the four lights via the button “select” by selecting “light switched on” for each light. The OR is now green, because all inputs are linked. Finally, you need to connect the digital output of the transformer with the OR. Do this by clicking on “select” under “output”, open the digital output there and select “set value” for the desired digital output.
The logic should now work as desired.
Ventilation Control
Task
You measure humidity in a room and want to switch on the ventilation as soon as the humidity has reached a certain value.
Solution
To do this, the humidity sensor must be connected to an analog input of an analog module and configured accordingly (to do this, see chapter “Analog Input”). The ventilation must be connected to the output of a digital module.
Next, create a logic program in the app “logic” using “add program”. Give the program a meaningful name (e.g. fan control) and if wish, allocate a room. Then open the parameter panel and select “edit” under “edit logic”. Insert a compare function via “add function”.
Now open the operator panel of the compare function. Under the item “settings”, first select for “type” the value “greater than” (since the fan is to be switched on when the humidity is GREATER than a certain value). You can configure the hysteresis for the compare function as you feel is necessary. In this example, select 5 for the hysteresis. The sample time can be left at 0. Now the compare function is correctly configured.
The inputs and output now need to be connected. Select the analog input you connected the humidity sensor to under “inputs” for “E1”. For “E2” enter the value above which the fan is to be switched on. In this example select 80. Now select the digital output you connected the fan to using the button “select” under “output”.
The ventilation control is now complete. If you want, you can change the hysteresis and the sample time as you require.
Mixer Circuit Control
The “mixer circuit control” app is an external temperature heating control loop. The “mixer circuit control” is used to configure and control 3-way heating mixer valves.
These functions are located under “all apps” – “mixer circuit control”.
Operation
Click on the element “add mixer control” to create a new mixer circuit controller. The next step is to give your mixer circuit control a name, and then you can continue with the configuration.
The operator panel displays a schematic of the control. This diagram shows you whether the pump is on (screw in the pump is green and rotates) or off. Displayed adjacently is the current temperature of the feed line and to the right the current position of the mixer valve and whether it is open or closed.
All relevant values pertaining to your mixer circuit control are displayed below this.
If your mixer valve is unreferenced, i.e. the current position of the valve is unknown, then the button “execute reference” is displayed. Clicking on it closes the valve completely; hence the current position is known. The mixer circuit control must be fully configured before a reference can be executed.
Heating Curve
The heating curve allows you to adjust the desired temperature of the feed line as a function of the outside temperature.
There are pre-defined curves you can select from using “select curve type”. If there is no pre-defined curve that entirely suits your needs, then you can edit the pre-defined curves by clicking on “edit”. The selection then jumps to “user-defined”. If you wish to save your curve, click on “save”. Saved curves can be deleted using “delete”. When selecting points, you are limited on the one hand by the minimum and maximum feed line temperature, and on the other by the previous and subsequent point. For example, the point at 10 °C outside temperature cannot have a lower feed line temperature than the point at 15°C and a higher temperature than the point at 5°C.
If the outside temperature reaches a value outside of the curve, then the curve is continued horizontally. This means if the curve were to end on the left-hand side at an outside temperature of +20°C with a corresponding feed line temperature of +22°C, then the feed line temperature for outside temperatures higher than +20°C will remain +22°C.
To be able to process outside temperatures higher than +20°C, the cooling operation must be activated under “all apps” – “settings” – “room climate”. Warning! Cooling operation may only be activated if the heating is really able to cool, since in cooling mode, the mixer outputs are switched exactly the opposite way.
Feed Line Temperature Limitation
You can define your minimum and maximum feed line temperatures here.
Mixer Parameters
Enter the runtime for the mixer valve in seconds according to the manufacturer in “manufacturer mixer valve runtime [s]”. If the value you entered was correct, then you must now click on the button “execute reference run”. Please note that you must have previously correctly set the inputs and outputs.
The field “overrun time” lets you how much longer in percent the mixer output remains switched on when completely open or closed. This guarantees that the mixer is subsequently really completely open or closed.
Since a mixer valve normally requires longer to close than to open, you can use the “multiplier mixer closed” to define how much longer the valve needs to close than open.
Calibration Run
Since there is always a certain error when opening and closing the valve, a calibration run must be run daily. All you have to do is set the desired time for this to occur and the rest is done automatically.
Inputs
Feed line actual temperature
Select the input here that measures the actual temperature of the feed line.
Outside temperature
Select here the input used to measure the outside temperature. The standard setting is located in “system” – “house status” – “outside temperature”.
Release
Select the main switch for the mixer control. This input is used to activate or deactivate the entire control.
Outputs
Valve Type
The used valve type is chosen here. The options are analog with "0-10V signal" and digital "open/close signal".
Valve
(With valve type "0-10V signal")
Select the analog output, which will be used for the valve control.
Mixer open
(With valve type "Auf/Zu signal")
Select here the output used to open the mixer valve.
Mixer closed
(With valve type "Auf/Zu signal")
Select here the output used to close the mixer valve.
Pump
Select the output used to connect the mixer pump.
Fault
Select an output to be switched if there is a fault.
Extended Configuration
The extended configuration allows you to configure all the components of your mixer control extra. Simply click on “edit”. Exercise caution, particularly when adjusting the controller parameters.
Below this, you can adjust the sample time and minimum error.
Sample time
This is the time period when a new position of the valve is calculated (standard 10s).
Minimum error
The position of the valve is only adjusted if there is a difference between desired and actual temperature of the feed line. If the difference (error) is larger than this value, then the position of the valve is changed.
Activate notification
If you wish to receive a notification of a fault condition, then activate this option.
REST API
Starting with version 1.4, your evonHOME offers you a REST API Service at "http://[evonHOME_IP]/api". The following steps are required to use it.
Preparation
- Navigate to 'Alle Apps' - 'Settings' - 'Rest Service' in the user interface of your evonHOME system.
- Enter your evonHOME credentials and generate a hash (You should save the hash value as it is needed for the following step).
Authentication
To send requests to the REST API, you must authenticate yourself. A token is used for this purpose, which you will receive once you make a successful login attempt via the REST API.
- Send a POST request to the following address:
"http://[evonHOME_IP]/login", with this header parameters:- x-elocs-username: [Username]
- x-elocs-password: [Hash]
You will receive a token 'x-elocs-token' as a response, which will automatically be set as a cookie. This token will now be used as an authentification for all further requests.
Depending on from where you are sending your requests, the cookie will automatically be used. Otherwise, you will have to add the token to the header of every request 'Cookie:token=[Token]'.
Requests
The evonHOME REST API allows you check the status of the components in your system and to control them. The following requests are available to you:
GET: apps
"http://[evonHOME_IP]/api/apps"
Returns a list of all apps.
GET: apps/{fullName}
Returns detailed information about the requested app.
GET: instances
Returns a list of all instances.
GET: instances/{instanceId}
Returns detailed informations about the requested instance.
GET: instances/{instanceId}/{action}
Returns the current value of the requested property of a specific instance. For example, the current state of a light.
POST: instances/{instanceId}/{action}
Calls a method of the specific instance.
You can find a test interface at "http://[evonHOME_IP]/api", which allows you to try out all listed requests.
Examples
In the following example, we want to switch a light by using the REST API.
Before we can start, we have to make sure that the preparations for authentification are done (see topic "Preparation" and "Authentification"). With the received token, we are now able to send all requests and commands.
At first we send a GET request to `"http://[evonHOME_IP]/api/instances" and receive a list with all instances, which are currently active in the evonHOME system.
"statusCode": 200,
"statusText": "success",
"data": [
{
"ID": "SC1_M04.Light1",
"ClassName": "SmartCOM.Light.Light",
"Name": "Roomlight",
Group": "AreaOutdoor
},
...
]
}```
As we want to switch a light, we choose the 'Roomlight' and use its "ClassName": "SmartCOM.Light.Light" to send a GET request to `"http://[evonHOME_IP]/api/apps/SmartCOM.Light.Light"` and receive the available methods and properties.
```{
"statusCode": 200,
"statusText": "success",
"data": {
"methods": [
{
"parameter": [],
"name": "SwitchOn",
"type": 0,
"derived": false,
"tags": [
linkable
],
"returnType": "void",
"description": "switch light on",
"isStatic": false
},
...
],
"properties": [
{
"name": "IsOn",
"type": "boolean",
"remark": "light switched on",
"declaration": "2",
"derived": true,
"parameter": false,
"tags": [
linkable
],
"isStatic": false
},
...
],
"fullName": "SmartCOM.Light.Light",
"displayName": "Light",
"autoStart": false
}
}```
We are now sending a POST request to `"http://[evonHOME_IP]/api/instances/SC1_M04.Light1/SwitchOn"` with the following parameters in the header:
- instanceId: SC1_M04.Light1
- action: SwitchOn
- body: [ ]
This will call the specified method of the light and switch it on. We can also check the current status by sending a GET request to `"http://[evonHOME_IP]/api/instances/SC1_M04.Light1/IsOn"` and receive a response containing the current status, in this case 'true'.
```{
"statusCode": 200,
"statusText": "success",
"data": true
}```TCP Client
The TCP Client app allows you to communicate with TCP-compatible devices (TCP clients). Among them are devices like beamers, TVs and many more. Additionally, you can use a gateway (TCP to serial port) to send commands to different devices with a serial port.
The TCP Client app is located under “all apps” – “TCP Client”.
Create
To create a new TCP Client, navigate to the app and choose 'add TCP client'.
On every TCP Client, there is a symbol which shows you if there ist a working connection to the desired device. As you have to configure every new TCP Client first, the symbol will display a red X.
Before the TCP Client can communicate, you have to enter a valid IP address in the settings. To do so, open the Parameter panel of your newly created TCP Clients and enter the IP address and the port of the desired device.
If the IP address and port are correct and a successful connection could be established, you will see a green checkmark in the display of the TCP Client after some seconds.
Operation
The Operator Panel of the TCP Client displays the current status of the client, allows you to send preconfigured commands and shows you a list of recently received data.
State
The current status of the TCP Client will be shown here.In case there are any problems with the connection to the desired device or you haven't entered a correct IP address yet, a red X will be displayed.
Events
Every TCP Client allows you to create 3 events, which are triggered when the conditions meets. You can then link to those events in created scenes (inside the Scene app) and use them as triggers. Configured events will be displayed in this list.
Commands
All commands you have created are listed here. You can trigger or delete each one.
Last received data
This list will display recently received data. You can switch between a 'text' or 'hex' view.
Configuration
The settings of the TCP Client allow you to configure new commands and events, which can be linked in scenes.
IP configuration
The IP address and port of the device for which you want your TCP Client to establish a connection to should be entered here. This settings should be the first configuration you make after creating a new TCP Client. The Operator Panel will then tell you if your connection is working.
Commands
If you want to create a new command, you can do this here by using the 'new command' button. Choose a name and the data which should be send. You can decide between simple text or hex values. Additionally, you can also decide whether you expect a specific answer and choose between text or hex values.
Test command
If you just want to test a command, you can do this here. The result will then be displayed beneath the 'test command' button.
Events
There are some devices, which may frequently send data, without the need for a explicit request (e.g. via a command). For such use cases, every TCP Client has 3 events. For each event, you can set what data you are expecting and their type (text or hex). If an expected event occurs this event will be triggered and can be linked to when creating a Scene.
uLux
The app allows you to configure the evonHOME uLux switch.
The uLux app is located under “all apps” – “uLux”.
Important: To integrate the uLux switch into evonHome, the required uLux design-template must be present on it. In delivery state, all evonHOME uLux switches already contain this template. Further configuration with the uLux software is not required.
Create
To create a new uLux room, click on the add symbol, after which a search for uLux switches in your network is started. If the switch is not immediately found, you can just restart the search. Once the uLux is found, you just have to select it to add it to your system.
Operation
The uLux switch works like a room control. This makes it easy to add all elements from a room (lights, blinds, heating, scenes) to it.
Just add a name and room to your uLux switch and once you finish the configuration every element from this room will automatically be displayed on the switch.
If an uLux extension module is connected, your can find all measured values in the 'extension' section. Those values can also be linked in the Logic app.
Configuration
After the uLux switch has been found, you only need to add a name, a room and an IP-address.
Settings
Here, you can change the network address of your uLux switch.
If you edit this settings, you will have to press the button 'write configuration' to transfer them to your uLux switch. The switch will then restart and boot up with your new configuration after some seconds.
Weather Station
The evonHOME weather station is a simple way to receive local weather data and use it in your evonHOME.
The app “weather station” is located under “all apps” – “weather station”.
In order to use this weather station, open the global settings (“all apps” –“settings” – “global settings”) and drag the weather station to the first position for wind, rain, outside temperature and daylight (it is also possible to only use the weather station for wind).
Create
To use the evonHOME weather station, follow the following steps:
Mounting
Mount the weather station following the documentation (follow the instructions concerning the direction and distances carefully)
Connecting
Connect the evonHOME weather station 2-wire bus cable to the evonHOME CPU iX800 – ensure the polarity is correct (A-B) (recommended cable J-Y(ST)Y 2 x 2 x 0,8).
Power supply
Supply the evonHOME weather station with power (see documentation).
Add
Add a new weather station. If you have done everything correctly, a connection is established and your weather data are updated every second.
Note: Only one weather station can be operated by the CPU iX800.
Configuration
Wind alarm settings
The wind alarm settings let you define a wind speed above which an alarm is triggered. You can also define hysteresis so that the wind alarm does not trigger and end continuously should the wind speed oscillate around the alarm value. If you want that the wind alarm is active only after a certain time, then you need to enter a delay. This means that this time must be longer than the time set for “wind speed alarm”, so that a wind alarm is triggered.
Dawn/dusk settings
These settings let you define the light levels when dusk/dawn is active and inactive. Hysteresis and delay have the same functions as described previously.
Operation
In the Operatorpanel of the Weather Station, you will find several statistics and charts, which provide you with an insight on the measured values.
Window
The app “windows” lets you operate and configure all windows in your system. You also have pre-defined central functions such as “open all windows” and “close all windows”.
The windows app is located under “all apps”.
Window Settings
You can configure general settings for all windows in the window settings area located under “all apps” – “settings”.
Notifications of open windows and rain/wind
If you wish to receive a notification if a window is open and it is raining or is windy, then you must activate this option.
The item “open windows” shows you a list of all open windows. The button “update” reloads the list of all open windows.
Types Of Window
You have the possibility of integrating two types of window into your system, by window contacts or electric windows.
If you have simply just one window contact connected to a digital input, then you must create a “window contact”. However, if you have an electric window that you wish to integrate into your system, then you must create an “electric window”. Electrical windows are connected to blind modules, since they work according to the same principle.
Window Contact
Create
To create a window contact, open the window app under “all apps” and select “create window contact”. This opens the operator panel and the newly created window contact. It is important to first give the contact a name and optionally the location of the window.
Configuration
Select the digital input the window contact is connected to in the item “digital input”.
The object panel for this window contact will display whether this window is open or closed. If “open” and “closed” are reversed, i.e. the object panel shows a window to be open although it is actually closed, then activate the option “invert” in the operator panel.
You can de-activate notifications for wind and rain in the tem “notifications”.
Using With A Scene
A scene lets you react to the opening and closing of a window by selecting the triggers “has been opened” or “has been closed” in the “IF…” statement and then selecting what should happen in the “THEN ..” statement.
Electric Window
Create
To create an electric window, open the app “shading” and select the blind the window is connected to. Navigate to the parameter panel and select the “type” “window”.
Operation
You can operate an electric window either via the object panel using the arrows on the left-hand side or via the operator panel using the buttons and the slider.
Adjust Opening Times
If you know exactly how long your window takes to open and close, then enter the times directly into the fields “closing time” and “opening time”, then click on the button “use values and run reference”.
If you do not know the times, simply use the wizard to determine the opening and closing times. Follow the wizard’s instructions and the times will be automatically entered and a reference activity carried out.
Configuration
Type
If you want to convert this electric window back into a blind, then you can easily do this by selecting the type “blind”.
Except from universal scene
A universal scene “open all windows”, for example, would open all windows. However, if you wish a window to be excepted from this universal scene, then activate this option.
Lock window
This option lets you lock a window, i.e. the position cannot be changed, neither via the visualization nor via a button.
Deactivate notifications
If you do not wish to receive notifications for this window, then activate this option.
Reserve (hide in visualization)
“Reserve” lets you hide unused channels. You can unhide them via the app “hardware” and the corresponding module.
Couple With
If you want two windows to always have the same position, this can be done by coupling them. Simply select the button “select” in the item “couple with” and choose the window you wish to couple this window with.
Using With A Scene
A scene lets you react to the opening and closing of a window in that you select “has been opened” or “has been closed” in the “IF” statement and then select what should happen as a consequence in the “THEN …” statement.
You can also select the actions “go to position” (go to a window position you have defined), “open” and “close” in the “THEN” statement of a scene.