Solvimus MBUS-GEV User manual

MBUS-GEV - USER MANUAL

MBUS-GEV

Gateway for

Smart Metering

Version: 1.1

Date: 6 December 2022

Firmware Version 1.35

Authors:

Remo Reichel, Frank Richter

solvimus GmbH

Ratsteichstr. 5

98693 Ilmenau

Germany

solvimus GmbH – Ratsteichstr. 5 – 98693 Ilmenau – Germany

Telephone: +49 3677 7613060 – Fax: +49 3677 7613069 – E-Mail: [email protected]

MBUS-GEV - User manual

Page intentionally left blank

Page 2/78

UG_EN_MBUS-GEV.pdf

Version: 1.1

Released

Frank Richter, 6 December 2022

©solvimus GmbH

MBUS-GEV - User manual

Table of Contents

Table of Contents 3

1 Notes and conventions 5

1.1 Aboutthisdocument ....................................... 5

1.2 Legalbasis............................................. 5

1.2.1 Placingonthemarket................................... 5

1.2.2 Copyrightprotection ................................... 5

1.2.3 Personnelqualiﬁcation .................................. 5

1.2.4 Intendeduse........................................ 5

1.2.5 Exclusionofliability.................................... 5

1.2.6 Disclaimer......................................... 5

1.3 Symbols .............................................. 6

1.4 Fontconventions ......................................... 6

1.5 Numbernotation ......................................... 6

1.6 Safetyguidelines.......................................... 7

1.7 Scope ............................................... 7

1.8 Abbreviations ........................................... 7

2 Introducing the device 10

2.1 Generalinformation ........................................ 10

2.2 Delivery variants and scope of delivery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

2.3 Connectors............................................. 10

2.4 StatusLEDs............................................ 11

2.5 Firststeps ............................................. 11

2.5.1 Powersupply ....................................... 11

2.5.2 Network conﬁguration and ﬁrst steps . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

2.6 Speciﬁctroubleshooting...................................... 13

2.6.1 All LEDs remain oﬀ, the device does not respond. . . . . . . . . . . . . . . . . . . . . 14

2.6.2 Cyclic ﬂashing of COL, TX, RX of a 3 U wide variant. . . . . . . . . . . . . . . . . . 14

2.7 Technicaldata........................................... 14

2.7.1 Generalspeciﬁcations................................... 14

2.7.2 Electrical speciﬁcations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

2.7.3 Furtherspeciﬁcations ................................... 15

3 Tool Netdiscover 16

3.1 Generalinformation ........................................ 16

3.2 Discovering and accessing devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

3.3 Networkconﬁguration....................................... 17

3.4 Access to the web-based front end via HTTP . . . . . . . . . . . . . . . . . . . . . . . . . . 18

3.5 Access to the ﬁle system via FTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

3.6 Access to the command line via SSH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

3.7 Massdeployment ......................................... 21

3.8 Importofadevicelist....................................... 23

3.9 Troubleshootingnetwork ..................................... 23

3.9.1 Nonetworkconnection .................................. 23

3.9.2 The device can not be accessed via website respectively FTP(S) . . . . . . . . . . . . 24

4 Web-based front end 25

4.1 Generalinformation ........................................ 25

4.2 AccessviaHTTPS......................................... 26

4.3 TabGeneral ............................................ 26

4.4 TabMeter............................................. 28

4.4.1 Systemmeter ....................................... 31

4.5 TabOutput ............................................ 31

4.6 TabConﬁguration......................................... 32

Frank Richter, 6 December 2022

©solvimus GmbH

Version: 1.1

Released

Page 3/78

UG_EN_MBUS-GEV.pdf

MBUS-GEV - User manual

4.7 TabWAN ............................................. 34

4.8 TabServer............................................. 36

4.9 TabSecurity............................................ 38

4.10TabUser.............................................. 39

4.11TabLog .............................................. 41

4.12TabService ............................................ 42

4.13Printpage ............................................. 43

4.14 Troubleshooting the front end . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

4.14.1 Website or front end cannot be accessed . . . . . . . . . . . . . . . . . . . . . . . . . 44

4.14.2 Login to website is refused . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

4.14.3 All input ﬁelds or buttons are greyed out . . . . . . . . . . . . . . . . . . . . . . . . . 45

4.14.4 Notalltabsarevisible .................................. 45

4.14.5 Export of the meter readings of one/several meters is empty . . . . . . . . . . . . . . 45

4.14.6 TheLogisempty ..................................... 46

