Universal Gateway. Manual. UGW//maxi UGW//compact UGW//micro UGW//nano25

(1)

Universal Gateway

Manual

UGW//maxi

UGW//compact

UGW//micro

UGW//nano25

Version 1.0 18.06.2014

(2)

MBS GmbH Phone: +49 2151 7294-0

Content

1. Preface ... 5

2. Bibliography ... 6

2.1. Interesting links on BACnet in the World Wide Web ... 7

2.2. Registered trade marks ... 7

2.3. Copyright ... 7

2.4. Revision of document ... 8

3 UGW Universal Gateway ... 8

3.1 Type label ... 8

3.2 Number of data points ... 8

4 Connections and controls ... 9

4.1 UGW maxi ... 9

4.1.1 UGW//maxi connections and controls ... 9

4.1.2 Startup phase ... 11

4.1.3 Resetting UGW//maxi ... 11

4.1.4 Operating the reset button ... 11

4.1.5 LED power indicator ... 11

4.1.6 LED status indicator ... 11

4.1.7 LED orange network indicator ... 12

4.1.8 LED green network indicator ... 12

4.1.9 Interfaces ... 13

4.2 UGW compact ... 15

4.2.1 Connections and controls ... 15

4.2.2 Startup phase ... 16

4.2.3 Resetting UGW//compact ... 17

4.2.5 Restart ... 17

4.2.7 MS/TP TxD LED indicator ... 17

4.2.8 RxD LED MS/TP RxD LED indicator ... 18

4.2.10 LED orange network indicator... 18

4.3 UGW//micro / UGW//nano 25 ... 18

(3)

4.3.2 UGW//micro RS485 / UGW//nano 25 RS485 ... 18

4.3.3 UGW//micro KNX RS485 / UGW//nano 25 KNX RS485 ... 20

4.3.4 UGW//micro MBus RS485 / UGW//nano 25 MBus RS485 ... 21

4.3.5 UGW//micro PROFINET RS485 / UGW//nano 25 PROFINET RS485 ... 22

4.3.7 UGW//micro RS232 / UGW//nano 25 RS232 ... 23

4.3.8 UGW//micro KNX RS232 / UGW//nano 25 KNX RS232 ... 24

4.3.9 UGW//micro MBus RS232 / UGW//nano25 MBus RS232 ... 25

4.3.10 UGW//micro PROFINET RS232 / UGW//nano 25 PROFINET RS232 ... 26

4.4 Startup phase ... 27

4.4.1 Resetting UGW//micro … / UGW//nano 25 … ... 27

4.4.3 Restart ... 27

4.4.5 MS/TP TxD LED indicator ... 28

4.4.6 RxD LED MS/TP RxD LED indicator ... 28

4.4.8 LED orange network indicator ... 28

5 Introduction ... 29

5.1 MS/TP or RS485 network installation ... 30

5.2 Connection to web server ... 31

5.3 Connection check... 31

5.4 Calling up the Gateway web server ... 34

5.5 Web browser support ... 35

6 User interface and functions ... 36

6.1 Data points ... 37

6.2 Driver ... 40

6.3 Log files ... 40

6.4 System status ... 41

6.5 Setup ... 42

6.6 Transferring configuration files ... 42

6.7 Transferring all files at once ... 43

6.8 Change password ... 44

6.9 Setting date and time ... 44

6.10 NTP setup ... 45

(4)

MBS GmbH Phone: +49 2151 7294-0

6.12 Changing Project ID ... 46

6.13 Restart the Software ... 46

6.14 Restart the system ... 46

6.15 Configuration files ... 46

6.16 Software update ... 47

7. Protocol properties and data points ... 48

7.1 Control via configuration data ... 48

7.2 Classification of protocols ... 51

7.3 Property and data point definitions ... 51

7.4 Client-server relationship, data points... 52

7.5 Actual values — set values data points ... 52

7.6 Analog – binary – multi-level – more complex types, data points ... 52

7.7 Abstract data point in data point system ... 52

7.8 Structuring technical addresses ... 53

7.9 Routing address ... 53

7.10 Data point type as part of address ... 53

7.11 Data point types ... 53

7.12 Address identification as part of address ... 53

7.13 Protocol-specific address ... 54

7.14 Mapping possibilities ... 55

8 Configuration ... 56

8.1 Data point files ... 56

8.2 Configuration files ... 57

8.3 Schematic file ... 57

8.4 Status LED ... 58

8.5 Typical data point schemata ... 58

6. Information for administrators ... 61

7. FAQ ... 62

(5)

1. Preface

Thank you for using an UGW Universal Gateway. This manual describes the series UGW//maxi, UGW//compact, UGW//micro und UGW//nano 25.

A gateway is used to enable communication between devices that use different

communications protocols. It’s typical area of application is for technical building service equipment. Communication partners are, for example, control systems, DDC systems, control systems for refrigeration and heat power stations, room control, safety equipment such as fire or burglar alarm systems, lighting control and others. For various reasons, these systems use different communication protocols. The protocols used are variably well suited for different purposes. They differ in speed, complexity, number of connectable devices, range, and the type of information transmitted.

(6)

MBS GmbH Phone: +49 2151 7294-0

Schematic design of a gateway

The following diagram schematically describes the functions and modules of a gateway.

2. Bibliography

http://www.ashrae.org/

ANSI/ASHRAE Standard 135-2001 BACnet – A Data Communication Protocol for Building Automation and Control Networks:

