Skip to content

2025 06 misc #123

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.

Sign up for GitHub

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
Fabian-Schmidt wants to merge 3 commits into
base: main
Choose a base branch
from
Open

2025 06 misc #123

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
352b004
Update README.md
Fabian-Schmidt Jun 21, 2025
dba8f4e
Update README.md
Fabian-Schmidt Jun 21, 2025
06a0a6c
Update README.md
Fabian-Schmidt Jun 23, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 9 additions & 2 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,14 +4,14 @@

**I am not responsible for any problems or damages with your devices or this code**

The goal of this component is to use the Victron Bluetooth Advertising protocol and expose all available data as ESPHome sensors.
The goal of this component is to use the Victron Bluetooth Advertising protocol (aka Instant readout) and expose all available data as ESPHome sensors.

Victron Bluetooth Advertising protocol data is also used by the Victron App on the Overview page (before you connect to a device).

This [ESPHome](https://esphome.io) component supports both official Victron Bluetooth BLE Protocols:

- (Recommended) [Bluetooth advertising protocol](https://community.victronenergy.com/questions/187303/victron-bluetooth-advertising-protocol.html) - Component `victron_ble`.
- Supported Devices:
- [Devices Supporting Instant readout](https://www.victronenergy.com/media/pg/VictronConnect_Manual/en/stored-trends---instant-readout.html#UUID-5eec18d4-9e11-0845-47e5-9a8f0cec49f4)
- Smart Shunt
- Smart Solar
- Inverter
Expand All @@ -33,6 +33,7 @@ This [ESPHome](https://esphome.io) component supports both official Victron Blue
- Orion XS
- Blue Smart Chargers
- Requires Firmware v3.61 or higher. Available in VictronConnect App v6.10beta14 (2024-09-28).
- MultiPlus with VE.Bus Smart Dongle
- Not suported. Awaiting final documentation or example log from device:
- GX-Device

Expand Down Expand Up @@ -365,6 +366,12 @@ If the bindkey is 31 characters long you must reset the bluetooth PIN on the vic

Each Victron Device is submitting one type of messages (one column in the tables above). Either based ob the device type or based on what you can see in the Victron App Overview Page you can derive the Victron message type.

### Can't get values from LOAD_POWER & LOAD_CURREN

Not all Victron solar charger/controllers have load terminals, and those won't report a value (other than N/A). Only smaller SmartSolar devices (up to 20A) have a load output.

See [Victron MPPT overview table](https://www.victronenergy.de/upload/documents/Datasheet-BlueSolar-and-SmartSolar-charge-controller-overview-EN.pdf).

## Your support

I don't have access to all Victron devices. Please provide feedback if the component is working and all values are correct and match the reading within the Victron app. Only after I got feedback for all devices I can try to get this merged into ESP Home. Given the size of this component I don't expect this soon or be a quick process.
Expand Down