wave reader utils

Ce package est actuellement en mode de maintenance. Veuillez utiliser Airthings-Ble pour de nouveaux projets.

Utilitaires des lecteurs de vagues

The Airthings Wave est une série d'appareils qui suivent les niveaux de radon à la maison. Le radon est un gaz radioactif qui provient de la dégradation de l'uranium dans le sol et la roche. C'est invisible, inodore et insipide.

Il s'agit d'une bibliothèque communautaire non officielle Airthings Wave conçue pour fournir des services publics pour la communication avec les appareils et le Web.

Caractéristiques

• Utilisation bleak comme dépendance pour la compatibilité entre la plate-forme et la prise en charge du fonctionnement asynchrone.
• Prise en charge des modèles majeurs: Wave +, Wave, Wave (version 2) et Mini Devices WAVE. View Plus n'est pas pris en charge, car il envoie des données sur le WiFi, pas Btle.
• Test de code, reporting de couverture, libellé, distinction de type et formatage.
• Fournissez une interface de programmation plus complète pour un public de développeur.
• Module auxrésiner qui fournit un client Web pour AirThings API et OAuth2 Authentication.

Exigences

Dans Ubuntu / Debian, assurez-vous que vous avez installé libglib2.0-dev et bluez :

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

D'autres distributions Linux devraient avoir des packages équivalents. En théorie, d'autres plates-formes (Windows, Mac) sont prises en charge en utilisant bleak comme dépendance, mais ouvrez un billet si vous rencontrez des problèmes.

Installation

Vous pouvez installer la bibliothèque en exécutant:

pip install wave-reader

Exemple d'utilisation

Il existe différents exemples en béton disponibles dans le répertoire examples . Cela comprend l'interaction CLI et d'autres scénarios intéressants qui démontrent l'utilisation de l'API.

 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 ... 

Module client API Web

Le module wave_reader/web de cette bibliothèque fournit un client pour l'API Web Airthings. Voir cette page pour plus de détails.

Contribution

Si vous identifiez un bogue, veuillez ouvrir un billet. Les demandes de traction sont toujours les bienvenues.

Essai

Vous pouvez exécuter toute la suite de tests en exécutant tox . Il exécutera flake8 , isort et pytest . Si vous souhaitez simplement exécuter des tests unitaires, exécuter pytest ./tests est suffisant.