5 Reading meters via M-Bus 47

5.1 Generalinformation ........................................ 47

5.2 SignallingontheM-Bus...................................... 47

5.3 Conﬁguration of the interface on the web-based front end . . . . . . . . . . . . . . . . . . . . 48

5.3.1 M-Busmode........................................ 48

5.3.2 Addressing, scanning and scan range . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

5.3.3 M-Busbaudrate ..................................... 50

5.3.4 M-Bustimeouts...................................... 51

5.3.5 M-Busrequestmode ................................... 51

5.3.6 M-Busresetmode..................................... 51

5.3.7 M-Busmultipaging .................................... 52

5.4 TroubleshootingtheM-Bus.................................... 52

5.4.1 Physical troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

5.4.2 M-Bus meters are not found . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

5.4.3 M-Bus meters are found, but do not show any data . . . . . . . . . . . . . . . . . . . 54

5.4.4 The scan takes a long time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

5.4.5 Device restarts during scan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

6 Advanced conﬁguration options 55

6.1 Linuxoperatingsystem ...................................... 55

6.1.1 User roles and user rights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

6.1.2 Commandline....................................... 55

6.2 Update............................................... 57

6.3 Conﬁgurationﬁlechip.ini ..................................... 57

6.4 Conﬁguration ﬁle Device_Handle.cfg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

6.5 OpenVPNclient.......................................... 71

6.5.1 Conﬁguration of the devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

6.6 Preconﬁguration of the meter list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

6.6.1 File meter-conf-import.csv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

6.6.2 FileDevice_Conﬁg.cfg .................................. 72

6.7 Scripting.............................................. 72

6.7.1 XSLTparser........................................ 72

6.7.2 Reportscript........................................ 73

6.7.3 Systemmeterscript.................................... 74

6.8 Media types, measurement types and units . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

7 Accessory 78

Page 4/78

UG_EN_MBUS-GEV.pdf

Version: 1.1

Released

Frank Richter, 6 December 2022

©solvimus GmbH

MBUS-GEV - User manual

1 Notes and conventions

1.1 About this document

This manual provides guidance and procedures for a fast and eﬃcient installation and start-up of the units

described in this manual. It is imperative to read and carefully follow the safety guidelines.

1.2 Legal basis

1.2.1 Placing on the market

Manufacturer of the MBUS-GEV is the solvimus GmbH, Ratsteichstraße 5, 98693 Ilmenau, Germany.

1.2.2 Copyright protection

This documentation, including all illustrations contained therein, is protected by copyright. The author is

solvimus GmbH, Ilmenau. The exploitation rights are also held by solvimus GmbH. Any further use that

deviates from the copyright regulations is not allowed. Reproduction, translation into other languages, as

well as electronic and phototechnical archiving and modiﬁcation require the written permission of solvimus

GmbH. Violations will result in a claim for damages. The solvimus GmbH reserves the right to provide for any

alterations or modiﬁcations that serve to increase the eﬃciency of technical progress. All rights in the event

of the granting of a patent or the protection of a utility model are reserved by solvimus GmbH. Third-party

products are always mentioned without reference to patent rights. The existence of such rights can therefore

not be excluded.

1.2.3 Personnel qualiﬁcation

The product use described in this documentation is intended exclusively for qualiﬁed electricians or persons

instructed by these. They must all have good knowledge in the following areas:

•Applicable standards

•Use of electronic devices

1.2.4 Intended use

If necessary, the components or assemblies are delivered ex works with a ﬁxed hardware and software conﬁg-

uration for the respective application. Modiﬁcations are only permitted within the scope of the possibilities

shown in the documentation. All other changes to the hardware or software as well as the non-intended use

of the components result in the exclusion of liability on the part of solvimus GmbH. Please send any requests

for a modiﬁed or new hardware or software conﬁguration to solvimus GmbH.

1.2.5 Exclusion of liability

Study this manual and all instructions thoroughly prior to the ﬁrst use of this product and respect all safety

warnings, even if you are familiar with handling and operating electronic devices.

The solvimus GmbH accepts no liability for damage to objects and persons caused by erroneous operation, inap-

propriate handling, improper or non-intended use or disregard for this manual, especially the safety guidelines,

and any warranty is void.

1.2.6 Disclaimer

All products, company names, trademarks and brands are the property of their respective holders. Their use

serves only to describe and identify the respective company, product or service. Use of them does not imply

any aﬃliation with, commercial relationship with or endorsement by them.

