Advanced

Performing an advanced meter search

The M-Bus Metering gateway has the capability of performing advanced meter searches using certain predefined criteria defining what meters should be searched for.

  1. Go to Meters > Search for meters.

  2. Select Change to advanced search mode checkbox.

  3. Choose the number of meters that will be installed and the baud rate that will be used by the Metering gateway to communicate with the meters.

  4. Set the addressing mode of the meters the Metering gateway will search for. A priority order may also be set to determine what addressing mode will be used if the first choice should not work.

  5. Set the Interfaces to use to search for meters. Viable options include Integrated M-Bus master (2-wire M-Bus) TCP/IP (Ethernet), or a combination of both. Select Add new to select an additional interface.

  6. Select Save.

  7. Select Start search.

Manual meter readouts

The manual meter readout is most often used in troubleshooting purposes, to ensure that the readout process works the way it is supposed to. It will trigger a readout of one or all meters without having to wait for the scheduled readout cycle. When the settings of an individual meter have been edited, for example through a change of MOID, a manual readout of the meter must be performed before the change is fully implemented. Manual meter readouts can be performed for all installed meters or for one individual meter.

Performing a manual readout of all installed meters

  1. Go to the Installation Panel.

  2. Select Read all & store.

  3. Go to the Meter list, just below. Select the update symbol to make sure that the readout succeeded and check the last readout time along with the status of the readout.

Performing a manual readout of an individual meter

  1. Go to Meters > Meter List.

  2. Choose the desired meter and select the readout (floppy) symbol.

  3. Select the update symbol and make sure that the latest readout was successful by checking the Last readout and the Status column.

The continuous readout mode

The Metering gateway offers the possibility of performing meter readouts continuously. The device will then constantly collect meter values, which can for example be used by a control system to regulate a heating system. Note that meter values collected through the Continuous Readout Mode will only be held in the internal memory of the M-Bus Metering gateway (not stored in the database) and can only be accessed using integration protocols such as REST, Modbus, JSON or DLMS. They will therefore not be included in Push reports. To use Continuous Readout Mode in combination with Push Reports, the meter readout schedule still needs to be set.

Activating continuous readout mode

  1. Go to Meters > Readout schedule.

  2. Select Activate Continuous readout mode.

  3. Select Save.

Security features

The Metering gateway supports HTTPS, FTPS and sFTP, were a Secure Socket Layer (SSL) is used to encrypt data between the device and the HTTP/FTP server. To enable HTTPS, FTPS, at least one SSL certificate must be uploaded to the web interface. To use sFTP, username and password, and username (password), key is supported.

Note

It is important that your server certificate works with your web browser. Otherwise, you might not be able to log in on the device and must perform a factory reset.

Supported key exchange methods for sFTP

  • diffie-hellman-group14-sha256

  • diffie-hellman-group16-sha256

  • diffie-hellman-group16-sha512

  • diffie-hellman-group18-sha512

  • diffie-hellman-group14-sha256@ssh.com

  • diffie-hellman-group16-sha384@ssh.com

  • diffie-hellman-group16-sha512@ssh.com

  • diffie-hellman-group18-sha512@ssh.com

Uploading a certificate for device authentication

When enabling HTTPS/FTPS, an SSL certificate, either self-signed (default option) or executed by a certificate authority (CA), is uploaded in the device KeyStore. The KeyStore SSL certificate will be used by the Metering gateway in two cases:

  • To authenticate itself as a trusted server when a user accesses the web interface via HTTPS or FTPS.

  • To authenticate itself as a trusted client to a server before delivering a HTTPS/FTPS Push Report.

If the SSL certificate has been executed by a CA, the Metering gateway will automatically be trusted by the server/client. However, when a self-signed certificate is used, it always needs to be added to the server’s/client’s list of trusted certificates before a connection can be established.

  1. Go to Configuration > Service > Web server.

  2. Select Install a new KeyStore (.jks).

  3. Attach the CA or the self-signed certificate (as a “.jks” file) as well as the private key password and the KeyStore password, which were both issued along with the certificate.

  4. Select Install.

  5. Select Save.

