P1 Meter exporter

Note When errors occur, the data that caused the error is submitted to Rollbar to reproduce and fix the error.

Usage

docker-compose

version: '3.0'
services:
  p1-meter-exporter:
    image: ghcr.io/vidavidorra/p1-meter-exporter:latest
    container_name: p1-meter-exporter
    environment:
      - METER_API_URL=http://192.168.1.10/api
      - INFLUXDB_URL=http://192.168.1.2:8086
      - 'INFLUXDB_TOKEN=RUHDbp7UGt7I6Q+abdG7QVtrcdOPtHJlGDugMNxFUSY='
      - INFLUXDB_ORGANISATION=my-org
      - INFLUXDB_BUCKET=p1-meter
      - LOG_LEVEL=trace # optional
    restart: unless-stopped

Parameters

The Docker container image is configured using environment envirables passed at runtime.

parameter	description
`METER_API_URL`	URL to the HomeWizard P1 meter API
`INFLUXDB_URL`	URL to Influx DB
`INFLUXDB_TOKEN`	Influx DB token with write permissions to the bucket
`INFLUXDB_ORGANISATION`	Influx DB organisation name or ID
`INFLUXDB_BUCKET`	name or ID of the Influx DB bucket to write the data to
`LOG_LEVEL`	optional specify log level, can be one of `trace`, `debug`, `info`, `warn`, `error`, `fatal`

Unraid

On Unraid the Docker container image can be used using the pre-defined template. Open a terminal or SSH to the server and execute the following command to download the template in the user template section. This template can then be used when adding a container.

curl https://raw.githubusercontent.com/vidavidorra/p1-meter-exporter/main/static/unraid.xml -o /boot/config/plugins/dockerMan/templates-user/p1-meter-exporter.xml

Security policy

Please refer to the Security Policy on GitHub for the security policy.

License

This project is licensed under the GPLv3 license.

License details.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

The full text of the license is available in the LICENSE file in this repository and online.