Metadata-Version: 2.4
Name: bluemaestro-ble
Version: 1.2.0
Summary: bluemaestro BLE devices
License: MIT
License-File: LICENSE
Author: J. Nick Koston
Author-email: nick@koston.org
Requires-Python: >=3.11,<4
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Libraries
Provides-Extra: docs
Requires-Dist: Sphinx (>=5,<9) ; extra == "docs"
Requires-Dist: bleak (>=0.21.1) ; python_version >= "3.10" and python_version < "3.15"
Requires-Dist: bluetooth-data-tools (>=1.28.0)
Requires-Dist: bluetooth-sensor-state-data (>=1.8.0)
Requires-Dist: habluetooth (>=3.42.0) ; python_version >= "3.11" and python_version < "3.15"
Requires-Dist: myst-parser (>=0.18,<4.1) ; extra == "docs"
Requires-Dist: sensor-state-data (>=2.6.0)
Requires-Dist: sphinx-rtd-theme (>=1,<4) ; extra == "docs"
Project-URL: Bug Tracker, https://github.com/bluetooth-devices/bluemaestro-ble/issues
Project-URL: Changelog, https://github.com/bluetooth-devices/bluemaestro-ble/blob/main/CHANGELOG.md
Project-URL: Documentation, https://bluemaestro-ble.readthedocs.io
Project-URL: Repository, https://github.com/bluetooth-devices/bluemaestro-ble
Description-Content-Type: text/markdown

# bluemaestro-ble

A Python library for decoding BlueMaestro Bluetooth Low Energy sensor advertisements.

## Supported advertisement formats

| Version | Device family                         | Readings                                                       |
| ------- | ------------------------------------- | -------------------------------------------------------------- |
| 8       | Legacy BlueMaestro temperature sensor | Temperature, battery                                           |
| 13      | Tempo Disc / Disc Mini temperature    | Temperature, battery                                           |
| 22      | Legacy Tempo Disc THD                 | Temperature, humidity, transmitted dew point, battery          |
| 23      | Tempo Disc THD / Disc Mini 3-in-1     | Temperature, humidity, transmitted dew point, battery          |
| 27      | Tempo Disc THPD / Disc Mini 4-in-1    | Temperature, humidity, pressure, battery                       |
| 41      | Disc Maxi temperature                 | Temperature, battery                                           |
| 42      | Disc Maxi 3-in-1                      | Temperature, humidity, calculated dew point, battery           |
| 43      | Disc Maxi 4-in-1                      | Temperature, humidity, pressure, calculated dew point, battery |

All devices also expose signal strength. Versions 22/23 use transmitted dew point;
Maxi 3-in-1/4-in-1 calculate it and report unknown at zero humidity. Truncated
packets are ignored and trailing data is accepted.

New formats were checked against synthetic bmLogger 13.8.4 readings. Physical
v13/v23 packets were also tested; other formats remain unverified on hardware.
Version 8's exact commercial model name is unconfirmed. See
[fixture provenance](tests/fixtures/README.md) for validation details.

## Installation

Install this via pip (or your favourite package manager):

`pip install bluemaestro-ble`

## Contributors ✨

Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

<!-- prettier-ignore-start -->
<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
<!-- markdownlint-disable -->
<!-- markdownlint-enable -->
<!-- ALL-CONTRIBUTORS-LIST:END -->
<!-- prettier-ignore-end -->

This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!

## Credits

This package was created with
[Cookiecutter](https://github.com/audreyr/cookiecutter) and the
[browniebroke/cookiecutter-pypackage](https://github.com/browniebroke/cookiecutter-pypackage)
project template.

