HMS Anybus 024380-C User manual

M-Bus to Modbus-TCP Gateway
024380-C, 025070-C
USER MANUAL
SCM-1202-0096-EN 2.1 ENGLISH

Important User Information
Liability
Every care has been taken in the preparation of this document. Please inform HMS Industrial Networks AB of any
inaccuracies or omissions. The data and illustrations found in this document are not binding. We, HMS Industrial
Networks AB, reserve the right to modify our products in line with our policy of continuous product development.
The information in this document is subject to change without notice and should not be considered as a
commitment by HMS Industrial Networks AB. HMS Industrial Networks AB assumes no responsibility for any errors
that may appear in this document.
There are many applications of this product. Those responsible for the use of this device must ensure that all the
necessary steps have been taken to verify that the applications meet all performance and safety requirements
including any applicable laws, regulations, codes, and standards.
HMS Industrial Networks AB will under no circumstances assume liability or responsibility for any problems that
may arise as a result from the use of undocumented features, timing, or functional side effects found outside the
documented scope of this 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.
The examples and illustrations in this document are included solely for illustrative purposes. Because of the many
variables and requirements associated with any particular implementation, HMS Industrial Networks AB cannot
assume responsibility for actual use based on these examples and illustrations.
Intellectual Property Rights
HMS Industrial Networks AB has intellectual property rights relating to technology embodied in the product
described in this document. These intellectual property rights may include patents and pending patent applications
in the USA and other countries.
Anybus®is a registered trademark of HMS Industrial Networks AB. All other trademarks mentioned in this document
are the property of their respective holders.
M-Bus to Modbus-TCP Gateway User Manual SCM-1202-0096-EN 2.1

M-Bus to Modbus-TCP Gateway User Manual SCM-1202-0096-EN 2.1
Table of Contents Page
1 Preface ............................................................................................................................... 3
1.1 About This Document.....................................................................................................3
1.2 Document History ..........................................................................................................3
1.3 Document Conventions ..................................................................................................4
2 Product Description ....................................................................................................... 5
3 Installation ........................................................................................................................ 6
3.1 Installation Overview......................................................................................................6
3.2 DIN Rail Mount ..............................................................................................................6
3.3 Connections and Indicators ............................................................................................7
3.4 Network Settings............................................................................................................8
4 Configuration ................................................................................................................... 9
4.1 Web Interface Login .......................................................................................................9
4.2 General Tab.................................................................................................................10
4.3 Meter Tab.................................................................................................................... 11
4.4 Configuration Tab.........................................................................................................14
4.5 Server Tab...................................................................................................................16
4.6 Security Tab ................................................................................................................17
4.7 User Tab .....................................................................................................................18
4.8 Service Tab .................................................................................................................20
4.9 Print Page ...................................................................................................................21
5 Modbus TCP Specification ......................................................................................... 22
5.1 Function Codes ...........................................................................................................22
5.2 Data Format ................................................................................................................22
6 Acquiring and Processing Meter Data..................................................................... 24
6.1 Meter Configuration .....................................................................................................24
6.2 Meter Data Format.......................................................................................................26
7 Troubleshooting ............................................................................................................ 31
7.1 Hardware Errors ..........................................................................................................31
7.2 Network Errors.............................................................................................................32
7.3 Meter Reading Errors...................................................................................................34
7.4 Meter Data Transmit Error ............................................................................................36

M-Bus to Modbus-TCP Gateway User Manual SCM-1202-0096-EN 2.1
Table of Contents
8 Advanced Configuration ............................................................................................. 37
8.1 FTP ............................................................................................................................37
8.2 SSH............................................................................................................................38
8.3 Ping............................................................................................................................38
8.4 Configuration Files.......................................................................................................39
A Technical Data................................................................................................................ 45

Preface 3 (46)
1 Preface
1.1 About This Document
This document describes how to install and configure the Anybus M-Bus to Modbus-TCP
gateway, models 024380-C and 025070-C.
For additional documentation, configuration examples, FAQs, troubleshooting guides and
technical support, please visit www.anybus.com/support.
1.2 Document History
Version Date Description
2.1 2018-02-01 First release for this model version
M-Bus to Modbus-TCP Gateway User Manual SCM-1202-0096-EN 2.1

Preface 4 (46)
1.3 Document Conventions
Ordered lists are used for instructions that must be carried out in sequence:
1. First do this
2. Then do this
Unordered (bulleted) lists are used for:
• Itemized information
• Instructions that can be carried out in any order
...and for action-result type instructions:
► This action...
➨leads to this result
Bold typeface indicates interactive parts such as connectors and switches on the hardware, or
menus and buttons in a graphical user interface.
Monospaced text is used to indicate program code and other
kinds of data input/output such as configuration scripts.
This is a cross-reference within this document: Document Conventions, p. 4
This is an external link (URL): www.hms-networks.com
This is additional information which may facilitate installation and/or operation.
This instruction must be followed to avoid a risk of reduced functionality and/or
damage to the equipment, or to avoid a network security risk.
Caution
This instruction must be followed to avoid a risk of personal injury.
WARNING
This instruction must be followed to avoid a risk of death or serious injury.
M-Bus to Modbus-TCP Gateway User Manual SCM-1202-0096-EN 2.1

Product Description 5 (46)
2 Product Description
The Anybus M-Bus to Modbus-TCP gateway allows measuring devices that use the M-Bus
protocol (meters) to communicate on a Modbus TCP network with up to 5 Modbus clients.
Meters can be added manually or automatically by scanning the M-Bus. The gateway
configuration maps data from each meter to a corresponding Modbus register. Meter data will
then be read automatically at an interval that can be set globally or individually for each meter.
The gateway and meters are configured through a built-in web interface, or by editing and
uploading configuration files via FTP. The complete configuration including the meter
configurations can be exported in HTML format.
PLC
HMI
Modbus TCP M-Bus
Fig. 1 Application example
Each gateway supports up to 20 or 80 unit loads (UL) on the M-Bus depending on model. 1 UL
equals 1.5 mA. Each meter can have more than one UL, so the total number of meters that can
be connected may be less than the maximum number of supported loads.
M-Bus to Modbus-TCP Gateway User Manual SCM-1202-0096-EN 2.1

Installation 6 (46)
3 Installation
This product contains parts that can be damaged by electrostatic discharge (ESD).
Use ESD prevention measures to avoid damage.
3.1 Installation Overview
1. Mount the unit on a DIN rail.
2. Connect the M-Bus and Ethernet cables.
3. Connect the power supply and power on the unit.
4. Check the network settings and configure them as required.
5. Open the web interface to configure the unit.
3.2 DIN Rail Mount
Fig. 2 DIN rail mounting/removing
Mounting
Hook the unit onto the rail and press it towards the rail until it snaps into place.
Removing
Pull the tab at the bottom of the unit gently downwards to release the unit.
M-Bus to Modbus-TCP Gateway User Manual SCM-1202-0096-EN 2.1

Installation 7 (46)
3.3 Connections and Indicators
To ensure a good M-Bus signal, make sure that power ground (GND) is NOT
electrically connected to protective earth (PE).
Maximum cross sectional area in terminal block = 2.5 mm
2
Terminal block
Pin Function
24VDC GND MBUS+ MBUS- MBUS+ MBUS-
24VDC +24 VDC
GND Power ground
MBUS+ M-Bus connection
MBUS-
MBUS+ M-Bus connection
MBUS-
Ethernet connector (RJ45)
Pin Function
ACTIVITY LINK
18
1 TD+
2 TD-
3 RD+
4, 5, 7, 8 (reserved)
6 RD-
LED Indicators
ACT OFF Inactive, standby
ACT ST
ACT ST
Green M-Bus readout
ST
Off Application not running
Green Application running
Orange Initializing
Orange, flashing M-Bus scan
Red Error
M-Bus to Modbus-TCP Gateway User Manual SCM-1202-0096-EN 2.1

Installation 8 (46)
3.4 Network Settings
The Anybus M-Bus to Modbus-TCP gateway is normally configured using the built-in web
interface. The IP address of the gateway must be in the same subnet range of your local
network as the computer used for configuration.
Default network settings
Static IP address 192.168.1.101
Subnet mask 255.255.255.0
Default gateway 192.168.1.254
The network settings can be configured automatically from a DHCP server or manually using
the configuration tool Net discover. The settings can also be changed from the web interface
after you have logged in.
Make sure that you have all necessary information about your local network before
starting installation. Contact your network administrator if in doubt.
Changing Network Settings with Net discover
1. Download Net discover from www.anybus.com/support and install it on your computer.
2. In Net discover, right-click on the entry for the device and select the configuration option.
Fig. 3 Net discover
3. If the network uses static IP addressing, enter the desired IP address, subnet mask and
default gateway address. If the network uses dynamic IP addressing, check the DHCP
checkbox. Contact your network administrator if in doubt.
Do not enable DHCP if there is no active DHCP server on the network.
4. Click on Send to download the IP settings to the gateway.
Right-click on the gateway in Net discover and select HTTP Web to open the web interface in
your default browser. You can also access the web interface by entering the IP address in the
address field of any standard web browser.
Additional features of Net discover are described in Advanced Configuration, p. 37.
M-Bus to Modbus-TCP Gateway User Manual SCM-1202-0096-EN 2.1

