HomeWizard P1 Prometheus Exporter

A Rust-based Prometheus exporter for the HomeWizard P1 Meter, providing real-time electricity and gas consumption metrics.

Features

• 🚀 High Performance - Lightweight and efficient Rust implementation
• 📊 Real-time Monitoring - Power consumption/production metrics updated every 10 seconds
• ⚡ Power Quality Tracking - Voltage sags/swells and power failure monitoring
• 🔥 Gas Consumption - Integrated gas meter reading support
• 💰 Tariff Support - Separate metrics for peak (T1) and off-peak (T2) tariffs
• 📡 Network Monitoring - WiFi signal strength tracking
• 🐳 Docker Ready - Multi-platform images for easy deployment
• ✅ Production Ready - Comprehensive test coverage and error handling

Prerequisites

• HomeWizard P1 Meter with local API enabled
• Rust 1.88+ (for building from source)
• Docker (for container deployment)

Quick Start

# Using Docker
docker run -d -p 9898:9898 -e HOMEWIZARD_HOST=192.168.1.100 rvben/homewizard-p1-exporter:latest

# Or using pre-built binary
wget https://github.com/rvben/homewizard-p1-exporter/releases/latest/download/homewizard-p1-exporter-$(uname -m)-linux.tar.gz
tar -xzf homewizard-p1-exporter-*.tar.gz
HOMEWIZARD_HOST=192.168.1.100 ./homewizard-p1-exporter

Installation

Using Docker (Recommended)

# From Docker Hub
docker run -d \
  --name homewizard-p1-exporter \
  -p 9898:9898 \
  -e HOMEWIZARD_HOST=192.168.1.100 \
  rvben/homewizard-p1-exporter:latest

# From GitHub Container Registry
docker run -d \
  --name homewizard-p1-exporter \
  -p 9898:9898 \
  -e HOMEWIZARD_HOST=192.168.1.100 \
  ghcr.io/rvben/homewizard-p1-exporter:latest

Using Pre-built Binaries

Download the latest release for your platform from the releases page.

# Example for Linux x86_64
wget https://github.com/rvben/homewizard-p1-exporter/releases/latest/download/homewizard-p1-exporter-x86_64-linux.tar.gz
tar -xzf homewizard-p1-exporter-x86_64-linux.tar.gz
chmod +x homewizard-p1-exporter
HOMEWIZARD_HOST=192.168.1.100 ./homewizard-p1-exporter

Using Cargo

cargo install homewizard-p1-exporter
HOMEWIZARD_HOST=192.168.1.100 homewizard-p1-exporter

Building from Source

# Clone the repository
git clone https://github.com/rvben/homewizard-p1-exporter
cd homewizard-p1-exporter

# Build the binary
cargo build --release

# Run the exporter
HOMEWIZARD_HOST=192.168.1.100 ./target/release/homewizard-p1-exporter

Configuration

The exporter can be configured via command-line arguments or environment variables:

Metrics

The exporter provides the following Prometheus metrics:

Prometheus Configuration

Add the following to your prometheus.yml:

scrape_configs:
  - job_name: 'homewizard'
    static_configs:
      - targets: ['localhost:9898']
    scrape_interval: 30s

Enabling HomeWizard Local API

1. Open the HomeWizard Energy app
2. Go to Settings → Meters → Your P1 Meter
3. Enable "Local API"

Grafana Dashboard

An example Grafana dashboard is included in grafana-dashboard.json. To import:

1. Open Grafana
2. Go to Dashboards → Import
3. Upload the JSON file or paste its contents
4. Select your Prometheus data source
5. Click Import

The dashboard includes:

• Real-time power usage graph
• Current power gauge
• Total power imported/exported
• Gas consumption
• Current tariff indicator

Development

# Show all available make targets
make help

# Build the binary
make build

# Run tests
make test

# Check code formatting and linting
make check

# Run the exporter locally
HOMEWIZARD_HOST=192.168.1.100 make run

# Build Docker image
make docker-build

# Run in Docker
HOMEWIZARD_HOST=192.168.1.100 make docker-run

License

MIT License - see LICENSE file for details

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.