Leviton Knxgw-000 User manual

Leviton KNX Gateway

Cat. No. KNXGW-000

The KNXGW Leviton KNX Gateway allows a Leviton Omni automation controller (Omni LTe, Omni IIe, or OmniPro II) to

communicate with and control KNX devices on an existing KNX bus. Lighting, temperature and energy management, and

motors (window coverings, shades, shutters, etc.) are among the many KNX devices that can be controlled. The KNX

Gateway provides an interface between the Omni controller and the KNX network by mapping speciﬁc data points of each

KNX device to a unit or thermostat number on the Omni controller.

The following is an overview of the inputs and outputs on the KNX Gateway.

On the top of the KNX Gateway there are two LEDs:

1. Green LED: Power Status LED. LED is illuminated when the KNX Gateway is powered either through a PoE Ethernet

connection or by providing 12-24V DC.

2. Red LED: Reset/Service LED. LED is normally off. LED will blink or illuminate during reset procedure.

1 Power Requires 12-24VDC, 240-120mA to terminals. Shall be powered with a separately approved SELV

power supply with current limitation and short circuit protection.

2KNX Bus

Connection

Connects the KNX Gateway to the KNX bus. Use KNX twisted-pair cable.

3Reset

Button

The Reset Button is used to restore the IP address and/or reset the KNX Gateway to its factory

default settings.

Ethernet

Port (PoE)

(Cat-5 or

better)

Provides a connection to the local network for conﬁguration of the KNX Gateway and

communications with an Omni controller. It also allows the KNX Gateway to be powered when using

a Power Sourcing Equipment (PSE) device, such as a PoE network switch, hub, or power injector.

5 RS-232 Port Connects to serial port on Omni controller. Required when one or more KNX thermostats/

temperature sensors are used in the installation.

6 USB Ports Not used.

7 RTS

DB9-FEMALE

BOTTOM VIEW

4 POSITION MODULAR

PHONE CABLE

YELLOW WIRE ON TOP TAB UP

TOP

SIDE

8 CTS

3 TX

2 RX

1 DCD

5 GND

4 DTR

6 DSR

GREEN

YELLOW

RED

BLACK

KNX Gateway Side View

62 mm

142 mm

12-24 VDC

240-120mA

BUS

RESET

PoE LAN RS232 USB

12-24 VDC

240-120mA

KNX

RESET

LAN

RS232

USB

Install the KNX Gateway as follows:

1. Install the KNX Gateway in a suitable distribution box ﬁtted with 35mm DIN rail.

2. Connect the KNX bus to the KNX Gateway using the KNX Bus Connection terminals on the KNX Gateway.

3. Power the KNX Gateway by supplying 12-24VDC to the power terminals on the KNX Gateway.

Alternatively, the KNX Gateway can also be powered using a Power Sourcing Equipment (PSE) device, such as a PoE

network switch, hub, or power injector which provides the power. A Cat-5 or better (4-pair) cable is required. Run the

Cat-5 cable between the location of a PoE network switch, hub, or power injector and the location of the KNX Gateway.

Terminate both ends of the Cat-5 cable with 8-position modular connectors to make a standard straight through network

patch cable. Plug the cable into the Ethernet Port (PoE) the KNX Gateway.

Operational Temperature 32° to 104° F (0° to 40° C)

Agency Standards and Certiﬁcations CE, Class B

EMC:

EN 50491-5-1: 2010-04

EN 50491-5-2: 2010-04

FCC Part 15, Class B

Safety:

EN 60950-1: 2006+A11:2009+A1:2010+A12:2011

EN 50491-3: 2009-07

IP Rating IPX0

Connect the DB9 connector to the RS-232 Port on the KNX Gateway. Connect the end of the modular cable to one of

the built-in serial ports on the Omni controller. Conﬁgure the function of serial interface on the Omni controller to "KNX".

It is important that the KNX programmer make available all of the device parameters that you will need. This is especially

important in the case of thermostats since not all of the features for a standalone thermostat would need to be conﬁgured

