HMS Anybus Modbus to KNX Gateway User manual

Modbus to KNX Gateway
USER MANUAL
SCM-1202-050 1.2 en-US ENGLISH

Important User Information
Disclaimer
The information in this document is for informational purposes only. Please inform HMS Industrial Networks of any
inaccuracies or omissions found in this document. HMS Industrial Networks disclaims any responsibility or liability
for any errors that may appear in this document.
HMS Industrial Networks reserves the right to modify its products in line with its policy of continuous product
development. The information in this document shall therefore not be construed as a commitment on the part of
HMS Industrial Networks and is subject to change without notice. HMS Industrial Networks makes no commitment
to update or keep current the information in this document.
The data, examples and illustrations found in this document are included for illustrative purposes and are only
intended to help improve understanding of the functionality and handling of the product. In view of the wide range
of possible applications of the product, and because of the many variables and requirements associated with any
particular implementation, HMS Industrial Networks cannot assume responsibility or liability for actual use based on
the data, examples or illustrations included in this document nor for any damages incurred during installation of the
product. Those responsible for the use of the product must acquire sufficient knowledge in order to ensure that the
product is used correctly in their specific application and that the application meets all performance and safety
requirements including any applicable laws, regulations, codes and standards. Further, HMS Industrial Networks will
under no circumstances assume liability or responsibility for any problems that may arise as a result from the use of
undocumented features or functional side effects found outside the documented scope of the product. The effects
caused by any direct or indirect use of such aspects of the product are undefined and may include e.g. compatibility
issues and stability issues.
Modbus to KNX Gateway User Manual SCM-1202-050 1.2 en-US

Modbus to KNX Gateway User Manual SCM-1202-050 1.2 en-US
Table of Contents Page
1 Preface ................................................................................................................................. 3
1.1 About This Document .......................................................................................................3
1.2 Document Conventions.....................................................................................................3
1.3 Trademarks.....................................................................................................................3
2 Safety ................................................................................................................................... 4
3 Product Description ............................................................................................................ 5
3.1 General..........................................................................................................................5
3.2 Operation.......................................................................................................................5
3.3 KNX Interface ..................................................................................................................6
3.4 Modbus Interface.............................................................................................................7
4 Installation........................................................................................................................... 9
4.1 Overview........................................................................................................................9
4.2 Mechanical Installation ................................................................................................... 12
4.3 Connecting the KNX interface........................................................................................... 13
4.4 Connecting the Modbus interface ..................................................................................... 13
4.5 Connecting the Power Supply........................................................................................... 14
4.6 Configuration Connections............................................................................................... 14
5 Anybus Configuration Manager (MAPS) .......................................................................... 15
5.1 Installation.................................................................................................................... 15
5.2 Connection Tab ............................................................................................................. 16
5.3 Configuration Tab .......................................................................................................... 18
5.4 Signals Tab.................................................................................................................... 25
5.5 Receive/Send Tab .......................................................................................................... 27
5.6 Diagnostic Tab............................................................................................................... 28
A Technical Data ................................................................................................................... 31

This page intentionally left blank

Preface 3 (32)
1 Preface
1.1 About This Document
This document describes how to configure and use the Modbus to KNX Gateway.
The instructions in this document require a basic knowledge of KNX and Modbus technologies
and terminology.
For additional related documentation and file downloads, please visit www.anybus.com/support.
1.2 Document Conventions
Numbered lists indicate tasks that should be carried out in sequence:
1. First do this
2. Then do this
Bulleted lists are used for:
• Tasks that can be carried out in any order
• Itemized information
►An action
→ and a result
User interaction elements (buttons etc.) are indicated with bold text.
Program code and script examples
Cross-reference within this document: Document Conventions, p. 3
External link (URL): www.hms-networks.com
WARNING
Instruction that must be followed to avoid a risk of death or serious injury.
Caution
Instruction that must be followed to avoid a risk of personal injury.
Instruction that must be followed to avoid a risk of reduced functionality and/or damage
to the equipment, or to avoid a network security risk.
Additional information which may facilitate installation and/or operation.
1.3 Trademarks
Anybus®is a registered trademark of HMS Industrial Networks. All other trademarks mentioned
in this document are the property of their respective holders.
Modbus to KNX Gateway User Manual SCM-1202-050 1.2 en-US

