Ekinex Ek-bf1-tp-d1 Instructions for use

Application manual

KNX/DALI gateways

EK-BF1-TP-D1/D2

and DCA App

Application Manual

KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App

Rev. 1.1 –06/10/2023 MAEKBF1TPD1D2_EN

Contents

1Revision history.......................................................................................................................... 4

2Using the application program.................................................................................................... 5

3General Product information ...................................................................................................... 5

3.1 DALI Bus system properties.................................................................................................. 5

3.2 EK-BF1-TP-D1/D2 product overview..................................................................................... 6

3.3 EK-BF1-TP-D1/D2 product features...................................................................................... 6

3.4 Improvements to the previous firmware 0.2.x ....................................................................... 8

3.4.1 Single ECG control ........................................................................................................ 8

3.4.2 ECG operating modes (normal, permanent, night and panic mode)............................. 8

3.4.3 Counting the operating hours of the individual ECGs.................................................... 8

3.4.4 Export and import of scenes.......................................................................................... 8

3.4.5 Editing and exporting/importing description texts.......................................................... 8

3.4.6 Manual override in schedules........................................................................................ 9

4Installation and Concept of Commissioning............................................................................. 10

4.1 Overview.............................................................................................................................. 10

4.2 ETS-App (DCA)................................................................................................................... 11

4.3 Parameter Configuration ..................................................................................................... 13

5Devices for colour control (DT-8) ............................................................................................. 14

5.1 DALI device type 8 features ................................................................................................ 14

5.2 Colour display via XY coordinates....................................................................................... 14

5.3 Colour display via colour temperature................................................................................. 15

5.4 Colour display via 3 or 4 colour channels (RGBWAF) ........................................................ 15

6Manual mode............................................................................................................................ 16

6.1 1 Channel Device (EK-BF1-TP-D1)..................................................................................... 16

6.2 2 Channels Device (EK-BF1-TP-D2)................................................................................... 18

7Operating modes...................................................................................................................... 21

7.1 Normal mode....................................................................................................................... 21

7.2 Permanent mode................................................................................................................. 21

7.3 Staircase mode.................................................................................................................... 21

7.4 Night mode .......................................................................................................................... 21

7.5 Panic mode (exceptional case) ........................................................................................... 22

7.6 Operating mode hierarchy................................................................................................... 22

8Analysis and service functions ................................................................................................. 23

8.1 Recording operating hours .................................................................................................. 23

8.2 Individual fault recognition at ECG level.............................................................................. 23

8.3 Fault analysis at group level................................................................................................ 23

8.4 Fault analysis at device level............................................................................................... 24

9ETS communication objects..................................................................................................... 25

9.1 General objects.................................................................................................................... 25

9.2 Objects for the time control module..................................................................................... 30

9.3 Objects for Energy Saving................................................................................................... 30

9.4 Group objects ...................................................................................................................... 31

Application Manual

KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App

Rev. 1.1 –06/10/2023 MAEKBF1TPD1D2_EN

9.4.1 Objects for colour control............................................................................................. 35

9.4.1.1 Colour temperature 35

9.4.1.2 RGB (DPT 232.600) 36

9.4.1.3 RGB (separate objects) 37

9.4.1.4 HSV 38

9.4.1.5 RGBW (DPT 251.600) 39

9.4.1.6 RGBW (separate objects) 40

9.4.1.7 HSVW (separate objects) 41

9.4.1.8 XY (DPT 242.600) 42

9.4.1.9 XY (separate objects) 43

9.5 ECG objects......................................................................................................................... 44

9.5.1 ECG objects behaviour................................................................................................ 44

9.5.2 ECG objects analysis and service ............................................................................... 45

9.6 Objects for scene control..................................................................................................... 45

10 ETS parameters ....................................................................................................................... 47

10.1 General................................................................................................................................ 47

10.1.1 Parameter page: Analysis and service ........................................................................ 47

10.1.2 Parameter page: Special functions.............................................................................. 50

10.2 Group................................................................................................................................... 52

10.2.1 General ........................................................................................................................ 52

