Skip to content

Feature/ha#3

Open
jkiddo wants to merge 5 commits into
gertvdijk:developfrom
jkiddo:feature/ha
Open

Feature/ha#3
jkiddo wants to merge 5 commits into
gertvdijk:developfrom
jkiddo:feature/ha

Conversation

@jkiddo
Copy link
Copy Markdown

@jkiddo jkiddo commented Jan 4, 2026

This pull request introduces a new Home Assistant MQTT integration for PyKMP, enabling Kamstrup meter data to be published to an MQTT broker for use in Home Assistant. It includes a new helper script, systemd service and environment file examples, comprehensive documentation, and a new mkdocs configuration for improved documentation management.

Home Assistant MQTT Integration:

  • Added a new helper script, examples/home_assistant_mqtt.py, which reads Kamstrup meter data and publishes it to MQTT, supporting Home Assistant auto-discovery and per-register topics. The script is configurable via environment variables and includes robust error handling and logging.

  • Added a sample environment file, contrib/systemd/pykmp-ha.env.example, providing configuration for MQTT and serial connection settings.

  • Added a systemd service unit, contrib/systemd/pykmp-ha-mqtt.service, to run the MQTT publishing helper as a service, with instructions for customization.

Documentation Improvements:

  • Added a new guide, docs/home-assistant-mqtt.md, with step-by-step instructions for installing, configuring, and running the MQTT integration on a Raspberry Pi, as well as details on published topics and Home Assistant integration.

  • Introduced a mkdocs.yml configuration, enabling modern, structured, and themed documentation for the project, including navigation, theming, and plugin setup.

@jkiddo jkiddo marked this pull request as ready for review January 4, 2026 15:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant