Instabus KNX/EIB-Product documentation

Page: 1 of 12

Gateway

EIB IP-Gateway e:cue Product name: EIB IP-Gateway e:cue Din rail Device description: Product-Nr.: Insta: 66130020 Communication / IP / EIB IP-Gateway e:cue ETS-search path: 04.08.2005 Status: Operational description:

The EIB IP-Gateway establishes interface between an e:cueNet-Ethernet network and the KNX/EIB-building installation. The EIB IP-Gateway converts unidirectional Data from the KNX/EIB-System into e:cueNet-protocol. This enables, e:cue-devices (e.g. the e:node) to be controlled through the KNX/EIB-devices. In this way, the entire KNX/EIBinstallation, e.g. EIB-tactile sensors, timer switches, weather sensors (wind and rain), may be utilized to control DMX-systems. Consequently, complex scenarios may be realized together with conventional and effect lighting, sun blind technology, and even air conditioning and ventilation technology, as well as with e:cue-DMX-systems. The connection to the e:cueNet takes place through an RJ45 connection (Ethernet-standard). The RS232 ports, a/b and "local bus" have no function. The start-up, on the EIB side, is initiated with the help of the ETS. On the IP side, start-up is initiated via PC web browser (recommended: Microsoft Internet Explorer V 5.5 or higher) or through the PC software "EcueGatewayBrowser.” The EIB IP-Gateway is not programmed through e:cueNet components. Diagram:

Measurements:

C

F

E

D

+ 24 V -

LAN

Width: 144 mm (8 TE) Height: 90 mm Depth: 61 mm

RS232

C O N T R O L

local bus

N

H

EI B

L I G H T I N G

G at ew

ay

LA

Be

tri

eb

www.ecue.tv

Controls:

TLN-Nr.: Bereich:

Linie:

A B C

DHCP:

Subnet Mask:

IP-Adresse: Insta Elektro GmbH D-58511 Lüdenscheid/Germany

INSTA 66130020

G

D E

A a / b

B

H

F G

Programming-LED (red) Programming-key Terminals for external voltage supply 24 V DC LAN-connection RJ45-slot RS-232 -without function! Local bus connection -without function! a/b-Trigger input -without function!

