wave reader utils

此软件包当前处于维护模式。请使用Airthings-Ble进行新项目。

波浪阅读器公用事业

Airthings Wave是一系列跟踪房屋中ra含量的设备。 ra是一种放射性气体，来自土壤和岩石中铀的崩溃。它是看不见的，无味的，无味的。

这是一个非正式的Airthings Wave社区库，旨在为设备和Web通信提供公用事业。

特征

• 使用bleak依赖性，用于平台交叉兼容性和对异步操作的支持。
• 支持主要模型：Wave+，Wave，Wave（版本2）和Wave Mini设备。 View Plus不受支持，因为它通过WiFi发送数据，而不是BTLE。
• 代码测试，覆盖范围报告，覆盖，类型提示和格式。
• 为开发人员受众提供更全面的编程界面。
• Auxillary模块为AIRTHINGS API和OAUTH2身份验证提供Web客户端。

要求

在Ubuntu/Debian中，请确保已安装libglib2.0-dev和bluez ：

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

其他Linux发行版应具有等效软件包。从理论上讲，其他平台（Windows，Mac）得到了使用bleak作为依赖性的支持，但是如果您遇到任何问题，请打开机票。

安装

您可以通过运行安装库：

pip install wave-reader

示例用法

examples目录中有各种具体示例。这包括CLI互动和其他有趣的场景，这些场景证明了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 ... 

Web API客户端模块

此库中的wave_reader/web模块为Airthings Web API提供了客户端。有关更多详细信息，请参见此页面。

贡献

如果确定错误，请打开票。始终欢迎拉动请求。

测试

您可以通过运行tox运行整个测试套件。它将运行flake8 ， isort和pytest 。如果您只想运行单元测试，则运行pytest ./tests就足够了。