Enabling HTTPS to access web interface

When enabling HTTPS for accessing the web interface, connecting clients will be authenticated by the Metering gateway by using certificates uploaded in the device TrustStore.

  1. Go to Configuration > Services > Web server.

  2. Change the Connection type from HTTP to HTTPS.

  3. Select Add client certificate. Attach the client certificate (“.cer” file) and a certificate alias as well as the TrustStore password, which were both issued along with the certificate.

  4. Select Install.

  5. Select Save.

Authenticating receiving servers of HTTPS/FTPS/ Push Reports

CMe3100 supports transmission of push reports over HTTPS/FTPS. Server certificates uploaded in the TrustStore will then be used to authenticate a receiving server before sending a push report. By uploading a complete TrustStore, a list of trusted server certificates (for example Java standard TrustStore) can be uploaded and used by the device.

This topic applies to the general push report settings. That means that settings configured for an individual push report will override changes made according to these instructions.

  1. Go to Configuration > Services > Web server.

  2. Select Add a new server TrustStore to upload a list of trusted server certificates, or select Add server certificate to upload an individual certificate.

  3. Add current and new TrustStore password if uploading a new TrustStore. Add certificate alias and TrustStore password if uploading a separate certificate.

  4. Select Install.

  5. Select Save.

Enabling HTTPS/FTPS for individual push reports

HTTPS/FTPS can be enabled for all push reports, without changing the default push report HTTP/FTP server of the device.

  1. Go to Configuration > Push Reports.

  2. Select the push report you want to configure.

  3. Set Report type (“FTP” or “HTTP”).

    • For HTTP Push Reports: Clear Send report to default HTTP server and type in the URI of the HTTPS server. If applicable, set Basic as Authentication mode, and type the credentials to log onto the server.

    • For FTP Push Reports: Clear Send report to default FTP server and type the FTP server information you want to use. Select whether to use Implicit FTPS or Explicit FTPS. If applicable, type the credentials to log onto the server.

M-Bus configuration

The web interface enables configuring of M-Bus settings which will be applied to all meters connected to the Metering gateway over M-Bus. This includes baud rate, addressing mode, and the interface used to search for meters.

The Metering gateway also supports configuring of more advanced M-Bus settings, including timeout and retry settings for various M-Bus events as well as multi telegram settings.

Configuring search parameters for meters

  1. Go to Meters > M-Bus settings.

  2. Set the Baud rate that will be used in the meter search. Make sure that the baud rate set for the M-Bus is supported by all the meters that the Metering gateway is going to communicate with.

  3. Set the Addressing mode that will be used in the meter search. A priority order can also be set, determining what addressing mode to use if the first choice should not work.

  4. Set the Interfaces to search for meters. If using Integrated M-Bus, meters will be accessed over the M-Bus interface. By selecting TCP/IP, meters will be accessed over the Ethernet network. Select Add New, choose TCP/IP or M-Bus and select Save to add an additional interface.

  5. Select Save.

Configuring M-Bus time and retry settings

The timeout and retry settings for various M-Bus events are configurable through the web interface of the Metering gateway.

  1. Go to Meters > M-Bus settings and select the Show advanced settings checkbox.

  2. Set the Response timeout, Readout retries, Selection retries, Initialization idle time, Collision idle time, and Request idle time.

  3. Select Save.

Configuring M-Bus multi telegram settings

The M-Bus multi telegram settings determine the maximum amount of telegrams received by the Metering gateway for each meter readout. Disabling multi telegrams means that only the first telegram will be read for each meter readout, regardless of if the meter is trying to send additional ones. The maximum number of telegrams per readout is configured by setting the multi telegram read limit.

  1. Go to Meters > M-Bus settings.

  2. To enable multi telegrams, select Auto in the Multi telegram tab.

  3. Set the Multi telegram read limit to configure the maximum number of telegrams sent per readout.

  4. Select the Show advanced settings checkbox to configure time and retry settings for the multi telegrams.