Operation (green):Glows steadily with electric voltage supply after initialization. LAN (yellow): Glows during existing LAN connection (connection to Ethernet Connection Point, e.g. a hub or switch (straight) or PC (cross). Flickers during data transfer over LAN.

Instabus KNX/EIB-Product documentation

Page: 2 of 12

Technical Data Protection classification: Control stamp: Ambient temperature: Storage and transport temperature: Mounting orientation: Minimum clearance: Mounting type:

IP 20 KNX / EIB -5 °C to +45 °C -25 °C to +70 °C (storage above +45 °C reduces lifetime) optional none snaps onto top-hat rail (no data track necessary)

Supply KNX / EIB (bus clamp) Voltage: Power consumption: Terminal:

21 – 32 V DC SELV typ. 150 mW (the bus controller is fed by the external power supply) KNX / EIB screw and branching terminal

External supply (screw terminal) Voltage: Power consumption: Terminal:

Behavior during voltage breakdown Voltage bus only: Power supply: Behavior during re-start Voltage bus only: Power supply:

LAN Amount: Port: LAN connection: Protocol: IP addressing:

24 V DC SELV (21 – 32 V DC z. B. via unrestricted output of a KNX/EIB-power supply) / polarity reversal protected typ. 3 W screw clamp: 2 0,5 – 4 mm single wire or 2 0,34 – 4 mm fine wire without ferrule or 2 0,14– 2,5 mm fine wire with ferrule

no reaction (no conversion possible) no reaction (device shuts down completely.) The KNX/EIB-interface initializes. The communication object’s data value is invalid! Device initializes (boot process starts and takes a few seconds. During the boot process, the green Operation-LED turns off). The communication object’s data value is invalid! 1 RJ45 socket (10/100 MBit/s Fast Ethernet) 8 pin straight to an Ethernet-Connection-Point (hub, switch, etc.), cross ,e.g. to an e:node TCP/IP (HTTP on port 80), UDP IP address (pre-defined), subnet mask, Gateway address adjustable; DHCP possible (but inactive at default factory setting), auto IP

a/b-Trigger input

without function!

RS232 (V.24)

without function!

'local bus'

without function!

Micro controller (KNX / EIB) Type: Communikation objects:

BIM M 112 (with TP-UART and AT Mega 128 fed by external power supply) 1

Instabus KNX/EIB-Product documentation

Page: 3 of 12

Table of Contents Page 1. Operational Description

3

2. Mounting and Installation 2.1 Ethernet Connection 2.2 Connecting the Power Supply und Bus Connection 2.3 IP Connection Types

4 4 4 5

3. Planing and ETS Plug-In 3.1 ETS Configuration and Start-Up 3.2 IP Configuration 3.2.1 Configuration through "EcueGatewayBrowser" 3.2.2 Configuration through Web Interface

6 6 7 7 11

1. Operational Description The EIB IP-Gateway converts unidirectional 8 Bit Datavalues received from the KNX/EIB-System into e:cueNetprotocol. The conversion on the IP side takes place in the form of UDP unicast datagrams, which can then be evaluated through e:cueNet components (like the e:node). The interpretation of values received by KNX/EIB are individually customizable on the IP side (depending on the addressed e:cueNet end-device). Unicast addressing requires the EIB IP-Gateway to know the IP-destination address of the targeted e:cueNet component. For this purpose, the appropriate IP address must be specified in the Gateway’s web interface. The default IP address is "192.168.123.123". In addition to unicast data value conversion, the EIB IP-Gateway cyclically generates a special e:cue registry service every 3 seconds. In addition, on the IP side, the Gateway sends out a UDP Broadcast, which is evaluated by the:cue programmer for instance. The EIB IP-Gateway is exclusively configured and programmed through the ETS and the PC start-up tool "EcueGatewayBrowser" or through a web browser. It is not possible, or necessary for the Gateway to be programmed through e:cueNet components (e.g. e:cue programmer). On the KNX/EIB side, the device is equipped with a received communication object. The required group addressing and the allocation of a physical address simply take place in the ETS. The IP-configuration takes place in the start-up tool "EcueGatewayBrowser" or alternatively through a web browser.

Page: 4 of 12

Instabus KNX/EIB-Product documentation 2. Mounting and Installation

The EIB IP-Gateway is designed as (REG) intended for installment into an electrical cabinet or terminal box. In general, the device requires an external voltage supply of 24 V DC and a connection to the KNX / EIB. Additionally, the Gateway must be connected to the ethernet network (LAN). Ideally, the LAN connection should be established before the power/voltage supply is connected! 2.1 Ethernet Connection The EIB IP-Gateway has an 8 pin RJ45-socket serving as a network interface. A twisted pair (TP) connection line is plugged into the 8 pin RJ45-socket. This connection line between devices may be executed in the following way: - as a 1:1 (patch cable) connection to the 'normal'- or auto-MDIX-port of a network distribution device (e.g.. hub, switch, router), - as a (crossover) connection line in a direct point-to-point connection to a PC. The utilized ethernet lines should conform to the cat.5 standard. Adherence to the general guidelines for ethernet connections is strongly advised! The EIB IP-Gateway supports the standards 10BaseT (10 Mbit) and 100BaseT (100 Mbit). As soon as the physical connection to the network distribution device or PC is established, the yellow LAN-LED lights up on the front panel of the device when voltage is applied. This LED flickers when data packages are received through the ethernet interface. The actual logical connection to the network is not established until an IP address has been allotted. The concept of IP addressing will be explained in more detail later, in the chapter "Configuration". 2.2 Connecting the Power Supply und Bus Connection The EIB IP-Gateway requires an external power supply of 24 V DC for operation. This voltage supply may be taken, for example, from the unrestricted voltage output of a KNX/EIB-power supply (21 – 32 V DC), or from an additional power supply unit (power pack) (SELV!). For the purpose of clarity, the correct polarity should be minded. In principle, however, the device is polarity reversal protected. Connection to the bus is made by way of the bus terminal. All other ports (RS232, a/b, local bus) of the EIB IP-Gateway are not to be connected. + -

+ 24 V -

LAN

RS232

C O N T R O L

local bus

N

TLN-Nr.:

at ew ay

LA

Be

tri e

b

www.ecue.tv

L I G H T I N G

Bereich:

G

Linie:

EI B

24 V DC

DHCP:

Subnet Mask:

IP-Adresse: Insta Elektro GmbH D-58511 Lüdenscheid/Germany

INSTA 66130020

a / b

KNX / EIB

Connecting the Power Supply und Bus Connection

Page: 5 of 12

Instabus KNX/EIB-Product documentation 2.3 IP Connection Types A: Operation in local area network (LAN) Crosskabel

z. B. e:node

+ 24 V -

LAN

RS232

C ON T RO L

local bus

www.ecue.t v TLN-Nr.: Bereich:

EIB IP-Gateway

L IG H T I NG

Linie: DH CP: Subnet Mask: IP-Adresse:

Ins ta Elek tro GmbH D-58511 Lüdenscheid/Germany

I NSTA 66130020

a / b

Direct connection between e:node and EIB IP-Gateway through an ethernet crossover cable (crossed connection between sender/receiver lines). B: Operation in local area network (LAN) with network distribution device (e.g. hub, switch) z. B. Hub / Switch

Patchkabel

z. B. e:node

Patchkabel

+ 24V -

LAN

RS232

CO N T R O L

local bus

...

www.ecue.tv TLN-Nr.:

L IG HT IN G

Bereich:

Patchkabel

EIB IP-Gateway

Linie: DH CP: Subnet Mask: IP-Adresse:

Insta El ektro GmbH D-58511 Lüdenscheid/Germ any

I NSTA 66130020

a / b

C: Operation in local area network (LAN) with link to internet

z. B. e:node

z.B. DSL ...

Internet Patchkabel

Patchkabel Router + 24 V -

LAN

RS232

C O N T RO L

local bus

www.ecue.t v TLN -N r.: Bereich:

EIB IP-Gateway

L IG HT I NG

Linie: DHCP: Subnet Mask: IP-Adresse:

Insta Elektro GmbH D-58511 Lüdenscheid/Germany

I NSTA 66130020

a / b

A local ethernet (LAN) sets up an internet connection with the help of a standard gateway (router or proxyserver).

Page: 6 of 12

Instabus KNX/EIB-Product documentation 3. Planning and ETS Plug-In

The EIB TP-Gateway is configured and set into operation in 2 steps. In the first step, the device is configured and programmed through the ETS on the EIB side (start-up for KNX/EIB components). On the IP side, in the second step, the gateway is [parameterized] through a web browser (recommended: Microsoft Internet Explorer V 5.5 or higher) or with the help of the PC program "EcueGatewayBrowser". The necessary hardware connections (power supply 24 V DC, bus connection und LAN connection) must be established before start-up! The power supply must be turned on.

3.1 ETS Configuration and Start-Up The device product-databank must be imported into the ETS. The device must be entered into the ETS-project, in order to be processed. The respective product-catalog-entry is listed in the catalog of the company. Insta Elektro GmbH, within the product line "Kommunikation / IP". The device’s application name is "EIB IP-Gateway e:cue C00B01". ETS-search path:

ETS-symbol: EIB

Communication / IP / EIB IP-Gateway e:cue

...

00 Hex AST-Type Applications: Nr. Description: 1 Conversion of KNX/EIB-value telegrams to IP UDP datagrams for e:cueNet. ApplicationName: Executable with mask version (or higher): Number of addresses (max.): Number of allocations (max.): Communication objects: Function: Receive-value Object Function 0

Value [Wert]

0 Dez

No adaptor used

Name: EIB IP-Gateway e:cue C00B01

Version: 0.1

EIB IP-Gateway e:cue C00B01 7.1 1 1 1

Name Entry [Eingang]

dynamic table management: maximum table lenght:

Typ 1 byte

DPT-ID *

yes 2

no

Flag K, S, (L) **, Akt

*: Non-standardized point data type. **: Once the L-Flag is set, the object status (the last value written into the object) may be read out. Object description 0 Value [Wert]:

1 Byte object for receiving a KNX/EIB data value. The received value is converted into a 540 Byte UDP Unicast IP-datagram and is broadcast at the LAN-interface (destination address adjustable).

Die ETS application features no parameters. The communication object ”value” is exclusively a receiver. In principle, only one group address should be associated with the object. If multiple addresses are linked, then only the group address with the least (least address value) is evaluated! In the ETS project, a physical address is allocated to the device. After the planning has been executed, the device must be programmed (physical address & application).

Instabus KNX/EIB-Product documentation

Page: 7 of 12

3.2 IP Configuration The IP parameters can be configured with the help of the PC program "EcueGatewayBrowser" or through a PC with a web browser (recommended: Microsoft Internet Explorer V 5.5 or higher). 3.2.1

Configuration through "EcueGatewayBrowser"

After starting the "EcueGatewayBrowser.exe" the program’s main window opens.

If the PC has more than one network card, then the specific network card must be selected, which establishes an ethernet link to the [Gateway]. This specific card is selected in the entry field "IP address in use". In case the PC in use only has one network card, then this field is deactivated by default. The start-up tool is launched by clicking on the "Discover" button. The start-up tool activates a special UDPDiscovery service as a LAN broadcast (through Port 19001). Every EIB IP-Gateway replies to this broadcast and transmits its own respective IP-address, its serial number, and the state of its respective KNX/EIB programming key.

Through the transmitted and displayed information, the [Planner] is capable of specifically identifying the device to be configured. By default factory setting, the EIB IP-Gateway has the IP address "192.168.123.100" DHCP is deactivated. Note on UDP Broadcast: A UDP broadcast datagram is not transmitted through a router. This is why gateways can only be located within a subnet or subnet for configuration!

Instabus KNX/EIB-Product documentation

Page: 8 of 12

In the next step, the planner goes to the entry field "Gateways:", and selects the gateway which is to be configured out of the list, by clicking on it with the mouse. The buttons "Configure" and "Browser", as well as the password entry field are activated when a device is selected. The designer or system administrator must legitimize him or herself through a password entry, in order to avoid unauthorized access to the device configuration. This required password is secured and set as "sysadminpw". For security reasons, this password is encrypted. When the button "Configure" is clicked after having entered the wrong password, or without having entered any password at all, an additional authentication dialog pops up. In this dialog, the planner is prompted to re-enter user name and password. At this point the required username is "sysadmin". A mouse click on the "Configure" button, or an approved authentication dialog after the correct password entry, opens the configuration dialog for the selected gateway.

The following settings can be made... use DHP: DHCP allows for the network settings like required IP addresses for single end-devices to be determined automatically. The use of DHCP in a network requires at least one DHCP server, which administers the configuration data for the specified IP address range. DHCP-compatible end-devices, e.g. EIB IP-Gateway, prompt the DHCP-Server at every boot-up (switching on the power supply) for their IP addresses and their respective parameters like subnet mask and gateway address. Upon arrival after shipment, the default settings have DHCP deactivated. By clicking on the checkbox "use DHCP," the DHCP function is activated. In this case all other configuration settings (IP address, subnet mask, gateway and DNS) are not evaluated.

Instabus KNX/EIB-Product documentation

Page: 9 of 12

Notes: "AutoIP instead of DHCP" In some cases the EIB IP-Gateway tries to load a network configuration through DHCP, but finds that no DHCP server is available. In this case the EIB IP-Gateway automatically assigns itself an IP address from the preset AutoIP range, and restarts with this self-assigned address. During this process the Gateway, verifies if the address is still available and not already taken by another network user. The following values are set in AutoIP: IP Configuration IP-address Subnet mask IP- address gateway (e.g. router) DHCP

Value Range / Value 169.254.x.y 255.255.0.0 0.0.0.0 (not preset / no gateway available) deactivated

The host-ID part of the IP address (x, y) is randomly selected. The AutoIP configuration is valid until the EIB IPGateway reboots (switching on the power supply). A DHCP server search is generally conducted only once during the booting process. Remarks on AutoIP: When the gateway AutoIP is activated, it can be expected that the start-up-PC and the EIB IP-Gateway will work with different subnet masks, although they are installed in the same sub network. For EIB IP-Gateway’s reply to reach the PC using AutoIP, the gateway sends the discovery-reply during configuration directly to the PC, without addressing a standard gateway (e.g. router). This is why the standard gateway address is not preset (setting: "0.0.0.0"). Only in this way is it possible to recognize the EIB IP-Gateway’s random AutoIP addresses and communicate with the devices.

IP address: Here the EIB IP-Gateway’s IP address is specified, if no DHCP is utilized. The EIB IP-Gateway has the IP address "192.168.123.100" in default setting.

Subnetmask: Here the subnet mask corresponding to the local subnet is entered, if no DHCP is utilized. The factory setting is "255.255.255.0".

Gateway: Here the IP address of a standard gateway is specified, if such a device is available in the network. Standard gateways are for example Routers, enabling an internet connection or a link between different subnets. In the factory setting no gateway is specified (setting: "0.0.0.0").

DNS: Here the IP address of a valid DNS server may optionally be specified. This setting is, however, not required. In the factory setting, upon arrival after shipment, no DNS server is specified (setting: "0.0.0.0"). If the specified DNS server is not located in the local network (LAN), then a valid standard gateway must be parameterized.

Instabus KNX/EIB-Product documentation

Page: 10 of 12

General notes on IP configuration: It should be noted that if no DHCP is used, the net-ID part of the start-up PC’s network card’s IP address matches the net-ID of the Gateway’s IP address for integration into the same subnet. Otherwise the Gateway will neither be found through the web browser, nor through the "EcueGatewayBrowser" for configuration! If necessary, the network card’s IP address may be adjusted. Examples: IP address PC: IP address of Gateway: Subnet mask:

192.168.1.101 192.168.123.100 255.255.255.0

Both devices are installed in the same subnet (physically identical Ethernet-String). No device communication can take place, since the PC net-ID (here: 192.168.1.x) does not coincide with the net-ID of the Gateway (here: 192.168.123.x).

IP address PC: IP address of Gateway: Subnet mask:

192.168.123.101 192.168.123.100 255.255.255.0

Both devices are installed in the same subnet (physically identical Ethernet-String). Device communication can now take place, since the net-ID of the PC (here: 192.168.123.x) coincides with the Net-ID of the Gateway. Configuration is now possible. When a proxy server is available and the gateway is located in the same subnet as the start-up PC, then the internet properties of the web browser should be set in the way that no proxy is utilized for the Gateway’s IP address!

After all the necessary IP-settings have been made, the "Apply changes" button is activated by mouse click. In this way the configurations are transmitted to the EIB IP-Gateway and saved. If changes have been made to the settings, the EIB IP-Gateway has to be restarted, so the device’s IP stack can initialize and actively take on these new settings. The system is restarted by clicking on the "Restart System" button. Subsequently, (delay of a few seconds) the green operation-LED turns off on the device’s front panel and the Gateway restarts. This process can take some time. After the start-up process has been completed, the green operation-LED glows steadily again. The device is now operational.

Instabus KNX/EIB-Product documentation 3.2.2

Page: 11 of 12

Configuration through Web Interface

As an alternative to configuration through the "EcueGatewayBrowser", EIB IP-Gateway may also be configured through a web browser. However, the search mechanism through the discovery service is only useable in the "EcueGatewayBrowser". The "receiver IP-address" of the e:cueNet device, receiving transmitted unicast data, can only be entered in the web interface. The web interface is opened, by entering the IP address of the targeted EIB IP-Gateway in the web browser’s URL-address bar, after which the “enter” key is pressed. In the factory setting, the Gateway’s IP address is set to "192.168.123.100". The URL in the address bar of the browser is to be entered as follows: http://192.168.123.100. Die HTTP-link to the EIB IP-Gateway is made through port 80. Alternatively, the web interface may be opened by clicking „Browser“ in "EcueGatewayBrowser’s" start-up tool. In this way the standard web browser is started while the web interface of the selected gateway is displayed. The start-up tool method is useful, if the Gateway’s IP address is unknown, and a discovery-service must be executed beforehand.

Instabus KNX/EIB-Product documentation

Page: 12 of 12

The web interface offers the following possible settings... "Reciever IP address": The EIB IP-Gateway converts data values received by KNX/EIB into special UDP unicast datagrams. These point-to-point IP-data packets target a component from the e:cueNet (e.g.the e:node). In order for this to work, the destination IP-address of the e:cueNet receiver must be entered into the device configuration of the gateway. The destination address has been preset at "192.168.123.123". This address may, however, be edited and changed anytime by activating the button assume. The address is saved in the device. When destination addresses are specified, which are not a part of the local network (LAN) (other Net-ID), the following should be noted. In order to route into the other network, a valid standard gateway must be entered into the IP device configuration. Otherwise extra-net communication will not be possible! The data value last received by the KNX/EIB is shown in the display field last value. Editing or presetting this value is not possible here. The web interface refreshes itself cyclically every 5 seconds. Newly received data values are displayed at the end of every 5 second cycle at the latest.

Die web interface also offers the possibility accessing and editing the IP device configuration, by clicking on the "config" link (marked red in the image). The user is prompted to enter his user name ("sysadmin") and password ("sysadminpw"). Once the user has been authenticated and confirmed, the IP configuration dialog box opens with the saved settings.