jDLMS is a Java implementation of the DLMS/COSEM protocol. It can be used to develop individual DLMS/COSEM client/master and. based communication while DLMS is a binary protocol. This document provides overview of COSEM modeling of metering devices, addressing and DLMS. The open smart grid platform supports DLMS/COSEM (IEC ]. DLMS/ COSEM is a popular protocol to read smart meters. DLMS/COSEM is the de facto .
|Published (Last):||19 March 2004|
|PDF File Size:||10.15 Mb|
|ePub File Size:||6.48 Mb|
|Price:||Free* [*Free Regsitration Required]|
You must accept the license to download this software. Please contact us for an dosem license agreement if the license terms shown below are not suitable for you. You may want to take a look at the source code of the ConsoleClient or the ConsoleServer which is part of the distribution. The following is a brief sample client that connects to a server and reads using the GET service the list of COSEM cowem available in the logical device.
The jDLMS server comes with an annotaion processor. The annotation processor can be applied using the following gradle build script. For futher information, see the gradle plugin project page https: A command line application is part of the library that can be used to connect, read, write and scan DLMS devices.
You can execute it using the jdlms-console-client script found in the folder run-scripts. Executing the script without any parameters will print help information to the screen.
Instead of running the application from cowem terminal you can create Eclipse project files as explained in our FAQs and run it from within Eclipse. Many meters offer an optical interface at the front of the meter.
One can communicate over this interface using optical probes that convert the signal to RS and back again. The entity accessing the meter is called the client or master respectively. In this manual we will always use the terms client and server. Each logical device has an address in the range [0, ].
As an example, a meter could consist of one logical device for electricity metering at address 18 and another one for a connected gas meter at address The content of this device may vary, but it must at least have a list of all logical devices inside the physical smart meter. The server address consists of the physical address and the address of the logical device.
Over serial the physical address also referred to as the lower HDLC address ranges from 0 to It can either be left empty over RS or not RS The client ID also called client SAP or client wPort defines the access level with which the client connects to the logical device.
The client ID 16 is a special client ID, which refers to the public client for which no authentication or encryption xosem required.
These are identified using attribute ID and method ID respectively.
Microstar Electric Company Limited
Attributes and methods can be addressed in two ways: The referencing method needs is negotiated during connection build up. Logical name referencing is recommend and is more commonly used. A logical name is actually an OBIS code. It sometimes also called instance ID.
It is a 6 byte number that uniquely identifies an object in a logical device. For example, the clock of a smart meter is always reachable under the address [0, 0, 1, 0, 0, ]. Only bytes C and D are mandatory. The six protodol have the prohocol meaning:. Defines the medium e. An object related to no medium e. The channel number allows to differentiate between different inputs e.
Defines the abstract of physical data items, related to the information source e. Defines types, or the result of the processing of physical quantities identified with the value groups A and Caccording to various specific algorithms e.
The value group E defines further processing or classification of pgotocol identified by value groups A to D e. Defines the storage of the data, identified by A to E e. May be set to 0xFF where this is irrelevant. Further attributes refer to actual data see section 4. Contains the list of all logical devices and their SAP addresses within the physical device.
The second way to address an attribute or protocoll is by means of the so called short address.
IEC – Wikipedia
Short addresses are used for small devices and should only be used if the connected smart meter cannot communicate using logical names.
When short name referencing is used the meter still holds a unique logical name i. Obis code for each of protoocl objects. In addition each object has 2 byte short name that maps to the logical name. Thus a client can address each attribute or method using 2 bytes only. The address space of short addresses is not standardized like the logical names, meaning that the same address can lead to different objects on different devices. After the connection to a logical device has been established, a client can send service requests to the server.
The part is defined by some specific selective access parameters. These selective access parameters are defined as part of the attribute specification. The two mechanisms often use the same keys but they can be chosen independently of each other and can be used in any combination. The protocpl mechanism is the mechanism by which client and server authenticate each other during connection build up.
The following authentication mechanisms also called security levels exist:.
DLMS/COSEM Protocol – Microstar Electric Company Limited
dosem In this case both client and server are authenticated. First both client and server exchange challenge strings e. Then both use cryptographic algorithms on these challenge strings and send the result back. The cryptographic algorith used cosej authentication depends on the HLS level:. The algorithm takes both the global encryption key 16 bytes as well as the authentication key 16 bytes as inputs.
Until recently only one encryption mechanism also called security suite existed. It has the the ID 0. By now new security mechanisms have been defined. It is the only mechanism currently supported by jDLMS. It uses the global unicast encryption key and, if available, the authentication key. Optionally a client may send a so called dedicated key i. The dedicated key is then used instead of the global encryption key for the remaining communication of this connection.
The dedicated key is a temporary key that is usually generated ad-hoc at connection time. Used by authentication mechanisms such as HLS 5 as well as optionally by encryption mechanisms such as mechanism 0. Used by authentication mechanisms such as HLS 5 as well as by encryption mechanisms such as mechanism 0.
A temporary session key that can optionally be used instead of the global encryption key by encryption mechanisms. The master key is used for wrapping global keys. When changing the global encryption or authentication keys one has to wrap the new key before transmitting it.
For license information check dosem license directory in the distribution. A library for ASN. The library is licensed under the LGPL v2. A library needed for security algorithms.
It is only needed if jDLMS is used with encryption or high level authentication enabled. The dependencies folder in the distribution contains more detailed license and copyright information about these dependencies. We use the Gradle build automation tool. The distribution contains a fully functional gradle build file build. Thus if you changed code and want to rebuild a library you can do it easily with Gradle. Also if you want to import our software into Eclipse you can easily create Eclipse project files using Gradle.
Just follow the instructions on our FAQ site. The generated classes are part of cossem. You will not need this application if you simply want to use the jDLMS library. License Agreement You must accept the license to download this software.
Command Line Application A command line application is part of the library that can be used to connect, read, write and scan DLMS protoxol. Server Address The server address consists of the physical address and the address of the logical device. The logical device address is sometimes called server wPort or server SAP. The six bytes have the following meaning: C Defines the abstract of physical data items, related to the information source e.
D Defines types, or the result of the processing of physical quantities identified with the value groups A and Caccording to various specific algorithms lrotocol.
E The value group E defines further processing or classification of quantities identified by value groups A to D e. F Defines the storage of the data, identified by A to E e. Class ID Logical Name i. Short Name Referencing The second way to address an attribute or method is by means of the so called short address. DLMS Services After the connection to a logical device has been established, a client can send service requests to the server.