This is ASHRAE’s official standard reference for BACnet. It covers the entire ASHRAE 135-2001 Standard (BACnet). There are several enhancements and attachments, which can be downloaded from the BACnet website (http://www.bacnet.org).

This information can be obtained from:

Promoter-Verlag, Postfach 211 053, D-76 160 Karlsruhe, http://www.cci-promotor.de or

(7)

Purchased directly from the ASHRAE online bookstore: http://www.ashrae.org/

2.1. Interesting links on BACnet in the World Wide Web

• www.bacnet.org

Official homepage of ASHRAE for BACnet

This is probably the most important source for technical information about BACnet. • www.bacnet.de

European BACnet Interest Group homepage, including information on activities and events of the BACnet Interest Group e.V.

• www.mbs-software.de

MBS GmbH homepage with information on BACnet products, fieldbus gateway products and software developments.

2.2. Registered trade marks

Trademarks and product names of various companies will be used in this book. The following names are the registered trademarks of their respective manufacturers and will not be mentioned separately in this book:

• Microsoft, Windows and MS-DOS are registered trademarks of the Microsoft Corporation

• BACnet and ASHRAE are registered trademarks of the American Society of Heating, Refrigerating and Air-Conditioning Engineers, INC. (ASHRAE)

• Intel and Pentium are registered trademarks of the Intel Corporation • BACstac is a registered trademark of Cimetrics, Inc.

• ARCnet is a registered trademark of the Datapoint Corporation

• IBM-PC and IBM-AT are registered trademarks of the International Business Machines Corporation (IBM)

• LONTalk is a registered trademark of Echelon, Inc.

2.3. Copyright

(8)

MBS GmbH Phone: +49 2151 7294-0 D-47809 Krefeld, Germany Phone: +49 / 21 51 / 72 94 - 0 Fax: +49 / 21 51 / 72 94 - 50 Email: info@mbs-software.de Internet: http://www.mbs-software.de

photocopy, or by any other method) or processed, copied or distributed electronically, without written permission by MBS GmbH.

2.4. Revision of document

Revision - no. Date Author Comment

0.1 05.01.2011 ane

0.2 11.03.2011 ane COM3 changed

configuration

0.3 07.04.2011 ane

0.4 11.04.2011 ane Corrections

0.5 18.08.2011 ane Pictures changed

0.6 05.12.2011 ane English version

1.0 18.06.2014 ane All gateways

included

3 UGW Universal Gateway

3.1 Type label

The label contains the name of the gateway, the comprised protocols including the corresponding interface, project ID, MAC address, standard IP address, part number and serial number.

3.2 Number of data points

The number of data points available is determined by the device type. It counts the number of files in dispatch.txt with the keyword target = different registered addresses.

(9)

4 Connections and controls

4.1 UGW maxi

4.1.1 UGW//maxi connections and controls

The following figure shows the front panel of the UGW//maxi

DC-Power Power supply

1 V+ 9-30VDC 2 V- GND RS232-1 RS232 interface 1 DCD 2 RXD Input 3 TXD output 4 DTR 5 GND 6 DSR 7 RTS output 8 CTS input 9 RI Baudrate 600,9600,19200,38400,57600,115200 Baud RS232-3 RS232 interface 1 DCD 2 RXD input 3 TXD output 4 DTR 5 GND 6 DSR 7 RTS output 8 CTS input 9 RI

(10)

MBS GmbH Phone: +49 2151 7294-0

RS485-4 RS485

1 100 Ohm termination 2 DATA + Non-inverted output 3 DATA - Inverted output 4 +5V

5 GND 6 7 8

(contact 1-2 for scheduling bridge)

Baudrate 600,9600,19200,38400,57600,76800,115200 Baud

RS485-5 RS485

1 100 Ohm termination 2 DATA + Non-inverted output 3 DATA - Inverted output 4 +5V

5 GND 6 7 8

(contact 1-2 for scheduling bridge)

Baudrate 600,9600,19200,38400,57600,76800,115200 Baud D-In/Out Digital inputs / outputs

1 GND Digital outputs 2 GND for digital inputs 3 Digital input 1 (max. 50VDC) 4 Digital input 2 (max. 50VDC) 5 Digital input 3 (max. 50VDC) 6 V + for digital output (max. 40V) 7 Digital Output 1 (max. 40VDC, 0.5A) 8 Digital Output 2 (max. 40VDC, 0.5A)

VGA VGA port

Port for screen devices with VGA signal

Reset Reset-button

PWR LED lights green when the unit is on

HDD LED for HDD access

Status Status - LED

LAN1 RJ45 10/100 MBit/s Ethernet

Displays a link to LAN connection 10/100 Displays the connection speed

LAN2 RJ45 10/100 MBit/s Ethernet

USB1 USB 2.0 for example device LON USB Adapter

(11)

Specification

Operating voltage: 9-30Volt DC, 1000mA max. Weight: about 1100g

Dimensions: Height: 60mm Width: 195mm, depth: 130 mm Ambient temperature: 0 .. 45 ° C, 32 ... 113 ° F

Ambient humidity: 20 .. 80 percent relative humidity, noncondensing Mounting: DIN-rail TS 35 according to EN50022

When mounting a lateral distance of 15 mm is to keep other devices.

4.1.2 Startup phase

After connecting to the power supply begins the start up phase of the UGW//maxi. The device is designed for continuous operation 24 / 7 and must not be turned on separately. If you like to set the UGW//maxi power off, disconnect the green power connector from the device.

4.1.3 Resetting UGW//maxi

Reset Briefly press the reset button and then let go again. The status LED

lights up in red for 2 seconds, then the restart takes place. In the startup phase the status LED remains orange.

Reset with IP default address

Hold down the reset button for 5 seconds but not longer than 10 seconds. The status LED flashes green and the gateway is set to the default IP address until the next reboot. (169.254.0.1)

DHCP To activate the built-in DHCP server, press the reset button for longer

than 10 seconds but not more than 15 seconds. The status LED flashes green/red alternately when the DHCP server is enabled. While the DHCP server is active, the default is set to the IP address. (169.254.0.1)

4.1.4 Operating the reset button

Restart of gateway Reset with default IP address Restart with DHCP server activation

0-5 seconds 5-10 seconds 5-15 seconds

4.1.5 LED power indicator

The power LED lights up green when the power is connected and goes off in the absence of a power supply.

4.1.6 LED status indicator

Normaler Zustand LED flashes in 2 sec rhythmus

Fatal Error LED lights up constantly

(12)

MBS GmbH Phone: +49 2151 7294-0

DHCP-Server aktiv LED flashes (1s on, 0,5s off,...)

