Bitvis Power Hub
The Bitvis Power Hub integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] reads real-time electricity data from a Bitvis Power Hub device. The Power Hub connects to the HAN port (a standard port on European smart meters) on your smart electricity meter and pushes measurements to Home Assistant over your local network using UDP.
Because data is pushed directly from the device, no cloud connection or polling is required.
Prerequisites
Before adding the integration, make sure:
- Your Bitvis Power Hub is connected to your local network.
- Your router or firewall allows UDP traffic from the Power Hub to Home Assistant on port 58220.
The Bitvis Power Hub and Home Assistant must be on the same network subnet, or your router/firewall must be configured to forward UDP traffic between them.
Configuration
To add the Bitvis Power Hub device to your Home Assistant instance, use this My button:
Bitvis Power Hub can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.
Manual configuration steps
If it wasn’t discovered automatically, don’t worry! You can set up a manual integration entry:
-
Browse to your Home Assistant instance.
-
In the bottom right corner, select the
Add Integration button. -
From the list, select Bitvis Power Hub.
-
Follow the instructions on screen to complete the setup.
Sensors
The following sensors are provided, depending on the capabilities of your smart meter:
Power
-
Active power import
- Description: Total active power consumed from the grid (kW).
-
Active power export
- Description: Total active power delivered to the grid (kW).
-
Active power import L1/L2/L3
- Description: Per-phase active power consumed (kW).
-
Active power export L1/L2/L3
- Description: Per-phase active power delivered (kW).
-
Reactive power import
- Description: Total reactive power consumed (kvar).
-
Reactive power export
- Description: Total reactive power delivered (kvar).
-
Reactive power import L1/L2/L3
- Description: Per-phase reactive power consumed (kvar).
-
Reactive power export L1/L2/L3
- Description: Per-phase reactive power delivered (kvar).
Voltage and current
-
Voltage L1/L2/L3
- Description: Phase voltages (V).
-
Current L1/L2/L3
- Description: Phase currents (A).
Energy
-
Active energy import
- Description: Cumulative active energy consumed from the grid (kWh).
-
Active energy export
- Description: Cumulative active energy delivered to the grid (kWh).
-
Reactive energy import
- Description: Cumulative reactive energy consumed (kvarh).
-
Reactive energy export
- Description: Cumulative reactive energy delivered (kvarh).
Diagnostic sensors
The following diagnostic sensors are also available:
-
Uptime
- Description: Estimated time the device was last started. Timestamp.
-
Wi-Fi signal strength
- Description: Received signal strength (dBm).
-
HAN messages successfully parsed
- Description: Counter of successfully parsed HAN port messages.
-
HAN buffer overflows
- Description: Counter of HAN port buffer overflow events.
Known limitations
The Power Hub protocol is unauthenticated UDP. Any host on the local network can send a datagram using the device’s MAC address and inject readings. The integration binds the UDP listener on all interfaces.
Removing the integration
To remove an integration instance from Home Assistant
- Go to Settings > Devices & services and select the integration card.
- From the list of devices, select the integration instance you want to remove.
- Next to the entry, select the three dots
menu. Then, select Delete.