pysml

What it is and what it does

pysml is a Python library that reads and decodes Smart Message Language (SML) protocol data from EDL21 smart electricity meters. It abstracts away low-level SML parsing and provides access to OBIS meter values. The library supports multiple transport mechanisms—direct serial connections, serial-over-TCP bridges, and HTTP endpoints—making it flexible for different deployment scenarios.

The package is actively used by Home Assistant's EDL21 integration and includes example code for publishing meter readings to MQTT. It depends on aiohttp, bitstring, and serialx for async HTTP, binary protocol handling, and serial communication. With MIT licensing and support for Python 3.11 through 3.14, it suits home automation, energy monitoring, and utility data collection workflows.

Use it for:

• Read energy consumption data from EDL21 meters in Home Assistant or other home automation systems.
• Build an MQTT bridge to publish smart meter OBIS values to a message broker for real-time monitoring.
• Collect meter readings over serial-over-TCP links in remote or networked meter deployments.
• Parse and log SML protocol data from HTTP-accessible meter endpoints for analytics or billing systems.
• Integrate smart meter data into custom Python applications for demand-side energy management.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Reads and parses Smart Message Language (SML) data from EDL21 smart meters via serial ports, serial-over-TCP, or HTTP connections.

Yes, if you need to read EDL21 smart meters. The library is actively maintained, has low install friction, carries no known vulnerabilities, and is proven in Home Assistant. MIT license is unrestrictive. Main consideration: ensure your meter model and transport method are supported, and your Python environment is 3.11 or later.

Install

pysml on PyPI

pip install pysml

uv add pysml

poetry add pysml

Installing pysml

Before you install

Low install friction with a pure-Python wheel distribution. Actively maintained with a recent release 75 days ago. Requires Python 3.11 or later.

License in practice

MIT license permits commercial and private use with minimal restrictions—suitable for most projects.

Quickstart

pip install pysml

import pysml
# Read SML data from serial port, serial-over-TCP, or HTTP endpoint
# See examples/sml-mqtt-bridge.py for MQTT publishing pattern

Requires Python 3.11 or later; meter must be accessible via serial, serial-over-TCP, or HTTP.

Verify before relying

• Whether aiohttp, bitstring, and serialx are stable and well-maintained for production use.
• Performance characteristics when reading from high-frequency meter streams or concurrent connections.
• Completeness of SML protocol support and compatibility with specific meter models.
• Whether example code for MQTT publishing is production-ready or demonstration-only.

Package facts

Evidence: pysml-0.1.8-py3-none-any.whl

Tags

More Monitoring packages