4.1.7 LED orange network indicator

The orange network LED is located in the right part of the RJ-45 connection and displays the following states:

4.1.8 LED green network indicator

The green LED network indicator is located in the left part of the RJ-45 connection and displays the following states:

LED OFF indicates no connection

LED ON indicates connection to network

LED flashing indicates network activity

LED OFF indicates a connection to 10Mbit/s

(13)

4.1.9 Interfaces

LAN1, LAN2

These RJ-45 connectors are used to connect the UGW / / maxi to the Ethernet network. Use a crossover network cable when you want to use your notebook for configuration. If you want to connect the UGW / / maxi to a network, use a CAT5e patch cable (or similar, not supplied).

! Attention !

Please note that configurations with BACnet protocol: The BACnet driver use by default the LAN interface eth0 (LAN1). If the LAN port 2 (eth1) is used, it should be

noted in the bac.cfg. RS485 connection with termination and bias

(14)

MBS GmbH Phone: +49 2151 7294-0

Digital inputs and outputs

The UGW maxi has 3 digital inputs and 2 outputs. The digital inputs are isolated up to 2500Volt. Low level 0-3V, high-level 10-50Volt. The outputs has 0.5A / 40V DC.

(15)

4.2 UGW compact

4.2.1 Connections and controls

The following figure shows the front panel of the UGW//compact

Power Power supply

1 PE PE

2 V + +24 VDC or 24VAC 3 V-GND or 24VAC

Digout Contact output, relay contacts, max 230V/2A 1 N0 make contact

2 common

3 NC break contact

The LED indicates the switching status Digin Input for potential-free contact

1 /2 contact inputs

The LED located on the connector shows the input state

Com3 RS485 1 B+ Non-inverting input 2 A- Inverting input 3 GND Com2 RS232 1 RTS Output 2 CTS Input 3 RXD Input 4 TXD Output 5 GND Com1 RS232 1 DCD 2 RXD Input 3 TXD Output 4 DTR 5 GND 6 DSR 7 RTS Output 8 CTS Input 9 RI

(16)

MBS GmbH Phone: +49 2151 7294-0

LAN RJ45 10/100 MBit Ethernet Displays a link to LAN connection 10/100 Displays the connection speed Specification

Operating voltage: 12-24V AC / DC, 1000mA max. Weight: about 350g

Dimensions: Height: 40mm Width: 170mm, depth: 75.5 mm (including DIN- rail) Ambient temperature: 0 .. 45 ° C, 32 ... 113 ° F

Stand: 03.11.2011

LAN

This RJ-45 connector is used to connect the UGW//compact to the Ethernet network.

Connect the crossover network cable here, if you want to use your notebook for configuration. When you want to connect the UGW//compact to a network, please use a CAT5e patch cable or comparable (not included in delivery).

DIP switch

The built-in DIP switches allow easy adjustment of the bus termination and the network bias (bias = pull-up resistors) in MS/TP networks.

Please note: The DIP switches are activated when these are in the upper position (marked with the designation "on"). The default setting for all DIP switches is inactive (off).

The two-network bias resistors S1 and S2 should always be turned on and off together; avoid switching one to active resistance, while the other is deactivated!

1 Bias S1 and S2 provide the 560 ohm resistance

for the bias network setting. In an MS/TP or RS485 segment at least one, but a maximum of two pairs of network bias resistors must be present.

2 Bias Functions as S1, always use S1 and S2

together!

3 Term The end of each MS/TP segment in the

networks must be terminated. This switch provides a 120 ohm switchable terminating resistor. Use this switch only when the UGW//compact is located at the end of a segment!

4.2.2 Startup phase

After connecting to the power supply begins the start up phase of the UGW///compact. The device is designed for continuous operation 24 / 7 and must not be turned on separately. If

(17)

you like to set the UGW//compact power off, disconnect the green power connector from the device.

4.2.3 Resetting UGW//compact

Factory reset To return the UGW//compact back to the default setting, press and

hold the reset button for longer than 15 seconds. The status LED flashes orange, after copying the factory configuration a restart will commence.

This function is currently not supported!

4.2.4 Operating the reset button

4.2.5 Restart

It takes UGW//compact about 25s to restart.

In this phase there is no Ethernet or MS/TP communication.

4.2.6 LED power indicator

4.2.7 MS/TP TxD LED indicator

(18)

MBS GmbH Phone: +49 2151 7294-0

4.2.8 RxD LED MS/TP RxD LED indicator

The MS/TP RxD LED lights up yellow when data is received from the MS/TP network.

4.2.9 LED status indicator

The status LED is a multi-colored LED for the following conditions:

Continuous green: Displayed when the reset button is held down.

Flashing green: Indicates normal operation.

Flashing green/red: Indicates active DHCP server.

Continuous orange: Appears during restart for approx. 25s.

Flashing orange: Appears after start up phase, if the UGW//compact has not

been configured yet.

Flashing red: Displayed at bus errors in the MS/TP network (e.g. framing

errors).

Continuous red: Appears before a reset, when files are closed.

4.2.10 LED orange network indicator

4.2.11 LED green network indicator

4.3 UGW//micro / UGW//nano 25

4.3.1 Connections and controls

4.3.2 UGW//micro RS485 / UGW//nano 25 RS485

(19)

PE PE protective earth terminal with M3 screw

LAN RJ45 10/100 MBit/s Ethernet

PWR - Power Power supply

1 V + +12 to +24 V DC or 12 to 24V AC 2 V-GND or 12 to 24V AC COM1 RS485 1 B+ Non-inverting input 2 A- Inverting input 3 GND 4 PE

DIP- Switch 1 Bias provide the 560 ohm resistance for the bias network setting. In an MS/TP or RS485 segment at least one, but a maximum of two pairs of network bias resistors must be present.

2 Bias Functions as S1, always use S1 and S2 together! 3 120 Ohm the end of each MS/TP segment in the networks

must be terminated. This switch provides a 120 ohm switchable terminating resistor. Use this switch only when the UGW//micro is located at the end of a segment!

