Barebones Bleak-based client for the Aranet4 sensor
Project description
ClAranet4
Ultra-minimal (i.e. incomplete) Python & CLI client for collecting current readings from Aranet4 Bluetooth sensors. This client uses Bleak and should work across platforms, and has been tested on Intel and ARM64 Macs.
Install
Python >= 3.10
pip install claranet4
git clone https://github.com/bede/claranet4.git
pip install ./claranet4
CLI usage
% claranet4 --help
usage: claranet4 [-h] [--version] {scan,discover,read} ...
positional arguments:
{scan,discover,read}
scan Show nearby Bluetooth devices
discover Discover nearby Aranet4 devices
read Request latest measurements from a nearby Aranet4 device
options:
-h, --help show this help message and exit
--version show program's version number and exit
Enumerate nearby Aranet4 devices
% claranet4 discover
INFO: Found 9 device(s)
INFO: Found 1 Aranet4 device(s)
[
{
"address": "390F544C-F0FF-F8BE-3A3A-BB1219AA2145",
"name": "Aranet4 1D6BA",
"rssi": -71
}
]
Request measurements from an Aranet4 by address. If the device is unpaired, a prompt should appear for the pairing code.
% claranet4 read 390F544C-F0FF-F8BE-3A3A-BB1219AA2145
INFO: Selected Aranet4 1D6BA (-74dBm)
{
"name": "Aranet4 1D6BA",
"address": "390F544C-F0FF-F8BE-3A3A-BB1219AA2145",
"rssi": -74,
"co2": 946,
"temperature": 17.6,
"pressure": 1002.1,
"humidity": 73.4
}
Executing claranet4 read
without specifying an address will request measurements from the Aranet4 with the highest received signal strength (RSSI)
% claranet4 read
INFO: Found 9 device(s)
INFO: Found 1 Aranet4 device(s)
INFO: Selected Aranet4 1D6BA (-74dBm)
{
"name": "Aranet4 1D6BA",
"address": "390F544C-F0FF-F8BE-3A3A-BB1219AA2145",
"rssi": -74,
"co2": 946,
"temperature": 17.6,
"pressure": 1002.1,
"humidity": 73.4
}
API usage
>>> from claranet4.lib import discover_ara4s, read
>>> discover_ara4s()
INFO: Found 28 device(s)
INFO: Found 1 Aranet4 device(s)
[Device(address='390F544C-F0FF-F8BE-3A3A-BB1219AA2145', name='Aranet4 1D6BA', rssi=-70)]
>>> read("390F544C-F0FF-F8BE-3A3A-BB1219AA2145").__dict__
INFO: Selected Aranet4 1D6BA (-74dBm)
{'name': 'Aranet4 1D6BA', 'address': '390F544C-F0FF-F8BE-3A3A-BB1219AA2145', 'rssi': -74, 'co2': 715, 'temperature': 20.4, 'pressure': 991.4, 'humidity': 63.4}
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
claranet4-0.1.0.tar.gz
(4.5 kB
view hashes)
Built Distribution
Close
Hashes for claranet4-0.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 25d4b7c612bc41a1cea63a5f035e19553d3544098f463184ca1d11bcb105744a |
|
MD5 | a5150572bf39b811036be26efdb9974a |
|
BLAKE2b-256 | 6b1a082a8ab0dae20799bd1543060fff9037d01d132dc09929ee7023fcb774da |