This page is a
translated version of the page
KNX Device and the translation is 100% complete.
KNX Device
KNX module - KNX interface via which connection to KNX bus is made.
KNX devices inside Module are device in the bus that KNX Home Server interactes with by means of group addresses. In the KNX Module are available:
Adding devices
KNX Module must be added if you skipped this step in the wizard or if you want to set connection with several KNX interfaces.
To create KNX Module, select a method to connect to the bus in the list (KNX IP Interface or KNX TP Interface) fill in connection settings, if you connect cia IP-interface and press Done.
Оnly two KNX IP interfaces and one KNX TP1 interface can be added in the project. Use the i3 pro app to add more interfaces to the project (if required).
Add a required number of devices by pressing Add device button in the module menu or by pressing + > KNX device.
In the device tree it is possible to move sub-devices on one line (D&D method), the KNX interface itself is not moved. It is not possible to move the devices beyond the KNX interface!
Import of Devices from ETS
Import a project file from ETS, to set group addressed in the project fast.
If an ETS project has a password, a widow to enter the password appears during import:
There is a set of filters for more convenient navigation in the list of devices. Devices can be sorted by address, name and type. There is also a search line.
When devices are imported from EST, the foloowing error can occure: when the app is restarted and the status of feedback channels are requested, commands are also done. It can be connected with:
- the communication object of a button an/or a control object of a relaу has an R flag;
- the communication object of a relaу has a U flag.
It is COMPULSORY to delete the U flag from the control object of a relay, it makes the relay turn on when a button sends its state to the bus.
It is also necessary to delete the R flag from buttons and control relay channel and leave it only with status relay channels (1 group address is always used to write and the other to read). The server requests only those group addreses that are connected with objects that have the R flag.
To solve the problem, it is enough to delete one flag of this group address (for example, U).
Import / export of KNX devices
iRidi device xml is a file that is created when a device is exported from the i3KNX app and saved in .irdxml. format. It allows you to save the current KNX device settings (device/sub-device name, connection parameters, widget icon and its color, description, placement, inscription and view of the selected widget) and add them to any available to you project.
Click the Export data to file button and save the exported file for exporting devices
The Import / Export button is only displayed on Windows.
If the devices are not set up, an empty line will be saved to the file.
To import the saved devices into the project press + and choose KNX interface from file. After that the conductor will open where you need to choose the previously saved file.
The entire line with the previously set up devices will be added to the project.
If an IP line has already been added to the project, a new one will be added additionally.
Only one TP line and no more than two IP lines can be added to a project. If you try to import a line that is more than the allowed number of lines into the project - the error "The maximum number of KNX IP(TP) interfaces added to the project" will be displayed on the screen.
Timers for devices
Each KNX device has an additional parameter - Timer. A timer allows to control actions of a device according to a weekly schedule. An action is repeated at a set time of a set day every week. If a day of the week is not chosen, the device activates an action only one time in the nearest set time. Several timers can be added to a device. The choice of actions is determined by the device for which a timer is set. A device with a set timer is displayed in the interface with a clock icon.
A timer can be set:
1 In the configurator
2 By holding the widget icon
3 In the room editor
Setting Devices
When adding KNX devices to the project, a page for configuring the settings of these devices is displayed on the screen.
Some settings are main (address, subtype of device), some are additional (individual) settings (see below).
You can copy seettings of one devices and apply them to another device of the same type (for example, you can copy settings of Relay 1 and paste these data to Relay 2).
You can copy settings with a group address and without it:
Dimmer
Dimmer - a widget to control a lighting dimmer. It can use from 1 to 3 group addresses (1 bit, 1 byte, 4 bits).
Widgets in a user interface:
Types of dimmers (when the type is changes, the widget icon ia changed automatically):
Ways to control:
- Switch;
- Absolute Dimmer;
- Relative Dimmer.
A dimmer has additional setting parameters:
- Switch - turning on/off a dimmer (1 bit address);
- Absolute dimmer - an absolute dimmer (1 byte address);
- Range (%) - a dimming range (by default it is from 0 to 100%, see more about a dimmer range in ETS);
- Step - a dimming step (it is used on "+" and "-" buttons of a widget);
- Relative dimmer - a relative dimmer (4 bit address);
- Step - a dimming step (it is used on "+" and "-" buttons of a widget, by default it is 12,5%);
- Color temperature - temperature of light;
- Range (K) - a range of changes of light temperature (by default it is from 2700 to 7700K);
- Step - a step to change the light temperature (t is used on "+" and "-" buttons of a widget);
- Dimming speed - the speed of dimming;
- From 0 to 100% (sec) - time a dimmer will take to gor from one state to the other smoothly.
Button
Button - a universal widget to send a set number to a group address. A number is sent to the address each time a button of the widget is pressed.
Additional settings:
- Event type - defines what event makes a widget button write a value in the group address (write address):
- Press / Release (Long press and release) - the first value is written the moment a button is pressed and the second value is written the moment a button is released by a user;
- Press (Long press) - the only value is written in the group address the moment a button is pressed;
- Release (Release after long press) - the only value is written in the group address the moment a button is released.
- Values - setting a value that a button will send.
To activate the Long press event, hold the widget button for several seconds. After the button is released, the Release after long press event is activated.
Relay
Relay - a universal widget to switch a group address between two values, for example 0 and 1 for a relay (1 bit). An address switches between 2 values each time a trigger is pressed: trigger state displays the current state of a group address.
Types of relays:
- Through Relay;
- Light;
- Fan Control.
Additional settings:
- Switch - turning on/off a relay, to set it press a corresponding button:
- On/Off Value - allows to set values, corresponding to “turned off” и “turned on” states of a relay. You can control in such a way not only bit but also information variable, for example, to switch values between 0 and 100.
Button Block
Button Block - a universal widget that contains several buttons (from 2 to 4) that can be set. Buttons without set group addresses are not displayed on the widget.
Widgets in a user interface:
Set group addresses manually or with the help of ETS project.
Additional settings:
- Value - values:
- Sending value - a value that is sent when the button is pressed;
- Activating value - is a value is received, the button changes its color;
- Button text - change the button name on the widget.
Shutters
Shutters - a widget to control blinds, shutters roller blinds.
A widget in a user interface:
Additional settings for Shutters:
- OPEN/UP BUTTON - a button to open blinds, shuters;
- Short press - an action by a short press;
- Long press - an action by holding a button;
- CLOSE/DOWN BUTTON - a setting to close blinds, shutters;
- Short press - an action by a short press;
- Long press - an action by holding a button;
- "Opened/Closed" status - the status of blinds, shutters: "open/closed";
- "Moving" status - the status of blinds, shutters: “in motion”;
- Position - the position of blinds, shutters from 0 to 100%;
- State - a setting of the max and min value;
- Plate angle - display and control of the slat angle of blinds;
- State - a setting of the max and min value;
- STOP - a setting to strop roller blinds during opening / closing;
- Short press - an action by a short press;
- Long press - an action by holding a button.
Set group addressed to corresponding operations manually or with the help of data from ETS project.
To change values that are sent when control buttons of shutters/blinds are pressed enter Value tab (a value can be set separately for each operation: short press, long press, status)
A range of values to display Position and Plate angle can be set in State (by default is it from 0 to 100).
If values of your equipment are inverted to default values for opening and closing on the widget, use the Invert position setting. Then the value of the Blind position is inverted, it's also necessary ot change the value of the "Opened/Closed" status parameter according to the inverted values.
Set addresses and values for operations that are supported by a controlled device. Unused operations can be skipped (for example, Plate angle), in this case unused control items for them are not displayed on a widget.
Digital Display
Digital Display - widget to display any integer, fractional or negative numerical value (up to eight digits in length) in the interface. For example, a value from a temperature or humidity sensor with a capability to indicate measure units.
Type - selection of the type of display. When the type is changed, the icon of the widget is changed automatically.
To go to settings, press Display Value. Enter a group address which value must be displayed on a widget manually or by selecting data from ETS project.
Additional settings:
- Number of decimal places - the parameter allow to set the number of displayed decimal places;
- Measure units - it allows to any text after a value.
Binary Display
Binary Display - a widget to display the state of a binary sensor in the interface. For example, a leakage sensor or a door sensor.
Type - selection of the type of display. When the type is changed, the icon of the widget is changed automatically.
Enter a group address which value must be displayed on a widget manually or by selecting data from ETS project.
Additional settings:
- On Value - it allows to set a value that corresponds to the “turned on” state of a sensor.
- Text settings - allows to set the color and text of sensor states (On / Off).
Input Number
Input number - a universal widget with the help of which numeric value of a group address can be sent and displayed.
Additional settings:
- Number of decimal places - the parameter allow to set the number of displayed decimal places.
- Measure units a value must be entered in the corresponding window.
Climate
Climate - a widget for a simple thermostat. It allows to control the value of set temperature, display the current temperature value from a sensor, as well as, heating and cooling modes.
You can choose the device type (conditioner, warm floor) to work with Yandex.Alice in the Type field.
Widgets in a user interface:
Additional settings:
Current temperature - current value of the temperature. It is available for reading only. Set up the address manually or with the help of ETS project.
Set temperature - temperature setpoint. Set group addresses and types for read and write channels manually or with the help of ETS project.
- State - a range to conrtol the set temperature. By default it is from 18 to 36 degrees Celsius. To change the range, set Min and Max values;
- Step - setpoint step (0,5; 1).
Current shift value - current shift of set temperature. It is available for reading and writing. Set the address manually or with the help of ETS project.
- Shift - the shift step of the set temperature (1; 2).
Switch – turning on/off a thermostat. Set group addresses and types of channels to read and write manually or with the help of EST project.
- On / Off value - it sets values to turn on / off a thermostat.
If you set the group address to read only, the device state (ON / OFF) will be displayed instead of the trigger:
Cooling status - status of cooling mode, non-obligatory parameter. It is available for reading only. Set up the address manually or with the help of ETS project.
- On value - it activates the cooling mode
Heating status - the status of a heating mode, the parameter is not compulsory. It's available for reading. Set a group address manually or with the help of ETS project.
- On value - it activates the heating mode.
Mode values - values of preset thermostat modes. It's available for reading and writing. Set the address manually or with the help of ETS project.
- Mode values - mode value setting. By default:
- Comfort Mode - 1;
- Away Mode - 2;
- Eco Mode - 3;
- Protect Mode - 4.
- Names of modes - by default they are as follows:
- Text on Comfort mode button - Comfort;
- Text on Away mode button - Away;
- Text on Eco mode button - Eco;
- Text on Protect mode button - Protect.
Set addresses and values for operations that are supported by a controlled device. Unused operations can be skipped (for example, do not fill in Mode values addresses), in this case unused control items for them are not displayed on a widget.
Color Picker
Color picker - a widget to control RGB or RGBA light with the help of 3 (or 4) separate dimmable channels.
Widgets in a user interface:
Additional settings:
- Switch - turning on/off RGB(A) dimmer with 1-bit address;
- Red - red channel;
- Green - green channel;
- Blue - blue channel;
- White - brightness channel, optional.
Media Remote
Media remote - a remote that can be freely set to control multimedia devices with the help of IR-emitter in KNX system or vis KNX universal gateway.
Set only required buttons.
A list of buttons available for setting:
1 Play - start playing;
2 Volume - control of volume;
3 Mute - decrease the sound to 0, a second press returns the volume to the previous value;
4 Previous track - the previous track;
5 Next track - the next track;
6 Previous Playlist - the previous playlist;
7 Next Playlist - the next playlist;
8 Shuffle - to shuffle;
9 Track - the name of a track;
10 Album - the name of an album;
11 Playlist - the name of a playlist.
For a button to appear in the widget, group addresses must be written in its settings manually of with the help of data from ETS
Time and date sender
Time and date sender is a universal tool to send the current data and time to the entered KNX address in a set period of time (min.).
Additional settings:
- Period - a period of time (min.), in which the current date and time will be sent to the set KNX address by the app.
Fan
Fan is a widget to control a fan. It allows to control the speed, to choose and a mode of fan work and display it.
Widgets in a user interface:
Additional settings:
- Auto / Manual mode - switching the mode of fan work:
- Auto mode - an automatc mode,
- Manual mode - a manual mode.
- Stop - a mode of fan stop:
- Sending value - a value of the stop mode of the fan that is sent to the bus when a button is pressed,
- Activating value - changing the state of the button to active when this value is received from the bus.
The speed of the fan work via KNX but is very often controlled with the help of several separate addresses, 1bit each, and the status comes to the common 1 byte address. Sending value and Activating value parameters allow to send and get values of modes and display them on a widget in the project.
- Speed 1 / Speed 2 / Speed 3 - fan speed:
- Sending value - a value of the stop mode of the fan that is sent to the bus when a button is pressed,
- Activating value - when a given value is received from the bus, the button changes its state into an active one.
The speed of the fan work via KNX but is very often controlled with the help of several separate addresses, 1 bit each, and the status comes to the common 1 byte address. Sending value and Activating value parameters allow to send and get values of modes and display them on a widget in the project.
TV Remote
TV remote is a remote that can be freely set to control TV-sets with the help of IR-emitter in KNX system or via KNX universal gateway.
Set only required buttons.
A list of buttons available for setting:
1 Power - turn on/off TV-set;
2 Channel Up - switch to the next channel;
3 Channel Down - switch to the previous channel;
4 Volume Up - increase volume;
5 Volume Down - descrease volume;
6 Mute - mute / unmute;
7 Source - choose the source of the incoming signal;
8 Digit 0 - 9 - switch to a required channel;
9 Channels List - open a list of channels;
10 Menu - open the menu;
11 Exit - exit the menu;
12 Up - forward;
13 Down - back;
14 Left - to the left;
15 Right - to the right;
16 Ok - "Ok";
17 Red / Green / Yellow / Blue - red / green / yellow / blue buttons;
18 FN 1 - 13 - buttons that can be set.
- Button text - the name of a button.
Enter group addresses in the settings manually or using data from ETS project. If a group address is not entered for FN 1 - 13 buttons, they won't be displayed on the widget of the remote.
Start the project, presee Save to server. Open the remote by pressing a corresponding button:
Virtual thermostat
Virtual thermostat is a widget to control climate equipment. It allows to control the set temperature, to display the current temperature value from sensors and to switch modes of the thermostat.
The number of temperature sensors can vary from 1 to 5. To add a new sensor, press Add sensor and enter its settings.
A widget in a user interface.
Modes:
- Comfort - it is set with manual setting if the temperature on the widget.
- Eco - the temperature is set 2 degrees Celsius lower than the temperature set in the comfort mode. For example, if the tempetarure in the comfort more is 22 degrees, the temperature in the eco mode is 20 degrees with an acceptable deviation.
- Away - the temperature is set 4 degrees Celsius lower than the temperature set in the comfort mode. For example, if the tempetarure in the comfort more is 22 degrees, the temperature in the "away" mode is 18 degrees with an acceptable deviation.
- Protect - it displays the min temperature that was set in the thermostat settings. The temperature in the room can't drop lower than the min temperature. When the real temperature reaches the min temperature, "Protect" mode is activated, a red triangle appears on the thermostat, informing about a danger. The thermostat must keep the temperature that is 2 degrees above the min set temperature with +/-1С deviation, to avoid freezing water pipes in the house or apartment.
If an error occurs, a button - red triangle with an exclamation mark appears on the widget of the thermostat. When this button is pressed, you can learn additional information about the mistake.
A list of errors and warnings:
- Error of turning on / off the heater - a virtual thermostat sent a command to turn on/off to a device, but it got no confirmation that the command was done, please, check that the device is on and set.
- Тhermostat - the heater is turned off manually, but routines, timers, and protection from freezing still work.
- Danger of freezing - check the heater, the temperature is lower that the min acceptable temperature.
- No data from a temperature sensor - in case an error occures, in 2 hours an obligatory request is sent to equipment. If data from equipment do not come, an error appears: "No data from a temperature sensor! Danger of freezing!".
Additional settings:
- Sensor 1-5 - a current value of room temperature.
- Heater - a heater (by default it is Switch type) is turned on, if the set temperature is above the real temperature by a value that is more than the set Acceptable deviation. If the temperature setpoint is lower than the current temperature by a value is more than the acceptable deviation, the heater is turned off.
- Heater type - a heater type:
- Water normally open - water normally open,
- Water normally close - water normally close,
- Electric - electric.
- On thermostat disable - a value that needs to be sent to the heater when the thermostat is turned off (by default, 0).
- General properties - general properties of a thermostat.
- Comfort setpoint - settings of the comfort mode.
- Min / Max - limits of a set temperature that are set by a user on a widget.
- Default value - a value by default.
- Protection setpoint - settings of the protection mode.
- Protect mode is on - turn on the protection mode.
- Value - the min value below which the current temperature of the room must not drop, otherwise an error "Danger of freezing" appears on the widget.
- Show button on widget - display of a button to turn on the protection mode on the widget of a virtual thermostat.
- Acceptable deviation - an acceptable deviation of the set temperature from the real temperature.
- Value - the value of the acceptable deviation.
- Names of modes - by default they are as follows:
- Text on Comfort mode button - Comfort;
- Text on Away mode button - Away;
- Text on Eco mode button - Eco;
- Text on Protect mode button - Protect.
Air conditioner
Air conditioner is a widget to control climate equipment. It allows to control the set temperature, to display the current temperature value from sensors and to switch air conditioner modes.
A widget in a user interface:
Air conditioning modes:
- Cool (cooling),
- Heat (heating),
- Auto (auto),
- Dry (drying),
- Fan (venting).
Additional settings:
- Switch - turning on/off the air conditioner.
- Current temperature - current temperature value. Available for reading only.
- Set temperature - temperature setpoint:
- Range (C) - temperature range limitation (by default, from 18 to 36).
- Step - temperature step (used on the "+" and "-" buttons of the widget).
- Current shift value - actual setpoint offset. Available for reading and writing:
- Shift - step setpoint offset (0.5; 1).
- Modes - air conditioning modes.
- Mode settings - mode setting:
- Value of Cool / Heet / Auto / Dry / Fan made - mode value.
- Text on button of Cool / Heet / Auto / Dry / Fan mode - text to be displayed on the button.
- Show on widget - display the mode on the widget.
- Speed - airflow speed.
- Speed settings - airflow speed setting:
- Value of Stop / Low / Medium / High / Turbo mode - airflow speed value.
- Text on the button of Stop / Low / Medium / High / Turbo mode - text to be displayed on the button.