LED 1 Power lights up when the device is connected to a suitable operating voltage

2 flashes when the unit is receiving data 3 multi-color status LED

4 Flashing when the device sends data Specification

Operating voltage: 12-24V AC / DC, 200mA max. Weight: 250g

Dimensions: Height: 100mm, Width: 31mm, Depth: 70mm (including DIN-DIN rail) Ambient temperature: 0 .. 45 ° C, 32 ... 113 ° F

(20)

MBS GmbH Phone: +49 2151 7294-0

4.3.3 UGW//micro KNX RS485 / UGW//nano 25 KNX RS485

1 V + +12 to +24 V DC or 12 to 24V AC 2 V-GND or 12 to 24V AC COM1 RS485 1 B+ Non-inverting input 2 A- Inverting input 3 GND 4 PE KNX + KNX connection + KNX connection - - KNX connection - KNX connection

4 Flashing when the device sends data 5 KNX Rx

6 KNX Tx 7 KNX Power

(21)

Specification

4.3.4 UGW//micro MBus RS485 / UGW//nano 25 MBus RS485

LAN RJ45 10/100 MBit Ethernet

Link displays LAN connection 10/100 displays link speed

1 V+ +12V - +24VDC or 12V - 24VAC 2 V- GND or 12V - 24VAC COM1 RS485 1 B+ non-inverted input 2 A- inverted input 3 GND

MBus + MBus connection

+ MBus connection - MBus connection - MBus connection

DIP-switch 1 Bias provide the 560 ohm resistance for the bias network setting. In an MS/TP or RS485 segment at least one, but a maximum of two pairs of network bias resistors must be present.

2 Bias Functions as S1, always use S1 and S2 together!

3 120 Ohm the end of each MS/TP segment in the networks must be terminated. This switch provides a 120 ohm switchable terminating resistor. Use this switch only when the UGW//micro is located at the end of a segment!

(22)

MBS GmbH Phone: +49 2151 7294-0

LED 1 Power LED

2 Flashes when the unit is receiving data 3 Multicolor status LED

4 Flashes when the device sends data 5 MBus Rx

6 MBus Tx 7 MBus Overload Specification

4.3.5 UGW//micro PROFINET RS485 / UGW//nano 25 PROFINET RS485

1 V + +12 to +24 V DC or 12 to 24V AC 2 V-GND or 12 to 24V AC COM1 RS485 1 B+ Non-inverting input 2 A- Inverting input 3 GND 4 PE

PROFINET1 PROFINET Version 2.3 RT, IRT

Activity Link

PROFINET 2 PROFINET Version 2.3 RT, IRT Activity

(23)

4 Flashing when the device sends data 5 PROFINET Maintance

6 PROFINET Ready

7 PROFINET System failure 8 PROFINET Bus failure Specification

4.3.7 UGW//micro RS232 / UGW//nano 25 RS232

PE PE protective earth terminal with M3 screw

1 V + +12 to +24 V DC or 12 to 24V AC 2 V-GND or 12 to 24V AC

COM1 RS232

1 TxD transmit line of the RS232 interface. 2 RxD receive line of the RS232 interface 3 GND Ground connection of the RS232 interface

(24)

MBS GmbH Phone: +49 2151 7294-0

DIP-Switch 1 not used

2 not used 3 not used

4.3.8 UGW//micro KNX RS232 / UGW//nano 25 KNX RS232

COM1 RS232

1 TxD transmit line of the RS232 interface. 2 RxD receive line of the RS232 interface

3 GND Ground connection of the RS232 interface

4 Shld ground connection of the cable shield is connected to PE

KNX + KNX connection

+ KNX connection - - KNX connection - KNX connection

(25)

4.3.9 UGW//micro MBus RS232 / UGW//nano25 MBus RS232

LAN RJ45 10/100 MBit Ethernet

Link displays LAN connection 10/100 displays link speed

1 V+ +12V - +24VDC or 12V - 24VAC 2 V- GND or 12V - 24VAC

COM1 RS232

MBus + MBus connection

+ MBus connection - MBus connection - MBus connection DIP-Schalter 1 not in use

2 not in use 3 not in use

(26)

MBS GmbH Phone: +49 2151 7294-0

LED 1 Power LED

2 Flashes when the unit is receiving data 3 Multicolor status LED

4 Flashes when the device sends data 5 MBus Rx

6 MBus Tx 7 MBus Overload Specification

4.3.10 UGW//micro PROFINET RS232 / UGW//nano 25 PROFINET RS232

COM1 RS232

PROFINET1 PROFINET Version 2.3 RT, IRT

Activity Link

PROFINET 2 PROFINET Version 2.3 RT, IRT Activity

Link

(27)

LED 1 Power lights up when the device is connected to a suitable operating voltage 2 flashes when the unit is receiving data 3 multi-color status LED

4 Flashing when the device sends data 5 PROFINET Maintance

6 PROFINET Ready

7 PROFINET System failure 8 PROFINET Bus failure Specification

4.4 Startup phase

After connecting to the power supply begins the start up phase of the Gateway. The device is designed for continuous operation 24 / 7 and must not be turned on separately. If you like to set the Gateway power off, disconnect the green power connector from the device.

4.4.1 Resetting UGW//micro … / UGW//nano 25 …

4.4.2 Operating the reset button

4.4.3 Restart

It takes Gateway about 25s to restart.

In this phase there is no Ethernet or MS/TP communication.

(28)

MBS GmbH Phone: +49 2151 7294-0

4.4.5 MS/TP TxD LED indicator

The MS/TP TxD LED lights up yellow when data is sent to the MS/TP network.

4.4.6 RxD LED MS/TP RxD LED indicator

The MS/TP RxD LED lights up yellow when data is received from the MS/TP network.

4.4.7 LED status indicator

The status LED is a multi-colored LED for the following conditions:

Continuous green: Displayed when the reset button is held down.

Flashing green: Indicates normal operation.

Flashing green/red: Indicates active DHCP server.

Continuous orange: Appears during restart for approx. 25s.

