A parser for Victron BLE messages suitable for use with Home Assistant
Project description
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.
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.
Project details
Release history Release notifications | RSS feed
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
Hashes for victron_ble_ha_parser-0.2.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | f327e86bd808ba64d26b7753a78bf2e9900ca7b859e3d4b32f302a7e443cf9e1 |
|
MD5 | 021c1a2daf4e0ca40847f5dec7b3e655 |
|
BLAKE2b-256 | bf7f7b7ebad1fe3afa4dccb3c0a52298415881f506567ef61fd79481204211af |
Hashes for victron_ble_ha_parser-0.2.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | fe1de4ffb04b9ca42eab2b092b23500664bd764643bec8a169e0d9c8650ef608 |
|
MD5 | 7ae973902ce5e9b1a36e19e3983963d8 |
|
BLAKE2b-256 | 12ca4eb14a0ec896d98dcce6a894a5ac048885e7824ada0294fe9a0990e694f7 |