Safety 4 (32)
2 Safety
Connecting power with reverse polarity or using the wrong type of power supply may
damage the equipment. Make sure that the power supply is connected correctly and of
the recommended type.
This product contains parts that can be damaged by electrostatic discharge (ESD). Use
ESD prevention measures to avoid damage.
The Modbus to KNX Gateway should only be installed by adequately trained personnel and
according to applicable safety regulations.
The unit should be mounted on a standard DIN rail or screw-mounted onto a flat surface inside a
properly grounded metallic enclosure. The unit should not be mounted outdoors or exposed to
direct sunlight, water, high humidity or dust.
Make sure that you have all the necessary information about the capabilities and restrictions of
your local network environment before installation.
Modbus to KNX Gateway User Manual SCM-1202-050 1.2 en-US

Product Description 5 (32)
3 Product Description
3.1 General
The Anybus Modbus to KNX Gateway is intended for integration of Modbus RTU and Modbus
TCP installations into KNX monitoring and control systems.
On the KNX side the gateway acts as a KNX device, and on the Modbus side it emulates a
Modbus RTU Master device and/or a Modbus TCP Client device. The Modbus slave device(s) are
read by the gateway using automatic continuous polling.
Configuration is carried out using Anybus Configuration Manager (MAPS) which can be
downloaded from www.anybus.com/support..
3.2 Operation
After the startup process has completed, the gateway will continuously read data points from
the connected Modbus TCP Server and/or Modbus RTU Slave devices and update these values in
its memory.
From the KNX system point of view, the whole Modbus system is seen as a single KNX device
with the same configuration and operation characteristics as other KNX devices. Every register in
the Modbus slave devices will be associated with a specific KNX group address. When a new
value is read from Modbus for a given register, a write telegram is sent to the associated KNX
group. When a telegram is received from the KNX bus, a message is sent to the associated
Modbus device to perform the corresponding action.
If a device is not responding during the continuous polling of Modbus devices, a virtual signal
inside the gateway will be activated indicating a communication error with the device. These
virtual signals indicating real-time communication status are accessible from KNX in the same
way as the other data points.
Modbus to KNX Gateway User Manual SCM-1202-050 1.2 en-US

Product Description 6 (32)
3.3 KNX Interface
The gateway connects directly to the KNX TP-1 (EIB) bus and behaves as one more device in the
KNX system, with the same configuration and operational characteristics as other KNX devices.
Internally, the circuit part connected to the KNX bus is opto-isolated from the rest of the
electronics.
The gateway receives, manages and sends all the telegrams related to its configuration to the
KNX bus.
On receiving telegrams of KNX groups associated to internal datapoints, the corresponding
messages are sent to Modbus to maintain both systems synchronised in every moment.
When a change in a signal of the external system is detected, a telegram is sent to the KNX bus
(of the associated KNX group) to maintain both systems synchronised in every moment.
The status of the KNX bus is checked continuously. If a bus drop down is detected (e.g. due to a
failure in the bus power supply), when the KNX bus is restored again, the gateway will retransmit
the status of all the KNX groups marked as “T” Transmit. Also the Updates of the groups marked
as “U” Update will be performed. The behaviour of each individual point into the gateway is
determined by the flags configured for the point.
3.3.1 KNX Points Definition
Every internal datapoint to define has the following KNX properties:
Property Description
Description Descriptive information about the Communication Object or Signal.
Signal Signal's Description. Only for informative purposes, allows identifying the signal
comfortably.
DPT It is the KNX data type used to code the signal's value. It will depend on the type of signal
associated in the external system in every case. In some integrations, it is selectable, in
others it is fixed due to the intrinsic characteristics of the signal.
Group It is the KNX group to which the point is associated. It is also the group to which the read
(R), write (W), transmit (T) and update (U) flags are applied. Is the sending group.
Listening addresses They are the addresses that will actuate on the point, apart of the main Group address.
RRead. If this flag is activated, read telegrams of this group address will be accepted.
Ri Read. It this flag is activated, the object will be read on initialization.
WWrite. If this flag is activated, write telegrams of this group address will be accepted.
TTransmit. If this flag is activated, when the point's value changes, due to a change in the
external system, a write telegram of the group address will be sent to the KNX bus.
UUpdate. If this flag is activated, on gateway start-up or after a KNX bus reset detection,
objects will be updated from KNX.
Active If activated, the point will be active in the gateway, if not, the behaviour will be as if the
point is not defined. This allows deactivating points without the need of delete them for
possible future use.
Modbus to KNX Gateway User Manual SCM-1202-050 1.2 en-US

