wave reader utils

Paket ini saat ini dalam mode pemeliharaan. Silakan gunakan Airthings-Ble untuk proyek baru.

Utilitas Pembaca Gelombang

Airthings Wave adalah serangkaian perangkat yang melacak tingkat radon di rumah. Radon adalah gas radioaktif yang berasal dari kerusakan uranium di tanah dan batu. Itu tidak terlihat, tidak berbau dan hambar.

Ini adalah Perpustakaan Komunitas Wave Airthings tidak resmi yang dirancang untuk menyediakan utilitas untuk komunikasi perangkat dan web.

Fitur

• Menggunakan bleak sebagai ketergantungan untuk kompatibilitas silang platform dan dukungan untuk operasi asinkron.
• Dukungan untuk model utama: Wave+, Wave, Wave (Versi 2) dan Wave Mini Devices. View Plus tidak didukung, karena mengirimkan data melalui wifi, bukan BTLE.
• Pengujian Kode, Pelaporan Cakupan, Linting, Ketik Petunjuk, dan Pemformatan.
• Berikan antarmuka pemrograman yang lebih komprehensif untuk audiens pengembang.
• Modul auxillary yang menyediakan klien web untuk API API dan OAuth2.

Persyaratan

Di Ubuntu/Debian, pastikan Anda memiliki libglib2.0-dev dan bluez diinstal:

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

Distribusi Linux lainnya harus memiliki paket yang setara. Secara teori, platform lain (Windows, Mac) didukung dengan menggunakan bleak sebagai ketergantungan, tetapi buka tiket jika Anda mengalami masalah apa pun.

Instalasi

Anda dapat menginstal perpustakaan dengan menjalankan:

pip install wave-reader

Contoh penggunaan

Ada berbagai contoh konkret yang tersedia di Direktori examples . Itu termasuk interaksi CLI dan skenario menarik lainnya yang menunjukkan penggunaan 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 ... 

Modul Klien API Web

Modul wave_reader/web di perpustakaan ini menyediakan klien untuk API Web Airthings. Lihat halaman ini untuk detail lebih lanjut.

Kontribusi

Jika Anda mengidentifikasi bug, buka tiket. Permintaan tarik selalu diterima.

Pengujian

Anda dapat menjalankan seluruh test suite dengan menjalankan tox . Ini akan menjalankan flake8 , isort dan pytest . Jika Anda hanya ingin menjalankan tes unit, menjalankan pytest ./tests sudah cukup.