(e.g. setpoints being set remotely). If the KNX programmer does not assign this feature a Group Address, you will not be

able to associate it with the Omni controller through the KNX Gateway.

The conﬁguration for the KNX Gateway is performed through a built-in web interface.

1. Connect the Ethernet Port of a PC to the KNX Gateway using a standard network cable. If the KNX Gateway is being

a. Temporarily change the network settings of the PC (IPV4 protocol), as follows:

• IP address: 192.168.0.100

• Subnet mask: 255.255.255.0

• Default gateway: 192.168.0.110

b. Once your computer is on the same subnet as the KNX Gateway, you can access the web interface by opening a

supported web browser and entering the following IP address into the address bar:

http://192.168.0.110

c. You will be prompted with a login screen. By default, the user name is admin and the password is admin.

After logging in to the web interface of the KNX Gateway, use the Menu tree to conﬁgure the various parameters of the KNX

Gateway. Whenever a change is made to the conﬁguration, the "Save" (disk icon) button in the upper-right side of the page

becomes red. It will stay red until the next auto-save process (about every 5 minutes). If you need to power down the KNX

Gateway while the "Save" button is still red, press this button to save the project; otherwise, the changes that were made

after the last auto-save will be lost.

After the new network settings have been made and saved:

a. If your computer’s network settings were previously changed to access the KNX Gateway web interface, you can now

set your computer’s network settings back to correct settings for your existing network.

b. You can now access the KNX Gateway using the new IP address.

Backup/Restore Page: Allows you to Export a backup for the conﬁguration ﬁle that is stored in the KNX Gateway. This

ﬁle will be useful if you ever need to replace the KNX Gateway or reset it to its factory default settings. You can also import

a previously exported conﬁguration ﬁle. This is useful if you needed to replace the KNX Gateway or reset it to its factory

default settings. The Reset option allows you to restore the KNX Gateway to its factory default conﬁguration.

After the controller’s network settings have been entered, press the Start button to initiate communications between the

Omni controller and KNX Gateway.

Units: Specify the Omni unit numbers to be used to monitor and control KNX lighting, relay, motor, and keypad devices.

a. Specify the number of units you want to create in the input ﬁeld next to the ADD button under Units.

b. Press the ADD button and wait until all items are created.

The last three columns allow for the command of the following attributes: On/Off, Level (if applicable), and Other attribute

(if any). Press the EDIT button for a unit to display the details page.

Thermostats: Allows you to specify the Omni thermostat numbers that will be used to monitor and control KNX thermostats

and temperature sensors.

a. Specify the number of thermostats you want to create in the input ﬁeld next to the ADD button under Thermostats.

b. Press the ADD button and wait until all items are created.

The last three columns contain the following attributes: Current temperature, Heating setpoint (if applicable), and Cooling

setpoint (if applicable). Press the EDIT button for a thermostat to display the details page.

Keyword One or more sentence (comma separated, without spaces) inside group address name in ETS project

Type Length of payload of group address in ETS project

Encoding Data encoding to be used by the KNX GATEWAY to communicate with the group address

VERSION 1.0.0

Setup

Network

Leviton

KNX

Gateway rules

Users

Backup/Restore

IP address 10.0.0.232

255.255.255.0

10.0.0.1

8.8.8.8

4.2.2.2

LAN

DNS

Subnet mask

Gateway

Primary DNS

Network

Secondary DNS

Date/Time

Software Update

Maintenance

SAVE CLOSE

VERSION 1.0.0

Setup

Network

Leviton

KNX

Gateway rules

Users

Units

Thermostats

Porch Light

Foyer Light

Foyer Lamp

Backup/Restore

IP address: 10.0.0.216

4369

....................................

Generic Settings

Communication

Units

Port:

Encryption keystring 1:

Omni controller

Date/Time

Software Update

Maintenance

Omni controller

....................................Encryption keystring 1:

Name

Porch Light

Foyer Light

Foyer Lamp

Number

1111Default user code:

RunningExecution state:

ConnectedConnection status:

STARTCLOSESTOP