Product Description 7 (32)
3.4 Modbus Interface
Modbus TCP basically embeds the Modbus RTU protocol in TCP/IP frames. TCP/IP allows faster
communication and a longer distance between the master and slave devices than RTU
communication over serial line. Modbus TCP allows communication over an existing TCP/IP
infrastructure such as a LAN, WAN or the Internet. It also allows multiple Modbus masters to
exist in the same network.
The Modbus to KNX Gateway will act as a master in a Modbus TCP network or as a Modbus RTU
Master, or both. All other Modbus devices connected to the same network must be slave/server
devices.
Each Modbus TCP slave device has an IP address and a predefined register address map. The
address map defines the address, type and characteristics of each internal point (register) of the
device and makes this data accessible through the Modbus TCP protocol.
Each defined point can be configured with a slave address from 0 to 255. This allows for great
flexibility, for example to integrate Modbus RTU slave devices connected in a serial line with an
RTU/TCP converter enabling access to their data points through TCP/IP. The converter,
communicating in TCP, will then identify the destination of the point (slave address in the RTU
network) by the contents of the slave address field.
The Modbus TCP protocol defines different types of function codes to read/write different type
of registers in Modbus devices, and also different data encoding formats. Implementation can
vary between different slave device types and manufacturers. The data encoding and byte order
for 16-bit registers can be configured in the gateway.
The communication parameters (IP address, netmask, default router address and TCP port) of
the Modbus TCP interface are also fully configurable.
See also Modbus Points Definition, p. 8.
Modbus to KNX Gateway User Manual SCM-1202-050 1.2 en-US

Product Description 8 (32)
3.4.1 Modbus Points Definition
Each point defined in the gateway has the following Modbus features associated to it:
Feature Description
Modbus Device Modbus TCP device to which belongs the point, from a list of Modbus TCP slave devices
that can be defined in the gateway (up to 5).
For every Modbus TCP slave device defined, a virtual signal is created automatically in
the gateway to inform about the communication with the device, this signal is available
also from the KNX interface like the rest of the points.
Function code
Read Func
Write Func
One of the following Modbus function codes can be used:
• 1- Read Coils.
• 2- Read Discrete Inputs.
• 3- Read Holding Registers.
• 4- Read Input Registers.
• 5- Write Single Coil.
• 6- Write Single Register.
• 15- Write Multiple Coils.
• 16- Write Multiple Registers.
#Bits Number of bits to be used by this signal.
Data Coding Format One of the following Modbus data coding formats can be used:
• 16/32/48/64 bits unsigned.
• 16/32/48/64 bits signed (one’s complement – C1).
• 16/32/48/64 bits signed (two’s complement – C2).
• 16/32/48/64 bits Float.
• 16/32/48/64 bits Bitfields.
• Error comm
Byte Order • Big Endian
• Little Endian
• Word Inverted Big Endian
• Word Inverted Little Endian
Register Address The Modbus register address inside the slave device for the point.
Bit inside the register Bit inside the Modbus register (optional). The gateway allows bit decoding from generic
16 bits input/holding Modbus registers.
Bit coding into 16 bit input/holding Modbus registers is used for some devices to encode
digital values into this type of registers, being these registers normally accessible using
Modbus function codes 3 and 4 (read holding/input registers).
Modbus to KNX Gateway User Manual SCM-1202-050 1.2 en-US

Installation 9 (32)
4 Installation
4.1 Overview
Fig. 1 Front panel
Read the Safety before starting installation.
Installation Procedure
These are the main steps when installing and setting up the Modbus to KNX Gateway. Each step
will be described in the following sections of this document.
1. Mount the gateway on a DIN rail or using the screw mounting clips.
2. Connect the KNX and Modbus serial and/or Ethernet interfaces.
3. Connect a computer for configuration to the Console USB port or to the Ethernet network.
4. Connect the power supply and power on the unit.
5. Configure the unit using Anybus Configuration Manager (MAPS).
Modbus to KNX Gateway User Manual SCM-1202-050 1.2 en-US