10.2.2 Behaviour..................................................................................................................... 56

10.2.3 Analysis and service.................................................................................................... 60

10.2.4 Colour control............................................................................................................... 61

10.3 ECG..................................................................................................................................... 66

10.3.1 ECG 1 (2.. 64).............................................................................................................. 66

10.3.1.1 Behaviour 71

11 DALI Channel Selection ........................................................................................................... 75

12 DALI commissioning................................................................................................................. 75

12.1 ECG info and errors............................................................................................................. 80

12.2 ECG and group detail info ................................................................................................... 82

12.2.1 ECG info in the right-hand side tree ............................................................................ 83

12.2.2 ECG info in the ECG table........................................................................................... 83

12.2.3 Group info in the group tree......................................................................................... 83

12.3 Operating DALI devices....................................................................................................... 84

12.4 Post Installation ................................................................................................................... 86

12.5 ECG Easy Replacement...................................................................................................... 87

12.6 Data Restore of DALI configuration..................................................................................... 87

13 Scenes...................................................................................................................................... 88

13.1 Configuration ....................................................................................................................... 88

13.2 Colour entries ...................................................................................................................... 90

13.3 Programming scenes........................................................................................................... 91

13.4 Testing a scene event ......................................................................................................... 91

Application Manual

KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App

Rev. 1.1 –06/10/2023 MAEKBF1TPD1D2_EN

13.5 Testing the whole scene...................................................................................................... 91

13.6 Export/Import/Delete............................................................................................................ 92

14 Time Control............................................................................................................................. 93

14.1 Configuration ....................................................................................................................... 93

14.2 Action types......................................................................................................................... 95

14.3 Disabling/Enabling............................................................................................................... 98

14.4 Manual Override.................................................................................................................. 99

14.5 Timer.................................................................................................................................... 99

14.6 Export/Import..................................................................................................................... 100

15 Extras...................................................................................................................................... 101

15.1 Menu: Edit Descriptions..................................................................................................... 101

16 DCA OSS ............................................................................................................................... 103

17 Markings................................................................................................................................. 104

18 Maintenance........................................................................................................................... 104

19 Disposal.................................................................................................................................. 104

20 General warnings ................................................................................................................... 104

21 Other information.................................................................................................................... 105

1 Revision history

Revision

Changes

Date

Written by

Verified by

1.0

First issue

06/05/2023

G. Schiochet

C. Baldini

1.1

Added instructions in case the ETS App installation fails

(par. 4.2).

06/10/2023

G. Schiochet

C. Baldini

Application Manual

KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App

Rev. 1.1 –06/10/2023 MAEKBF1TPD1D2_EN

2 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

Number of objects: 1279

Number of group addresses: 1279

Number of associations: 1279

2 Channels Device:

Name: EK-BF1-TP-D2_V1.0.0

Order no.: EK-BF1-TP-D2 DALI2 2CH

Number of objects: 2316

Number of group addresses: 2316

Number of associations: 2316

3 General Product information

3.1 DALI Bus system properties

The cross-functional DALI-Bus (DALI = Digital Addressable Lighting Interface) is a system used to

control electronic ballasts (ECGs) in lighting technology. The specifications of the DALI

communications interface are set in the international norm EN62386.

The DALI Bus enables the receipt of switch and dim commands. In addition, the DALI can be used

for status information about light values or the notification of a fault such as a light or ECG failure.

Via the connected control device / gateway (Master), up to 64 individual DALI ECGs (Slaves) can

be connected in a DALI segment. When the DALI is commissioned, the ECGs receive an

automatically generated 3 Byte long address. Based on the long address a short address between

0 and 63 is assigned during the further commissioning process. As the address assignment is

automatic, the device order is random. The individual ECGs/lights therefore need to be identified

during the further commissioning process (see below).

Application Manual

KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App

Rev. 1.1 –06/10/2023 MAEKBF1TPD1D2_EN

The addressing of individual ECGs in the system is either based upon the short address (individual

addressing) or upon a DALI group address (group addressing). For this purpose, any number of

