This software connects to a VictronEnergy SmartSolar devices and retrieves some supported values.
Caution: Implementation is based on reverse engineering and may not work, harm or destroy your devices. Please only use if you understand this risk.
usage: smartsolar [-h] [-v] [-p PASSKEY] [-d DISCOVERY_DURATION] [-q QUERY_DURATION]
Connects to the Victron Energy device of nearest proximity via BLE and queries its values
optional arguments:
-h, --help show this help message and exit
-v, --verbose increase output verbosity (default: 0)
-p PASSKEY, --passkey PASSKEY
passkey for pairing BLE device (default: 000000)
-d DISCOVERY_DURATION, --discovery-duration DISCOVERY_DURATION
duration to discover BLE devices (s) (default: 5)
-q QUERY_DURATION, --query-duration QUERY_DURATION
duration to wait for data from device (s) (default: 20)
The script works such, that it connects to the device of nearest proximity, collects all parsable data and outputs the data as json only after the connection is terminated from the device. A successful run takes around 20 seconds:
pi@umr-test-00001:~/SmartSolar $ python -m smartsolar
WARNING:smartsolar:[c7:c8:06:27:13:11] VREG 9001 decode error: premature end of stream (expected to read 1 bytes, got 0 instead)
WARNING:smartsolar:[c7:c8:06:27:13:11] VREG 9001 decode error: premature end of stream (expected to read 1 bytes, got 0 instead)
{"Mac address": "c7:c8:06:27:13:11", "Firmware version": "00590100", "Battery temperature (K)": 655.35, "Adjustable voltage minimum (V)": 8.0, "Load output status": 0, "Channel 1 voltage (V)": 4.17, "Adjustable voltage maximum (V)": 17.400000000000002, "Load output voltage (V)": 0.13, "Load output offset voltage (V)": 0.0, "Uptime (s)": 587970, "Device mode": 1}- vvvrrooomm/victron: Implementation of VictronEnergy protocol and Wireshark disssector
- birdie1/victron: Fork of vvvrrooomm's approach for multiple outputs
- Olen/VictronConnect: Reverse engineering approach to VictronEnergy's BLE protocol
- Victron Bluetooth BLE protocol?: Some details on the protocol (CBOR + VREGs), some explanation on messages parsing.
- Victron Bluetooth BLE Protocol announcement: Details on the stalling BLE GATT characteristic service (only available on SmartShunt devices).
- VictronConnect Instant readout: see readings immediately on the Device list: Information on the 2022 Bluetooth Broadcast feature.
- VE.Can registers: including VREGs