Installation 10 (32)
Connectors
See Technical Data, p. 31 regarding terminal wiring and power supply requirements.
Power Connector (3-pole terminal block)
Pin Function
Protective Earth
-Power Ground
+24 VAC or +9 to +36 VDC
Port A / KNX (2-pole terminal block)
Pin Function
A1, A2 Not used
A3 KNX +
A4 KNX -
Port B / Modbus RTU EIA-485 (3-pole terminal block)
Pin Function
B1 EIA-485 Line B (-)
B2 EIA-485 Line A (+)
B3 Signal Ground
Ethernet Port (RJ-45)
Pin Function
1 TD+
2 TD-
3 RD+
6 RD-
4, 5, 7, 8 (reserved)
USB Port (USB Type A)
Can be used to connect a USB flash storage device for storing logfiles.
HDD drives are not supported (max. 150 mA load).
Console Port (USB Type Mini-B)
Used to connect the gateway to a computer for configuration.
Modbus to KNX Gateway User Manual SCM-1202-050 1.2 en-US

Installation 11 (32)
LED Indicators
Fig. 2 Overview
LED Indication Meaning
Run Green Normal operation
Error Red Operating error
Eth Link Green
Yellow
Flashing
100 Mbit/s Ethernet
10 Mbit/s Ethernet
Ethernet traffic
Eth Spd Green
Off
Flashing
Full-duplex Ethernet mode
Half-duplex Ethernet mode
Packet collision
Port A Tx Green Transmitting on Port A
Port A Rx Green Receiving on Port A
Port B Tx Green Transmitting on Port B
Port B Rx Green Receiving on Port B
Button A/B (reserved for future use)
DIP Switches
DIP switches
SW A is reserved for future use.
SW B toggles internal termination and polarization for Port B.
Switch Function
1ON = 120 Ω termination enabled
2, 3 ON = line polarization enabled
Modbus to KNX Gateway User Manual SCM-1202-050 1.2 en-US

Installation 12 (32)
4.2 Mechanical Installation
The unit should be mounted on a standard DIN rail or screw-mounted onto a flat surface inside a
properly grounded metallic enclosure. The unit should not be mounted outdoors or exposed to
direct sunlight, water, high humidity or dust.
Make sure that there is enough space for the connectors and that the LED indicators and
configuration switches are accessible after the unit is mounted.
DIN Rail Mount
Fig. 3 DIN rail mounting option
Mounting
1. Hook the unit onto the upper lip of the rail.
2. Press the unit gently towards the rail until it snaps into place.
Removing
1. Pull the tab at the bottom of the unit gently downwards.
2. Pull the bottom end free and lift the unit from the rail.
Wall Mount
Fig. 4 Wall mounting option
Push the three mounting clips on the back of the unit from the original position to the outer
position. A click indicates when the clip is locked in the outer position.
The holes in the mounting clips can now be used for screw mounting.
Modbus to KNX Gateway User Manual SCM-1202-050 1.2 en-US

Installation 13 (32)
4.3 Connecting the KNX interface
Connect the KNX TP1 bus to Port A on the gateway.
Observe the correct polarity of the connections, see Connectors, p. 10.
If there is no response on the KNX interface, check that the devices on the bus are connected
and operating correctly, and that traffic to/from the gateway is not restricted.
If using a KNX line coupler, make sure that the coupler is not filtering the telegrams to/from the
Modbus to KNX Gateway.
4.4 Connecting the Modbus interface
Modbus TCP
Connect the network to the Ethernet port on the gateway using a straight UTP/FTP CAT5e or
CAT6 Ethernet cable.
If there is no response from the network, check that the devices on the network are connected
and operating correctly, and that traffic to/from the gateway is not restricted. Contact your
network administrator if in doubt.
Modbus RTU
Connect the EIA-485 bus to Port B on the gateway.
Observe the correct polarity of the connections, see Connectors, p. 10.
If the gateway is installed at one of the ends of the Modbus serial bus, the internal termination
switch for the port (DIP switch 1) should be switched on. See DIP Switches, p. 11.
Do not use an external termination resistor when internal termination is enabled.
Modbus to KNX Gateway User Manual SCM-1202-050 1.2 en-US