Configuring M-Bus settings of an individual meter

  1. Go to Meters.

  2. Select the secondary address of a meter.

  3. Go to Settings.

  4. Set the Baud rate that will be used by the Metering gateway to communicate with the meter.

  5. Set the Addressing mode that will be used by the Metering gateway to access the meter. If using the wireless addressing mode, you may select through which Wireless M-Bus Receiver the meter should be accessed. However, the meter will by default automatically be assigned to the Wireless Receiver which has managed to establish the best connection.

  6. Set the state of the multi telegram. If enabled, set the Multi telegram read limit. It will determine the maximum number of telegrams read by the Metering gateway per readout.

  7. Select Save.

Access to the M-Bus from a master device

The transparent M-Bus service enables a master device, other than the Metering gateway, to communicate directly with the meters on the M-Bus. The transparent M-Bus service might for example be used if direct communication with a meter is necessary for debug or meter software update purposes. In such cases, the service allows for example a head-end system to communicate directly with the meter, completely bypassing the Metering gateway. A maximum of two different transparent M-Bus TCP/IP services with different baud rates can be enabled at the same time.

Note

It is not recommended to enable the transparent M-Bus service if other services that access the M-Bus, e.g., push reports, are active in the Metering gateway. This might otherwise lead to that M-Bus activity due to one service interrupts the other service.

Enabling a master device to communicate directly on the M-Bus

  1. Go to Configuration > Services. In the list, the Transparent M-Bus services are easily enabled or disabled.

  2. Select one of the Transparent M-Bus services.

  3. Set the Baud rate and make sure it is supported by the M-Bus meters.

  4. Choose Packing mode. By using M-Bus, all data transmitted over Transparent M-Bus is controlled by the Metering gateway to assure it follows the M-Bus standard. By setting the Packing Interval to Transparent, the data will be transmitted without performing any such control.

  5. Set the Packing Interval to determine number of milliseconds that need to pass before data received from the master device is transmitted on the M-Bus.

  6. Set the Idle timeout to determine the number of seconds of inactivity that needs to pass before a connection with a master device is closed. Make sure that the time is set to reflect the connection scheme of the master device.

  7. Select Save.

Access to meter readings from a master device

The Metering gateway supports virtual M-Bus communication over TCP/IP, which means that another master device can retrieve data directly from the database of the CMe3100. When using the virtual M-Bus mode, the master device will never communicate directly on the M-Bus, but only with the Metering gateway and its meter value database.

Enabling a master device to collect meter values from the database

  1. Go to Configuration > Services.

  2. Enable the virtual M-Bus service. Select it to configure the virtual M-Bus settings.

  3. Set the Value expiration date to determine how long a stored meter value will be valid if requested over virtual M-Bus. If a meter value has been stored in the database for a longer time than the value expiration time, a requesting master device will receive a “not valid” notification if the meter value should be requested.

  4. Set the Idle timeout to determine how many seconds a communication link with a master device may be inactive before it is closed. The default setting allows for ample time between operations without the need of reconnecting and assures that a connection that is lost, automatically closes after the timeout period. It will work well in most cases. However, the Idle timeout needs to be set to reflect the connection scheme of the master device.

  5. Select Save.

Use of M-Bus slave ports for virtual or transparent M-Bus

The Metering gateway has two slave ports available, which can be used by a master device to access the virtual or transparent M-Bus services. Each port can be individually configured by setting the baud rate, packing interval and idle timeout settings.

Enabling and configuring the settings of the M-Bus slave ports

  1. Go to Configuration > Services.

  2. Enable the desired slave port. Select ot to configure its settings. Select whether the master device should use the transparent M-Bus or virtual M-Bus service when connecting to the slave ports.

  3. Set the Baud rate to determine the rate of communication between the Metering gateway and its master device.

  4. Set the Packing interval to determine how many milliseconds that will have to pass before data received by the Metering gateway will be sent to the master device.

  5. Set the Idle timeout to determine the number of seconds of inactivity that needs to pass before a connection with the master device is closed. Make sure that the time is set to reflect the connection scheme of the master device.

  6. Select Save.

Readouts by a master over Modbus

