DLMS client configuration example
The information in this page is updated in accordance with 00.07.05.4 firmware version.
Introduction
DLMS (Device Language Message Specification) is a set of standards used for communication between various meters, monitoring equipment, and the respective controllers. It uses TCP/IP or serial communication and utilizes Client and Server topology, where the client polls the data from the server (usually gas/electricity/water meter). It should be noted, that there often confusion between IEC 62056-21 and DLMS. IEC 62056-21 is not DMLS.
COSEM (Companion Specification for Energy Metering) is a protocol that falls under the DLMS standard, and it provides application and transport layers for the protocol. COSEM defines a set of objects that represent the data and functions of the meter, and a set of services that allow the client to access the objects. COSEM also specifies the security mechanisms for authentication and encryption of the messages. It should be noted, that for now our implementation of COSEM only allows us to only perform read operations on DLMS servers, with write operations not currently supported.
In this article, we will be providing an example of how to configure DLMS Client in RutOS, as well as outlining a few things to keep in mind. RutOS supports DLMS as an additional software package that can be installed from the System → Package Manager → Packages page.
For this example we will be using a three phase electricity meter made by CLOU Electronics with a model number of CL730S22. We will be demonstrating the configuration of TCP/IP connections as well.
Configuration
The first step in getting DLMS up and running will be to configure the connection to a device. Here we will cover both TCP/IP and serial connection configuration. To get started with DLMS, a separate DLMS Client package needs to be downloaded from our package manager, which can be found by navigating to System → Package Manager → Packages.
Connection configuration
Once installed, we can head over to Services → DLMS. Once the DLMS is opened, head over to the Connections tab:
TCP/IP
- Create a new instance with an easily recognizable name and press the Add button;
- When the configuration window opens up, specify:
- Connection type as TCP;
- IP address of the DLMS server. It can be assigned statically or dynamically using DHCP;
- Port number of the DLMS access. Usually, the port used for DLMS/COSEM is anywhere from 4059 to 4063. Please refer to a manual of your device to understand which port is used by your device;
After the connection parameters are entered, do not forget to enable the instance! The configuration could look similar to this:
Serial
- Create a new instance with an easily recognizable name and press the Add button;
- When the configuration window opens up, specify:
- Connection type as Serial;
- Under the Serial device field, specify whether you're using RS485 or RS232;
- Specify the remaining serial parameters. They can either be configured in the DLMS server itself, or the default ones should be specified within the operating manual;
The final configuration could look like so:
Physical device configuration
Once we have configured the basic connection parameters, we can move onto configuring the DLMS physical devices. Back in the Main tab, we can create a new DLMS physical device interface with a recognizable name. Once the instance is created, and the configuration window opens up, there are a few parameters we need to specify:
- Select the connection instance created earlier;
HDLC Addressing
- Specify the Server address. This address is also commonly known as Physical device address or Lower address. For a single physical device, there can only be one physical server address! This parameter is mainly used in serial connections where there are no other means of addressing a device.
- Specify the Logical server address. It is also commonly known as the Upper address. A single physical device can have more than one logical address. Each logical server can have their own client addresses, access security levels, etc.
Client addressing
Client address, as defined by the standard, relates to the permissions of the user. Each client address represents a different Access security level:
- Client address 16 - None;
- Client address 17 - Low;
- Client address 18 - High;
The client address should be specified in the user manual of the DLMS Server. However, if you are not able to find this information, the most commonly used address is 16 with no authentication. Keep in mind, that some manufacturers may not follow the standard and use Client addresses that do not follow the scheme mentioned above.
Interface type
We currently support two DLMS interface types:
- Wrapper - can only be used with TCP/IP connections, but is simpler to implement;
- HDLC - can be used with both serial and TCP/IP connections. We currently support direct serial connections, as well as IEC 62056-21 protocol mode E / HDLC with mode E interfaces, which contain an optical probe on one end, and RS interface on the other.
Transport security
Transport security, unlike access security, specifies on how the data should be encrypted when being transferred via the TCP/IP or Serial communication lines. This parameter can also be found in the user manual of the DLMS Server. It has 4 possible levels of security.
Finally, once we have configured the physical DLMS device, we can test if our configuration up until this point was correct by enabling the DLMS Client package, the created physical device instance, saving the settings, and pressing the TEST button:
If you're receiving an error, open physical device instance, and press the TEST button at the bottom. It will provide a more specific error message:
