Skip to main content

Library to parse IEC62056/IEC1107/DSMR telegrams

Project description

iec62056

a robust IEC1107/IEC62056 parser in Python.

This library is meant to parse IEC1107/IEC62056 telegrams in Python. You'll need this to process information from your smart meter (e.g. DSMR P1). The code differs from other libraries in several ways:

  • It actually parses the messages using a (EBNF) grammar. This makes the parsing robust and extendable.
  • It is designed as an external library instead of being inseperable with other software components (such as P1 serial readers).
  • It aims to handle all IEC 62056 formatted telegrams, not only DSMR. I needed this, because of my IEC 1107 speaking district heat meter, which resembles DSMR.

Compatibility

This module is targeted to be compatible with all kinds of digital meters outputting IEC62056 formatted telegrams. It implements several (sub)standards.

Standards

The module implements the following standards:

  • IEC 1107/IEC 62056-21 (COSEM, OBIS). IEC 1107 was superseded by IEC 62056
  • DSMR (versions 2.2, 4.0, 4.0.5, 4.0.7, 4.2, 5.0)

Data types

These data types are recognised:

  • Standard COSEM OBIS register
  • COSEM OBIS timestamped register (e.g. gas via M-Bus)
  • Profile Generic (e.g. power failure logs)

Equipment

Testing was done with sample telegrams from the following meters:

  • Kamstrup Multical 66C (district heating meter)
  • Kaifa MA 105
  • Iskra AM 550
  • Iskra MT 382
  • Landis + Gyr E350/ZCF110

Usage

$ pip install iec62056
$ python3
>>> import iec62056
>>> p = iec62056.parser.Parser()
>>> t = p.parse(b'... your telegram ')
>>> print(t.keys())
>>> for k in t.keys():
...   o = t[k]
...   if isinstance(o, iec62056.objects.Register):
...     print('  {} = {}'.format(k, o.value))
>>>

Thanks

Since specs on IEC 62056/1107 and DSMR can sometimes be tough to find or interpret, I used a lot of concepts from other projects. I've used knowledge from these projects:

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

iec62056-0.1.1.tar.gz (5.8 kB view details)

Uploaded Source

File details

Details for the file iec62056-0.1.1.tar.gz.

File metadata

  • Download URL: iec62056-0.1.1.tar.gz
  • Upload date:
  • Size: 5.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.0.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.7.1

File hashes

Hashes for iec62056-0.1.1.tar.gz
Algorithm Hash digest
SHA256 a72c8fcca14db2112c6e4bb909d5a9fb0b4860d26bfc29ae18abce86b11c916b
MD5 258310f07ba85f8e7848c8a388ba2f82
BLAKE2b-256 4753ba7ba65fcfc8597cd45416155036dd843dbfd509bbcc0167d463992c56ad

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page