wave reader utils

Dieses Paket befindet sich derzeit im Wartungsmodus. Bitte verwenden Sie Airthings-BLE für neue Projekte.

Wellenleser Versorgungsunternehmen

Die Airthings Wave ist eine Reihe von Geräten, die die Radonwerte im Haushalt verfolgen. Radon ist ein radioaktives Gas, das aus dem Zusammenbruch von Uran in Boden und Gestein stammt. Es ist unsichtbar, geruchlos und geschmacklos.

Dies ist eine inoffizielle Airthings Wave Community Library, die Dienstprogramme für Geräte- und Webkommunikation bereitstellt.

Merkmale

• Verwenden von bleak als Abhängigkeit für die Plattformübergreifbarkeit und Unterstützung für den asynchronen Betrieb.
• Unterstützung für Hauptmodelle: Wave+, Wave, Wave (Version 2) und Wave Mini -Geräte. View Plus wird nicht unterstützt, da es Daten über WLAN und nicht BTLE sendet.
• Code -Test, Berichterstattung, Linie, Typ Hinweis und Formatierung.
• Bieten Sie eine umfassendere Programmierschnittstelle für ein Entwicklerpublikum.
• Auxillary -Modul, das einem Web -Client für Airthings -API und OAuth2 -Authentifizierung bietet.

Anforderungen

Stellen Sie in Ubuntu/Debian sicher, dass Sie libglib2.0-dev und bluez installiert sind:

sudo apt-get install libglib2.0-dev bluez -y

Andere Linux -Verteilungen sollten äquivalente Pakete haben. Theoretisch werden andere Plattformen (Windows, MAC) durch die Verwendung von bleak als Abhängigkeit unterstützt. Öffnen Sie jedoch ein Ticket, wenn Sie auf Probleme stoßen.

Installation

Sie können die Bibliothek durch Ausführen installieren:

pip install wave-reader

Beispiel Verwendung

Es gibt verschiedene konkrete Beispiele im examples . Dazu gehört die CLI -Interaktion und andere interessante Szenarien, die die API -Verwendung demonstrieren.

 import asyncio
from wave_reader import wave

if __name__ == "__main__" :
    # Scan for BTLE Wave devices.
    devices = wave . scan ()
    # Event loop to run asynchronous tasks.
    loop = asyncio . new_event_loop ()
    # Get sensor readings from available wave devices.
    for d in devices :
        sensor_readings = loop . run_until_complete ( d . get_sensor_values ())
        print ( sensor_readings )

# >>> DeviceSensors (humidity: 32.5, radon_sta: 116, radon_lta: 113 ... 

Web -API -Clientmodul

Das wave_reader/web -Modul in dieser Bibliothek bietet einem Client für die Airthings -Web -API. Weitere Informationen finden Sie in dieser Seite.

Beitrag

Wenn Sie einen Fehler identifizieren, öffnen Sie bitte ein Ticket. Pull -Anfragen sind immer willkommen.

Testen

Sie können die gesamte Testsuite durch Ausführen tox ausführen. Es wird flake8 , isort und pytest laufen. Wenn Sie nur Unit -Tests ausführen möchten, ist es ausreichend, pytest ./tests .