ADD1REFRESH

Value OtherON/OFF

Off

...

Thermostats

Name

Thermostat 1

Number Type

1 Auto Heat/Cool

ADD1REFRESH

Set Heat Set CoolTemperature

24.5° 20 25

...

DI-000-KNXGW-04A

DESCRIPTION

CONFIGURING THE KNX GATEWAY

SETUP

KNX

OVERVIEW

INSTALLATION

The Setup menu allows you to conﬁgure the network settings, make a backup of the conﬁguration ﬁle, restore from a

previous backup of a conﬁguration ﬁle, reset the KNX Gateway to its factory default settings, conﬁgure the date and time

settings, update the software, and obtain system information about the KNX Gateway.

Network Page: Allows you to assign an IP address, Subnet mask, Gateway, and DNS to match your existing network.

Before building rules (see the section entitled Gateway Rules) between devices on the KNX bus and devices on the Omni

controller (which were added under the section entitled Leviton), you must ﬁrst assign the KNX Gateway a Physical Address and

add the KNX objects (speciﬁc attributes, typology, encoding, etc.) to the KNX Gateway for each KNX Group Address used on the

KNX bus. It is recommended that you obtain an export of the ETS project ﬁle in OPT format (this ﬁle has an extension of .ESF)

from the KNX programmer. This ﬁle can be imported into the KNX Gateway to automatically add KNX objects and attributes.

Otherwise, KNX objects can be manually added. In this case, it is recommended that you obtain a "Group Addresses Details

Report" from the KNX programmer. This can be printed from ETS software using the Print function.

Add KNX Objects: Allows you to manually add KNX objects to the KNX Gateway. When objects are manually added, you must

enter the name (user friendly name for identifying the device/function), read and/or write function, command address, state

address, and length for the type of encoding.

Click Add to add a new object. Click Save to save the added objects.

ETS Import Rules: For each KNX Group Address in the ETS project, the import procedure looks for a matching rule by keyword

and type. When found, the rule for encoding is assigned to the newly created KNX object. If a rule is not found, you will be

prompted to specify missing information manually.

WARNINGS AND CAUTIONS

• WARNING: TO AVOID DEATH OR SERIOUS PERSONAL INJURY never push objects of any kind into this product through openings, as they may touch dangerous voltages.

• WARNING: TO AVOID DEATH OR SERIOUS PERSONAL INJURY never touch uninsulated wires or terminals unless the wiring has been disconnected at the network interface.

• For Installation within a home and building automation control system compliant with HD 60364-4-41 and applicable national requirements.

• Read and understand all instructions. Follow all warnings and instructions marked on the product.

• If you are not sure about any part of these instructions, consult an electrician.

• Do not use this product near water - e.g., near a tub, wash basin, kitchen sink or laundry tub, in a wet basement, or near a swimming pool.

WARNINGS AND CAUTIONS

• Never install communications wiring or components during a lightning storm.

• Never install communications components in wet locations unless the components are designed speciﬁcally for use in wet locations.

• Use caution when installing or modifying communications wiring or components.

• For indoor applications only.

• Use this device with copper wire only.

• SAVE THESE INSTRUCTIONS.

Date/Time Page: Allows you to set the date and time, conﬁgure time zone, and synchronize date/time from a server.

Software Update Page: Allow you to update the software in the KNX Gateway when new software is available.

Note: For software updates, use a Google Chrome web browser only.

Maintenance Page: Allows you to view system information, system status, download log ﬁle, restart communications

services, and reboot the KNX Gateway.

Leviton

The Leviton menu allows you to conﬁgure the connection information for the Omni controller, the units that will be used to

monitor and control KNX lighting, relay, motor, and keypad devices, and thermostats that will be used to monitor and control

KNX thermostats and temperature devices.

Omni Controller: Allows you to enter the IP address, Port, Encryption Keys, and Default user code for connecting to the

Omni controller. It also shows the executing status of the communication service and connection status of the Omni.

4. If there is at least one KNX thermostat or temperature sensor on the KNX bus, a connection between the RS-232 port