Flashing orange: Appears after start up phase, if the UGW//compact has not

been configured yet.

Flashing red: Displayed at bus errors in the MS/TP network (e.g. framing

errors).

Continuous red: Appears before a reset, when files are closed.

4.4.8 LED orange network indicator

4.4.9 LED green network indicator

(29)

5 Introduction

Necessary tools

To install the Gateway, you will need the following tools: - These instructions (included with delivery)

- Notebook PC with the following specifications: Built-in or external network interface card,

Installed web browser, (a list of tested browsers can be found at the end of this chapter)

Installed PDF reader, e.g. Foxit PDF Reader, PDF-XChange Viewer, Adobe Acrobat Reader.

Crossover network cable.

The concept of the Gateway configuration

The Gateways provides a conveniently built-in web server that allows for easy configuration. This manual describes the steps required to access the web server.

All documents necessary for further settings, including the user manual, can be found in the help directory of the web server. These can be viewed using the Adobe Acrobat Reader and printed on demand.

Electrical installation

Connect the Gateway to a power supply according to the technical specifications within this document. An international power supply is optionally available if required. The warranty becomes void if the UGW//compact is connected to an inadequate power supply or the casing is opened. There are no controls inside the casing.

Ethernet network installation

Connect the Ethernet network cable (RJ-45 connector) to the UGW//compact. Use CAT5 UTP or STP cable (or equivalent). Avoid laying cables parallel to power lines, e.g. to motors, frequency inverters, etc.

Do not connect to a network before the Gateway has been fully configured. Use the crossover network cable for configuration.

(30)

MBS GmbH Phone: +49 2151 7294-0

5.1 MS/TP or RS485 network installation

Connect the MS/TP or RS485 network to the orange plug. Observe the instructions for connecting MS/TP or RS485 networks according to 135-2004 (BACnet standard). The Gateway network will provide bias and termination resistors if necessary.

(31)

5.2 Connection to web server

Overview

An IP connection between the notebook and the UGW//compact must be established in order to access the internal web server.

The web server provides the configuration settings in the form of websites.

If your notebook PC is set up as a DHCP client (the default), you can use the gateway to provide an IP address. Connect the crossover network cable to your notebook PC, the IP address is assigned automatically.

Activating the DHCP server (optional)

On request the DHCP = Dynamic Host Configuration Protocol, automatically provides IP addresses to clients. If your notebook PC is set as a DHCP client (the default), you can use the DHCP server of the gateway to provide an IP address. Press and hold the gateway reset switch for at least 10 but not more than 15 seconds. When the status LED flashes green/red alternately, the DHCP server is enabled.

Then connect the crossover network cable to your notebook PC, the IP address will be assigned automatically.

Using a manual IP address

If you plan to use an IP-address manually, please set your PC to the following settings:

IP address: 169.254.0.2 (or higher)

Subnet mask: 255.255.0.0

Standard gateway: enter nothing

5.3 Connection check

(32)

MBS GmbH Phone: +49 2151 7294-0

The standard IP address of the UGW//compact is 169.254.0.1; to test the connection, use the ping command.

Open a command prompt and type in the following command: Ping 169.254.0.1 <ENTER>

The UGW//compact responds with an output of the time period: Reply from 169.254.0.1: bytes = 32 time <1ms TTL = 64

(33)

If there is no answer, or an error is indicated in the connection, please check the network settings using the command:

ipconfig / ALL <ENTER >

(34)

MBS GmbH Phone: +49 2151 7294-0

5.4 Calling up the Gateway web server

To access the configuration pages of the Gateway web server, launch your preferred web browser and type the IP address 169.254.0.1 into the address field. Then enter your username and password.

Default setting on delivery: Username: gw

Password: GATEWAY

The password can be changed in the menu item Setup. The homepage of Gateway is called up and displayed.

(35)

5.5 Web browser support

The integrated web server has been tested with various browsers and operating systems and has been approved If you have problems with your preferred browser, please notify MBS Support. Please indicate the exact browser version, the exact version of the operating system and a brief description of the problem for the diagnosis.

Browser support

Browser From this version on or later

Internet Explorer 6.0.2900.2180 Mozilla Firefox 2.0.0.14 Opera 9.50 Safari 3.1.1 (525.17) Epiphany 1.8.5 Google Chrome 0.4.154.25

(36)

MBS GmbH Phone: +49 2151 7294-0

6 User interface and functions

De En Change language: German or English

Home Call up homepage

Data points Projected data points and current values display Drivers Installed drivers and protocols display

Log files Log files, value changes and diagnosis output display System status System status display

Setup Display and change in configuration, restart of system Configuration Files Display and transfer configuration files.

(37)

6.1 Data points

Indicator of projected data points including address, timestamp, status, and current value. Lists starting from data point: Here a selection as to from which data point the data

point list should be compiled, can be made. Number of data points per page: Number of data points displayed per page.

Refresh every: Time interval at which the output values will be updated.

The value of the data points can be assigned to the following status flags:  Valid value V

 Sensor fault F

 Incorrect data point E

 Local operator value L

 Set value/actual value automatic mode -

 Locked, cannot be changed at the moment O

 Upper limit warning W

 Upper limit alarm A

 Upper range of values S

 Lower limit warning w

 Lower limit alarm a

 Lower value range s

 Historical value H

 Value has changed c

 Definition of new data point N

(38)

MBS GmbH Phone: +49 2151 7294-0

 Definition of changed data point C

Using the filter functions, “by data point address" and "by data point name", “Search” can be filtered by data point addresses or data point names. Under the item "Show all data points again", the filter function is turned off.

Show search rules

The web gateway search uses "regular expressions" to make even complex searches simple. A regular expression forms a search pattern by which matching patterns can be searched for in the text. This type of search varies a lot, which is why a full description cannot be given here.

A brief description of special characters in a term is given below. For more information, please see the POSIX 1003.2 standard or – on UNIX systems – in the egrep (1) or regex (7)

documentation.

