Victron BLE HA Parser
Overview
This project exists solely to provide an interface to the excellent
victron-ble project suitable for use with a Home
Assistant integration. Thank you to Keshav Varma for maintaining the victron-ble project.
Installing the Home Assistant custom component
Currently the Home Assistant integration is only available as a custom component, for testing purposes. The goal is to make this part of Home Assistant core.
If you'd like to test this, clone my fork on the HA project and checkout the victron-ble-custom-component branch:
git clone https://github.com/rajlaud/home-assistant.git --branch victron-ble-custom-component
Then, copy or symlink homeassistant/components/victron-ble into your config/custom_components folder.
Details
The parser module has one class, VictronBluetoothDeviceData, which parses Bleak advertisements and
updates itself with the sensor data from the advertisement. Each instance of
VictronBluetoothDeviceData should be fed advertisements from exactly one Victron device (based on
the MAC address) and the instance needs to be initiated with the encryption key of the device that
is going to be sending updates. If the encryption key is set correctly everything else will be
figured out automatically.
There is a handy package from maintainers of the HA project called sensor-state-data to make it
easy to automate ingesting sensor state updates like this. Unfortunately, we need to use a unit
(amp-hours) not supported by the module and my PR to include amp-hours was rejected because they are
not a common unit (https://github.com/Bluetooth-Devices/sensor-state-data/pull/47). For that
reason, we need a custom extension of sensor-state-data, which is contained in the
custom-sensor-state.py file.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file victron_ble_ha_parser-0.4.4.tar.gz.
File metadata
- Download URL: victron_ble_ha_parser-0.4.4.tar.gz
- Upload date:
- Size: 10.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/5.1.1 CPython/3.13.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d1a71bd78f3efc8d9226f55caa9c8fcd152201e935698f7957ae86aa2712c57c
|
|
| MD5 |
a5609fa1cf22359080f7f0d749ecfb08
|
|
| BLAKE2b-256 |
f41f13f93e28b685beea5c4ce742314a9d0f711a9638b5795d97b7583ef756c8
|
File details
Details for the file victron_ble_ha_parser-0.4.4-py3-none-any.whl.
File metadata
- Download URL: victron_ble_ha_parser-0.4.4-py3-none-any.whl
- Upload date:
- Size: 10.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/5.1.1 CPython/3.13.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ba009b1ddf38eac29196797149ee851b32931c473caa2d3afbc4f2e84fb2a387
|
|
| MD5 |
25c856c4e1f097878946392e98adf919
|
|
| BLAKE2b-256 |
fd31b5fc71c664ad6ebf6db1e433d5698bb5e972ddff00f97d8ddc920b0a2ef9
|
