Skip to content

Commit c6d5e50

Browse files
rajlaudcoderabbitai[bot]Copilotc0ffeeca7joostlek
authored
Documentation for new victron_ble integration (home-assistant#39829)
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> Co-authored-by: Copilot <[email protected]> Co-authored-by: c0ffeeca7 <[email protected]> Co-authored-by: Joost Lekkerkerker <[email protected]>
1 parent 5479599 commit c6d5e50

File tree

1 file changed

+47
-0
lines changed

1 file changed

+47
-0
lines changed
Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
---
2+
title: Victron BLE
3+
description: Instructions on how to integrate Victron BLE devices into Home Assistant.
4+
ha_category:
5+
- Sensor
6+
ha_bluetooth: true
7+
ha_release: '2025.12'
8+
ha_iot_class: Local Push
9+
ha_codeowners:
10+
- '@rajlaud'
11+
ha_domain: victron_ble
12+
ha_config_flow: true
13+
ha_platforms:
14+
- sensor
15+
ha_integration_type: device
16+
---
17+
18+
The **Victron BLE** {% term integration %} integrates [Victron Energy](https://www.victronenergy.com/) devices that support the BLE protocol into Home Assistant.
19+
20+
{% include integrations/config_flow.md %}
21+
22+
The Victron BLE integration will automatically discover devices once the [Bluetooth](/integrations/bluetooth) integration is enabled and functional.
23+
24+
## Adding a device
25+
26+
To configure a discovered device, you will need to supply the per-device encryption key. For more information, see these [instructions](https://github.com/keshavdv/victron-ble/tree/main#fetching-keys).
27+
28+
To get the encryption key, use the VictronConnect app ([Android](https://play.google.com/store/apps/details?id=com.victronenergy.victronconnect), [iOS](https://apps.apple.com/us/app/victron-connect/id943840744), [Linux](https://www.victronenergy.com/support-and-downloads/software#victronconnect-app), [macOS](https://apps.apple.com/us/app/victronconnect/id1084677271?ls=1&mt=12), [Windows](https://www.victronenergy.com/support-and-downloads/software#victronconnect-app)):
29+
30+
1. Install the **VictronConnect** app, ideally on the device you are using to set up this integration so you can simply cut and paste the key.
31+
2. Open the app and pair with your device.
32+
3. From the list, select the device that you want to monitor.
33+
4. To open the **Settings** for that device, select the gear icon.
34+
5. Open the menu and select **Product Info**.
35+
6. Scroll down to **Instant Readout via Bluetooth** and enable the feature (if it is not already enabled).
36+
7. To display the encryption key, next to **Instant Readout Details**, select **Show**.
37+
38+
## Data updates
39+
40+
This integration subscribes to passive Bluetooth updates and will update the sensors
41+
as often as the updates are received.
42+
43+
## Removing the integration
44+
45+
This integration follows standard integration removal. No extra steps are required.
46+
47+
{% include integrations/remove_device_service.md %}

0 commit comments

Comments
 (0)