We only support Python 3.6+
pip install dlms-cosem
Full documentation can be found at www.dlms.dev
dlms-cosem is designed to be a tool with a simple API for working with DLMS/COSEM
enabled energy meters. It provides the lowest level function, as protocol state
management, APDU encoding/decoding, APDU encryption/decryption.
The library aims to provide a sans-io implementation of the DLMS/COSEM protocol so that the protocol code can be reused with several io-paradigms. As of now we provide a simple client implementation based on blocking I/O. This can be used over either a serial interface with HDLC or over TCP.
We have not implemented full support to be able to build a server (meter) emulator. If this is a use-case you need, consider sponsoring the development and contact us.
- AssociationRequest and AssociationRelease
- GET, GET.WITH_BLOCK
- SET
- ACTION
- DataNotification
- GlobalCiphering - Authenticated and Encrypted.
- HLS-GMAC auth
- Selective access via RangeDescriptor
- Parsing of ProfileGeneric buffers
A simple example:
from dlms_cosem.clients.dlms_client import DlmsClient
from dlms_cosem import enumerations, cosem
# read current client invocation counter
with DlmsClient.with_tcp_transport(
server_logical_address=1,
client_logical_address=16,
host="localhost",
port=4059
).session() as client:
data = client.get(
cosem.CosemAttribute(
interface=enumerations.CosemInterface.DATA,
instance=cosem.Obis(0, 0, 0x2B, 1, 0),
attribute=2,
)
)Look at the different files in the examples folder get a better feel on how to fully
use the library.
Technically we aim to support any DLMS enabled meter. The library is implementing all the low level DLMS, and you might need an abstraction layer to support everything in your meter.
DLMS/COSEM specifies many ways of performing tasks on a meter. It is customary that a meter also adheres to a companion standard. In the companion standard it is defined exactly how certain use-cases are to be performed and how data is modeled.
Examples of companion standards are:
- DSMR (Netherlands)
- IDIS (all Europe)
- UNI/TS 11291 (Italy)
On top of it all your DSO (Distribution Service Operator) might have ordered their meters with extra functionality or reduced functionality from one of the companion standards.
We have some meters we have run tests on or know the library is used for in production
- Pietro Fiorentini RSE 1,2 LA N1. Italian gas meter
- Iskraemeco AM550. IDIS compliant electricity meter.
This library is developed by Palmlund Wahlgren Innovative Technology AB. We are based in Sweden and are members of the DLMS User Association.
If you find a bug please raise an issue on Github.
We welcome contributions of any kind.
We add features depending on our own, and our clients use cases. If you need a feature implemented please contact us.
We offer consultancy service and training services around this library and general DLMS/COSEM. If you are interested in our services just reach out to us.
If you have implemented a solution based on this library we also offer a commercial support scheme.