Configuration 9 (46)
4 Configuration
When power is applied the gateway will run the following startup sequence:
1. Applying TCP/IP network settings using DHCP or static configuration
2. Initial generation of SSL device keys (may take some time on first startup)
3. Setting system time via SNTP
4. Starting system services
5. Starting the main application
The Anybus M-Bus to Modbus-TCP gateway is normally configured using the web interface,
which gives access to all device parameters, meter configuration, and services.
The gateway can also be configured by editing and uploading configuration files directly to the
device using FTP. See Advanced Configuration, p. 37.
4.1 Web Interface Login
The first time you access the web interface you will be automatically logged in as the default
username (web). You can also log in as the default user manually by clicking Default Login on
the login screen. The default user only has read access.
If the default user has been disabled in the configuration, you must enter a valid username and
password and click Login.
Fig. 4 Login window
Default usernames and passwords
Username Password Description
admin admin Administrator user with root access, allows full access to all services (HTTP,
FTP, flash update, IP configuration).
web web Default user for the web interface. Allows write access to the web interface.
If a user with this name and password exists, the web server will automatically
log in with these credentials when accessed.
ftp ftp User for FTP access to the log directory of the gateway (C:/log/)
If you are logged in with write access you should always log out after finishing the
configuration, as only one user with write access can be logged in at a time. If your
session stays active, other users will not be able to log in with write access.
M-Bus to Modbus-TCP Gateway User Manual SCM-1202-0096-EN 2.1

Configuration 10 (46)
4.2 General Tab
This tab contains general network settings.
Fig. 5 General tab
Field Description Writable
Device name Name of the gateway (displayed in configuration tool) Yes
Serial number Serial number of the gateway No
DHCP Enable/disable dynamic IP addressing Yes
IP address IP address of the gateway Yes
Subnet mask Subnet mask of the gateway Yes
Gateway address IP address of the default gateway/router on the local network Yes
DNS IP IP address of the DNS server on the local network Yes
Free Memory Flash Available storage space in the internal memory No
System date (local) Current local system date Yes
System time (local) Current local system time Yes
SNTP Server IP address of SNTP time server Yes
The network parameters will be disabled if DHCP is checked.
Discard changes and reload the current settings
Save the changes and reinitialize the gateway
See Print Page, p. 21.
Changing the network configuration may restrict accessibility. Contact your
network administrator for guidance if in doubt.
If the network configuration is changed, the gateway will be available under the new IP address
after saving. All established network connections to the gateway will be terminated, and all
logged in users will be logged out.
Date and time are processed internally as UTC time (without time zone shift). The web browser
will then convert the date and time according to the local time zone of the computer.
M-Bus to Modbus-TCP Gateway User Manual SCM-1202-0096-EN 2.1

Configuration 11 (46)
4.3 Meter Tab
This tab lists the connected meters and allows you to add and edit individual entries.
Fig. 6 Meter tab
The meter list is initially empty. After connecting meters to the gateway, click Scan to start
populating the list. The scanning settings can be changed on the Configuration tab.
Successive scans will add discovered meters to the list. Existing meters will not be deleted
even if they are unavailable. To delete a meter from the list, select it and click Delete.
Scanning can take a long time depending on the scan mode and the number of connected
meters. The scan process cannot be interrupted.
Discard the changes made on the page and reload the currently active settings.
Refresh all the read out meter values. The normal update cycle will not be not affected.
Scan for meters on the M-Bus.
Add meters not found during a scan or that do not support an automated scan.
Delete the selected meter entry. Individual value entries cannot be deleted.
Save the changes and reinitialize the gateway.
See Print Page, p. 21.
M-Bus to Modbus-TCP Gateway User Manual SCM-1202-0096-EN 2.1