The most important rules for a search of data points on a gateway:

 The main element of a regular term is an element that matches a character. Almost all the characters, e.g. letters and numbers, are such elements. Also, all special characters can lose their special meaning when a "\" character is prefixed.

 There is no distinction between upper and lower case letters.

 A dot (.) always represents any character.

 A group of characters can be defined with the [and] character. A match between the search pattern and the text to be searched in this case is successful if one of the characters in the search group is found in the text which is being searched.

 . If the first character in the search group is a circumflex ^, the search is reversed. Example: The term [0123456789] represents a digit, and [^.] means everything except one point.

 The same expression can be written more briefly if it is defined as a range: [0-9]. If the minus sign should appear in the text, it must be placed in front or behind the term: [-0-9].

 Outside a search group the sign ^ circumflex and dollar $ are operators representing a beginning or ending of a line. Example: "^11" is any line that begins with "11", and "22$" every line ending with "22".

 An element can follow one of the following repeated operations: ? - The upcoming element is optional.

* - The upcoming element can occur 0 or more times. + - The upcoming element can occur one or more times.

(39)

 Two expressions can be composed by one |-operator. The entire term finds the line that corresponds to one of the sub-terms.

 The parentheses (and) are used for grouping. Example: x (cd|ab)y finds "xabyba" and "xcdyef".

(40)

MBS GmbH Phone: +49 2151 7294-0

6.2 Driver

In this menu, the installed drivers (protocols) are listed. With the buttons Diagnostics ON and Diagnostics OFF the diagnostic function is turned on or off. The diagnostic is issued in the Log files of the Diagnostics output.

6.3 Log files

Output of diagnostic messages: These are made either via http at an interval of 60 seconds or via the Telnet program in a DOS window. For this, the Telnet program must be installed on the connected PC. (Please refer to the documentation for your operating system) depending on your operating system a security check is done after selecting a function, asking whether

(41)

the program "Telnet" can be started. This question should be answered with yes. Then the output is displayed on the screen.

Starting at Internet Explorer version 7 or higher or Windows Vista or higher, the Telnet function in the operating system is locked. In order to enable a Diagnostic output over Telnet (live) or Value change over Telnet (live) the Telnet output must be activated. For Windows 2000 and Windows XP, you can alternatively use a different internet browser (e.g. Firefox, Opera).

From the Windows Vista and on, the "Telnet" operating system must be enabled in the operating system.

The release is described online in detail at Microsoft: http://support.microsoft.com/kb/978779/de

When using the Internet - Explorer 7 or higher with Windows 2000 / XP, an entry in the registry is to be made.

! Attention!

Changes to the registry can result in the destruction of the operating system and the data of the PC. Be sure to backup the registry and your data beforehand.

Activating the "Telnet" program:

Quit Internet Explorer, if it has been started.

Create a file in a text program (Notepad) containing the following: REGEDIT4

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Internet

Explorer\Main\FeatureControl\FEATURE_DISABLE_TELNET_PROTOCOL] "iexplore.exe"=dword:00000000

Save this file as: ie7telnet.reg.

Run this file and confirm the security prompt.

Start Internet Explorer. Now you can use the functions: Diagnostics output over Telnet (live) or Value change over Telnet (live).

6.4 System status

Under the menu item System status a text file with all important information concerning the UGW//compact is displayed. This gives you a compact overview of the system’s status and all installed and configured properties.

(42)

MBS GmbH Phone: +49 2151 7294-0

6.5 Setup

6.6 Transferring configuration files

The menu item configuration file transfer, allows the configuration files to be read online or transferred to the gateway. Here you can view files online, download or transferred them to the gateway.

(43)

Transferred files are not immediately activated by the gateway, but are written into a

temporary store. Files already stored can be checked and then – if the test was successful - can be activated. Files in the cache are preserved during a restart of the gateway. In a further step, the files can be activated by Program restart.

6.7 Transferring all files at once

Under the item:

Please click here to transfer all configuration files from the gateway to your PC. With this function you can save the gateway's configuration on the connected PC. The transferred file is compressed with gzip and packed with tar.

Under the item:

Here all configuration files can be transferred at once from the gateway to your PC.

Please choose a .zip or .tar.gz file in your file system and click Transfer to transfer the file into the gateway.

Choosing individual files

Please note that the ever present files, led.txt as well as driver.cfg can be viewed, but not changed.

The files shown here are currently active on the gateway configuration files. File can be viewed online by clicking on the file name.

Using the browser buttons Search and Transfer, single active configuration files and can be uploaded to the gateway.

Please note that these files are stored only in temporary storage and are only activated by the Restart the software.

(44)

MBS GmbH Phone: +49 2151 7294-0

6.8 Change password

To change the password you enter New Password into the field: enter the desired password and confirm it by re-entering under Repeat password: Confirm by selecting the Change button. Use the Reset values button to cancel the change of the password.

The username is in the delivery, gw.

The factory default password is GATEWAY.

6.9 Setting date and time

Set date and time in Change the date and/or time field. Entering the date is not necessary if only the time is to be changed. The confirmation of the entry is made through the Set button, and with Reset value the input value is deleted.

(45)

6.10 NTP setup

6.11 Setting IP address

The current setting of the IP address appears under Active configuration. To change this setting enter the desired IP address, subnet mask and default gateway in

New configuration. With the button Activate configuration you activate the new setting. If there are communication protocols installed on this gateway that operate via the network, please restart the system afterwards. This is necessary because the drivers only take over the settings of such protocols when starting the system.

With the Reset values button, input will be cleared and the change of the current state is maintained.

(46)

MBS GmbH Phone: +49 2151 7294-0

6.12 Changing Project ID

The gateway determines the function and the licensed number of data points from the project ID.

Here you have the option of entering a new project ID in the gateway.

Please only enter an ID that you have received from the gateway manufacturer. To activate the new ID, it is necessary to restart the software.

In evaluating the entries the gateway is not sensitive to lower or upper case. Hyphens may, but need not be entered.

The project ID is used to check whether the configuration files match the gateway configured in software drivers. This system prevents the possibility of loading invalid configurations, which could lead to malfunction.