Frank Richter, 6 December 2022

©solvimus GmbH

Version: 1.1

Released

Page 5/78

UG_EN_MBUS-GEV.pdf

MBUS-GEV - User manual

Firefox is a trademark of the Mozilla Foundation in the U.S. and other countries.

Chrome™browser is a trademark of Google Inc.

Microsoft Excel is a trademark of the Microsoft group of companies.

1.3 Symbols

Danger: It is essential to observe this information in order to protect persons from injury.

Caution: It is essential to observe this information in order to prevent damage to the device.

Notice: Boundary conditions that must always be observed to ensure smooth and eﬃcient operation.

ESD (Electrostatic Discharge): Warning of danger to components due to electrostatic discharge. Observe

precautionary measures when handling components at risk of electrostatic discharge.

Note: Routines or advice for eﬃcient equipment use.

Further information: References to additional literature, manuals, data sheets and internet pages.

1.4 Font conventions

Names of paths and ﬁles are marked in italics. According to the system the notation is using slash or backslash.

e. g.: D: \Data

Menu items or tabs are marked in bold italics.

e. g.: Save

An arrow between two menu items or tabs indicates the selection of a sub-menu item from a menu or a

navigation process in the web browser.

e. g.: File →New

Buttons and input ﬁelds are shown in bold letters.

e. g.: Input

Key labels are enclosed in angle brackets and shown in bold with capital letters.

e. g.: ⟨F5⟩

Programme codes are printed in Courier font.

e. g.: ENDVAR

Variable names, identiﬁers and parameter entries are marked in italics.

e. g.: Value

1.5 Number notation

Numbers a noted according to this table:

Numbering system Example Comments

Decimal 100 Normal notation

Hexadecimal 0x64 C-like notation

Binary ’100’ In apostrophes

’0110.0100’ Nibbles separated by dots

Table 1: Numbering systems

Page 6/78

UG_EN_MBUS-GEV.pdf

Version: 1.1

Released

Frank Richter, 6 December 2022

©solvimus GmbH

MBUS-GEV - User manual

1.6 Safety guidelines

Observe the recognized rules of technology and the legal requirements, standards and norms, and other

recommendations.

Study the instructions for the extinction of ﬁre in electrical installations.

The power supply must be switched oﬀ before replacing components and modules.

If the contacts are deformed, the aﬀected module or connector must be replaced, as the function is not guar-

anteed in the long term.

The components are not resistant to substances that have creeping and insulating properties. These include

e.g. aerosols, silicones, triglycerides (ingredient of some hand creams). If the presence of these substances in

the vicinity of the components cannot be excluded, additional measures must be taken:

•Install the components in an appropriate casing.

•Handle components with clean tools and materials only.

Only use a soft, wet cloth for cleaning. Soapy water is allowed. Pay attention to ESD.

Do not use solvents like alcohol, acetone etc. for cleaning.

Do not use a contact spray, because in an extreme case the function of the contact point is impaired

and may lead to short circuits.

Assemblies, especially OEM modules, are designed for installation in electronic housings. Do not touch

the assembly when it is live. In each case, the valid standards and directives applicable to the construction

of control cabinets must be observed.

The components are populated with electronic parts which can be destroyed by an electrostatic discharge.

When handling the components, ensure that everything in the vicinity is well earthed (personnel, work-

place and packaging). Do not touch electrically conductive components, e.g. data contacts.

1.7 Scope

This documentation describes the device manufactured by solvimus GmbH, Ilmenau, and stated on the title

page.

1.8 Abbreviations

Abbreviation Meaning

2G Mobile radio standard, synonym for GSM or GPRS

3G Mobile radio standard, synonym for UMTS

4G Mobile radio standard, synonym for LTE

ACK Acknowledge

AES Advanced Encryption Standard

AFL Authentication and Fragmentation Layer

AI Analog Input

ANSI American National Standards Institute

AO Analog Output

APN Access Point Name

ASCII American Standard Code for Information Interchange

ASHRAE American Society of Heating, Refrigerating and Air-Conditioning Engineers

BACnet Building Automation and Control networks

BBMD BACnet Broadcast Management Device

BCD Binary-coded decimal numbers

BDT Broadcast Distribution Table

BMS Building Management System

CA Certiﬁcation Authority

CHAP Challenge Handshake Authentication Protocol

CI Control Information

CLI Command line interface

COSEM COmpanion Speciﬁcation for Energy Metering

CPU Central processing unit

