STAKOHOME KNX - DMX512 Owner's manual

Gateways KNX - DMX512
BES-GW612100
v2.1.2
Programming manual
z

DMXBUS-K - Gateways
Programmingmanual v2.1.2
www.besknx.cz
2
Index
1GENERAL DESCRIPTION ..........................................................................................................................................3
2TECHNICAL INFORMATION.....................................................................................................................................4
3PROGRAMMING....................................................................................................................................................5
3.1 APPLICATION PROGRAM INFORMATION........................................................................................................................... 5
3.2 INDIVIDUAL ADDRESS .................................................................................................................................................. 5
3.3 RESTORE FACTORY SETTINGS ......................................................................................................................................... 5
3.4 ADDING DMX LIGHTS ................................................................................................................................................. 6
3.4.1 Device type ........................................................................................................................................................ 6
3.4.2 Parameters........................................................................................................................................................ 7
3.5 COMMUNICATION OBJECTS .......................................................................................................................................... 8
3.5.1 Objects table ..................................................................................................................................................... 8
3.5.2 Objects description............................................................................................................................................ 9
3.6 SCENES/ SEQUENCES PROGRAMMING............................................................................................................................ 10
3.6.1 How to create a scene ..................................................................................................................................... 10
3.6.2 Nomenclature.................................................................................................................................................. 10
3.6.3 Commands ...................................................................................................................................................... 11
4INSTALLATION .....................................................................................................................................................12

DMXBUS-K - Gateways
Programmingmanual v2.1.2
www.besknx.cz
3
1General description
The device DMXBUS-K with Ref. GW612100, is a communication gateway between KNX protocol and DMX 512 protocol.
This device allows to regulate the 512 channels supported by DMX protocol and to execute up to 16 scenes, being easily
programmable through the projects developing software ETS.
Thanks to this gateway it is possible to develop the integration of a DMX device or system into a KNX home automation
installation, and regulate individually each DMX channel in a simply way like any other KNX dimmer or to program a complex
group of commands in a scene in order to create sequences.

DMXBUS-K - Gateways
Programmingmanual v2.1.2
www.besknx.cz
4
2Technical information
Main power supply
230Vac
Max. power consumption
2,6VA @ 230Vac
Current consumption
1 mA from KNX BUS
Mounting
DIN rail
Size
6 modules.
Connections
BUS connection terminal KNX.
Screw terminals for main supply and DMX bus.
DMX Channels
Up to 512 DMX channels emulation.
Environment temperature
range
Operation: -10ºC/55ºC
Storage: -30ºC/60ºC
Transportation: -30ºC/60ºC
Regulation
According to the directives of electromagnetic compatibility and
low voltage: EN 50090-2-2 / UNE-EN 61000-6-3:2007 / UNE-EN
61000-6-1:2007 / UNE-EN 61010-1.

DMXBUS-K - Gateways
Programmingmanual v2.1.2
www.besknx.cz
5
3Programming
3.1 Application program information
Application program: Ingenium / Dimmers (manufacturer / program name).
Catalogue version: v2.1.2
Maximum number of communication objects: 24.
Maximum number of assignments: 25.
ETS minimum required version: 4.1.8 (build 3614)
The parameters of the gateway are configured with a specific parameter dialog (plug-in); do click on “open” from t h e
parameters menu in the ETS to run it.
3.2 Individual Address
This KNX-DMX gateway is a device that allows having more than one internal individual address. Each DMX device is virtually
represented in its memory as a KNX dimmer with its own communication objects and individual address.
This KNX-DMX gateway answers always with the individual address 15.15.255 to the "devices in programming mode" check
procedure from the ETS, even if it has been already programmed with virtual DMX dimmers. However, an individual address
existence check or line scan will report all virtual dimmers in the KNX-DMX gateway memory.
When a virtual dimmer is programmed in the gateway memory, the individual address cannot be overwritten with the same
device because the ETS will show a “more than one device in programming mode” error. It is highly recommended to delete
the internal memory of the device before programming in order to avoid these problems (see next paragraph).
3.3 Restore factory settings
This KNX-DMX gateway allows to restore factory settings just using the programming button. To get this functionality, it is
necessary to disconnect the power supply (230Vac) from the device, push the programming button and connect again while
holding the programming button for 5 seconds. When LED status turns on, it indicates that the gateway has been successfully
restored.

DMXBUS-K - Gateways
Programmingmanual v2.1.2
www.besknx.cz
6
3.4 Adding DMX lights
3.4.1 Device type
To include a DMX light in the ETS project it is necessary to add to the gateway memory a number of Dimmer applications.
Each application will control a DMX light depending on the parameters configured.
We have to configure the DMX address of each light in the corresponding application. To do so, from the topology window,
do right click on the device and select Edit parameters / General.
The device type parameter allows selecting the corresponding device that will be programmed by the application. The ETS
will show or hide communication objects and parameters according to this parameter. In this case the device that must be
selected is Dimmers DMX Channel.
Some parameters can be hidden depending on the device selected or the previous configuration. The description of the
DMXBUS-K parameters is shown next:

DMXBUS-K - Gateways
Programmingmanual v2.1.2
www.besknx.cz
7
3.4.2 Parameters
Name
DMX Address
Values
From 0 to 512
Description
It is the DMX address number of the light (from 0 to 512). The communication objects of the current
programming application will control the DMX light whose address is configured here.
Name
Ramp speed (sec)
Values
From 0 to 255
Description
It is the brightness change rate measured in seconds. The brightness changes gradually when using
Channel X value or dimming communication objects.
Typical value = 10 (seconds).
Now we can associate the device communication objects to the group addresses as always in the ETS. The KNX telegrams
will be translated by the gateway so that the DMX light device will seem to be a KNX dimmer.