Installation 14 (32)
4.5 Connecting the Power Supply
Connect a suitable power supply to the Power terminal. See Technical Data, p. 31 regarding the
power supply requirements.
Observe the correct polarity of the connections, see Connectors, p. 10.
4.6 Configuration Connections
Connect the computer to be used for configuration to the Console port on the front panel of the
gateway using a standard USB type B cable.
The gateway can also communicate with the computer over Ethernet if they are connected to
the same Ethernet network subnet. The gateway uses DHCP as default.
The USB port next to the EIA-232 serial port is only intended for making file backups to a USB flash drive
and cannot be used for configuration.
Modbus to KNX Gateway User Manual SCM-1202-050 1.2 en-US

Anybus Configuration Manager (MAPS) 15 (32)
5 Anybus Configuration Manager (MAPS)
Anybus Configuration Manager (MAPS) is a free Windows®-based software tool which is used to
monitor and configure the AnybusModbus to KNX Gateway.
5.1 Installation
Make sure that you have all the necessary information about the capabilities and restrictions of
your local network environment before installing and using this software.
1. Download Anybus Configuration Manager (MAPS) from www.anybus.com/support.
2. Double-click on the self-extracting archive to extract the installation files to your computer.
3. Double-click on the installer executable and follow the instructions in the installation wizard.
You will be prompted for a location for the installation on your hard disk. Use the default
location if unsure.
Fig. 5 Installation wizard
4. Open Anybus Configuration Manager (MAPS) from the Start menu or by double-clicking on
the icon on your desktop.
Modbus to KNX Gateway User Manual SCM-1202-050 1.2 en-US

Anybus Configuration Manager (MAPS) 16 (32)
5.2 Connection Tab
Anybus Configuration Manager (MAPS) can communicate with the gateway either over an
Ethernet network or directly via the Console USB port. Projects can be created when the
gateway is offline and then downloaded to the unit once a connection has been established.
5.2.1 Connection Mode
IP
When this option is selected the computer used for configuration must be connected to the
same Ethernet network subnet as the gateway. DHCP addressing is used as default.
A password is required for IP connection. The default password is “admin”.
See Configuration Tab, p. 18 on how to change the password and the IP addressing mode.
Fig. 6 IP connection
The software will scan the local Ethernet network for devices that match the current
configuration. Compatible devices will be listed in black, incompatible devices in red.
Select the gateway and click on the Connect button or on the symbol in the footer bar. If the
connection is successful the footer bar will change color and indicate that the gateway is
connected.
If the gateway does not appear in the list:
►Check the network connections on the gateway and the computer.
►Check that the gateway is powered on.
►Check that the firewall settings allow communication with the gateway. Contact your
network administrator if necessary.
Modbus to KNX Gateway User Manual SCM-1202-050 1.2 en-US

Anybus Configuration Manager (MAPS) 17 (32)
USB Port
Select this option if the computer used for configuration is connected directly to the gateway via
the Console USB port. All the available serial (COM) ports on the computer will be listed.
Fig. 7 USB port connection (COM port numbers may be different on your computer)
Select the COM port used by the USB interface and click on the Connect button or on the
symbol in the footer bar. If the connection is successful the footer bar will change color and
indicate that the gateway is connected.
Fig. 8 Footer bar
If the gateway does not appear in the list:
►Check the USB connections on the gateway and computer.
►Check that the gateway is powered on.
►Open the Windows Device Manager to check for issues with the COM ports.
Modbus to KNX Gateway User Manual SCM-1202-050 1.2 en-US

Anybus Configuration Manager (MAPS) 18 (32)
5.3 Configuration Tab
Fig. 9 Configuration tab
5.3.1 General
General Configuration
Gateway Name Used for easy identification of the unit in the project.
This entry is only informational and can be edited freely.
Project Description A brief description of the project.
This entry is only informational and can be edited freely.
Connection
Enable DHCP Enables/disables dynamic IP addressing. DHCP is enabled as default.
IP Static IP address for the unit when not using DHCP.
Netmask Subnet mask when using static IP
Gateway Default gateway when using static IP
Password The password when connecting to the gateway via Ethernet.
The default password is “admin”. To change the password, enter a new password in the
text box and download the configuration to the gateway.
Modbus to KNX Gateway User Manual SCM-1202-050 1.2 en-US