To protect the project planning service against unauthorized access or improper use, a password may be stored on the gateway.

So access is only possible if the correct password is entered, otherwise access is denied.

6.13 Restart the Software

Restarting the gateway software:

Pressing the "Restart" button triggers a restart of the gateway software. The system will not transfer any data for several minutes after the restart until the software is active again. The configuration is retained.

6.14 Restart the system

Restarting software and hardware :

If you press the "Restart" button, the gateway shuts down and a restart of the hardware is triggered. The gateway will not transfer any data for a few minutes, until the software has been restarted. This process can take several minutes. The configuration is retained.

6.15 Configuration files

is a link on the menu item Configuration files in order to reach this function from the top level quickly. (See also 3.5.1)

(47)

6.16 Software update

Here you have the ability to transfer a file to the gateway, which includes a software update. Please only select a file that you have received from the manufacturer of the system. The name "update.ugw“ is mandatory. The update does not automatically run by transferring the file to the gateway. This occurs after transfer only when the gateway is started up once again. The configuration is not changed during an update.

(48)

MBS GmbH Phone: +49 2151 7294-0

7. Protocol properties and data points

This is a general description only, and independent of the existing gateway.

With a gateway, different systems (e.g. Ethernet, RS485, ...) are connected to the building automation system for data exchange. Since each bus system works with its own data formats (protocols) (e.g. BACnet, EIB, MS/TP ...) data conversion is performed within the gateway. In order to convert the input format to the output format, an internal intermediate format is used. This makes it possible to convert between any two or more formats.

The internal intermediate format consists of individual data points that are to be regarded as the smallest amount of information. A data point classically consists of an address and a value.

Example: Analog actual value (measured value) and an address which makes measured value selectable.

940.Y bac 34.AV 55 Routing address 940 Data point type Y Analog value Address type bac

BACnet address 34.AV 55

In addition, there may be other properties, such as plain text or special identifiers, which can for example report that the measuring sensor is out of order. To facilitate data exchanges between different protocols various data point types are provided in the gateway. These data point types meet the specific requirements of each protocol.

7.1 Control via configuration data

The configuration of the gateway occurs via text files. There is one file per driver with protocol information (e.g. baud rate) with the extension .cfg and a file containing the definition of data points with the extension .txt. The file named dispatch.txt contains the mappings of the data points of the protocols to each other.

(49)

Examples of configuration files

The files all have the same basic structure: there are so-called sections (areas) that begin with a line containing a name in square brackets. The lines following belong to such a section up to the next section or to the end of the file. The lines following section names have the structure Keyword = value

The files can also include blank and comment lines at any point – introduced by the # character. Upper and lower case are distinguished.

Example 4.1.1 Example of File Format 1 # Comment first line of the file

# First data point [address1]

name = first sample data point further_properties = 7

[address2]

# Another comment

name = second sample data point # Comment last line

Comment line

Begin Section with the address address1

Key name with value of first sample data point

Key further_properties with value 7 Begin section with the address address2

(50)

MBS GmbH Phone: +49 2151 7294-0

Example 4.1.2 Example for file format 2 # Data point list

[S 2000.BI 1]

name = Failure slave 1 query = pe writecache = yes bac_polarity = 0 bac_time_delay = 0 bac_alarm_value = 1 bac_notify_type = event bac_event_enable = (1,1,1) bac_inactive_text = Available bac_active_text = Error [Y 2000.AI 1001]

name = Slave 1 Value 1 query = pe writecache = yes bac_units = 95 bac_cov_increment = 0 bac_resolution = 0.1 Comment line Begin Section 1

Key name with value of first sample data point

Begin the section with 2

Key name with value of second sample data point

(51)

7.2 Classification of protocols

Protocols can be classified according to several criteria. These properties must be considered part of using the gateway.

Protocol properties table

Topology Point to point

connection With point to point connections the connection is between two

communication partners. Compared to a connection with several participants, the protocol can be simple, since

addressing different participants is not necessary.

Bus

Bus systems allow multiple users to share access to one transmission medium. The ability to specifically differentiate, connect and coordinate access of many devices to the common transmission medium is more complex. Communication control MasterSlave

PeerToPeer

Transmission control

Event-controlled

Poll end

Transmission medium

7.3 Property and data point definitions

Data points are differentiated according to different categories. The data points behave differently depending on their classification and must be treated differently according to the gateway configuration.

(52)

MBS GmbH Phone: +49 2151 7294-0

7.4 Client-server relationship, data points

In a client-server relationship a server is available to connected clients. The server accepts requests from clients and then sends the requested data to the client. This is similar with regards to the relation of data points to each other.

Example: A field device controls an actuator with feedback.

An automation station is intended to set the control variable and evaluate the feedback. The data points’ control values and feedback are within the field device, which is then the server. Through reading and writing the automation station accesses these data points and is thus the client in this communication. Normally, all data points of a device are client as well as server data points.

For some protocols, it can also happen that both client and server data points are in one device.

7.5 Actual values — set values data points

Actual values are values that are measured or calculated by the server and the results are transferred to the client.

Set values are values that are meant to affect the behavior of the server through the client. In set values, another important distinction is whether the value is transferred only by the client to the server, or whether the actual value of the set value must also be reported back to the client.

Example: A typical example of an actual value is the mapping of a temperature sensor. A typical set value would be a nominal room temperature set value in a room controller.

7.6 Analog – binary – multi-level – more complex types, data points

Data points also differ as to which values are allowed. We distinguish:

 Analog values (e.g. temperature reading sensor)

 Binary values (e.g. relay output)

 Multi-stage values (e.g. status data point with the operating conditions: Normal operation, Off, Economy mode, Failure).

In some protocols there are more, sometimes complex data points.

Example: An example of this is utilization times. At times such values cannot or only

indirectly can be shown in the gateway. These include attributes that can detect whether data points contain a valid value. With set values there is an automatic value, which causes the server to take over control of the data point itself.

7.7 Abstract data point in data point system

