weltenwort / py-power-meter-monitor

A bridge between the RS-485 interface of certain Logarex power meters and MQTT with Home Assistant support.
MIT License
2 stars 0 forks source link
home-assistant homeassistant logarex mqtt power-meter

py-power-meter-monitor

license standard-readme compliant test-status GitHub release (latest SemVer)

A bridge between the serial interface (RS485 or infrared) of certain power meters and MQTT with Home Assistant support.

Table of Contents

Background

This is intended to be deployed on a device that has a physical serial connection to a power meter manufactured. It has only been tested with the following models:

Please contribute experiences with this or other models in an issue.

Install

The application may be deployed from source or as a container.

From source

To deploy from source use poetry to install or build a wheel.

As a container

The included Dockerfile contains build instructions for an image based on Alpine Linux. The recommended way to build and deploy it is podman:

$ podman build --rm -t py-power-meter-monitor:latest .
$ podman run \
  --device /dev/ttyUSB0:/dev/ttyUSB0 \
  --volume $(pwd)/default-config.toml:/home/py-power-meter-monitor/config.toml:ro \
  localhost/py-power-meter-monitor:latest --config-file config.toml

Usage

The configuration file allows for parameterization of various aspects:

Contributing

I welcome requests, bug reports and PRs.

Small note: If editing the Readme, please conform to the standard-readme specification.

License

MIT