Configuration 12 (46)
The default configuration for each meter is applied immediately after scanning. Additional
changes to the configuration must be saved manually.
When activating or deactivating a meter, its meter values will automatically be enabled or
disabled according to the hierarchy. An inactive meter will be activated when one of its meter
values is enabled.
Hold down the SHIFT or CTRL keys to select multiple meters or meter values.
Meter tab fields
Field Description Writable
Interface Interface of meter (M-Bus) No
S Entry status
E = Value has been edited
* = Value display is limited in the configuration
!= Unable to read value
No
Serial Serial number of meter No
MAN Manufacturer of meter (3-letter abbreviation) No
Medium Medium of meter No
Version Version number of meter No
Link Primary address No
Value Meter reading or measurement value No
Scale Scale factor (scientific notation) No
Unit Unit No
Cycle Readout interval in seconds (0 = use general readout interval) Yes
User label User specific description of meter or value.
Included in export of CSV data, allows application specific mapping.
Yes
Description Description of meter value No
Register Modbus register address in steps of 10 Yes
The arrangement of data in the meter list corresponds to the order of the data in the M-Bus
protocol. The meaning of the values can thus be compared directly with the data sheet of the
meter. It is also possible to assign the meter values to the raw data of the meter.
Timestamps
Timestamp values transmitted within the M-Bus protocol are automatically assigned to the
other meter values where possible. This means that some of the timestamps may not appear in
the list. To enable the display of all timestamps values in the list, set the system configuration
parameter MUC_SHOWTIMESTAMPENTRIES to 1. See Configuration Files, p. 39.
Webserver capacity error
If a scan or a change in the meter list is terminated with the error message “Webserver capacity
exceeded”, see Troubleshooting, p. 31.
M-Bus to Modbus-TCP Gateway User Manual SCM-1202-0096-EN 2.1

Configuration 13 (46)
Editing Entries
Fig. 7 Editing meter and value entries
Meter and value entries can be configured by double-clicking the entry or by right-clicking the
entry and selecting Edit. The fields in the Edit dialog correlate with the fields in the meter list.
Depending on the used interface some fields may be disabled for editing.
The readout interval can be set independently for each meter in the field Cycle. If no value is
entered the global readout interval will be used, see Configuration Tab, p. 14.
Each meter or value entry can be assigned a User label for application-specific use. The label
can consist of up to 50 characters including spaces.
Valid characters in user labels: A-Z, a-z, 0-9, ! § $ % & / ( ) = ? + , . *
Invalid characters: < > “ ”
Modbus Address Allocation
The Modbus register address can be assigned or reset for a single meter or for all meters by
right-clicking on the entry and selecting Allocate or Deallocate. If duplicate addresses are
detected an error message will be shown when the configuration is saved.
M-Bus to Modbus-TCP Gateway User Manual SCM-1202-0096-EN 2.1

Configuration 14 (46)
4.4 Configuration Tab
This tab provides global meter settings.
Fig. 8 Configuration tab
Discard the changes made on the page and reload the currently active settings.
Save the changes and reinitialize the gateway.
See Print Page, p. 21.
M-Bus to Modbus-TCP Gateway User Manual SCM-1202-0096-EN 2.1