For the processing and forwarding of data points within the gateway, information that is exchanged by a protocol within the gateway is shown in a generalized internal data point. The properties of these internal data points allow the mapping of the most commonly used data points in building automation. The linkage between different data points occurs via these internal data points. Due to the decoupled internal data points, it is possible to simply add more protocols to the gateway without needing to change the complete configuration. Thus,

(53)

the extension of the gateway system by adding another communication protocol in combination with all previously available protocols becomes possible.

7.8 Structuring technical addresses

Within the gateway, data points are identified on the basis of the unique technical addresses. A complete data point address consists of a routing address, a data point type character, an address type character and a protocol-specific address.

Example:

940.Y bac 34.AV 55

Routing address 940 Data point type Y analog value

Address type bac

BACnet addresss 34.AV 55

7.9 Routing address

With the routing address, called unit, the communication port of the gateway is selected and the routing address is defined for each communication port in the fabrication of the gateway. If a gateway has multiple connections of the same type, the unit typically increases by one. Example: If a gateway has FMS Profibus twice, the routing addresses are 250 and 251.

7.10 Data point type as part of address

In order to be able to use the address to derive specified information concerning possible uses, the address may contain a code letter. With this the direction of data flow and the type of values is determined. The four main types are briefly presented here. For special purposes, other types come into consideration, which will be explained when used.

7.11 Data point types

X analog value that is transmitted from the communication partner to the gateway. Y analog value that can be transmitted in both directions.

M binary or multi-level value that is transmitted from the communication partner to the gateway.

S binary or multi-level value that can be transmitted in both directions.

! Attention !

There may be several meaningful ways to assign a data point type to a data point. The selected data point type must be used consistently. A frequent source of error in the configuration is to use the same data point for different data point types.

7.12 Address identification as part of address

In order to be able to correctly interpret the protocol-specific part of the address an abbreviation of the communication protocol is used.

(54)

MBS GmbH Phone: +49 2151 7294-0

Examples:

 mod for MODBUS addresses

 pbfms for Profibus FMS addresses

 bac addresses for BACnet

7.13 Protocol-specific address

The last part of the address is determined by the communication protocol. Example of data point addresses in the gateway system

70.M eib 4/5 Routing address 70 Data point type M Address type eib EIB group address 4/5

940.Y bac 34.AV 55 Routing address 940 Data point type Y analog value

Address type bac

(55)

7.14 Mapping possibilities

A mapping basically consists of a source data point and a destination data point. Changes in the value of the source data point are transmitted to the destination data point. This transfer can additionally be modified by configuration entries. The address of the source data point is entered as a section in the dispatch file. The address of the destination point is registered on another line under the keyword target =.

Example of a dispatch.txt

# mapping of 1 bit value from Profibus FMS on MODbus [250.M fms 22.2.4]

target = 60.S mod 3 coil 4

# mapping of an analog value from Profibus FMS on MODbus [250.X fms 4.23]

(56)

MBS GmbH Phone: +49 2151 7294-0

8 Configuration

8.1 Data point files

Which data points are to be used and which properties these data points should have is determined in the data point file of each protocol.

The file name is derived from a protocol-specific part of the name, a serial number, which is numbered in the event of multiple connections for the same protocol and the extension.txt. Example of a gateway with two EIB connections:

eib1.txt and eib2.txt.

The name of the protocol-specific part is mentioned in the description of the designated protocol.

The address of the data point serves as the section’s name. An abbreviation of the address is used. Since the routing address and the data point type have already been determined by the file and they are not indicated again. This means that the full address 60.X eib 2/3/5 is written in the list data point as X 2/3/5.

The use of the following key words is standard:

name Optionally, you can specify a plain text for the data point here. The text is usually only used for commentary purposed within the gateway. In some protocols, e.g. BACnet, the text is used in the protocol. This is especially mentioned separately each time in the protocol description.

format Optionally, here protocol-related properties of the data point are described which cannot be derived solely from the address. For example, it is common to transfer analog values of many protocols using a scaling factor. This scaling factor must be specified in the configuration, so the gateway can interpret this value correctly. The available data are protocol-dependent and are described in the respective chapters.

write cache Optionally, possible values YES or NO (default). This parameter only has meaning for those parameters whose value is described by the gateway. If the option has the value YES, the gateway remembers a value during a failed entry and repeats its entry attempt, when for example the connection to the device has been restored. If this option is missing, or your value is NO, the value is discarded after a failed entry.

A scenario for a meaningful application of this option would be to make a binary fault visual via EIB. If the EIB bus is not connected to the gateway at the time of occurrence of the failure, the gateway naturally cannot report the failure. When the connection has been restored the fault condition should generally at least be is transmitted afterwards.

A scenario where this behavior is not desired would be the switching of room lighting. If at the time of the switching the EIB does not work, it is generally not desired that the switching takes place after the event (e.g. after several days).

(57)

query Specifies how the data point should be picked up via the corresponding protocol. Each of which, with a few exceptions, is described separately and uses the value permanent abbreviated as pe here. This value is standard.

further options

For some protocols, there are other options that need to be projected at this point. The description can be found in each of the protocol chapters.

8.2 Configuration files

The file name is derived from a protocol-specific name part, a serial number, which may number several links of the same protocol and the extension .cfg.

Example of a gateway with two EIB connections: eib1.cfg and eib2.cfg.

The name of the protocol-specific part is specified in the description of the corresponding protocol.

General parameters for each connection are established in the configuration file for each connection. Typically, information such as baud rate, individual addresses or poll rates should be indicated. The content consists of a section with a protocol-specific description and

configuration entries.

Example 5.1. Modbus sample configuration file modslave1.cfg

# Modbusconfiguration [MOD]

baudrate = 9600 mode = 485

# individual slave address address = 12

8.3 Schematic file

In this file the allocations between the data points are defined.

With the keyword value a value can be specified to represent the source data point value, which is to be transmitted to the target data point.

The keyword threshold depending on the data point type of the source data point has two different meanings.

If the source data point is an analog value (data point type X or Y), then the specified value has the effect of a threshold, which means that only changes in value where the change is greater than the specified threshold are transferred.