Solvimus MBUS-GEV User Manual
  1. Manuals
  2. Brands
  3. Solvimus Manuals
  4. Gateway
  5. MBUS-GEV
  6. User manual

Solvimus MBUS-GEV User Manual

Gateway for smart metering
Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this 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: info@solvimus.de

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the MBUS-GEV and is the answer not in the manual?

Questions and answers

Related Manuals for Solvimus MBUS-GEV

Summary of Contents for Solvimus MBUS-GEV

  • Page 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: info@solvimus.de...
  • Page 2 MBUS-GEV - User manual Page intentionally left blank Page 2/78 Version: 1.1 Frank Richter, 6 December 2022 UG_EN_MBUS-GEV.pdf Released © solvimus GmbH...

  • Page 3: Table Of Contents

    MBUS-GEV - User manual Table of Contents Table of Contents 1 Notes and conventions 1.1 About this document ........
  • Page 4 MBUS-GEV - User manual 4.7 Tab WAN ..........

  • Page 5: Notes And Conventions

    GmbH. Violations will result in a claim for damages. The solvimus GmbH reserves the right to provide for any alterations or modifications that serve to increase the efficiency 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.

  • Page 6: Symbols

    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. 7-Zip Copyright (C) 1999-2022 Igor Pavlov.

  • Page 7: Safety Guidelines

    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...
  • Page 8 MBUS-GEV - User manual Table 2 – Continued from previous page Abbreviation Meaning Clear to send D0 interface (optical interface, IEC 62056-21) Direct Digital Control DHCP Dynamic Host Configuration Protocol Digital Input, digital input terminal Data information field DIFE Data information field extensions Deutsches Institut für Normung, German Institute for Standardization...
  • Page 9 MBUS-GEV - User manual Table 2 – Continued from previous page Abbreviation Meaning Random Access Memory REQ_UD Request User Data (Class 1 or 2) Requests For Comments RSP_UD Respond User Data RSSI Received Signal Strength Indicator Real-Time Clock RTOS Real-Time Operating System...

  • Page 10: Introducing The Device

    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).

  • Page 11: Status Leds

    In the operating state, the State-LED is green and the Active-LED flashes green briefly during the readout. 2.5 First steps 2.5.1 Power supply The MBUS-GEV requires an external power supply 24 VDC. The MBUS-GEV starts automatically after con- nection to the supply voltage. By default, the following calls are made on system startup: •...

  • Page 12: Network Configuration And First Steps

    PC. The MBUS-GEV is fully transparent to the data communication on the M-Bus. This means that the device is not visible as an M-Bus slave and baud rate changes of the M-Bus master do not need any user interaction.

  • Page 13: Specific Troubleshooting

    Figure 4: WinSCP main window after establishing the connection 2.6 Specific troubleshooting In case the MBUS-GEV does not work as described in this document, it is useful to locate the malfunction in order to resolve the issue and to recover the full functionality again.

  • Page 14: All Leds Remain Off, The Device Does Not Respond

    Only trained and appropriately qualified personnel are allowed to check the electric power supply (see Section 1.2.3). Switch off the power supply and remove the device. Remove all cables and antennas. Test the MBUS-GEV under laboratory conditions, that means at an isolated and separate measurement installation. Switch on the power supply at that measurement installation.

  • Page 15: Electrical Specifications

    MBUS-GEV - User manual 2.7.2 Electrical specifications Power supply The device is powered by an external power supply (pin assignment see Section 2.3): • Voltage: 21.6-24.5 VDC, screw terminals ( 2.5 mm , tightening torque 0.5 Nm) • Power consumption: 2 W (idle state), max. 10 W •...

  • Page 16: Tool Netdiscover

    3.2 Discovering and accessing devices After the tool is started, it uses UDP broadcast via UDP port 8001 to discover all devices from solvimus GmbH accessible in the local network and displays them in the main window.

  • Page 17: Network Configuration

    MBUS-GEV - User manual • SSH: startet Putty with the IP of the device. The login data must be entered to connect to the SSH console. • Deploy: starts the mass deployment for devices in a separate tab. • Import device list: imports a device list into the main window.

  • Page 18: Access To The Web-Based Front End Via Http

    3.5 Access to the file system via FTP The devices from solvimus GmbH can be accessed via FTP to work directly on the file system level. This enables updates, special configurations and extended functionality (see Chapter 6). The integrated FTP server of the devices supports both FTP and SFTP.
  • Page 19 SFTP, its authenticity is checked using stored certificates. Normally, the devices from solvimus GmbH are coming with an individual, self-signed certificate upon delivery. This certificate is usually classified as untrusted by your PC. Therefore, a security prompt with information about the device’s certificate is displayed.

  • Page 20: Access To The Command Line Via Ssh

    When a connection is established to a specific device with SSH, its authenticity is checked using stored certifi- cates. Normally, the devices from solvimus GmbH are coming with an individual, self-signed certificate upon delivery. This certificate is usually classified as untrusted by your PC. Therefore, a security prompt with infor- mation about the device’s certificate is displayed.

  • Page 21: Mass Deployment

    MBUS-GEV - User manual Figure 11: Security prompt for the certificate of the device Now the Putty client opens and the login information for the user admin has to be entered. Then, the command line is ready for input via SSH. The password is not displayed on the screen.
  • Page 22 MBUS-GEV - User manual Figure 13: Selection of devices and initiation of the mass deployment The command Deploy from the context menu in the tool Netdiscover opens another tab for mass deployment. Figure 14: Mass deployment via the tool Netdiscover The following input fields and buttons are available here: •...

  • Page 23: Import Of A Device List

    MBUS-GEV - User manual 3.8 Import of a device list Devices cannot always be discovered automatically. Firewalls, routing settings or even the deactivation of the function Network discovery active in the Security tab (see Section 4.9) are possible reasons. Therefore, a device list can be imported. This enables managing devices via the tool Netdiscover even without automatic dicovery.

  • Page 24: The Device Can Not Be Accessed Via Website Respectively Ftp(S)

    MBUS-GEV - User manual The network connection must be inserted in the connector for Ethernet. At the network connection the hyperlink-LED must be lit yellow and the Active-LED must flash green from time to time. Check also the corresponding LEDs at the remote station (PC, hub etc.). If need be, repeat the connectivity test with switched cables.

  • Page 25: Web-Based Front End

    4 Web-based front end 4.1 General information Many products from solvimus GmbH, especially data concentrators and gateways for smart metering, are com- ing with an integrated web server and provide a website for the configuration. The devices can be configured easily and in a user-friendly manner via this website.

  • Page 26: Access Via Https

    The Print button (see Figure 17, bottom right) can be used for getting an entire overview of the configuration or for exporting it via the clipboard. Details are given in Section 4.13. The solvimus GmbH provides a manual directly on the device. Press the Help button (see Figure 17, bottom right) to open the included PDF file.
  • Page 27 MBUS-GEV - User manual Figure 17: General tab The following parameters are shown and can be changed here: Column name Description Device name Name of the device (correlation with the tool Netdiscover) Serial number Serial number of the device (MAC address), not editable DHCP Enable automatic network configuration.

  • Page 28: Tab Meter

    MBUS-GEV - User manual If the network configuration is changed, the device will be available under the new IP right after processing the changes. All active sessions will be closed and users will be logged out automatically then. Changing the network parameters of the device can affect the accessibility. If the network parameters have already been set correctly by an administrator, they should not be changed.
  • Page 29 MBUS-GEV - User manual Table 8 – Continued from previous page Column name Description S (Status) Shows the status of the meter or the meter value • !: meter or meter values cannot be read, meter values are not up-to-date.
  • Page 30 MBUS-GEV - User manual The meter values of M-Bus and wM-Bus meters are arranged in the same order as the data is present in the protocol. So, the meaning of the values can be directly compared with the data sheet of the relevant meter.

  • Page 31: System Meter

    MBUS-GEV - User manual Figure 19: Exporting log data in the Meter tab 4.4.1 System meter The system meter is a special function for providing device-specific operating parameters. These parameters are displayed via the system meter like normal meter values and can thus be monitored and analysed. The system meters must be added manually in the tab Meter using the Add button or using the Add meter item in the context menu.

  • Page 32: Tab Configuration

    By default, only the S0 inputs and the digital output of the system meter can be switched. Information on the system meter is given in Section 4.4.1. If need be, the settings can be extended. This is done via the config- uration file chip. ini (see Section 6.3). In the Group [SOLVIMUS], the parameter MUC_SETDEVICES must be set.
  • Page 33 MBUS-GEV - User manual Field name Description General readout and display parameters Readout cycle mode Format for specifying the standard readout cycle (for all meters, unless otherwise specified for individual meters in the Meter tab via the parameter Cycle). • Second: Readout cycle is specified in seconds.

  • Page 34: Tab Wan

    MBUS-GEV - User manual Table 10 – Continued from previous page Field name Description M-Bus max. multipage Limits the number of multipage requests. M-Bus transparent port Network port of the transparent M-Bus mode Specific parameters of the M-Bus-Slave* M-Bus slave mode Sets the mode of the M-Bus slave (M-Bus, TCP or UDP) or deactivates the interface.
  • Page 35 MBUS-GEV - User manual Figure 23: WAN tab The following parameters are available: Column name Description WAN active Activation of the WAN module SIM PIN PIN of the SIM card Name des access point (APN) APN auth mode Authentication mode of the APN...

  • Page 36: Tab Server

    MBUS-GEV - User manual Changing the WAN configuration via an active cellular network connection is not recommended, as the device may no longer be accessible after a changed or invalid configuration. The Save button is used to save the configuration. The Reload command loads the last saved parameters and resets current changes.
  • Page 37 MBUS-GEV - User manual Table 12 – Continued from previous page Field name Description Report mode Sets the operating mode of the respective instance or deactivates it. There are these modes to choose from: • TLS: active data push via secured TCP channel to the specified server •...

  • Page 38: Tab Security

    MBUS-GEV - User manual Table 12 – Continued from previous page Field name Description Parameters for BACnet server* BACnet active Activates the BACnet functionality BACnet config network Activates a second virtual network interface for the BACnet service BACnet IP IP address of the second virtual network interface for BACnet...

  • Page 39: Tab User

    MBUS-GEV - User manual Table 13 – Continued from previous page Field name Description FTP server active Activates the internal HTTP server of the device. If deactivated, there is no FTP access to the device. SSH server active Activates the internal SSH server of the device (administrative access).
  • Page 40 Change password button when the admin user itself is logged in. File access on the device is limited for safety reasons. If the administrator password is lost, the device can only be reset to factory defaults by solvimus GmbH. When resetting, all configuration data and meter data are lost.

  • Page 41: Tab Log

    MBUS-GEV - User manual 4.11 Tab Log The Log tab allows accessing log information and status outputs. That facilitates the analysis of the behaviour and troubleshooting. The extent of the log entries depends largely on the settings in the Log mode field in the General tab (see Section 4.3).

  • Page 42: Tab Service

    MBUS-GEV - User manual If no log entries are shown, please check the filter settngs. If necessary, extend the specified time range, reset the filter or deactivate it. The number of log entries shown is limited to 500. Use the filter or the time range to reduce the entries.

  • Page 43: Print Page

    Using the Update firmware button opens a file selection dialogue as well. An update file can be selected here. The solvimus GmbH provides updates as *. enc files on a regular basis. These files can then be uploaded to the device. After successfully uploading them, the update process is started automatically and the device is then restarted.

  • Page 44: Troubleshooting The Front End

    MBUS-GEV - User manual plus Figure 31: Print page of the device (excerpt), here the example MUC.easy 4.14 Troubleshooting the front end Using a standard web browser for accessing the web server running on the device is an easy and intuitive way to manage the device.

  • Page 45: Login To Website Is Refused

    MBUS-GEV - User manual Please check whether the device is listed in the Netdiscover tool (see chapter Chapter 3). Please check the connectivity in general via ping test integrated in the Netdiscover tool. Please check whether a firewall is blocking the data transmission or whether the routing is configured accord- ingly.

  • Page 46: The Log Is Empty

    MBUS-GEV - User manual If errors could not be eliminated, please contact our customer support: Email: support@solvimus.de Phone: +49 3677 7613065 4.14.6 The Log is empty Please check the filter settings. If no filter is active, entries should always be available for the Log source System log.

  • Page 47: Reading Meters Via M-Bus

    MBUS-GEV - User manual 5 Reading meters via M-Bus 5.1 General information A widely used interface for the automated meter reading is the wired M-Bus (Meter-Bus). This was originally specified in EN 1434-3. It was then moved to a separate standard EN 13757: •...

  • Page 48: Configuration Of The Interface On The Web-Based Front End

    MBUS-GEV - User manual Certain terms are used in the M-Bus standard. The basics of communication are taken from IEC 60870-5-101. Key terms are explained in the table below: Term Description ACKnowledge, confirmation of a command, transmitted over the M-Bus as a single char- acter telegram with content 0xE5.

  • Page 49: Addressing, Scanning And Scan Range

    MBUS-GEV - User manual interface to an IP interface (network (LAN) or cellular radio (WAN)). The device then works in a way similar to an Ethernet-M-Bus converter or even to a cellular router with an M-Bus interface. The network port to be used is defined in the parameter M-Bus transparent port.

  • Page 50: M-Bus Baud Rate

    MBUS-GEV - User manual Figure 33: Example of primary and secondary addressing in comparison Secondary addressing is supporting wildcards. For example, this allows using the 8-digit secondary ID for selection only. The other parts are masked with the placeholder 0xFF (255) or 0xFFFF (65535). Individual digits of the secondary ID can be masked with 0xF (16) as well.

  • Page 51: M-Bus Timeouts

    In addition, the parameter M-Bus request mode in the Configuration tab can be used to explicitly define the requested data before the actual readout. Devices from solvimus GmbH can send a so-called global readout request to the meter before the actual request. A SND_UD is sent to the meter for this purpose. The user data then consists of only one or two characters.

  • Page 52: M-Bus Multipaging

    The FCB mechanism according to IEC 60870-5-2 is used by the readout sequence. The solvimus GmbH calls this process „multipaging“. In order to request possibly existing telegrams from the meter, the master has to toggle the FCB with each new request REQ_UD2.

  • Page 53: M-Bus Meters Are Not Found

    MBUS-GEV - User manual Figure 34: Troubleshooting the M-Bus by measurements with a multimeter 5.4.2 M-Bus meters are not found Check the cables between the device and the meter, and replace faulty cables if necessary. While the device is switched on, please measure the M-Bus voltage (approx. 30-40 V) between the two M-Bus contacts at the device and also at the meter.

  • Page 54: M-Bus Meters Are Found, But Do Not Show Any Data

    MBUS-GEV - User manual Please activate the raw data log by using Raw data log in the Configuration tab (see Section 4.6). The communication process can be analyzed very well using this raw data log. If errors could not be eliminated, please contact our customer support: Email: support@solvimus.de...

  • Page 55: Advanced Configuration Options

    (read, write or execute). In addition to the user root, the devices from solvimus GmbH are coming with the user admin. It has read and write access to the partitions app and ext and can execute files there. For the operator, admin is the user who can completely configure the device.
  • Page 56 • xsltproc: Executing XSL transformations solcmd command interpreter Due to the system access rights for users, solvimus GmbH adds a command interpreter solcmd. It offers special application functions via the command line. The interpreter can be called with various parameters and thus provides access to the application and allows controlling it.

  • Page 57: Update

    MBUS-GEV - User manual • start-virtual-tty : Activate a virtual interface via an Ethernet port • stop-virtual-tty : Deactivate a virtual interface via an Ethernet port • update-rtc: Write the system time to the buffered real-time clock • factory-reset: Reset the device to factory settings •...
  • Page 58 MBUS-GEV - User manual Table 19 – Continued from previous page Parameter Description Range Standard Group [VPN] CONFIGFILE Path to the OpenVPN configura- Text, max. 255 charac- vpn/config.ovpn tion file ters ENABLE Activation of the OpenVPN client 0, 1 Group [WEB]...
  • Page 59 MBUS-GEV - User manual Table 19 – Continued from previous page Parameter Description Range Standard DLDERS_BAUDRATE Baud rate for the serial DLDE 300, 600, 1200, 1800, 9600 communication 2400, 4800, 9600, 19200, 38400, 57600, 115200, 230400, 460800 DLDERS_DATABITS Data bits for the serial DLDE...
  • Page 60 MBUS-GEV - User manual Table 19 – Continued from previous page Parameter Description Range Standard MBUS_DEVPATH Linux path of the M-Bus interface Text, max. 255 charac- Not set ters MBUS_DISABLE Deactivation of decrypting the 0, 1 DECRYPTION M-Bus packets (status field)
  • Page 61 MBUS-GEV - User manual Table 19 – Continued from previous page Parameter Description Range Standard MBUS_RS485ENABLE Activation of the RS-485 interface 0, 1 for the M-Bus communication MBUS_SCANMODE Searcch algorithm for the M-Bus PRIMARYSCAN, SECONDARYSCAN SECONDARYSCAN, SECONDARYSCAN ALLOC, SECONDARYSCAN REVERSE,...
  • Page 62 MBUS-GEV - User manual Table 19 – Continued from previous page Parameter Description Range Standard MBUSSLV_ Maximum timout for the request 0-65535 10000 FULLTIMEOUT of a meter (in ms) MBUSSLV_ Idle time for detection of the end 0-65535 IDLETIMEOUT of communication (in ms)
  • Page 63 MBUS-GEV - User manual Table 19 – Continued from previous page Parameter Description Range Standard METER_RETRYDIVIDER Reduces the quantity of val- 0-65535 ues read and used for report- ing. Only values every METER_ RETRYDIVIDER are retained for reporting. All read values are used for visualisation and for other in- terfaces (Modbus resp.
  • Page 64 MBUS-GEV - User manual Table 19 – Continued from previous page Parameter Description Range Standard MODBUS_RS485ENABLE Activation of the RS-485 interface 0, 1 for the serial Modbus communica- tion (RTU) MODBUS_SPAN MODBUS_STOPBITS Stop bits for the serial Modbus 1, 2...
  • Page 65 MBUS-GEV - User manual Table 19 – Continued from previous page Parameter Description Range Standard MUC_SHOWTIMESTAMP Explicit representation of the 0, 1 ENTRIES timestamps of a meter MUC_SHOWVENDOR Explicit listing of manufacturer- 0, 1 RAWDATA dependent data as meter value...
  • Page 66 MBUS-GEV - User manual Table 19 – Continued from previous page Parameter Description Range Standard WAN_PUK PUK for the SIM card Text, max. 255 charac- Not set ters WAN_RADIOACCESS Manuel selection of Radio Access TECHNOLOGY Technology: 0: default of the modem,...
  • Page 67 MBUS-GEV - User manual Table 19 – Continued from previous page Parameter Description Range Standard WMBUS_FLOW Handshake for the wM-Bus com- 0, 1, 2, 8, 9 CONTROL munication: 0: none, 1: XON/XOFF when sending, 2: RTS/CTS, 8: XON/XOFF when receiving,...
  • Page 68 MBUS-GEV - User manual Table 19 – Continued from previous page Parameter Description Range Standard WMBUS2_PARITY Parity of the wM-Bus communi- cation (channel 2): 0: none, 1: odd, 2: even, 3: mark, 4: space WMBUS2_RS485ENABLE Activation of the RS-485 interface...
  • Page 69 MBUS-GEV - User manual Table 19 – Continued from previous page Parameter Description Range Standard DLDERS_ TRANSPARENT_ TLSENABLE DLDERS_ TRANSPARENT_CA_FILE DLDERS_ TRANSPARENT_CERT_ FILE DLDERS_ TRANSPARENT_KEY_ FILE DLDERS_ TRANSPARENT_ INSECURE MBUSSLVMETER_ TLSENABLE MBUSSLVMETER_CA_ FILE MBUSSLVMETER_CERT_ FILE MBUSSLVMETER_KEY_ FILE MBUSSLVMETER_ INSECURE MBUSSLV2METER_...

  • Page 70: Configuration File Device_Handle.cfg

    MBUS-GEV - User manual Table 19 – Continued from previous page Parameter Description Range Standard KEY_FILE Path to the device key for the re- port instance CYCLEMODE MINUTE CYCLE Cycle time for meter reading (unit according to CYCLEMODE) CYCLEDELAY CYCLETIMESTAMP...

  • Page 71: Openvpn Client

    Table 20: Structure of Device_Handle.cfg 6.5 OpenVPN client An OpenVPN client is integrated on the devices from solvimus GmbH for enabling an encrypted remote access. This offers a comfortable way to configure and operate the devices remotely. The configuration of the devices themselves is very simple and intuitive.

  • Page 72: Preconfiguration Of The Meter List

    Its basis are source codes which are executed or interpreted on the target system, i.e. the device. Compiled standard environments such as XSLTPROC or BASH are available as interpreters on the devices from solvimus GmbH. Scripts can run in these environments and enable various functions. 6.7.1 XSLT parser XSLTPROC is an interpreter for applying XSLT stylesheets to XML documents.

  • Page 73: Report Script

    Conditional statements and loops can also be used. The main intention for offering XSLT on the devices from solvimus GmbH is generating of user-specific data formats. The device internally uses a proprietary XML format to provide the meter data. In order to generate the format that the operator uses or prefers, an XSLT conversion rule is used.

  • Page 74: System Meter Script

    In the EN 13757-3 standard, media types, measurement types (measurement value descriptions) and units and are predefined. The devices from solvimus GmbH are using it for allowing a uniform data display. The following table contains the predefined values for the medium:...
  • Page 75 MBUS-GEV - User manual Table 21 – Continued from previous page Index Description Heat (outlet) Steam Warm water Water Heat cost allocator Compressed air Cooling (outlet) Cooling (inlet) Heat (inlet) Combined heat / cooling Bus / System component Unknown medium...
  • Page 76 MBUS-GEV - User manual Table 22 – Continued from previous page Index Description Timestamp Time Units for H. C. A. Averaging duration Actuality duration Identification Fabrication Address Meter specific description (text based) Digital input Software version Access number Device type...
  • Page 77 MBUS-GEV - User manual Table 22 – Continued from previous page Index Description Security key Data frame 96-255 Reserved Table 22: Measurement types The following table contains the predefined units. Depending on the meter’s interface, user-specific units can also be configured.

  • Page 78: Accessory

    MBUS-GEV - User manual 7 Accessory The solvimus GmbH recommends the external power supply PHOENIX CONTACT STEP-PS/1AC/24DC/0.5, order number of the solvimus GmbH: 103501. The usage of accessories not recommended is at your own risk. It is imperative to mind Section 1.2.5.

Table of Contents