Dbus BLE sensors py

This is a fork of ldenisey/venus-os-dbus-ble-sensors-py with the following PRs merged in ahead of upstream:

• #2 Replace Bleak with raw HCI monitor channel — passive BLE scanning via AdvertisementMonitor1, no scan contention
• #3 Add SeeLevel 709-BTP3/BTP7 support — tank, temperature, and battery sensors
• #4 Add alarm delay setting to BleRoleTank
• #6 Fix Mopeka tank level scaling — execution order, butane formula, role consolidation
• #7 Cache D-Bus connections — prevent connection proliferation
• #8 Add curl-based install method — install without opkg or remounting the filesystem

Venus OS dbus service for BLE device support. Replaces and extends official dbus ble service which does not allow collaboration for new devices support.

Devices currently supported :

Brand	model	Product page
Teltonika	EYE Sensor	https://www.teltonika-gps.com/products/accessories/sensors-beacons/eye-sensor-standard
Safiery	Star Tank	https://safiery.com/product/tank-level-sensor-star-tank-phased-coherent-radar-battery/
Gobius	Gobius C	https://gobiusc.com/fr/
Victron Energy	SolarSense 750	https://www.victronenergy.com/upload/documents/Datasheet-SolarSense-750-EN.pdf
Mopeka	Mopeka Pro Check Universal	https://mopeka.com/consumer-solutions/#:~:text=Mopeka%20Pro%20Check%20Universal%20%E2%80%93%20Latest%20Version
Mopeka	Mopeka Pro Check H2O	https://mopeka.com/commercial-industry-based-solutions/water/#:~:text=Mopeka%20Pro%20Check
Mopeka	Mopeka Pro Check LPG	https://mopeka.com/consumer-solutions/#:~:text=Mopeka%20Pro%20Check,-Ideal%20for%20Residential
Mopeka	Mopeka Pro 200	https://mopeka.com/consumer-solutions/#:~:text=Mopeka%20Pro200
Mopeka	Mopeka Pro Plus	https://mopeka.com/consumer-solutions/#:~:text=Mopeka%20Pro%20Plus
Mopeka	Mopeka TD40	https://mopeka.com/consumer-solutions/#:~:text=Mopeka%20TD40
Mopeka	Mopeka TD200	https://mopeka.com/commercial-industry-based-solutions/water/#:~:text=Mopeka%20TD40,%20TD200
Ruuvi	Ruuvi Tag	https://ruuvi.com/ruuvitag/
Ruuvi	Ruuvi Air	https://ruuvi.com/air/
Garnet	SeeLevel 709-BTP3	https://www.garnetinstruments.com/document/709-btp3-seelevel-ii-tank-monitor-2/
Garnet	SeeLevel 709-BTP7	https://www.garnetinstruments.com/document/709-btp7-seelevel-ii-tank-monitor/

Installation

Quick Install (curl)

Run this one-liner on your Venus OS device (SSH as root):

curl -fsSL https://raw.githubusercontent.com/TechBlueprints/venus-os-dbus-ble-sensors-py/main/install.sh | bash

This installs to /data/apps/dbus-ble-sensors-py/ which persists across firmware updates automatically. If an existing opkg installation is detected, it will be cleanly removed and replaced (all device settings are preserved).

To update, re-run the same command. To disable:

bash /data/apps/dbus-ble-sensors-py/disable.sh

To re-enable after disabling or a firmware update:

bash /data/apps/dbus-ble-sensors-py/enable.sh

To fully remove:

bash /data/apps/dbus-ble-sensors-py/disable.sh
rm -rf /data/apps/dbus-ble-sensors-py

Alternative: opkg Install

Add the venus-os-configuration opkg feed, then :

opkg install dbus-ble-sensors-py

To make it persistent to Venus OS firmware upgrades, you can install mod-persist then :

persist-opkg install dbus-ble-sensors-py

Usage

Device scan and enabling is done through the GUI, as described in the official documentations, i.e. Cerbo GX bluetooth.
In short devices can be enabled/disabled in Settings -> Integrations -> Bluetooth Sensors and configured in Settings -> Devices dedicated menu.

Note

Even though the configuration process is the same, the configuration themselves are NOT shared between this service and official ble service hence configuration will have to be reset when switching between the two.

Development

For technical info and guide to add new devices, see dedicated developer page.