on the KNX Gateway and a serial port on the Omni controller is required.

a. Use the Leviton 21A05-2 serial cable kit, or make your own serial cable, as follows:

It is possible to edit predeﬁned rules and/or create new ones, by pressing the Add button and entering all required

information. New rules can easily be created during the ETS import procedure, as described under ETS Import.

ETS Import: The ETS project must be exported in OPC format within the ETS application. This operation creates two ﬁles.

The ﬁle with extension of ESF must be used. Select the Choose File button under Project File. Select the ESF ﬁle to be

used and then click the Next button to start the import process.

If you desire to completely remove any previously created KNX objects in the project, put a check in the checkbox next to

Delete existing KNX objects prior to clicking the Next button to start the import process.

The same ETS project can be imported more than once. Each time modiﬁcations are made in ETS, the import procedure

creates new objects for group addresses not previously present in the project, and updates attributes (if necessary) of

existing objects.

ETS Project: This option displays the number of KNX objects created (this should match the number of group addresses in

ETS project) and the list of KNX group addresses not matching any of the import rules.

In the case of group addresses not matching import rules, the available options are:

a. Ignore them (in such a case, these items will not be available for Gateway rules).

b. Manually set encoding.

c. Create a new import rule by accessing ETS Import Rules and adding a new rule matching the name(s) of group

addresses.

Conﬁgure Communication: Allows you to assign the KNX Physical Address of the KNX Gateway.

To rename a Gateway rule, right-click anywhere on the empty area of the Gateway rule to open the Object properties side

menu. Enter the new name for the rule and click the Edit button.

Add Items and Connections to Gateway Rules

Drag and drop Omni devices (Units and Thermostats under the Omni controller menu) and KNX objects (under the ETS

project menu) onto the workspace or search for them using the Search feature above the menu tree.

Omni Thermostats appear in gateway rules as follows:

VERSION 1.0.0

Setup

Leviton

KNX

Gateway rules

Users

Name:

Gateway rule 4

Drop here one or more objects from tree menu or search results

Object properties

Gateway rule 4

Porch Light Rule 1

Foyer Light Rule 1

Thermostat 1

Gateway rule 4

EDIT

VERSION 1.0.0

Setup

Leviton

KNX

Gateway rules

Users

Name:

Number:

Porch Light

Object properties

Gateway rule 4

Porch Light Rule 1

Foyer Light Rule 1

Thermostat 1

Gateway rule 4

Type:

ON/OFF

EDIT

PORCH LIGHT (STATE )

WRITE

KNX 0/0/2

VALUE 0

PORCH LIGHT

ON/OFF

LEVITON S&A UNIT 1

ON/OFF 00

VERSION 1.0.0

Setup

PORCH LIGHT (STATE)

WRITE

KNX 0/0/2

VALUE 0

Leviton

KNX

Gateway rules

Users

Gateway rule 4

Porch Light Rule 1

Foyer Light Rule 1

Thermostat 1

Gateway rule 4

PORCH LIGHT

ON/OFF

LEVITON S&A UNIT 1

ON/OFF 0

PORCH LIGHT (CMD)

WRITE

KNX 0/0/1

VALUE 00

In order to connect items to each other:

a. Place your mouse pointer over the

outstanding square part of an "output" node

of a block (right side).

b. Click and hold the left mouse button while

you move to an "input" node of another block

(left side); an arrow is drawn dynamically.

c. Release when the pointer is on the

outstanding square part of the "target" node.

Once connected, nodes appear as follows:

Each item can appear only once inside a gateway

rule, and each node can be associated with only

one connection per rule. If necessary, consider

creating a new gateway rule with the same item(s).

To display the most important attributes of an

item, right-click on the block. The block becomes

highlighted and its information is displayed on the

Object properties side menu.

Drag area Drop area

KITCHEN LIGHT (STATE)

KNX

10/0/2

UNIT 1

ON/OFF

LEVITON S&A UNIT

ON/OFF 00WRITE VALUE

Connection source node Connection target node

