wave reader utils

Este paquete se encuentra actualmente en modo de mantenimiento. Utilice AirThings-Ble para nuevos proyectos.

Utilidades de lector de olas

La Airthings Wave es una serie de dispositivos que rastrean los niveles de radón en el hogar. El radón es un gas radiactivo que proviene de la descomposición del uranio en el suelo y la roca. Es invisible, inodoro e insípido.

Esta es una biblioteca comunitaria de Wave Airthings Official diseñada para proporcionar servicios públicos para la comunicación de dispositivos y web.

Características

• Usar bleak como dependencia para la compatibilidad cruzada de la plataforma y el soporte para la operación asincrónica.
• Soporte para modelos principales: Wave+, Wave, Wave (Versión 2) y Mini Devices de onda. View Plus no es compatible, ya que envía datos a través de wifi, no btle.
• Prueba de código, informes de cobertura, pelusa, tipo de insinuación y formato.
• Proporcione una interfaz de programación más completa para una audiencia de desarrollador.
• Módulo auxilar que proporciona un cliente web para la API ARTHING y la autenticación OAUTH2.

Requisitos

En Ubuntu/Debian, asegúrese de tener libglib2.0-dev y bluez instalados:

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

Otras distribuciones de Linux deben tener paquetes equivalentes. En teoría, otras plataformas (Windows, Mac) son compatibles con el uso de bleak como dependencia, pero abren un boleto si se encuentra con algún problema.

Instalación

Puede instalar la biblioteca ejecutando:

pip install wave-reader

Uso de ejemplo

Hay varios ejemplos concretos disponibles en el directorio examples . Eso incluye la interacción CLI y otros escenarios interesantes que demuestran el uso de 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 ... 

Módulo de cliente de API web

El módulo wave_reader/web en esta biblioteca proporciona un cliente para la API web de AirThings. Vea esta página para más detalles.

Contribución

Si identifica un error, abra un boleto. Las solicitudes de extracción siempre son bienvenidas.

Pruebas

Puede ejecutar todo el conjunto de pruebas ejecutando tox . Correrá flake8 , isort y pytest . Si desea simplemente ejecutar pruebas unitarias, ejecutar pytest ./tests es suficiente.