DMXBUS-K - Gateways
Programmingmanual v2.1.2
www.besknx.cz
8
Now we just have to program the application in the gateway, from this point the procedure is completely identical to the one
with any other KNX device. Do right click over the device and select download, then press the gateway programming button
when the software requests for it.
Repeat again to control the next DMX light with address 2 adding a new Dimmer application to the gateway memory and
setting its DMX address parameter a value of 2 and so on with the other DMX lights.
3.5 Communication objects
3.5.1 Objects table
Object
Name / Function
Length
DPT
Flags
C
R
W
T
U
0
CH1 - on/off
1 bit
1.001
●
●
1
CH1 - dimmer
4 bits
3.007
●
●
2
CH1 - value
1 byte
5.001
●
●
3
CH1 - on/off state
1 bit
1.001
●
●
●
4
CH1 - value state
1 byte
5.001
●
●
●
21
DMX_Vrt_Dm - Enable
1 bit
1.001
●
●
●
22
Scene
1 byte
17.001
●
●

DMXBUS-K - Gateways
Programmingmanual v2.1.2
www.besknx.cz
9
3.5.2 Objects description
Name
Object 0: CH1 | On/Off
Function
1-bit communication object to switch on and off the channel.
Description
When a “1” is received through this object the light is switched on and the brightness level goes up to the
last one memorized (different from “0”).
When a “0” is received through this object the light is switched off.
Name
Object 1: CH1 - Dimmer
Function
4-bits communication object for dimming control with pushbuttons.
Description
Depending on the dimming steps set in the pushbutton, telegrams will make the brightness level go up or
down according to the ramp speed configured.
Break telegrams to this object will stop the brightness at the current level.
Name
Object 2: CH1 - Value
Function
1-byte communication object for precise control by setting a new brightness level directly.
Description
The brightness level will go up or down slowly according to the ramp speed configured.
Name
Object 3: CH1 - On/Off state
Function
1-bit communication object for feedback signalling of the on / off state of the channel.
Description
When the light is off and receives a switch on telegram or a brightness value, a “1” is sent through this
object.
When the light is on and it receives a switch off telegram or a brightness value of 0% a “0” is sent through
this object.
Name
Object 4: CH1 - Value state
Function
1-byte communication object for feedback signalling of the current brightness level of the channel.
Description
When it receives a new brightness value or an increase/decrease telegram the final brightness value is
sent through this object.
Name
Object 21: DMX-Vrt_Dm - Enable
Function
1-bit communication object to enable or disable the device control through the KNX BUS.
Description
When a “0” is received through this object the device cannot be controlled by BUS telegrams. When a “1”
is received the device control is enabled.
By default the enable function is activated. It is not necessary to use this object to enable the normal
function of the device.

DMXBUS-K - Gateways
Programmingmanual v2.1.2
www.besknx.cz
10
Name
Object 22: Scene
Function
1-byte communication object for internal scenes execution.
Description
Scenes can be programmed by scripts using the microSD card (3.6.1 How to create a scene pag.10). A
scene can be executed using this communication object (from any virtual DMX application).
Values from 0 to 15: Run the corresponding scene (DMXx.h script).
Values from 100 to 115: Stop the corresponding scene (DMXx.h script).
3.6 Scenes/sequences programming
The DMXBUS-K gateway allows to program 16 scenes including up to 256 commands each.
3.6.1 How to create a scene
The scenes which will be executed must be created previously using text files that have to be loaded in the microSD card of
the gateway. The memory card must have a maximum capacity of 2GB and be FAT16 formatted.
3.6.2 Nomenclature
These text files can be generated with any text editor and must be correlative and named like this:
DMXx.h
Where xis the number of the scene.
The number of the scene is the value that must be sent to the scene communication object (number 22) of any of the
DMXBUS-K device applications in order to execute it.

DMXBUS-K - Gateways
Programmingmanual v2.1.2
www.besknx.cz
11
3.6.3 Commands
The commands that can be used in the scenes text files must be written like this:
- EXECUTE X Y Z
Where X is the DMX channel, Y is the lighting value (from 0 to 100) and Z is the ramp speed (changing speed from the
actual value to the Y value)
- WAITX
Where X is the pause value in seconds.
- LOOP
With this command the scene is executed again from the beginning. Send 100 + value of the scene to stop the execution.
Scenes examples (text files generated into the memory card):
EXECUTE 1 100 5 EXECUTE 1 75 3 EXECUTE 1 0 3
EXECUTE 2 100 5 WAIT 2 EXECUTE 2 0 3
WAIT 2 EXECUTE 3 75 3 EXECUTE 3 0 3
EXECUTE 3 75 5
LOOP
DMX1.h DMX2.h
DMX0.h

DMXBUS-K - Gateways
Programmingmanual v2.1.2
www.besknx.cz
12
4Installation
Feed low voltage lines (BUS and inputs) in separate ducting to that of power (230V) and outputs to ensure there
is enough insulation and avoid interferences.
Do not connect the main voltages (230V) or any other external voltages to any point of the BUS or inputs.

Liability limitation: The present document is subject to changes or excepted errors. The contents are continuously checked to be
according to the hardware and software but deviations cannot be completely excluded. Consequently any liability for this is not accepted.
Please inform us of any suggestion. Every correction will be incorporated in new versions of this manual.
Manual version: v1.2
Výhradní distributor pro ČR aSR:
Stakohome Innovation s.r.o.
Aloisovská 934/8,
198 00 Praha 9Hloubětín
Česká republika
Tel.: [phone]
Mob.:[phone]
[e-mail]
www.besknx.cz
z