KITCHEN LIGHT (STATE)

KNX

10/0/2

UNIT 1

ON/OFF

LEVITON S&A UNIT

ON/OFF 00WRITE VALUE

More details can be found on the item’s details page, accessible by pressing the Edit button. When an item, or a

connection, is selected, it is possible to remove it from the gateway rule, by pressing the [Delete] key on the keyboard.

On/Off An immediate toggle command is sent

Multiple Values The node cycles between values, by sending corresponding commands with each double-click

Free Value Enter a value in the input ﬁeld; corresponding command is sent when pressing [ENTER]

Drag areaInput node

(command)

KNX group address

Name Drop area Command area

of output node

KITCHEN LIGHT (CMD)

KNX

10/0/1

KITCHEN LIGHT (CMD)

KNX

10/0/1

WRITE VALUE WRITE VALUE

On/Off nodes change their color according

to the value (0=gray, 1=yellow). Numeric

nodes are always drawn in blue.

KITCHEN LIGHT (STATE)

KNX

10/0/2

UNIT 1

LEVITON S&A UNIT

ON/OFF ON/OFF 0

WRITE VALUE 0

On the other side, in order to update the

Omni controller of a changed value on

KNX bus for its address, you must create a

connection from its output node (right side),

as in the following example:

In order to send a value to the KNX bus

on its group address, you must create a

connection having its input node (left side)

as target, as in the following example:

KITCHEN LIGHT (CMD)

KNX

10/0/1

UNIT 1

LEVITON S&A UNIT

ON/OFF ON/OFF 0

WRITE VALUE0

Below is an example of a complete bi-directional gateway rule between a unit (On/Off) and a KNX light:

KITCHEN LIGHT (STATE)

KNX

10/0/2

UNIT 1

LEVITON S&A UNIT

ON/OFF ON/OFF 0

WRITE VALUE

KITCHEN LIGHT (CMD)

KNX

10/0/1

WRITE VALUE

Omni Units appear in a gateway rules as follows:

The Users page allows you to change the login credentials for the web interface. Enter a new username and password.

NOTE: Only letters and numbers are allowed in the password (no space or special characters).

Omni Controller Setup

To conﬁgure the KNX Gateway, the Omni controller must be utilizing controller ﬁrmware 3.11 or later:

1. If KNX thermostats or temperature devices are used, conﬁgure the serial port on the Omni controller to "KNX".

2. Any thermostats that will be associated with the KNX system must be changed to use "KNX". Change the Protocol

Address for each thermostat to "KNX".

IP Address Restore

To restore IP address of the KNX Gateway to its factory default IP address:

1. Press the Reset Button for 10 seconds (until the red Reset/Service LED starts blinking), then release.

2. Within the next 5 seconds, press the Reset Button again for 1 second, then release; the red Reset/Service LED will

turn ON for a few seconds.

3. When red Reset/Service LED turns off, cycle the power to the KNX Gateway.

4. Upon reboot, the IP address of the KNX Gateway will be: 192.168.0.110

If the Reset/Service LED turns off after the ﬁrst long press, repeat the entire procedure.

Resetting to Factory Default

To reset the KNX Gateway to its factory default conﬁguration:

1. Press Reset button for 10 seconds, (until red Reset/Service LED starts blinking), then release.

2. Within the next 5 seconds, press and hold the Reset Button again for 10 seconds (until the red Reset/Service LED

turns ON continuously).

3. Release RESET button and wait until red Reset/Service LED turns OFF.

4. When red Reset/Service LED turns off, cycle the power to the KNX Gateway.

5. Upon reboot, all previously saved conﬁguration will be cleared the KNX Gateway will be restored to its factory default

conﬁguration.

If the Reset/Service LED turns off after the ﬁrst long press, repeat the entire procedure.

Supported Web Browsers

When accessing the KNX Gateway web interface, the Google Chrome or Apple Safari web browser must be used.

UNIT 1

LEVITON S&A UNIT

ON/OFF ON/OFF 0

VALUE VALUE 00

Name

Unit number