ECGs within a segment can be assigned to up to 16 groups. The group addressing in the DALI

system guarantees that switch and dim processes of different lights within a system are performed

simultaneously without time delays.

In addition to short and group addresses, the light values of individual DALI ECGs can also be

merged into scenes and addressed via scene addresses.

For a detailed description of the DALI system, please see the DALI handbook at

https://www.digitalilluminationinterface.org

3.2 EK-BF1-TP-D1/D2 product overview

The EK-BF1-TP-D1/D2 is delivered in 2 product variants:

Feature

Description

Order No.

1 Channel

EK-BF1-TP-D1

EK-BF1-TP-D1 DALI2 1CH

2 Channels

EK-BF1-TP-D2

EK-BF1-TP-D2 DALI2 2CH

The application of the second DALI channel is an identical copy of the first channel.

All functions, objects and parameters are available twice.

Both DALI segments are commissioned separately.

Therefore, both DALI segments are configured independently of each other.

The following documentation describes the configuration and commissioning of one DALI channel

as an example.

3.3 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.

The EK-BF1-TP-D1/D2 is a Single Master Application Controller (in accordance with EN 62386-

103). This means the device must only be used in DALI segments with connected ECGs and not

with other DALI control devices within the segment (no multi-master function). Power supply for the

up to 64, resp. 128 connected ECGs comes directly from the EK-BF1-TP-D1/D2. An additional

DALI power supply is not required and not permitted. . Supported are ECGs according to EN

Application Manual

KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App

Rev. 1.1 –06/10/2023 MAEKBF1TPD1D2_EN

62386-102 ed1 (DALI1) as well as devices according to EN 62386-102 ed2 (DALI2). The device is

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:

Addressing of 16, resp. 32 DALI groups or 64, resp. 128 Single ECGs

Flexible DALI commissioning concept in the ETS5

Coloured light control with the help of device type 8 ECGs (DT-8)

Coloured light control depending on ECG sub-type:

oColour temperature (DT-8 Sub-Type Tc)

oXY colour (DT-8 Sub-Type XY)

oRGB (DT-8 Sub-Type RGBWAF)

oHSV (DT-8 Sub-Type RGBWAF)

oRGBW (DT-8 Sub-Type RGBWAF)

The DT-8 sub-type PrimaryN is not supported.

Support of time scheduling programmes to control groups and ECGs according to values

and/or colour

Different operating modes such as permanent mode, night-time mode or staircase mode

Integrated operating hours counter for each group and ECG with an alarm for when the

maximum life-span has been reached

Individual fault recognition with objects for each light/ECG

Application Manual

KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App

Rev. 1.1 –06/10/2023 MAEKBF1TPD1D2_EN

Complex fault analysis at group/device level with number of faults and fault rate calculation

Fault threshold monitoring with individually configurable threshold values

Scene module for extensive scene programming and possibility of dimming scenes,

“Quick exchange function“ for easy replacement of individual faulty ECGs,

Manual control of group and broadcast telegrams via control buttons on the device,

Indication of a fault status via LEDs on the device.

