---
id: dsmr-parser
version: "1.11.2"
license: MIT
license_treatment: permissive
maintenance: active
---

# dsmr-parser — Library to parse Dutch Smart Meter Requirements (DSMR)

License: permissive · Maintenance: active · Downloads: 82.1K/mo

## What it is and what it does

dsmr-parser is a library for reading and parsing Dutch Smart Meter (P1 port) data. It provides both low-level parsing of raw DSMR telegram strings and high-level client implementations for reading directly from serial ports, TCP sockets, or remote serial servers. The library normalizes meter readings (electricity usage, tariffs, gas consumption, current draw) into structured Telegram objects with typed values and units.

The package supports three usage patterns: synchronous serial or socket clients (blocking, suitable for dedicated processes), a parsing module for pre-captured telegram strings, and an asyncio-based TCP client for non-blocking integration. It handles multiple DSMR protocol versions transparently, allowing you to specify the version when creating a reader or parser. Telegrams are returned as objects with named attributes for each meter value, though the legacy dictionary interface is preserved for backwards compatibility.

Use it for:

- Read electricity and gas consumption from a Dutch smart meter connected via serial port and log or store the data.
- Parse raw DSMR telegram strings captured from a meter or ser2net proxy into structured meter readings.
- Build an asyncio-based home automation or monitoring service that consumes meter data from a remote TCP endpoint.
- Extract specific meter values (current usage, tariff counters, timestamps) from parsed telegrams for real-time dashboards.
- Support multiple DSMR protocol versions in a single application by switching telegram specifications at runtime.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Parses Dutch Smart Meter Requirements (DSMR) telegram data from serial ports, sockets, or raw strings, supporting DSMR versions 2, 3, 4, and 5.

Yes. The package is actively maintained, has no known vulnerabilities, low install friction, and a permissive license. It directly solves a specific, well-defined problem (DSMR parsing) with multiple integration patterns. Install it if you need to read Dutch smart meter data; skip it if you don't have a P1 port or DSMR source.

## Install

pip install dsmr-parser
uv add dsmr-parser
poetry add dsmr-parser

## Installing dsmr-parser

Before you install: Low friction: pure Python wheel with only three runtime dependencies (serialx, Tailer, dlms_cosem). Actively maintained with a recent release (13 days old) and steady commit history.

License in practice: MIT license is permissive; you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.

Quickstart:

from dsmr_parser import telegram_specifications
from dsmr_parser.parsers import TelegramParser

parser = TelegramParser(telegram_specifications.V4)
telegram = parser.parse(telegram_str)  # telegram_str is a raw DSMR telegram
print(telegram.electricity_used_tariff_1.value)  # access parsed meter value

Requires Python 3.10 or later. For serial client usage, a physical serial port or ser2net proxy must be available.

Verify before relying:

- Whether all three runtime dependencies (serialx, Tailer, dlms_cosem) are themselves actively maintained and secure.
- Whether the asyncio implementation fully supports all DSMR versions or has version-specific limitations beyond what the description states.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 82.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

DSMR telegram parser, Dutch smart meter data, P1 port reader, electricity meter parsing, smart meter serial client, DSMR protocol parser, meter data extraction, smart-meter, dsmr, iot-data

[View on SkillFed](https://skillfed.io/packages/dsmr-parser) · [View on PyPI](https://pypi.org/project/dsmr-parser/)