The Metering gateway supports meter readouts by master devices over the Modbus protocol, which might for example be desired in a Digital Control System. The Modbus readout is performed by TCP/IP (Ethernet network).

Enabling meter readouts over Modbus

  1. Go to Configuration > Services.

  2. Enable the Modbus service in the list. Select it to configure its the settings.

  3. Go to Settings.

  4. Set the number of Simultaneous connections that should be allowed (i.e., the number of requesting clients in the system).

  5. Set the Default data type and the Default constant to handle decimal values. Make sure they correspond with the ones used by the master device.

  6. Select if the Metering gateway should Respond on invalid addresses.

  7. Select Save.

Metering status monitoring with SNMP

CMe3100 supports SNMP v2c, a standardized protocol used for monitoring of devices on a TCP/IP network. By activating the SNMP service, the Metering gateway aggregates the result of the last meter readout and the last round of push reports and makes it available for an SNMP manager to poll. There are three available status codes used to describe the status of meter readouts and Push Reports.

Table 101. Aggregated status of meter readouts and Push Reports

Status

Mode

Description

1

OK

The last meter readout and the last round of Push Reports were both successful.

2

WARNING

The last meter readout completed with errors for one or several (but not all) meters or the last round of Push Reports completed with errors for one or several (but not all) reports.

3

ERROR

The last meter readout was unsuccessful for all meters, or the last round of Push Reports was unsuccessful for all reports.


CMe3100 uses a MIB-file, which can be downloaded from the web interface to structure lists that will present the SNMP manager with the status of the last meter readout and the last round of push reports. The following lists are available for the SNMP manager software to access:

  • A status report, which presents the aggregated status of the last meter readout and the last round of push reports.

  • A meter status list, which presents the last readout status for each individual meter. If the last meter readout succeeded, the status code will be 1. If it failed, the status code will be 3. Status code 2 indicates that CMe3100 was unable to decrypt the last message from that specific meter or that the meter has never been read.

  • A report status list, which presents the last status of each individual push report. If the last push report succeeded, the status code will be 1. If it failed, the status code will be 3.

CMe3100 also supports SNMP traps, which are asynchronous notifications sent to all configured recipients each time the aggregated status of the meter readout or the push reports changes. For example, if one of the activated push report suddenly fails (and the aggregated status changes from 1 to 2), an SNMP trap will be triggered, and all recipients will be notified.

Note

The SNMP trap message only informs that the aggregated status has changed. Information about the meters or push reports that have caused the change of status can be accessed by using the meter status list and the report status list.

Enabling and configuring the SNMP service

  1. Go to Configuration > Services.

  2. Enable SNMP in the list.

  3. Select the service to enter its settings.

  4. Enter the TCP port number for the SNMP manager to connect to.

  5. Enter the Community string. The SNMP manager and the device need to use the same community string to communicate with each other.

  6. Select Save.

Configuring recipients of SNMP traps(optional)

  1. Go to Configuration > Services.

  2. Enable the SNMP service.

  3. Select the service and go to Settings.

  4. Select Add new trap and enter the hostname and the port of the desired recipient.

  5. Enter Trap notification retries to determine the maximum number of retries the CMe3100 will perform when trying to notify a trap receiver.

  6. Enter Trap timeout to determine the maximum number of seconds the CMe3100 will wait for a response from the SNMP manager when sending a trap notification.

  7. Select Save.

Enabling automatic updates of configuration settings

By enabling the Auto Configuration service, the metering gateway will periodically check a URL for a settings command file (.cad file) which will be downloaded and parsed. The settings command file can include settings updates like what is possible using the command line interface.

  1. Go to Configuration > Services > Auto Configuration.

  2. Select the Activate Auto Configuration checkbox.

  3. Choose the Schedule of the Auto Configuration service out of the preset alternatives or by using cron patterns. To learn more about cron patterns, see Configuring service and job schedules using cron patterns.

  4. Enter the URL of the command file.

  5. Choose Authentication mode, which will then be used every time an Auto Configuration is run.

  6. Select Save.

Advanced push report settings

