Manual Universal Gateway UGW//maxi
Transcription
Manual Universal Gateway UGW//maxi
Universal Gateway Manual UGW//maxi UGW//compact UGW//micro UGW//nano25 Version 1.0 18.06.2014 MBS Universal Gateway 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.4 Operating the reset button .......................................................................................... 17 4.2.5 Restart ......................................................................................................................... 17 4.2.6 LED power indicator .................................................................................................... 17 4.2.7 MS/TP TxD LED indicator ........................................................................................... 17 4.2.8 RxD LED MS/TP RxD LED indicator .......................................................................... 18 4.2.9 LED status indicator .................................................................................................... 18 4.2.10 LED orange network indicator................................................................................... 18 4.2.11 LED green network indicator..................................................................................... 18 4.3 UGW//micro / UGW//nano 25 ............................................................................................ 18 4.3.1 Connections and controls ........................................................................................... 18 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de Seite 2 von 64 MBS Universal Gateway 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.2 Operating the reset button .......................................................................................... 27 4.4.3 Restart ......................................................................................................................... 27 4.4.4 LED power indicator .................................................................................................... 27 4.4.5 MS/TP TxD LED indicator ........................................................................................... 28 4.4.6 RxD LED MS/TP RxD LED indicator .......................................................................... 28 4.4.7 LED status indicator .................................................................................................... 28 4.4.8 LED orange network indicator..................................................................................... 28 4.4.9 LED green 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 6.11 Setting IP address ........................................................................................................ 45 Seite 3 von 64 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de MBS Universal Gateway 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 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de Seite 4 von 64 MBS Universal Gateway 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. Seite 5 von 64 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de MBS Universal Gateway 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 1352001 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 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de Seite 6 von 64 MBS Universal Gateway 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 ©2014 MBS GmbH Römerstraße 15 Seite 7 von 64 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de MBS Universal Gateway D-47809 Krefeld, Germany Phone: +49 / 21 51 / 72 94 - 0 Fax: +49 / 21 51 / 72 94 - 50 Email: [email protected] Internet: http://www.mbs-software.de All rights reserved. No part of this publication may be reproduced in any form (print, 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. 0.1 Date 05.01.2011 Author ane 0.2 11.03.2011 ane 0.3 0.4 0.5 0.6 07.04.2011 11.04.2011 18.08.2011 05.12.2011 ane ane ane ane 1.0 18.06.2014 ane Comment COM3 changed configuration Corrections Pictures changed English version 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. MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de Seite 8 von 64 MBS Universal Gateway 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 Baud rate 600,9600,19200,38400,57600,76800,115200 Baud Seite 9 von 64 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de MBS Universal Gateway 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 Displays a link to LAN connection 10/100 Displays the connection speed USB1 USB 2.0 for example device LON USB Adapter USB2 USB 2.0 für USB – Gerät z.B. USB–LON-Adapter MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de Seite 10 von 64 MBS Universal Gateway 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 Error LED flashes in 1 sec rhythmus Seite 11 von 64 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de MBS Universal Gateway 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: LED OFF indicates a connection to 10Mbit/s LED ON indicates a connection to 100Mbit/s 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 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de Seite 12 von 64 MBS Universal Gateway 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 COM4 / COM5 RS485 connection Seite 13 von 64 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de MBS Universal Gateway 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. MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de Seite 14 von 64 MBS Universal Gateway 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 USB USB 2.0 for example device LON USB Adapter Seite 15 von 64 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de MBS Universal Gateway 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 Ambient humidity: 20 .. 80 percent relative humidity, noncondensing Mounting: DIN-rail TS 35 according to EN50022 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 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de Seite 16 von 64 MBS Universal Gateway you like to set the UGW//compact power off, disconnect the green power connector from the device. 4.2.3 Resetting UGW//compact 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) 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 Restart of gateway Reset with default IP address Restart with DHCP server activation 0-5 seconds 5-10 seconds 5-15 seconds 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 The power LED lights up green when the power is connected and goes off in the absence of a power supply. 4.2.7 MS/TP TxD LED indicator The MS/TP TxD LED lights up yellow when data is sent to the MS/TP network. Seite 17 von 64 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de MBS Universal Gateway 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 The orange network LED is located in the right part of the RJ-45 connection and displays the following states: LED OFF indicates a connection to 10Mbit/s LED ON indicates a connection to 100Mbit/s 4.2.11 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 4.3 UGW//micro / UGW//nano 25 4.3.1 Connections and controls 4.3.2 UGW//micro RS485 / UGW//nano 25 RS485 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de Seite 18 von 64 MBS Universal Gateway PE PE protective earth terminal with M3 screw LAN RJ45 10/100 MBit/s Ethernet Displays a link to LAN connection 10/100 Displays the connection speed 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 Ambient humidity: 20 .. 80 percent relative humidity, noncondensing Mounting: DIN-rail TS 35 according to EN50022 Seite 19 von 64 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de MBS Universal Gateway 4.3.3 UGW//micro KNX RS485 / UGW//nano 25 KNX RS485 LAN RJ45 10/100 MBit/s Ethernet Displays a link to LAN connection 10/100 Displays the connection speed 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 KNX + KNX connection + KNX connection - KNX connection - KNX 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! 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 KNX Rx 6 KNX Tx 7 KNX Power MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de Seite 20 von 64 MBS Universal Gateway Specification Operating voltage: 12-24V AC / DC, 250mA max. Weight: 300g Dimensions: Height: 100mm, Width: 48mm, Depth: 70mm (including DIN-DIN rail) Ambient temperature: 0 .. 45 ° C, 32 ... 113 ° F Ambient humidity: 20 .. 80 percent relative humidity, noncondensing Mounting: DIN-rail TS 35 according to EN50022 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 PWR - Power Power supply 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! Seite 21 von 64 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de MBS Universal Gateway 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 Operating voltage: 12-24V AC / DC, 250mA max. Weight: 300g Dimensions: Height: 100mm, Width: 31mm, Depth: 70mm (including DIN-DIN rail) Ambient temperature: 0 .. 45 ° C, 32 ... 113 ° F Ambient humidity: 20 .. 80 percent relative humidity, noncondensing Mounting: DIN-rail TS 35 according to EN50022 4.3.5 UGW//micro PROFINET RS485 / UGW//nano 25 PROFINET RS485 LAN RJ45 10/100 MBit/s Ethernet Displays a link to LAN connection 10/100 Displays the connection speed 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 PROFINET1 PROFINET Version 2.3 RT, IRT Activity Link PROFINET 2 PROFINET Version 2.3 RT, IRT Activity Link MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de Seite 22 von 64 MBS Universal Gateway 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 5 PROFINET Maintance 6 PROFINET Ready 7 PROFINET System failure 8 PROFINET Bus failure Specification Operating voltage: 12-24V AC / DC, 320mA max. Weight: 300g Dimensions: Height: 100mm, Width: 48mm, Depth: 70mm (including DIN-DIN rail) Ambient temperature: 0 .. 45 ° C, 32 ... 113 ° F Ambient humidity: 20 .. 80 percent relative humidity, noncondensing Mounting: DIN-rail TS 35 according to EN50022 4.3.7 UGW//micro RS232 / UGW//nano 25 RS232 PE PE protective earth terminal with M3 screw LAN RJ45 10/100 MBit/s Ethernet Displays a link to LAN connection 10/100 Displays the connection speed 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 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 Seite 23 von 64 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de MBS Universal Gateway DIP-Switch 1 not used 2 not used 3 not used 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 Ambient humidity: 20 .. 80 percent relative humidity, noncondensing Mounting: DIN-rail TS 35 according to EN50022 4.3.8 UGW//micro KNX RS232 / UGW//nano 25 KNX RS232 LAN RJ45 10/100 MBit/s Ethernet Displays a link to LAN connection 10/100 Displays the connection speed 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 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 DIP-Switch 1 not used 2 not used 3 not used MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de Seite 24 von 64 MBS Universal Gateway 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, 250mA max. Weight: 300g Dimensions: Height: 100mm, Width: 31mm, Depth: 70mm (including DIN-DIN rail) Ambient temperature: 0 .. 45 ° C, 32 ... 113 ° F Ambient humidity: 20 .. 80 percent relative humidity, noncondensing Mounting: DIN-rail TS 35 according to EN50022 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 PWR - Power Power supply 1 V+ +12V - +24VDC or 12V - 24VAC 2 V- GND or 12V - 24VAC 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 MBus + MBus connection + MBus connection - MBus connection - MBus connection DIP-Schalter 1 not in use 2 not in use 3 not in use Seite 25 von 64 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de MBS Universal Gateway 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 Operating voltage: 12-24V AC / DC, 250mA max. Weight: 300g Dimensions: Height: 100mm, Width: 31mm, Depth: 70mm (including DIN-DIN rail) Ambient temperature: 0 .. 45 ° C, 32 ... 113 ° F Ambient humidity: 20 .. 80 percent relative humidity, noncondensing Mounting: DIN-rail TS 35 according to EN50022 4.3.10 UGW//micro PROFINET RS232 / UGW//nano 25 PROFINET RS232 LAN RJ45 10/100 MBit/s Ethernet Displays a link to LAN connection 10/100 Displays the connection speed 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 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 PROFINET1 PROFINET Version 2.3 RT, IRT Activity Link PROFINET 2 PROFINET Version 2.3 RT, IRT Activity Link DIP-Switch 1 not used 2 not used 3 not used MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de Seite 26 von 64 MBS Universal Gateway 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 Operating voltage: 12-24V AC / DC, 320mA max. Weight: 300g Dimensions: Height: 100mm, Width: 31mm, Depth: 70mm (including DIN-DIN rail) Ambient temperature: 0 .. 45 ° C, 32 ... 113 ° F Ambient humidity: 20 .. 80 percent relative humidity, noncondensing Mounting: DIN-rail TS 35 according to EN50022 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 … 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.4.2 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.4.3 Restart It takes Gateway about 25s to restart. In this phase there is no Ethernet or MS/TP communication. 4.4.4 LED power indicator Seite 27 von 64 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de MBS Universal Gateway The power LED lights up green when the power is connected and goes off in the absence of a power supply. 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 The orange network LED is located in the right part of the RJ-45 connection and displays the following states: LED OFF indicates a connection to 10Mbit/s LED ON indicates a connection to 100Mbit/s 4.4.9 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 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de Seite 28 von 64 MBS Universal Gateway 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. Seite 29 von 64 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de MBS Universal Gateway 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. MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de Seite 30 von 64 MBS Universal Gateway 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. Crossover-cable 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 Seite 31 von 64 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de MBS Universal Gateway 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 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de Seite 32 von 64 MBS Universal Gateway If there is no answer, or an error is indicated in the connection, please check the network settings using the command: ipconfig / ALL <ENTER > This command displays the list of NICs and assigned IP configuration. Seite 33 von 64 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de MBS Universal Gateway 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. MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de Seite 34 von 64 MBS Universal Gateway 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 Internet Explorer Mozilla Firefox Opera Safari Epiphany Google Chrome Seite 35 von 64 From this version on or later 6.0.2900.2180 2.0.0.14 9.50 3.1.1 (525.17) 1.8.5 0.4.154.25 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de MBS Universal Gateway 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. Software update Transfer of gateway system’s software MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de Seite 36 von 64 MBS Universal Gateway 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 Definition of deleted data point D Seite 37 von 64 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de MBS Universal Gateway 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. MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de Seite 38 von 64 MBS Universal Gateway 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". Seite 39 von 64 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de MBS Universal Gateway 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 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de Seite 40 von 64 MBS Universal Gateway 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. Seite 41 von 64 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de MBS Universal Gateway 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. MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de Seite 42 von 64 MBS Universal Gateway 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. Seite 43 von 64 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de MBS Universal Gateway 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. MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de Seite 44 von 64 MBS Universal Gateway 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. Seite 45 von 64 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de MBS Universal Gateway 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) MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de Seite 46 von 64 MBS Universal Gateway 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. Seite 47 von 64 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de MBS Universal Gateway 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. MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de Seite 48 von 64 MBS Universal Gateway 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 Comment line further_properties = 7 Begin Section with the address address1 [address2] # Another comment name = second sample data point Begin section with the address address2 # Comment last line Seite 49 von 64 Key name with value of first sample data point Key further_properties with value 7 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de MBS Universal Gateway Example 4.1.2 Example for file format 2 # Data point list [S 2000.BI 1] Comment line name = Failure slave 1 Begin Section 1 query = pe Key name with value of first sample data point 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 Begin the section with 2 writecache = yes bac_units = 95 Key name with value of second bac_cov_increment = 0 sample data point bac_resolution = 0.1 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de Seite 50 von 64 MBS Universal Gateway 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. Seite 51 von 64 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de MBS Universal Gateway 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, MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de Seite 52 von 64 MBS Universal Gateway 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. Seite 53 von 64 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de MBS Universal Gateway 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 BACnet address 34.AV 55 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de Seite 54 von 64 MBS Universal Gateway 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] target = 60.Y mod 7 holding 30 Seite 55 von 64 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de MBS Universal Gateway 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). MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de Seite 56 von 64 MBS Universal Gateway 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. Seite 57 von 64 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de MBS Universal Gateway If the source data point is an integer value (M or S) the target data point is changed only when the value of the source data point is equal to the specified value. 8.4 Status LED The gateway provides quick orientation of the current operational state via a three-color status LED. The LED has the colors green and red and as a mixed color orange. During system initialization, the LED lights up orange. After the initialization, the status LED flashes green. Table: status LED during normal operation Color code Definition Data point Green flashing Normal state Alternately orange, green flashing Projected indicator S LED information Alternately red, green flashing Usually a failure parameter on defect S LED warning Red flashing All failure parameters on defect S LED warning Red constant light At least one driver does not start properly The data points determine the LED color code with ascending priority. The warning and error parameters are set automatically by the gateway in accordance with the failure parameters. The info parameter is available for the normal dispatch mechanism and may be used for optical signalling of a collective defect, for example. 8.5 Typical data point schemata This section shows schematically, how typical data point mappings are constructed. In the examples pseudo addresses are used. Example of actual analog value MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de Seite 58 von 64 MBS Universal Gateway Entry in file protA.txt [X address1] name = outside temperature of Protocol A query = pe Entry in file protB.txt [Y parameters 16] name = outside temperature to Protocol B query = pe Entry in filedispatch.txt # Mapping of the outside temperature [110.X Prota address1] target = 140.Y protB parameters 16 Example of actual binary value Entry in file protA.txt [M adresse7] name = pump failure of protocol A query = pe Entry in file protB.txt [S parameter 23] name = pump failure in protocol B. query = pe Entry in file Dispatch.txt # Mapping of pump failure [110.M Prota address1] target = 140.S protB parameter 23 Example of multi-level setpoint without feedback Entry in file protA.txt [M adresse8] name = operating status of the protocol A query = pe Entry in file protB.txt [S parameter 29] name = operating condition in protocol B query = pe Entry in file Dispatch.txt # mapping of pump failure [110.M Prota adresse8] target = 140.S protB parameter 29 Example of multi-level setpoint with feedback Entry in file protA.txt [S adresse8] name = operating status of protocol A query = pe Seite 59 von 64 Entry in file protB.txt [S parameter 29] name = operating condition in protocol B query = pe MBS GmbH Römerstraße. 15 D-47809 Entry in file dispatch.txt # mapping of the operational status [110.S protA adresse8] target = 140.S protB parameter 29 [140.S parameter protB 29] target = 110.S protA adresse8 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de MBS Universal Gateway Sample mapping of a two-stage actual value (1 = day, 2 = night on two binary values.) Entry in file protA.txt [M adresse83] name = operating status of protocol A query = pe Entry in file protB.txt [S parameter 129] name = mode day in protocol B query = pe [S parameter 130] name = night mode in protocol B query = pe Entries in file Dispatch.txt # mapping of the operational status [110.S Prota adresse83] threshold = 1 value = 1 target = 140.S protB parameter 129 [110.S Prota adresse83] threshold = 1 value = 0 target = 140.S protB parameter130 [110.S Prota adresse83] threshold = 2 value = 0 target = 140.S protB parameter129 [110.S Prota adresse83] threshold = 2 value = 1 target = 140.S protB parameter 130 Example of projecting MBus to BACnet File: dispatch.txt slave # 1 value 1 [60.X mbus P26 value 1] target = 940.Y bac 2000.AI 1001 File: mbus1.txt [X P26 value 1] name = value 1 slave 1 query = pe MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de Seite 60 von 64 MBS Universal Gateway 6. Information for administrators The MBS universal gateways use the following IP ports: Port Nummer Dienst TCP UDP Port 20 und 21 FTP Port 23 Telnet Port 80 HTTP-Webserver Port 4996 diagnostic output/ Telnet Port 4998 Changes in the value / telnet on this port If necessary, specific services and ports are blocked from use. Standard ports that are used by communication protocols: Protokoll Port Nummer Netzwerk Protokoll BACnet Port 47808 UDP Modbus/IP Port 502 TCP SNMP Port 161 TCP / UDP SNMP Trap Port 162 TCP / UDP IEC Port 2404 TCP PMA Port 2015 UDP Isgus Port 4901 / 4902 TCP Seite 61 von 64 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de MBS Universal Gateway 7. FAQ Problem: You want to access UGW//compact and do not know the IP address. Solution 1 If your notebook PC is set as a DHCP client (the default), you can use the DHCP server of the UGW//compact for providing an IP address. Press and hold the rest button of the UGW//compact for at least 10 but not more than 15 seconds. If the status LED flashes green/red alternately, the DHCP server is enabled. Then connect the crossover network cable to your notebook PC and the IP address is assigned automatically. Crossover-cable To access the configuration pages of the UGW//compact web server, launch your preferred web browser and type the IP address 169.254.0.1 in the address field. Then enter your username and password. The default setting on delivery: Username: gw Password: GATEWAY The password can be changed in the setup menu. The home page of the UGW//compact is called up and displayed. MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de Seite 62 von 64 MBS Universal Gateway Solution 2: (computer skills required and an installed BACnet protocol) When BACnet is installed on the gateway (see sticker on the casing of the device) it can be combined with the Wireshark (freeware, available at: http:// www.wireshark.org) to sniff the network traffic and to read out on the basis of the reports. Start by selecting the Wireshark program and choose Capture Options. Check the settings in the next window and press the Start button. The capture – window will appear. Set the filter to bacnet. Then you start the UGW//compact and wait for the output shown in the picture. The IP address is shown below: Source: 169.254.0.1 (in this example) Network protocol: BACnet Info: I-Am-Router-To-Network Problem: You do not know the password to log on to the web console. Solution: In this case, you can only revert the UGW//compact back to the factory settings. !Attention! In this case you will lose all settings and parameterizations of the UGW//compact Seite 63 von 64 MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de MBS Universal Gateway To set the UGW//compact back to the default setting, press and hold the reset button for longer than 15 seconds. The status LED flashes orange and after copying the factory configuration a restart will be made. Then the gateway should be reset to the default settings: IP address 169.254.0.1 Username: gw Password: GATEWAY Problem: RS-485 connection problems Solution: For RS485 connections if possible do not connect the GND, especially not between switching cabinets with different GND - potentials. Problem: A B RS485 cables reversed. Solution: With swapped A B data lines a connection does not take place. The yellow LED lights up constantly. MBS GmbH Römerstraße. 15 D-47809 Phone: +49 2151 7294-0 Fax: +49 2151 7294-50 email: [email protected] Web: www.mbs-software.de Seite 64 von 64