Custom Integration: PVHub 2.0

Hi everyone,

I’ve been working on a Home Assistant custom integration for PVHub 2.0, used by some 1KOMMA5° solar systems.

This is not the 1KOMMA5° Heartbeat API integration. My system uses the PVHub 2.0 portal, so the existing Heartbeat/Auth0-based libraries did not work for my account.

GitHub repo:

What it does

The integration currently reads monitoring data from the PVHub 2.0 web portal API and creates Home Assistant sensors for:

  • Battery SoC
  • Solar power
  • Battery charge power
  • Battery discharge power
  • Grid import power
  • Grid export power
  • Site power usage

It also groups entities into logical Home Assistant devices:

  • PVHub Battery
  • PVHub Solar Inverter
  • PVHub Grid Meter
  • Site Power Usage

Authentication

At the moment, setup uses copied request headers from Chrome DevTools:

  • PVHUB_COOKIE
  • PVHUB_TOKEN
  • PVHUB_SIGNATURE
  • PVHUB_TIMESTAMP
  • PVHUB_LANG
  • PVHUB_TIMEZONE

I originally experimented with username/password login, but PVHub signs browser requests with signature.js / signature.wasm, so copied headers are currently the reliable path.

Safety

This integration is intended for monitoring only.

It does not send inverter control, battery control, export-limit, charge/discharge, settings, configuration, or automation commands.

Dashboard example

The repo includes an ApexCharts card example to show power and battery SoC over time, similar to the PVHub portal graph.