Changes

<p style="color:red">The information in this page is updated in accordance with [https://wiki.teltonika-networks.com/view/FW_%26_SDK_Downloads'''00.07.05.4'''] firmware version.</p>  

<p style="color:red">The information in this page is updated in accordance with [https://wiki.teltonika-networks.com/view/FW_%26_SDK_Downloads'''00.07.05.4'''] firmware version.</p>  

==Introduction==

==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 is confusion between IEC 62056-21 and DLMS. '''IEC 62056-21 is not DLMS'''.

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 is confusion between IEC 62056-21 and DLMS. '''IEC 62056-21 is not DLMS''' and is not currently supported by our devices.

    

    

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 perform read operations on DLMS servers, with write operations not currently supported.

COSEM (''Companion Specification for Energy Metering'') is a protocol that falls under the DLMS standard. 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 perform read operations on DLMS meters, with write operations not currently being supported.

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==

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

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===

===Connection configuration===

----

----

Once installed, we can head over to Services → DLMS. Once the DLMS is opened, head over to the '''Connections tab''':<br>

Once installed, we can head over to Services → DLMS. Select the '''Connections tab''':<br>

[[File:DLMS_client_configuration_example_Connections_tab_v1.png|border|class=tlt-border|1100x1100px]]<br>

[[File:DLMS_client_configuration_example_Connections_tab_v1.png|border|class=tlt-border|1100x1100px]]<br>

====TCP/IP====

====TCP/IP====

* When the configuration window opens up, specify:

* When the configuration window opens up, specify:

** '''Connection type''' as '''TCP''';

** '''Connection type''' as '''TCP''';

** '''IP address''' of the DLMS server. It can be assigned statically or dynamically using DHCP;

** '''IP address''' of the DLMS meter. 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;

** '''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 check 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:<br>

After the connection parameters are entered, do not forget to '''enable the instance'''! The configuration could look similar to this:<br>

[[File:DLMS_client_configuration_example_TCP_connection_v1.png|border|class=tlt-border|900x900px]]<br>

[[File:DLMS_client_configuration_example_TCP_connection_v1.png|border|class=tlt-border|900x900px]]<br>

** '''Connection type''' as '''Serial''';

** '''Connection type''' as '''Serial''';

** Under the '''Serial device''' field, specify whether you're using RS485 or RS232;

** 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;

** Specify the remaining serial parameters. They can either be configured in the DLMS meter itself, or the default ones should be specified within the user manual;

The final configuration could look like so:<br>

The final configuration could look like so:<br>

[[File:DLMS_client_configuration_example_serial_connection_v1.png|border|class=tlt-border|900x900px]]<br>

[[File:DLMS_client_configuration_example_serial_connection_v1.png|border|class=tlt-border|900x900px]]<br>

===Physical device configuration===

===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:<br>

Once we have configured the basic connection parameters, we can move onto configuring the physical DLMS 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:<br>

[[File:DLMS_client_configuration_example_physical_device_window_v1.png|border|class=tlt-border|700x700px]]<br>

[[File:DLMS_client_configuration_example_physical_device_window_v1.png|border|class=tlt-border|700x700px]]<br>

* Select the '''connection instance''' created earlier;

* Select the '''connection instance''' created earlier;

*** Client address '''17''' - '''Low''';

*** Client address '''17''' - '''Low''';

*** Client address '''18''' - '''High''';

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

** The client address should be specified in the '''user manual''' of the DLMS meter. 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'''

* '''Interface type'''

** We currently support two DLMS interface types:

** We currently support two DLMS interface types:

*** '''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.

*** '''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'''

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

** 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 meter. It has 4 possible levels of security.

===Testing physical device reachability===

===Testing physical device reachability===

====COSEM value configuration====

====COSEM value configuration====

----

----

Each COSEM value needs to be created for every OBIS code that needs to be read from the DLMS Server. In this window we will need to specify:

Each COSEM value needs to be created for every OBIS code that needs to be read from the DLMS meter. In this window we will need to specify:

* '''Physical device''' that we will be reading the value from;

* '''Physical device''' that we will be reading the value from;

* '''OBIS code''' of the value that we would like to read;

* '''OBIS code''' of the value that we would like to read;

** OBIS codes specify the location of the data on the DLMS server, and they can be found in the user manual of your device.  

** OBIS codes specify the location of the data on the DLMS meter, and they can be found in the user manual of your device.  

** It should be in the following format: '''A.B.C.D.E.F''' (''for example, 1.0.1.4.6.255''). OBIS codes are comprised of 6 groups, and each group represents a different piece of information about the OID in question. More information about it can be found in the sources linked at the end of the article.

** It should be in the following format: '''A.B.C.D.E.F''' (''for example, 1.0.1.4.6.255''). OBIS codes are comprised of 6 groups, and each group represents a different piece of information about the OID in question. More information about it can be found in the sources linked at the end of the article.

** The same OBIS code can be read from multiple devices/logical devices at the same time;

** The same OBIS code can be read from multiple devices/logical devices at the same time;

* '''COSEM class ID''' (''also known as COSEM object'') specifies the format in which the data will be returned. The most commonly used ones are '''DATA (ID: 1)''' and '''REGISTER (ID: 3)''', however, this information should be available in the user manual of your DLMS server along with each OBIS code.<br>

* '''COSEM class ID''' (''also known as COSEM object'') specifies the format in which the data will be returned. The most commonly used ones are '''DATA (ID: 1)''' and '''REGISTER (ID: 3)''', however, this information should be available in the user manual of your DLMS meter along with each OBIS code.<br>

Here is an example of a configured COSEM value:<br>

Here is an example of a configured COSEM value:<br>

[[File:DLMS_client_configuration_example_cosem_value_v1.png|border|class=tlt-border|800x800px]]<br>

[[File:DLMS_client_configuration_example_cosem_value_v1.png|border|class=tlt-border|800x800px]]<br>

If the service fails to obtain one or more COSEM values, you'll get an error within the JSON string, as well as when hovering over the exclamation mark next to each COSEM value in question:<br>

If the service fails to obtain one or more COSEM values, you'll get an error within the JSON string, as well as when hovering over the exclamation mark next to each COSEM value in question:<br>

[[File:DLMS_client_configuration_example_testing_cosem_group_error_v2.png|border|class=tlt-border|800x800px]]<br>

[[File:DLMS_client_configuration_example_testing_cosem_group_error_v2.png|border|class=tlt-border|800x800px]]<br>

The JSON string will then be sent to the Data to Server module, to be sent to a remote data collection server. In the Data to server module, it is possible to filter the values by the COSEM Group name.

The JSON string will then be available in the Data to Server service, which then can send the data to your remote data collection server. Values can be filtered in the Data to server module by their COSEM group names.

==References==

==References==

* DLMS in a nutshell by GuruX: https://www.gurux.fi/DLMSInNutshell

* DLMS in a nutshell by GuruX: https://www.gurux.fi/DLMSInNutshell