Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Contents Revision history .......................... 4 Using the application program ....................5 General Product information ...................... 5 DALI Bus system properties ....................5 EK-BF1-TP-D1/D2 product overview..................6 EK-BF1-TP-D1/D2 product features ..................6 Improvements to the previous firmware 0.2.x ............... 8 3.4.1...
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Using the application program The application description is valid for firmware version 0.3.0 and higher. Product family: Lighting Product type: Gateway Manufacturer: Ekinex S.p.A. 1 Channel Device: Name: EK-BF1-TP-D1_V1.0.0 Order no.: EK-BF1-TP-D1 DALI2 1CH...
EK-BF1-TP-D1/D2 product features The Ekinex KNX/DALI gateway EK-BF1-TP-D1/D2 is a device used to control ECGs with a DALI interface via the KNX installation bus. The device transforms switch and dim commands from the connected KNX system into DALI telegrams and status information from the DALI bus into KNX telegrams.
Page 7
DALI-2 certified and listed in the corresponding database of DiiA. The device comes in a 4 units wide DIN Rail casing so it can be directly integrated into the mains distribution box. In addition to the pure gateway function, the EK-BF1-TP-D1/D2 offers numerous additional features: ...
App) for the ETS5. Please remember to install the corresponding ETS App in addition to the product database KNXprod. The ETS App is available for download on the Ekinex website or from KNX website. Improvements to the previous firmware 0.2.x Firmware 0.3.0 also introduces a new ETS application and a new DCA.
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Installation and Concept of Commissioning The Commissioning is separated in following steps: Overview After the wiring of the DALI segment according to the operating and installation instructions document, software start-up can begin.
KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App ETS-App (DCA) The application for the EK-BF1-TP-D1/D2 is based on the standard interface for the configuration of communication objects and parameters as well as a special interface for configuring the DALI bus system. This special interface is designed as a DCA (Device Control App) for the ETS5. All required program data are automatically created when the App is imported.
This work can be carried out offline without connection to the KNX, or without connection to the EK-BF1-TP-D1/D2. The actual DALI commissioning is only possible online, that means a connection to the device is necessary. In this step, all connected ECGs are searched and found and can then be assigned to the preconfigured configuration.
KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Devices for colour control (DT-8) The EK-BF1-TP-D1/D2 also supports ECGs for colour control (device type 8 according to EN 62386-209). Such devices allow for multi-channel colour control (RGB) and thereby enable the mixing of a light colour or the setting of a colour temperature via DALI.
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App In devices that support the XY coordinates method, the colour is set via two values between 0.0 and 1.0. However, because of the physical properties of an LED, even in an RGB LED module not every colour is practically possible.
Manual mode 1 Channel Device (EK-BF1-TP-D1) The EK-BF1-TP-D1 has 9 operating buttons and LEDs on the front side, which offer numerous possibilities for manual control and broadcast and analysis functions. The buttons and LEDs are accessible without having to remove the cover. During KNX bus operation and in the absence of any errors, all 9 LEDs are switched off.
Page 17
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Manual mode level 1 LED on Man. button lights up permanently in green Use buttons 1/9 to 8/16 to switch DALI groups 1 to 8. The light value of the group changes from 100% (On) to 0% (Off) each time the button is pressed.
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App 2 Channels Device (EK-BF1-TP-D2) The EK-BF1-TP-D2 has 9 operating buttons and LEDs on the front side, which offer numerous possibilities for manual control and broadcast and analysis functions. The buttons and LEDs are accessible without having to remove the cover. During KNX bus operation and in the absence of any errors, all 9 LEDs are switched off.
Page 19
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Manual mode level 1 (channel 1) LED on Man. button lights up permanently in green Use buttons 1/9 to 8/16 to switch DALI groups 1 to 8. The light value of the group changes from 100% (On) to 0% (Off) each time the button is pressed.
Page 20
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Manual mode level 5 (channel 2) LED on Man. button flashes blue Use buttons 1/9 to 8/16 to switch DALI groups 9 to 16. The light value of the group changes from 100% (On) to 0% (Off) each time the button is pressed.
The control of each group and individual ECG is based on three communication objects (switching, dimming, value setting). ECGs can only be assigned to one DALI group. The EK-BF1-TP-D1/D2 does not support multi- group assignments on DALI level. If such assignment is required, please use KNX communication objects for this purpose.
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Panic mode (exceptional case) The panic or emergency mode can be activated via a central object for the whole gateway. All ECGs/ groups that have been enabled for panic mode, permanently switch to a programmable panic light value on receipt of the object.
Analysis and service functions Recording operating hours The EK-BF1-TP-D1/D2 allows for the operating hours (life time) of each group to be individually recorded. Internal recording is accurate to the second. The value is available externally in an hourly unit with the internal value in seconds always being rounded. (e.g. 7199 seconds 1 h, 7201 seconds ...
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Fault analysis at device level Error analysis objects similar to those at group level are also available at device level (i.e. for all ECGs connected to the gateway). The error rate or number of faulty ECG in the whole DALI segment can be made available via communication objects.
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App ETS communication objects The EK-BF1-TP-D1/D2 communicates via the KNX bus based on a powerful communication stack. Note for the 2-channel device: All communication objects of the 1st channel are marked with the prefix D1- and those of the 2nd channel with the prefix D2-.
Page 26
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App For time-controlled sequencing, the current date and time are required. These need to be made available via the bus. Two objects are available for this purpose. Object name Function Type Flags Time...
Page 27
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Activates or deactivates the panic mode via the bus. Activate Night Mode Activate/Stop 1 Bit 1.010 Activates or deactivates the night mode via the bus. Scene invoke/ programm Scene No. 8 Bit 18.001...
Page 28
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App a simultaneous light error will no longer be detected or counted. Lamp Failure Exceeds Yes/No 1 Bit Threshold 1.005 This object is used to report that the total of all lamp failures recognised by the gateway exceeds the threshold set via parameters.
Page 29
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Sends the switch status of individual groups in the DALI segment when the system is started or when a change has taken place. Bit 0 - 15 show the status. Bit 16-31 show whether the information is valid.
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Objects for the time control module For each of the up to 16 time program templates in the colour control module communication objects are available for activation/deactivation. Please see chapter /Enabling. These need Disabling to be enabled under time control in the DCA.
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Object name Function Type Flags Energy Saving Object On / Off 1 Bit 1.001 With the appropriate assignment in the parameters, this object is switched off when associated groups or ECGs are switched off. This allows a separate power supply to be switched off. If the associated groups or ECGs are controlled again with a value >...
Page 32
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App The following objects are available (Example group 1): Object name Function Type Flags G1, Switching On/Off 1 Bit 1.001 This object is used to switch group 1 on or off. G1, Dimming...
Page 33
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Object name Function Type Flags This object is used to disable the operation of group 1: Object = 0 Operation enabled Object = 1 Operation disabled G1, Disable Staircase Yes/No 1 Bit 1.003...
Page 34
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Object name Function Type Flags Reports the total number of devices within a group as well as the error status according to type of error. The different Bits within the object have the following meaning:...
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Object name Function Type Flags G1, Life Time Exceeded Yes/No 1 Bit 1.005 This object shows whether the maximum life span set in the parameters has been exceeded. Note: If the treshold has been exceeded, an alarm is issued via this object (by sending “1“). This status is resent for each further hour that is above the threshold.
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Object name Function Type Flags Colour Temperature Value 1 Byte relativ 5.001 Sets the relative colour temperature in the group between 0 and 100%. The value range 0 to 100% is automatically converted into the possible colour temperature range.
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App 232.600 Sends the selected colour of the group as a status. 9.4.1.3 RGB (separate objects) Object name Function Type Flags G1, Colour (RGB) Red Value 1 Byte 5.001 Sets the colour of the group. The values for red (R) are transferred here.
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App 5.001 Use this object to send the set colour blue as status of the group. 9.4.1.4 HSV The colour is set as an HSV value which consists of hue, saturation and value.
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Object name Function Type Flags G1, Colour (HSV) Hue Value 1 Byte 5.003 Sets the colour as an HSV value. The hue values are transferred as values between 0° and 360°. Please note that only a resolution of approx.
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Use this object to set the colour as RGBW within the group. The colour values for red, green, blue and white are entered in the upper Bytes ranging from 0 to 100%. 4 Bits in the lower Byte show whether the respective colour values are valid.
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App G1, Colour (RGB) Fading Brighter/Cooler 4 Bit Green 3.007 See colour change red. G1, Colour (RGB) Fading Brighter/Cooler 4 Bit Blue 3.007 See colour change red. G1, Colour Fading White Brighter/Cooler 4 Bit 3.007...
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App 9.4.1.8 XY (DPT 242.600) Figure 7: XY-colour spectrum (Source: Wikipedia) The colour is identified through an XY value between 0 and 1.This value range is converted into a range from 0 to 65535 (2 Byte floating point) in the KNX. The value 65535 corresponds to value 1 in the diagram.
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App This object is used to set the colour in the group via XY coordinates. In the upper 4 byte the X and Y- coordinates ranging from 0 to 65535 are defined. This is followed by the brightness level ranging from 0 to 100%.
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Object name Function Type Flags G1, Colour Y Status 2 Byte 7.001 Sends the set Y value as status of the group. ECG objects 9.5.1 ECG objects behaviour A communication object is available for each of the up to 64 connected ECGs and corresponding lamps to display the failure status.
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Sends the ECG switch status. Each value >0% is interpreted as ON. ECG 1, Status Value 1 Byte 5.001 Sends the ECG value status. 9.5.2 ECG objects analysis and service Object Object name...
Page 46
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App This object is used to invoke or program scenes. Up to 16 scenes are available on the DALI gateway. To program a selected scene you need to set the top Bit: Start...
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App 10 ETS parameters The ETS parameters of the device are distributed across different parameter pages. To simplify the overview, only the parameter pages of the device selected in the function tree are displayed.
Page 48
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Parameter Settings Failure Status Send Condition Send on Request Send on Change Send on Change and after Busreset Sets the conditions under which the error status objects of the connected ECGs and groups are to be sent.
Page 49
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Configures a threshold value for the general failure alarm object (object 14). The threshold value takes all errors (ECG, lamp and converter errors) into consideration independent of the error type and relates them to the total number of connected ECGs and converters.
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App 10.1.2 Parameter page: Special functions Parameter Settings Broadcast enabled Use this parameter to enable the broadcast function in addition to group control. Please note: When activating the broadcast function, additional objects to control the DALI system can be used.
Page 51
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Selection of Object Type RGB (3 Byte combined Object) RGB (separated Object) HSV (separated Object) Determines which type of colour control is to be used. If RGBW colour is selected: Selection of Object Type RGBW (6 Byte combined Object 251.600)
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App 1000…10000 [3000] Dim To Cold Colour Temperature at Value 0% The colour temperature set via this parameter is automatically adjusted for a light value at the lower limit [0%]. For light values between the lower limit [0%] and the upper limit [100%], the automatically set colour temperature is adjusted interpolated.
Page 53
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Use this parameter to define a group description. To simplify the overview, this description will be displayed for all communication objects. For example: Test group Normal Mode Operation Mode Permanent Mode Normal /Night Mode Staircase Sets the operating mode of the group.
Page 54
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Automatic Switch 1 Minute After (min) 2 Minutes 3 Minutes 4 Minutes 5 Minutes 10 Minutes 15 Minutes 90 Minutes Use this parameter to set the time after which a group in night mode automatically switches off. This parameter is only visible if you select ‘normal / night mode’.
Page 55
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Sets the function of an additional object. If you select “Disable object“, an object appears which disables control of the group when the value is 1. If you select “Release object“, an object appears which enables control of the group when the value is 1.
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Calculation Dimming logarithmic Values linear Sets the dimming curve for the group. 10.2.2 Behaviour Parameter Settings Switch-On Value … 100% Last Value Use this parameter to set the switch-on value. If you select ‘last value‘, the value is set to the dim value prior to the lamps being switched off.
Page 57
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Switch-Off Value … … Sets the switch-off value. Set Value immediately Switch-Off Behaviour Dimm to Value in 3 Seconds Dimm to Value in 6 Seconds Dimm to Value in 10 Seconds Dimm to Value in 20 Seconds...
Page 58
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Time for Dimming 3 Seconds 4 Seconds 5 Seconds 6 Seconds 10 Seconds 20 Seconds 30 Seconds 60 Seconds Sets the dim time for relative dimming in relation to a value range from 0 to 100%.
Page 59
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Additional Set Value Object incl. Dimming Time Use this parameter to select whether the value object should be used with the combined dimming time (DPT 225.001), see object No. 74. Please note: If you select the 3 Byte object (combination of value and dimming time) the dimming time is ignored in the ETS.
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App 10.2.3 Analysis and service Parameter Settings Type of Failure Status Object 1 Bit 1 Byte Determines whether the error object of the group is to be sent as a 1 Bit object without differentiating the type of error status or as an 8 Bit object with error type differentiation.
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App 10.2.4 Colour control Parameter Settings Colour Control Type none Colour Temperature RGB Colour RGBW Colour XY Colour Use this parameter to select the type of colour control you would like to use for the group.
Page 62
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Colour changing Fading Time via Dimming fast (10 Seconds) standard (20 Seconds) slow (40 Seconds) Use this parameter to select how quickly you want to change the colour temperature during dimming. If “RGB colour“ is selected.
Page 63
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Colour changing Fading Time immediately 1 Second 5 Seconds 10 Seconds 20 Seconds 30 Seconds 60 Seconds 90 Seconds Use this parameter to select how quickly you want the colour temperature to change.
Page 64
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Sets the additional white value ranging from 0 to 100%. Behaviour when Switching On Keep last Object Value Use ETS Parameter above Determines whether the last valid colour value or the colour temperature set in the ETS are to be used.
Page 65
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Use this parameter to define the x-colour for switching on. The value range is between 0 and 1. X= 0.33 and Y=0.33 corresponds to the white point. Figure 8: XY-colour spectrum (Source: Wikipedia) 0…1 [0.33]...
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App 10.3 ECG 10.3.1 ECG 1 (2.. 64) Parameter Settings ECG x, Description e.g.: Floor, 1 level With this parameter an ECG description can be defined. This description is displayed as an overview for all communication objects.
Page 67
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App ECG Type Fluorescent Lamp Self Contained Battery Lamp (non switchable) Self Contained Battery Lamp (switchable) Discharge Lamp Low Voltage Lamp Incandescent Lamp 0..10V Converter LED Module Relay Module ECG with Colour Control Use this parameter to set the type of ECG used.
Page 68
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App This parameter allows you to set the value to which the corresponding lamp is permanently set in "Permanent" Mode. In the operating mode 'continuous operation' the lamp cannot be switched or changed, but always lights up in the set value.
Page 69
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Behaviour on Enable No Change Switch to On-Value Switch to OFF-Value This parameter appears when an additional object has been selected to define the behaviour when enabled. Enabled for Panic Mode Determines whether a group should be considered during panic mode. The panic mode is controlled via central object number 9.
Page 70
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Operating hours Limit value (hours) 1 h..200.000 h [4000 h] (Calculation for operating hours). This parameter is used to set the lamp life at which an individual warning is sent. Type of the error object...
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App 10.3.1.1 Behaviour Parameter Settings 1.. 100% [100] Switch-ON Value Last value Use this parameter to set the switch-on value. If you select "Last value", the value is set to the dimming value prior to the lamp being switched off.
Page 72
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Switch-OFF Value … … Use this parameter to set the switch-off value. Set Value Immediately Switch-OFF Behaviour Dimm to Value in 3s Dimm to Value in 6s Dimm to Value in 10s...
Page 73
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Use this parameter to configure the behaviour on receipt of a new dimming value via value setting. Please remember that the dim time always refers to the full value range. Accordingly a dimming time of 30 s means a value change of 100% within 30 s.
Page 74
Application Manual KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App Switch ON via Dimming Switch ON with Dimming Object Switch ON with Value Object Switch ON with Dimming & Value Object Use this parameter to select whether a switched off group should be switched on when receiving a relative 4 Bit dimming object, a value setting object or both.
11 DALI Channel Selection DALI commissioning is carried out individually for each channel. When calling the DCA, channel 1 is preselected. The selection buttons can be used to select between channel 1 and channel 2 (only in case of using a 2-channel device). The following description refers to the commissioning of one channel.
Error type 11: More than one new ECG 12.6 Data Restore of DALI configuration This command is used to completely restore a EK-BF1-TP-D1/D2, for example, by replacing it with a completely unprogrammed device. In this case all DALI relevant data from the ETS are written onto the device. Once this process is complete, the device is restarted automatically.
Once all scene values have been set, you need to download the scene onto the DALI ECGs. For this purpose, please press the download button in the top right-hand corner. A connection to the EK-BF1-TP-D1/D2 is required. In principle, you can also plan individual scenes in the ETS ‘offline‘, independently of the DALI system.
Presence / movement sensor EK-DH4-TP After a scene has been programmed, the button becomes active. Press the button to activate and execute the selected scene. A connection to the EK-BF1-TP-D1/D2 is required for this purpose. 13.6 Export/Import/Delete In order to be able to reuse a scene that has already been created, it is possible to export it. The created XML file can be saved separately to be used again in another project or in another template.
Presence / movement sensor EK-DH4-TP 14 Time Control In order to use the colour setting options of DT-8 devices, EK-BF1-TP-D1/D2 offers an integrated colour control module. With this module, users can automatically set a defined light colour for a certain time or date. This function is particularly interesting for white light control. Changes in colour temperature over the course of a day have a positive effect on well-being and efficiency in the work place.
Test action Immediately executes the chosen action (without regard for any potentially configured transition time) for all selected groups within a template. A connection to the EK-BF1-TP-D1/D2 is required. Test group action Immediately executes the chosen action (without regard for any potentially configured transition time) for a certain group within a template.
Generally, these embedded free software files are distributed in the hope that they will be useful, but WITHOUT ANY WARRANTY, without even implied warranty such as for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE, and without liability for any Ekinex entity other than as explicitely documented in your purchase contract.
Need help?
Do you have a question about the EK-BF1-TP-D1 and is the answer not in the manual?
Questions and answers