Configuration 15 (46)
Configuration tab fields
Field Description Writable
Readout interval (s) Standard readout cycle of meters (in seconds). Value might be overwritten for each
meter by parameter Cycle in tab Meter
Yes
Description mode Mode of displaying the meter value description.
None No display of description
Standard Display of common value description.
Extended Extended display of value description (if not 0).
Notation: Description [Memory] <Tariff> {min|max|error}
Example: Energy [2] <1> {max}
Extended
with DIF/VIF
Extended display including DIF and VIF raw data.
Notation: Description [Memory] <Tariff> {Value Type} # XX XX XX…
Example: Energy [2] <1> # 8C 11 04
Extended
with raw data
Extended display including raw data of the complete value entry.
Notation: Description [Memory] <Tariff> {Value Type} # XX XX XX…
Example: Energy [2] <1> # 8C 11 04 96 47 06 00
DIF/VIF Display of DIF/VIF raw data
Raw data Displays the raw data of the complete meter value entry.
After changing this parameter a readout is needed to update the
meter list and to display the relevant data.
Yes
Maximum device count Maximum number of meters to scan (0 = no limitation).
Already configured meters are not affected by this parameter.
Yes
Maximum value count Maximum number of meter value entries to read during a readout (0 = no limitation).
Already configured meter value entries are not affected by this parameter.
Yes
RAW log active Activates the raw data log. Yes
M-Bus mode M-Bus scan mode (secondary, reverse secondary or primary search) Yes
Primary start address First address for primary search Yes
Primary final address Last address for primary search Yes
Secondary address
mask
Search mask for secondary search, 8 numerical characters.
Fdefines a wildcard. Missing characters will be filled up with leading zeros
Yes
M-Bus baud rate Baudrate for M-Bus communication (300–19200 baud) Yes
M-Bus timeout M-Bus timeout until reception of first data (ms) Yes
M-Bus idle timeout M-Bus timeout until end of reception (ms) Yes
M-Bus full timeout M-Bus timeout (complete) for reception of a whole data packet (ms) Yes
M-Bus request mode Mode of the M-Bus readout (REQ_UD2)
Standard Readout with REQ_UD2
Extended 1 Readout with Get-All-Data (DIF/VIF 7F 7E) and REQ_UD2
Extended 2 Readout with Get-All-Data (DIF 7F) and REQ_UD2
Yes
M-Bus reset mode Mode of the M-Bus Reset (before scan and readout)
None No reset
Standard Send SND_NKE to primary address of the meter or broadcast
address when using secondary adressing.
Extended 1 Send SND_NKE to primary address FD and SND_NKE to primary
address of the meter or broadcast address when using secondary
addressing.
Extended 2 Send SND_NKE and an Application Reset to primary address FD
and a SND_NKE to the primary address of the meter or to
broadcast address when using secondary addressing.
Yes
M-Bus max. multipage Limits the count of multipage requests Yes
M-Bus to Modbus-TCP Gateway User Manual SCM-1202-0096-EN 2.1

Configuration 16 (46)
4.5 Server Tab
This tab provides settings for the Modbus TCP interface.
Fig. 9 Server tab
Server tab fields
Field Description Writable
Modbus mode Select Modbus TCP (default) or Modbus UDP.
A maximum of 5 simultaneous connections from Modbus masters are
accepted in Modbus TCP mode.
Yes
Modbus port Port number that the Modbus TCP client (master) should connect to.
Default = 502.
Yes
Modbus test Activates a dummy process image for testing purposes.
See Modbus TCP Specification, p. 22.
Yes
Modbus swap Swap the byte order from MSB first (default) to LSB first. Yes
Modbus float only Use a compressed register layout with double words per value and only
the floating point representation of a meter value.
Yes
Modbus multi slave Represent each meter as an individual Modbus slave address. Yes
Discard the changes made on the page and reload the currently active settings.
Save the changes and reinitialize the gateway.
See Print Page, p. 21.
M-Bus to Modbus-TCP Gateway User Manual SCM-1202-0096-EN 2.1

Configuration 17 (46)
4.6 Security Tab
This tab allows you to enable/disable access to the gateway over FTP, SSH and Telnet
connections.
Fig. 10 Security tab
Server tab fields
Field Description Writable
FTP server active Enable FTP server Yes
SSH server active Enable SSH server Yes
Telnet server active Enable Telnet server Yes
Discard the changes made on the page and reload the currently active settings.
Save the changes and reinitialize the gateway.
See Print Page, p. 21.
M-Bus to Modbus-TCP Gateway User Manual SCM-1202-0096-EN 2.1

Configuration 18 (46)
4.7 User Tab
This tab allows you to create and manage users and assign them specific access rights.
Fig. 11 User tab
User tab fields
Field Description Writable
Name Username No
Overwrite password Not used Yes
Change password User is allowed to change his/her password Yes
Sessions Number of currently open session with this user account No
Maximum sessions Max. number of simultaneous sessions for this user (-1 = unlimited) Yes
Read General Read access for tab General Yes
Write General Write access for tab General Yes
Read Meter Read access for tab Meter Yes
Write Meter Write access for tab Meter Yes
Read Config Read access for tab Configuration Yes
Write Config Write access for tab Configuration Yes
Read Server Read access for tab Server Yes
Write Server Write access for tab Server Yes
Read Security Read access for tab Security Yes
Write Security Write access for tab Security Yes
Read Service Read access for tab Service Yes
Write Service Write access for tab Service Yes
Write User Read/Write access for tab User Yes
FTP User is allowed to access the FTP server (maximum 2 users) No
Discard the changes made on the page and reload the currently active settings.
Add a new user
Delete the selected user
Save the changes and reinitialize the gateway.
See Print Page, p. 21.
M-Bus to Modbus-TCP Gateway User Manual SCM-1202-0096-EN 2.1