There is a group of more advanced push reports settings, configurable through the web interface of the metering gateway. These include:

  • Adaptive Retries, which adjust retry attempts for failed push reports to the schedule in use.

  • Value Period, which determines how far back in time the metering gateway will include values for when compiling a push report.

  • Value Interval, which determines the time between the readouts included in the push reports.

  • Timeout value, which for each protocol determines how long a push report transmit attempt may linger before timing out.

Adaptive retries

The adaptive retries ensure that all push report retry attempts are performed before the next scheduled push report is going to be sent. For example, if the push report schedule is set to every 16th-60th minute, up to two retries will be attempted with 300 seconds between each one. If all retry attempts fail, the meter values will instead be included in the next push report.

Table 102. Adaptive retry schedule

Push Report schedule

Max amount of retry attempts

Seconds between each attempt

1-15 min

1

0

16-60 min

2

300

61 min-23 h

3

500

>23 h

6

3600


If choosing to disable the adaptive retries, the metering gateway will use its individual report settings to determine how to handle failed push report attempts. These settings are not displayed in the web interface but can be accessed through the console interface. If no such report settings have been configured for the metering gateway, general job settings will determine how the device handles failed push report retry attempts.

Disabling adaptive retries

  1. Go to Configuration > Services > Push Reports.

  2. Disable Activate Adaptive Retries.

  3. Select Save.

Value period

The value period of the metering gateway can be set to Auto or to a fixed number. Using the Auto settings will deliver all previously unsent meter values up to a max limit of 180 meter readouts. For example, if the metering gateway has been unable to send push reports, scheduled every 15th minute for a certain amount of time, it will be able to go back and deliver a maximum of 45 hours of undelivered meter values with the next successful push report (180 * 15 minutes = 2700 minutes = 45 hours). When setting the value period to a fixed number, the metering gateway will look exactly that far back in time for undelivered meter values.

Configuring value period

  1. Go to Configuration > Push Reports.

  2. Select a push report.

  3. Enter Value period.

    • By setting the value period to Auto, the metering gateway calculates the value period based on how far back in time it is able to find unsent meter values.

    • By setting the value period to a specific value, meter values exactly that long back in time will be included in the push report, regardless of if there are older unsent meter values.

  4. Select Save.

Configuring value interval

  1. Go to Configuration > Push Reports.

  2. Select a push report.

  3. Set the Value Interval to determine the time between each meter readout included in the push report.

    Setting the Value Interval to All values automatically ensures that all meter values read by the metering gateway are included in the push reports.

  4. Select Save.

Configuring the push report timeout settings

  1. Go to Configuration > Services > Push Reports.

  2. Set the desired timeout for each protocol.

    Setting the timeout to "-1" disables the timeout functionality of the metering gateway, and instead lets the server determine when a connection should be closed. The default settings will work well in most cases. However, if the connection between the metering gateway and the server is slow, the timeout value might have to be increased accordingly.

  3. Select Save.

Job retries

The job retries settings determine how the metering gateway performs retry attempts for scheduled and manual jobs, for example meter readouts, if failing the first time. If adaptive retries have been disabled for push reports, and no other retry settings have been configured for the metering gateway, these retry settings will also affect the push report retry settings.

Configuring job retry settings for scheduled and manual jobs

  1. Go to Configuration > Services > Job settings.

  2. Enter the desired number of retries to determine the maximum number of times the metering gateway will attempt to perform a job.

  3. Enter the retry offset to determine the time between the metering gateway will wait between each attempt for these jobs.

  4. Select Save.

Access to the device through a console application

The metering gateway can be accessed through a console application, i.e., by using a command-line interface. This is most often used for troubleshooting and advanced operations. To increase the security of the console application, the metering gateway supports the usage of passwords to access various levels of device functions. It is also possible to create a list of specific IP addresses which are allowed to access the metering gateway through the console application.

Enabling and configuring access of the console application

  1. Go to Configuration > Services.

  2. Select the console application.

  3. Enter TCP port number where the console application will connect.

  4. Enter Idle timeout to determine the number of seconds of inactivity that needs to pass before a connection with a console application is closed.

  5. Go to Security. Enter a password for accessing various levels of device functions and a list of authorized IP addresses which will be able to use the console application.

  6. Select Save.

