#bluetooth #ble #bluetooth-le #encryption-key #reader #victron

victron_ble

Read data from Victron devices over Bluetooth Low Energy

2 releases

0.1.1 Oct 19, 2024
0.1.0 Oct 19, 2024

#349 in Hardware support

Download history 236/week @ 2024-10-14 38/week @ 2024-10-21

274 downloads per month

MIT license

27KB
407 lines

Victron BLE

Read data from Victron devices over Bluetooth Low Energy.

Some Victron devices use the BLE advertising data protocol to broadcast some aspects of their state on a regular basis. This crate enables you to easily decrypt and parse the broadcast data into usable form.

Currently only Solar Charger type devices are supported but support can be added for other device types if requested.

Usage

If you already have the manufacturer data from your Victron device you can use the basic function parse_manufacturer_data to decrypt and parse it.

let device_encryption_key = hex::decode("Victron device encryption key").unwrap();
// Sourced from the manufacturer data part of a BLE advertisement event
// The Victron manufacturer ID is 737
let device_manufacturer_data = [0x10, 0, 0, 0, 0 ]; 

let device_state_result = victron_ble::parse_manufacturer_data(&device_manufacturer_data, &device_encryption_key);

println!("{device_state_result:?}");

If you want the crate to handle the bluetooth side, including discovering the device and receiving the manufacturer data then use the open_stream function which currently supports MacOS and Linux.

let device_name = "Victon Bluetooth device name";
let device_encryption_key = hex::decode("Victron device encryption key").unwrap();

let mut device_state_stream = victron_ble::open_stream(
   device_name, 
   device_encryption_key
).await;

while let Some(result) = device_state_stream.recv().await {
   println!("{result:?}");
}

Encryption Key

The device status messages published by the Victron device are encrypted. In order to decrypt them the device encyption key is needed. This can be found for a given device using the Victron Connect app on iOS or Android.

Using the app, connect to the device, then go to Settings -> Product Info -> Encryption data.

Serialization

If you add the serde feature then the DeviceState enum will be (de)serializable.

Ackowledgements

Various aspects of this crate are either inspired by or copied from these projects:

Sources

https://communityarchive.victronenergy.com/questions/187303/victron-bluetooth-advertising-protocol.html

And see the file is this repo: extra-manufacturer-data-2022-12-14.pdf

Dependencies

~3–32MB
~483K SLoC