1. Manuals
  2. Brands
  3. Elvaco Manuals
  4. Measuring Instruments
  5. CMe3100
  6. User manual

Elvaco CMe3100 DLMS Plugin User Manual

Hide thumbs Also See for CMe3100 DLMS Plugin:
Table of Contents

Advertisement

Quick Links

Download this manual
CMe3100 DLMS Plugin
User's Manual
v1.8
CMe3100 DLMS Plugin User's Manual– Version 1.8

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the CMe3100 DLMS Plugin and is the answer not in the manual?

Questions and answers

Related Manuals for Elvaco CMe3100 DLMS Plugin

Summary of Contents for Elvaco CMe3100 DLMS Plugin

  • Page 1 CMe3100 DLMS Plugin User's Manual v1.8 CMe3100 DLMS Plugin User's Manual– Version 1.8...

  • Page 2: Table Of Contents

    CONTENTS DOCUMENT NOTES ......................4 ..................4 OPYRIGHT AND RADEMARK ........................4 ONTACTS USING THIS MANUAL ..................... 5 ....................5 URPOSE AND UDIENCE ........................5 ODELS ............... 5 DDITIONAL AND UPDATED INFORMATION INTRODUCTION ......................6 INSTALLING THE PLUGIN ....................7 ...................
  • Page 3 CMe3100 DLMS Plugin User's Manual ........28 UERYING DATA FROM THE GATEWAY USING POLL OPERATION 7.5.1 Management logical device COSEM objects ............. 28 7.5.2 Meter logical device COSEM objects ................. 33 ....................39 USH NOTIFICATIONS 7.6.1 Periodical push data ....................39 7.6.2...

  • Page 4: Document Notes

    Copyright and Trademark © 2022, Elvaco AB. All rights reserved. No part of the contents of this manual may be transmitted or reproduced in any form by any means without the written permission of Elvaco AB. Printed in Sweden.

  • Page 5: Using This Manual

    CMe3100 DLMS Plugin User's Manual Using this manual Purpose and Audience This document covers installation, configuration and usage of the CMe3100 DLMS Plugin add- Models CMe3100 Additional and updated information Latest documentation version is available on Elvaco web site at https://www.elvaco.com...

  • Page 6: Introduction

    CMe3100 DLMS Plugin User's Manual Introduction The DLMS Plugin is one of the extensions (add-ons) available for the CMe3100 product. It can be ordered separately or pre-installed from the factory. The DLMS Plugin extends the CMe3100 core services with support for DLMS over TCP/IP, providing a powerful and versatile suite of tools for Head-end System (HES) integration as well as the possibility to read and monitor any M-Bus meter using the DLMS protocol.

  • Page 7: Installing The Plugin

    This section covers the installation procedure of the Plugin. Validate license information To be able to install the Plugin, the Product must have the license for CMe3100 DLMS Plugin. Validate the license information by navigating to Device > Licenses & Add-ons. See Figure 1 below.

  • Page 8: Plugin Settings

    DLMS Plugin settings may be viewed through either: • Navigate to Configuration > Services > DLMS • Click the Settings Elvaco-DLMS link in the Add-ons list to view the settings page of the DLMS Plugin. Figure 2 DLMS Plugin Settings link Overview The default selected tab in the DLMS Plugin settings is the Overview page.
  • Page 9 CMe3100 DLMS Plugin User's Manual From the menu tab, you may access the other available settings pages: • Settings Page containing general DLMS configuration for the Plugin. • OBIS meter mapping Page containing settings for meter mapping information from M-Bus meter data to COSEM data objects with OBIS code notation.

  • Page 10: Dlms Settings

    CMe3100 DLMS Plugin User's Manual DLMS Settings This section covers the basic settings for the DLMS Plugin, see Figure 4. The settings page contains the following sections: • DLMS Settings • Value interval for profiles • Security Change settings to desired values and click save to store changes.

  • Page 11: System Title

    CMe3100 DLMS Plugin User's Manual The Plugin will automatically restart and start listening on the given port once changes are saved. 5.2.3 System title The system title identifies the gateway during DLMS communication. This field is read-only and hold a per product unique string (shown for informational use only). See 7.2.1 for more information.

  • Page 12: Security

    CMe3100 DLMS Plugin User's Manual Figure 6 Value interval resolutions 5.2.6 Security The Product supports security suite 0 with none, low level or high level security. The security policy can also be changed using the DLMS protocol, see section 7.5.1.9. For security purposes the security policy can only be increased using the DLMS protocol.
  • Page 13 CMe3100 DLMS Plugin User's Manual Figure 7 Security CMe3100 DLMS Plugin User's Manual page | 2022-02-23 Version 1.8...

  • Page 14: Obis Meter Mapping

    CMe3100 DLMS Plugin User's Manual OBIS meter mapping The OBIS meter mapping page is used to configure the mapping information needed to translate M-Bus meter values to readable COSEM objects. The mapping table allows an M-Bus meter to be accessed using DLMS through mapping one or more M-Bus meter value fields to corresponding OBIS codes (and COSEM objects).

  • Page 15: Active Meter Mappings

    CMe3100 DLMS Plugin User's Manual Figure 8 OBIS meter mapping 5.3.1 Active meter mappings The section Active meter mappings shows the current active meter mappings and for which meters they will be applied depending on if they match the meter type, manufacturer and version (based on M-Bus header information read from the meter).

  • Page 16: Meter Types In Use

    CMe3100 DLMS Plugin User's Manual The updated or new meter mapping file will be available under Active meter mapping section. See section 5.3.3 for more information about how to create or modify meter mapping files. To delete a meter mapping: •...

  • Page 17: Simplified Mapping

    CMe3100 DLMS Plugin User's Manual The example file above matches all water meters and doesn’t care about manufacturer or version. The translation entry will map both m-bus values with internal keys: "mbus.dib.volume.0.0.0.0.unmodifiedvalue" and "mbus.dib.0c13.unmodifiedvalue" to the same OBIS object: 8.0.1.0.0.255. If a new meter is added with a different DIF/VIF combination for the same value it could simply be supported by adding that new DIF/VIF to the list of “mbusKeys”.

  • Page 18: Retrieving Raw M-Bus Data

    CMe3100 DLMS Plugin User's Manual 5.3.4.1 Retrieving raw M-bus data To retrieve raw M-bus data simply map an OBIS code to the “mbus.frame.raw” key. The M-bus data will be provided in the same way as if it was retrieved directly from the meter.

  • Page 19: Excluding Obis Codes From Push Reports

    CMe3100 DLMS Plugin User's Manual Example values: 0016000000;-2147483648;2000-01-01 01:00:00;00;HYD;37;water;10;0;0;47559461;47559461;85,946;0,000;0,000;27,300;14399;22525; 167;2016-01-06 16:50:00 Mapping sample Below is a sample of how to map OBIS codes for getting decoded M-bus data: "includeInPush": "ALL", "mbusTelegram": 0, "mbusKeys": ["mbus.telegram.decoded.value "], "dlmsObisCode": "0.0.1.2.128.255", "dlmsScaler": 0, "dlmsUnit": 0, "dlmsClass": "data",...
  • Page 20 CMe3100 DLMS Plugin User's Manual manufacturer String A three letter manufacturer code for which meter manufacturers this mapping applies to. Use all to match all manufacturers. version Integer Numeric value for which meter version this mapping applies to. Use 0 to match all versions.

  • Page 21: Configure Push Reports

    CMe3100 DLMS Plugin User's Manual Configure Push Reports This section covers how to configure the DLMS Plugin Push Report support, which enables the CMe3100 to send DLMS Push Report to a HES with: • Load Profile data • Billing Profile data •...

  • Page 22: Dlms Push Report Settings

    CMe3100 DLMS Plugin User's Manual DLMS Push Report settings Navigate to Configuration > Push Reports and click the menu tab DLMS Settings to access the configuration page, see Figure 10. Figure 10 Push Reports - DLMS settings Push notifications Enable or disable the Push notification when meter list changed by check/uncheck the checkbox.

  • Page 23: Enable Push Report Of Load Profile/Billing Profile

    CMe3100 DLMS Plugin User's Manual Enable Push Report of Load Profile/Billing Profile Click on the report (Report 1 to Report 5) in the Push Reports page to access the individual push report configuration page. Select DLMS in the drop-down field Report type, see Figure 11.

  • Page 24: Set Dlms Server Settings - Report Receiver

    CMe3100 DLMS Plugin User's Manual 6.4.2 Set DLMS server settings – report receiver Configure desired DLMS servers which should receive the Push Report in the DLMS server settings – report receiver section, see Figure 13. Use the default server settings by check the Send report to default DLMS server checkbox. If the default server settings shouldn’t be used, uncheck the checkbox and enter the desired DLMS...

  • Page 25: Dlms Implementation And Integration

    CMe3100 DLMS Plugin User's Manual DLMS implementation and integration The Product is tested according to the specification defined in the Yellow Book[3] for the DLMS certification. The Product (physical device) comprises of the management logical device (Product) and one logical device for each connected meter. The logical devices can be addressed using channel selection or logical device addressing.

  • Page 26: System Title

    CMe3100 DLMS Plugin User's Manual • Security suite 0 • Authentication: None, Low Level Security or High Level Security mode 5 (see 9.2.74) • Security policy: “None” or “Authenticated and encrypted” (see 9.2.7.2.3) • 7.2.1 Server System title according to IDIS (see 6.1.1 and section...

  • Page 27: High Level Security (Hls) Authentication

    CMe3100 DLMS Plugin User's Manual 7.3.3 High Level Security (HLS) authentication When running HLS authentication both the client and the server have to successfully authenticate themselves to establish a connection (in DLMS known as Application Association or AA). It is a four-pass process and there are several HLS authentication mechanisms available, e.g.

  • Page 28: Logical Device Addressing

    CMe3100 DLMS Plugin User's Manual 7.4.1 Logical device addressing The management logical device can be addressed using logical device address 1. Connected M- Bus meters (meter logical devices) are addressed using logical device address 16..n. A gateway with a single M-Bus meter connected will consequently have two accessible logical devices; the management logical device at address 1 and the meter logical device at address 16.
  • Page 29 CMe3100 DLMS Plugin User's Manual Public client Management (16) client (1) SAP Assignment SAP Assignment (17) Association LN Association LN (15) Clock Clock (8) Logical Device Name Data (1) Receive Frame Counter Data (1) Channel Selection Data (1) None Meter List...
  • Page 30 CMe3100 DLMS Plugin User's Manual ELV<serial number> Example: ELV0016000001 7.5.1.5 Receive Frame Counter Data type: double-long-unsigned This object holds the current value of the frame counter (invocation counter) needed for encrypted communication. The gateway will drop any message carrying a frame counter with the value less than the gateway current value.
  • Page 31 CMe3100 DLMS Plugin User's Manual 7.5.1.11 Gateway IP Address Data type: double-long-unsigned This object holds the gateway IPv4 address numeric representation. For example, the address 192.168.1.2 is represented as 0xC0A80102, decimal value 3232235778. 7.5.1.12 Standard Event Log – Event Id Data type: long-unsigned This object holds the event id of the last event logged to Standard Event Log.
  • Page 32 CMe3100 DLMS Plugin User's Manual COSEM objects/OBIS codes: Date/Time: 0.0.1.0.0.255 Event object: 0.0.96.11.0.255 (Standard), 0.0.96.11.1.255 (Fraud) Event message: 0.128.96.11.0.255 (Standard), 0.128.96.11.1.255 (Fraud) Limitations: Maximum of 1000 rows can be read in one request. See [6] for available log items. 7.5.1.18...

  • Page 33: Meter Logical Device Cosem Objects

    CMe3100 DLMS Plugin User's Manual Attributes: 1: Logical name 2: Push Object List 3: N/A 4: N/A 5: N/A 6: N/A 7: N/A 7.5.1.21 Security setup The security setup object enables read/write of keys and policy used in security suite 0.
  • Page 34 CMe3100 DLMS Plugin User's Manual Load Profile 1 Profile Generic (7) None Load Profile 1 Profile Generic (7) None Billing Data Profile Generic (7) None Standard Event Log Profile Generic (7) None Fraud Event Log Profile Generic (7) None Push Setup Meter Load Profile 1...
  • Page 35 CMe3100 DLMS Plugin User's Manual <type> = Two digit ASCII hex (one byte) type/medium of meter according to [4] section 5.8 representing the meter medium. <version> = Two digits ASCII hex (one byte) version of the meter. 7.5.2.5 Receive Frame Counter...
  • Page 36 CMe3100 DLMS Plugin User's Manual 7.5.2.13 Fraud Event Log – Event Id Data type: long-unsigned This object holds the event id of the last event logged to Fraud Event Log. 7.5.2.14 Fraud Event Log – Event Message Data type: visible-string This object holds the event description of the last event logged to Fraud Event Log.
  • Page 37 CMe3100 DLMS Plugin User's Manual The fraud detection log contains a table of log items of type Profile Generic with meter related log items. The data which can be read from the log is date/time of event and event code.
  • Page 38 CMe3100 DLMS Plugin User's Manual 7.5.2.19 Push Setup Meter Load Profile 2 The push setup object holds the information about the objects to be included in the Load Profile 2 Push report. For more information see 7.6.1.1 Push Profiles Attributes:...

  • Page 39: Push Notifications

    CMe3100 DLMS Plugin User's Manual 1: Logical name 2: Push Object List 3: N/A 4: N/A 5: N/A 6: N/A 7: N/A 7.5.2.23 Security setup The security setup object enables reading of the security parameters. The keys and policy can be changed only in the gateway instance of the security setup object.
  • Page 40 CMe3100 DLMS Plugin User's Manual <octet-string>COSEM logical device name of the meter</octet-string> <octet-string>COSEM logical name of the push setup object</octet-string> <octet-string>COSEM logical name of profile</octet-string> <array> <structure>capture object 1</structure> <structure>capture object m</structure> </array> <array> <structure>profile buffer entry 1</structure> <structure>profile buffer entry n</structure>...
  • Page 41 CMe3100 DLMS Plugin User's Manual 7.6.1.2 Push Event logs Event logs (gateway and meters) are pushed according to configured schedule (see section 6.1) via the Data-Notification Service. A push contains data from a single logical device (gateway or meter). It may contain data from multiple event logs.

  • Page 42: Event Triggered Push Of Data

    CMe3100 DLMS Plugin User's Manual <octet-string>timestamp of the event</octet-string> <octet-string>OBIS code of the event object</octet-string> <unsigned>event code</unsigned> Optionally, it may also contain another item: <visible-string>custom event message</visible-string> OBIS codes used: Timestamp: 0.0.1.0.0.255 Event object: 0.0.96.11.0.255 (Standard), 0.0.96.11.1.255 (Fraud) Custom event message: 0.128.96.11.0.255 (Standard), 0.128.96.11.1.255 (Fraud) 7.6.2 Event triggered push of data...

  • Page 43: Managing Configurations

    CMe3100 DLMS Plugin User's Manual Managing configurations The product feature for managing configurations and backups also include settings for DLMS Plugin (see “Manage configurations” section of the Product’s user interface). As configuration files are used for duplicating settings between many devices the DLMS password and keys are not part of the Configuration file.

  • Page 44: Device Replacement Workflow

    CMe3100 DLMS Plugin User's Manual Device replacement workflow In the case a device needs to be replaced the configuration should be backed up from the device being replaced and import to the replacement device. The steps for accomplishing this are described in section 8.

  • Page 45: Examples And Guides

    CMe3100 DLMS Plugin User's Manual 10 Examples and guides Please contact Elvaco to obtain integration support and access to example code (Java/DLMS). Available examples and guides: • Reading historical data for load profile 1, load profile 2, billing period •...

  • Page 46: Document History

    CMe3100 DLMS Plugin User's Manual Document History Version Date Description Author 2016-06-13 Initial version David Vonasek Added description of System 2016-07-20 David Vonasek title in section 7.2.1 . 2016-09-06 Added description of password Peter Janson and key handling in section 7.3.4.

  • Page 47: References

    CMe3100 DLMS Plugin User's Manual 11 References [1] DLMS UA 1000-2 Ed. 8.0 (Green book) [2] DLMS UA 1000-1 Ed. 12.0 (Blue book) [3] DLMS UA 1001-1 Ed. 5.0 (Yellow book) [4] IDIS Package 2 IP profile Ed 2.0 [5] EN13757-3:2013, Communication systems for and remote reading of meters – Part 3: Dedication...

  • Page 48: Terms And Abbreviations

    CMe3100 DLMS Plugin User's Manual 12 Terms and Abbreviations Abbreviation Description Plugin CMe3100 DLMS Plugin Product CMe3100 Gateway (CMe3100) Head-end system COSEM Companion Specification for Energy Metering DLMS Device language Message Specification OBIS Object Identification System IDIS Interoperable Device Interface Specifications 12.1...

Table of Contents