-
-
Notifications
You must be signed in to change notification settings - Fork 8.3k
Add Bitvis Power Hub integration #44082
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Open
MandusBorjesson
wants to merge
6
commits into
home-assistant:next
Choose a base branch
from
MandusBorjesson:add-bitvis-docs
base: next
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Open
Changes from all commits
Commits
Show all changes
6 commits
Select commit
Hold shift + click to select a range
bc8c7ca
Add Bitvis Power Hub integration
MandusBorjesson 2fe717b
Apply suggestions from code review
MandusBorjesson af7bc3e
fixup! Add Bitvis Power Hub integration
MandusBorjesson 5204d6a
fixup! fixup! Add Bitvis Power Hub integration
MandusBorjesson 49d5a4e
Apply suggestions from code review
MandusBorjesson 4fc795d
fixup! Apply suggestions from code review
MandusBorjesson File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,116 @@ | ||
| --- | ||
| title: Bitvis Power Hub | ||
| description: Read real-time electricity data from your smart meter with the Bitvis Power Hub integration for Home Assistant. | ||
| ha_release: 2026.4 | ||
| ha_category: | ||
| - Energy | ||
| - Sensor | ||
| ha_platforms: | ||
| - sensor | ||
| ha_iot_class: Local Push | ||
| ha_config_flow: true | ||
| ha_zeroconf: true | ||
| ha_codeowners: | ||
| - '@MandusBorjesson' | ||
| - '@simontegelid' | ||
| ha_domain: bitvis | ||
| ha_integration_type: device | ||
| --- | ||
|
|
||
| The **Bitvis Power Hub** {% term integration %} reads real-time electricity data from a [Bitvis Power Hub](https://bitvis.se/) device. The Power Hub connects to the <abbr title="Home Area Network">HAN</abbr> 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 and configured to send data to the IP address of your Home Assistant host on the UDP port above (default: `58220`). | ||
| - Your router or firewall allows UDP traffic from the Power Hub to Home Assistant on that port. | ||
|
|
||
| {% note %} | ||
| 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. | ||
| {% endnote %} | ||
|
|
||
| {% include integrations/config_flow.md %} | ||
|
|
||
| {% configuration_basic %} | ||
| Host: | ||
| description: The hostname or IP address of your Bitvis Power Hub on your local network. | ||
| Port: | ||
| description: The UDP port Home Assistant listens on for data from the device. Defaults to `58220`. | ||
| Name: | ||
| description: A friendly name for this device in Home Assistant. | ||
| {% endconfiguration_basic %} | ||
|
|
||
| ## 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). | ||
|
|
||
MandusBorjesson marked this conversation as resolved.
Show resolved
Hide resolved
|
||
| - **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. | ||
|
|
||
| ## Removing the integration | ||
|
|
||
| {% include integrations/remove_device_service.md %} | ||
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.