Input node for ON/OFF Output node for ON/OFF

Input node for % value Output node for % value

Symbol

THERMOSTAT 1

LEVITON S&A THERMOSTAT

GENERAL GENERAL

TEMPTEMP00

SYSMODE SYSMODE

FAN MODE FAN MODE

ALARMALARM

HOLD HOLD

HEATING HEATING

HEAT STP HEAT STP

2020

HEAT ON/OFF HEAT ON/OFF

COOLING COOLING

ON/OFF ON/OFF 2424

COOL ON/OFF COOL ON/OFF

HUMIDIFICATION HUMIDIFICATION

HUMIDITY HUMIDITY 00

HUMSTP HUMSTP 00

DEHUMSTP DEHUMSTP

DEHUMON/OFF DEHUMON/OFF

General input nodes

Humidiﬁcation

input nodes

Heating & cooling

input nodes

General output nodes

Humidiﬁcation

output nodes

Heating & cooling

output nodes

Thermostat number

GATEWAY RULES

INSTANT COMMANDS

USERS

After the Omni devices and KNX objects have been deﬁned, the next step is to deﬁne gateway rules between the KNX bus

and the Omni controller.

Each rule can contain one or more connections among KNX objects and Omni devices, in both directions. When an item’s

attribute is connected to another one, each time its value changes, the value is sent to the other item.

To create a Gateway rule:

a. Select Gateway Rules in the menu tree.

b. Press the + icon on the bottom-left of the interface.

c. Select the new gateway rule in the menu tree and press the shortcut icon beside its name in the menu.

It is possible to send instant commands to a block, once they have been dropped into a Gateway rule, by double clicking on

the white square portion of an output node (containing the value):

FOR CANADA ONLY

For warranty information and/or product returns, residents of Canada should contact Leviton in writing at Leviton Manufacturing of Canada Ltd to the

attention of the Quality Assurance Department, 165 Hymus Blvd, Pointe-Claire (Quebec), Canada H9R 1E9 or by telephone at 1 800 405-5320.

Licensed under one or more of the following U.S. Pat. Nos. 7,457,250; 8,155,012; 8,902,760; 8,942,107; and 9,049,019.

For Technical Assistance Call: 1-800-824-3005 (U.S.A. Only) www.leviton.com

LEVITON LIMITED WARRANTY

Leviton warrants to the original consumer purchaser and not for the beneﬁt of anyone else that products manufactured by Leviton under the Leviton brand name (“Product”) will be free from defects in material and workmanship for the time periods indicated below, whichever is shorter: • OmniPro II and Lumina

Pro: three (3) years from installation or 42 months from manufacture date. • OmniLT, Omni IIe, and Lumina: two (2) years from installation or 30 months from manufacture date. • Thermostats, Accessories: two (2) years from installation or 30 months from manufacture date. • Batteries: Rechargeable batteries

in products are warranted for ninety (90) days from date of purchase. Note: Primary (non-rechargeable) batteries shipped in products are not warranted. Products with Windows

Operating Systems: During the warranty period, Leviton will restore corrupted operating systems to factory default at no charge,

provided that the product has been used as originally intended. Installation of non-Leviton software or modiﬁcation of the operating system voids this warranty. Leviton’s obligation under this Limited Warranty is limited to the repair or replacement, at Leviton’s option, of Product that fails due to defect in material or

workmanship. Leviton reserves the right to replace product under this Limited Warranty with new or remanufactured product. Leviton will not be responsible for labor costs of removal or reinstallation of Product. The repaired or replaced product is then warranted under the terms of this Limited Warranty

for the remainder of the Limited Warranty time period or ninety (90) days, whichever is longer. This Limited Warranty does not cover PC-based software products. Leviton is not responsible for conditions or applications beyond Leviton’s control. Leviton is not responsible for issues related to improper

installation, including failure to follow written Installation and operation instructions, normal wear and tear, catastrophe, fault or negligence of the user or other problems external to the Product. To view complete warranty and instructions for returning product, please visit us at www.leviton.com.