CRC Cyclic redundancy check

CSV Character-Separated Values

Continued on next page

Frank Richter, 6 December 2022

©solvimus GmbH

Version: 1.1

Released

Page 7/78

UG_EN_MBUS-GEV.pdf

MBUS-GEV - User manual

Table 2 – Continued from previous page

Abbreviation Meaning

CTS Clear to send

D0 D0 interface (optical interface, IEC 62056-21)

DDC Direct Digital Control

DHCP Dynamic Host Conﬁguration Protocol

DI Digital Input, digital input terminal

DIF Data information ﬁeld

DIFE Data information ﬁeld extensions

DIN Deutsches Institut für Normung, German Institute for Standardization

DLDE Direct Local Data Exchange (EN 62056-21, IEC 1107)

DLDERS DLDE communication via RS-232 or RS-485

DLMS Device Language Message Speciﬁcation

DNS Domain Name System

DO Digital Output, digital output terminal

EEG German Renewable Energy Sources Act

EIA/TIA Electronic Industries Alliance/Telecommunications Industry Association

ELL Extended Link Layer

EMC Electromagnetic compatibility

EN European norm

ESD Electrostatic Discharge

FCB Frame Count Bit

FCV Frame Count Valid Bit

FNN Forum Netztechnik/Netzbetrieb, subgroup of VDE

FSK Frequency Shift Keying

FTP File Transfer Protocol

FTPS FTP via TLS

GB Gigabyte

GMT Greenwich Mean Time

GPRS General Packet Radio Service

GSM Global System for Mobile Communications

HCA Heat cost allocator

HTTP Hypertext Transfer Protocol

HTTPS Hypertext Transfer Protocol Secure

I2C Inter-Integrated Circuit

I/O Input/Output

ICMP Internet Control Message Protocol

ID Identiﬁcation, Identiﬁer, unique marking

IEC International Electrotechnical Commission

IEEE Institute of Electrical and Electronics Engineers

IoT Internet of Things

IP Internet Protocol or IP address

ISO International Organization for Standardization

JSON JavaScript Object Notation

LAN Local area network

LED Light-Emitting Diode

LSB Least signiﬁcant byte

LSW Least signiﬁcant word

LTE Long Term Evolution

M2M Machine-to-Machine

M-Bus Meter-Bus (EN 13757, part 2, 3 and 7)

MAC Medium Access Control or MAC-Adresse

MB Megabyte

MCR Multi Channel Reporting

MDM Meter Data Management

MEI Modbus Encapsulated Interface

MHz Megahertz

MQTT Message Queuing Telemetry Transport

MSB Most Signiﬁcant Byte

MSW Most Signiﬁcant Word

MUC Multi Utility Communication, MUC controller

NB-IoT Narrow Band Internet of Things

OBIS Object Identiﬁcation System

OEM Original Equipment Manufacturer

OMS Open Metering System

PAP Password Authentication Protocol

PEM Privacy Enhanced Mail

PIN Personal Identiﬁcation Number

PKI Public Key Infrastructure

PLC Programmable Logic Controller

PPP Point-to-Point Protocol

PPPoE Point-to-Point Protocol over Ethernet

PUK Personal Unblocking Key

Continued on next page

Page 8/78

UG_EN_MBUS-GEV.pdf

Version: 1.1

Released

Frank Richter, 6 December 2022

©solvimus GmbH

MBUS-GEV - User manual

Table 2 – Continued from previous page

Abbreviation Meaning

RAM Random Access Memory

REQ_UD Request User Data (Class 1 or 2)

RFC Requests For Comments

RSP_UD Respond User Data

RSSI Received Signal Strength Indicator

RTC Real-Time Clock

RTOS Real-Time Operating System

RTS Request to send

RTU Remote Terminal Unit

S0 S0 interface (pulse interface, EN 62053-31)

SCADA Supervisory Control and Data Acquisition

SCP Secure Copy

SFTP SSH File Transfer Protocol

SIM Subscriber Identity Module

SML Smart Message Language

SMTP Simple Mail Transfer Protocol

SND_NKE Send Link Reset

SND_UD Send User Data to slave

SNTP Simple Network Time Protocol

SPST Single Pole Single Throw Relay (closing switch)

SRD Short Range Device

SSH Secure Shell

SSL Secure Sockets Layer

TCP Transmission Control Protocol

THT Through-Hole Technology

TLS Transport Layer Security

U Unit width of the housing (1 U = 18 mm)

UART Universal Asynchronous Receiver Transmitter