The special interface for the configuration of DALI segments is designed as a DCA (Device Control

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.

3.4 Improvements to the previous firmware 0.2.x

Firmware 0.3.0 also introduces a new ETS application and a new DCA.

3.4.1 Single ECG control

Special attention is now given to the possibility of single ECG control.

Single ECGs can be addressed in scenes, in schedules or via KNX communication objects.

3.4.2 ECG operating modes (normal, permanent, night and panic mode)

The individual ECGs can be used in different operating modes, just like the groups.

3.4.3 Counting the operating hours of the individual ECGs

This function counts the switch-on times of groups and/or ECGs. The counter reading can be used

as threshold value for an alarm notification, for example when the service life has been reached.

3.4.4 Export and import of scenes

In order to be able to use configured scenes easily in other projects, the possibility of importing and

exporting has been implemented.

3.4.5 Editing and exporting/importing description texts

All description texts of the groups or the single ECGs can be edited now additionally centrally.

There, the texts can also be easily imported or exported from other file formats.

Application Manual

KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App

Rev. 1.1 –06/10/2023 MAEKBF1TPD1D2_EN

3.4.6 Manual override in schedules

An automatic schedule can be manually overridden for certain requirements. More information can

be found in chapter 14.4 Manual Override.

Application Manual

KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App

Rev. 1.1 –06/10/2023 MAEKBF1TPD1D2_EN

4 Installation and Concept of Commissioning

The Commissioning is separated in following steps:

4.1 Overview

After the wiring of the DALI segment according to the operating and installation instructions

document, software start-up can begin.

To do this, the product database is loaded and the corresponding ETS App installed in the ETS5,

see Chapter: 4.2 ETS-App (DCA).

Application Manual

KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App

Rev. 1.1 –06/10/2023 MAEKBF1TPD1D2_EN

4.2 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.

The ETS App can be downloaded from KNX website, following the instructions at

https://support.knx.org/hc/en-us/articles/115001353070-Installing-ETS5-Apps

Therefore click on Button “App“ in the footer of ETS5 and then the “plus“ sign in order to add an

ETS App to your ETS5 system:

A file box will become visible to select the ETS App for the EK-BF1-TP-D1/D2:

The App is displayed in the list of all ETS5 Apps:

When the product is selected an additional DCA tab is shown:

Then the ETS must be started again.

Note: if during the installation the following error is displayed

Application Manual

KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App

Rev. 1.1 –06/10/2023 MAEKBF1TPD1D2_EN

then follow the instructions at the link: https://support.knx.org/hc/en-us/articles/360019187920-

How-to-force-an-ETS-App-uninstall

Application Manual

KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App

Rev. 1.1 –06/10/2023 MAEKBF1TPD1D2_EN

4.3 Parameter Configuration

The parameters and the corresponding group addresses can then be configured as with any other

KNX product. With the help of the parameters, various operating modes can also be configured,

which are described in more detail in the chapter: 6 Manual mode.

The DALI specific configuration is performed in the DCA tab. First, the assigment of the ECGs to

the desired groups should be carried out.

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.

After this assignment has been carried out, this special DALI configuration must be loaded into the

device. The "Download" key is available in the DCA tab, see Chapter: 12 DALI commissioning.

In the last step, the parameters and the links to the group addresses should be loaded into the

device using normal ETS download. The device is now ready for operation.

Application Manual

KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App

Rev. 1.1 –06/10/2023 MAEKBF1TPD1D2_EN

5 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.

5.1 DALI device type 8 features

ECGs for colour control (DT-8) are offered by a range of manufacturers. Usually these devices

allow for the direct control of LED modules with multi-colour LEDs. The most common ones are

modules with LEDs in the three colours red, green, blue (RGB), as well as modules with two

different white tones (Tunable White). Occasionally LED modules with a further integrated white

channel (RGBW) are offered on the market. Whilst it is, of course, possible to control the different

colour channels individually, each via a separate DALI control device for LEDs (Device Type-6),

this solution has the disadvantage, that each of these devices is assigned a separate DALI short

address. This means that two (tunable white), three (RGB) or even four short addresses are

required to control a module. With a maximum number of 64 available short addresses per DALI

segment, the number of lights that can be used is greatly reduced. With a DT-8 device, however,

only one short address is required for all colour channels and the maximum possible range of 64

lights can be controlled. The DALI standard EN 62386-209 defines different colour control methods

for DT-8 devices. Normally, a certain device supports only one of these possible methods.

Therefore please pay attention to the specifications of the respective manufacturer.

5.2 Colour display via XY coordinates

The display of a colour via two nominated coordinates in a so-called colour space is a common

method. By means of the XY coordinates any point in this space is accessible and as a result any

colour can be defined. The diagram used in the DALI standard is the colour space chromaticity

diagram according to the 1931 CIE standard. (Cambridge University Press) which is shown in the

following graphic.

Figure 1: Colour space chromaticity diagram according to CIE 1931 (Source: Wikipedia)

Application Manual

KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App

Rev. 1.1 –06/10/2023 MAEKBF1TPD1D2_EN

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. In practice, it iscommon toset the valuewhich is closest. Please

pay attention to the instructions of the ECG or light manufacturer. Usually the XY values, which are

supported by the lamp, are specified here. Values outside of the specified range can generate non-

reproducible colours.

5.3 Colour display via colour temperature

A subset of all possible colours in the colour space are the different white tones. The white tones

are found on one line across the whole colour space.

Figure 2: White tone on Black-Body-Line (Source: Wikipedia)

The points on this so-called black-body-line (BBL) are usually defined via a colour temperature in

Kelvin. This makes it possible to exactly determine the white tone of a light between warm and cool

with just one value. The colour temperature principle is therefore perfect for the control of white

light fixtures (tunable white). DT-8 operating devices set the required colour temperature on an LED

module by mixing cool and warm white LEDs. Of course, as before this is only possible within

certain physical limits. With today’s LED modules colour temperatures between 2000 and 8000

Kelvin are common.

5.4 Colour display via 3 or 4 colour channels (RGBWAF)

Principally, a colour is created by mixing different individual colours (different white tones, RGB or

RGBW). A colour can therefore also be displayed based on the mixing ratio of different single

colours, e.g. 50% red, 0% green, 60% blue. The colour definition in this case is not exact but

depends greatly on the specific, physical attributes of the LEDs used to create the colour (wave

length, intensity). Nonetheless, the indication of the primary colour percentages within a system is

useful for the relative description of a colour. In some DT-8 ballasts, the colour is set by stating 3

(RGB) or 4 values (RGBW) between 0 and 100%. Accoring to DALI standard EN 62386-209, up to

six colours (RGBWAF) can theoretically be drawn upon.

Application Manual

KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App

Rev. 1.1 –06/10/2023 MAEKBF1TPD1D2_EN

6 Manual mode

6.1 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. If the gateway detects an

error (e.g. a faulty lamp or KNXfailure), only the LED on the Man. button lights up inred and flashes

quickly. During programming (e.g. during installation) all LEDs light up in red and flash slowly.

Activate the manual mode with a long keypress on the button in the bottom right-hand corner.

The manual mode ends automatically 60 seconds after the last time the button has been activated.

If manual mode is active, shortly press the same button again to toggle between the different

manual mode levels. The RGB LED on the Man. button shows which level you are currently on.

The individual levels have the following meaning:

Application Manual

KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App

Rev. 1.1 –06/10/2023 MAEKBF1TPD1D2_EN

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. The switch status of each group is shown

via the LEDs on the buttons 1/9 to 8/16.

Manual mode level 2

LED on Man. button flashes green

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 switch status of each group is shown

via the LEDs on the buttons 1/9 to 8/16.

Manual mode level 3

LED on Man. button lights up permanently in red

Briefly press button 1/9 to trigger a broadcast command. Whether the command that is sent first is

an on or off command depends on the status of group 1. Each further keypress toggles all lights

via broadcast. The LED on button 1/9 shows the switch status. All lights react to a broadcast

command even if group assignment has not yet taken place.

A long keypress on button 5/13 triggers a quick exchange command. This function makes it

possible to replace a faulty ECG even without the ETS (see chapter ECG quick exchange).

A long keypress on button 6/14 activates the converter inhibit mode. If the power supply for the

connected emergency lights is turned off within 15 minutes after activating the converter inhibit

mode, the lights are turned off instead of changing into emergency mode. This operating mode

may be necessary during the commissioning and installation process to prevent constant

emergency lighting and battery discharge.

If the gateway detects a fault, the LEDs on buttons 2/10 to 4/12 and 7/15 to 8/16 show the exact

type of fault. The LED is constantly lit up in red. The faults are as follows:

LED Button 2/10 Converter fault

LED Button 3/11 ECG fault

LED Button 4/12 Lamp fault

LED Button 7/15 DALI short-circuit

LED Button 8/16 KNX fault

Application Manual

KNX/DALI gateways EK-BF1-TP-D1/D2 and DCA App

Rev. 1.1 –06/10/2023 MAEKBF1TPD1D2_EN

6.2 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