On demand reports

The on demand report is a way of triggering a report manually, without having to set a schedule. It differs from other types of reports in the sense that an actual meter readout is performed each time the on demand report is requested. In contrast, all other types of push reports include meter values that has already been stored in the database of the metering gateway.

Enabling and configuring the on demand report

  1. Go to Configuration > Push Reports > On demand report.

  2. Enable the On demand report.

  3. Select the On demand report.

  4. Choose the protocol to receive the report by.

  5. Choose report template. To learn more about the report templates available, please visit our support site https://support.elvaco.com.

  6. Enter recipients of the on demand report.

  7. Select Save (or Save & Send test report to test the settings).

Configuring identity settings for push reports

Configuring device identity settings includes assigning an identity for the metering gateway, which will be displayed as the sender of push reports, as well as contact information to be included in the push reports.

  1. Go to Configuration > Localization > Identity.

  2. Enter product name for the metering gateway. Also enter contact information to be included in the push reports, if desired.

  3. Select Save.

Configuring localization settings for push reports

  1. Go to Configuration > Localization > Conventions.

  2. Choose Language, enter Decimal separator, enter Report separator, and choose First day of the week. The Character encoding should be set with respect to the operational system used to make sure that all characters of the push reports will be encoded correctly.

  3. Select Save.

Rebooting the metering gateway

In rare cases, e.g., in case of troubleshooting, it might be desired to perform a reboot of the metering gateway. This can be done directly through the web interface.

  1. Go to System > About, or System > Restart.

  2. Select Reboot now.

Resetting to factory default settings via the web interface

By performing a factory reset of the metering gateway, all settings will be reset to default and the meter value database and logs will be cleared.

  1. Go to System > About,.

  2. Select Factory reset.

Configuring service and job schedules using cron patterns

For scheduled jobs, e.g., meter readouts and push reports, cron patterns can be used to customize the time interval by which the jobs will be performed. It is done by setting up to five different time variables, each one represented by a star. Replace each star with a number to set a specific job execution schedule.

Cron pattern

Illustration of cron pattern

The “/” character is used to set periodic values, i.e., schedule a job with a recurrent time interval. The “?” character is used to generate a random value. Lastly, using the “|” character allows to combine several cron patterns. See the following example table including a list of chosen cron patterns.

Table 103. Examples of different cron patterns

Cron pattern

Description

15 * * * *

Schedule a job 15 minutes past every hour, i.e., 00:15, 01:15, 02:15 etc.

*/15 * * * *

Schedule a job every 15th minute, i.e., 00:00, 00:15, 00:30, etc.

* * * * *

Schedule a job every minute, i.e., 00:01, 00:02, 00:03, etc.

* 12 * * mon

Schedule a job every minute during the 12th hour of every Monday.

* 12 16 * mon

Schedule a job every minute during the 12th hour of every Monday if the day is the 16th of the month.

59 11 * * 1,2,3,4,5

Schedule a job 11:59 on Monday, Tuesday, Wednesday, Thursday, and Friday.

59 11 * * 1-5

Schedule a job 11:59 on Monday, Tuesday, Wednesday, Thursday, and Friday.

*/15 9-17 * * *

Schedule a job every 15th minute between the 9th and the 17th hour of the day, i.e., 09:00, 09:15, 09:30, etc.

* 12 10-16/2 * *

Schedule a job every minute during the 12th hour of the day, if the day is the 10th, the 12th, the 14th, or the 16th of the month.

* 12 1-15,17,20-25 * *

Schedule a job every minute during the 12th hour of the day, if the day is between the 1th and the 15th, the 17th or between the 20th and 25th day of the month.

0 5 * * *|8 10 * * *|22 17 * * *

Schedule a job every day at 05:00, 10:08 and 17:22.

?1-30 0 * * *

Schedule a job at a random chosen minute during the first 30 minutes of every hour.


Was this article helpful?

0 out of 0 found this helpful
Have more questions? Submit a request

Comments (0 comments)

Article is closed for comments.