UDP User Datagram Protocol

UL Unit load for M-Bus

UMTS Universal Mobile Telecommunications System

UTC Universal Time Coordinated

VDE Verband der Elektrotechnik Elektronik Informationstechnik e.V., German association

VHF Very high frequency

VIF Value information ﬁeld

VIFE Value information ﬁeld extensions

VLAN Virtual Local Area Network

VPN Virtual Private Network

WAN Wide Area Network

WLAN Wireless Local Area Network

wM-Bus Wireless Meter-Bus (EN 13757, part 3, 4 and 7)

XML eXtensible Markup Language

XSLT eXtensible Stylesheet Language Transformation

Table 2: Abbreviations

Frank Richter, 6 December 2022

©solvimus GmbH

Version: 1.1

Released

Page 9/78

UG_EN_MBUS-GEV.pdf

MBUS-GEV - User manual

2 Introducing the device

2.1 General information

The M-Bus (Meter-Bus) is an established and well-known interface for automated meter reading. Especially

the ease of installation (simple two-wire system with powering by the bus) and the robustness are important

features. These are also special attributes that are of interest for use in industrial environments.

The M-Bus is deﬁned in the standard EN 13757. It establishes an own physics as well as an own protocol.

For connecting it to other systems, a translation is necessary.

Oftentimes, the interpretation of the protocol and of the data is done in a PC or another host system with

M-Bus software. Thus, the physics of the M-Bus must be connected to available interfaces. This is commonly

achieved with level converters for the RS-232 interface. However, the communication via RS-232 is limited to

short distances.

Ethernet as a means of communication enables larger distances and is already widely employed. It is thus

advantageous to read out data from distributed installations via Ethernet. Hence, any PC with an Ethernet

interface can be made a (physical) bus master. With the products MBUS-GE20V and MBUS-GE80V (in

the sequel MBUS-GEV for brevity), two gateways are available that transmit M-Bus data via Ethernet in a

transparent mode. A driver for a virtual COM port, interfacing to a PC is intuitive and integrates into existing

software solutions.

The device supports operating 20 respectively 80 unit loads (UL, mostly equivalent to the number of meters)

at the wired M-Bus. The communication is controlled entirely by the software on the PC. The MBUS-GEV

merely transmits the data.

The MBUS-GEV comes in a housing 2 U (modules) wide and is intended for top hat rail mounting (DIN rail

35 mm).

The serial number of the devices of the solvimus GmbH can be read from the housing.

2.2 Delivery variants and scope of delivery

The MBUS-GEV is oﬀered in a range of variants, and so can easily be adapted to the requirements of the

particular property.

Variant Order number M-Bus

MBUS-GE20V 500332 20 UL

MBUS-GE80V 500333 80 UL

Table 3: Delivery variants

The scope of delivery contains the device and a Quick Start Guide.

2.3 Connectors

The various interfaces of the MBUS-GEV are on diﬀerent sides of the device.

The following ﬁgure shows the device.

Page 10/78

UG_EN_MBUS-GEV.pdf

Version: 1.1

Released

Frank Richter, 6 December 2022

©solvimus GmbH

Table of contents

Other Solvimus Gateway manuals

Solvimus

Solvimus MBUS-GEB User manual

Popular Gateway manuals by other brands

LST

LST M500RFE-AS Specification sheet

Kinnex

Kinnex Media Gateway quick start guide

2N Telekomunikace

2N Telekomunikace 2N StarGate user manual

Mitsubishi Heavy Industries

Mitsubishi Heavy Industries Superlink SC-WBGW256 Original instructions

ZyXEL Communications

ZyXEL Communications ZYWALL2 ET 2WE user guide

Telsey

Telsey CPVA 500 - SIP Technical manual

RTA

RTA 460A-NNA4 Product user guide

Shaw

Shaw Gateway HDPVR user manual

ABB

ABB VSN900 Commissioning manual

Commander

Commander Pulse owner's manual

2N Telekomunikace

2N Telekomunikace ATEUS EasyGate 501309E manual

NETGEAR

NETGEAR C6300BD installation guide

Amit

Amit CDW531AM user guide

HMS

HMS Netbiter EasyConnect EC150 user manual

Huawei

Huawei EchoLife HG620 user guide

AT&T

AT&T U-verse 3801 Replacement self-installation guide

Logic IO

Logic IO RTCU MX2 turbo Technical manual

Suttle

Suttle MediaMAX MXM-521 installation instructions