https://github.com/legrego/combustion_ble

A Python SDK for interacting with Combustion Bluetooth thermometers
https://github.com/legrego/combustion_ble

ble bleak bluetooth combustion python python3

Last synced: about 1 month ago
JSON representation

A Python SDK for interacting with Combustion Bluetooth thermometers

• Host: GitHub
• URL: https://github.com/legrego/combustion_ble
• Owner: legrego
• License: apache-2.0
• Created: 2024-01-10T13:50:21.000Z (12 months ago)
• Default Branch: main
• Last Pushed: 2024-04-29T16:21:01.000Z (8 months ago)
• Last Synced: 2024-04-29T17:38:58.712Z (8 months ago)
• Topics: ble, bleak, bluetooth, combustion, python, python3
• Language: Python
• Homepage: https://combustion-ble.readthedocs.io/
• Size: 208 KB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: .github/CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# 🔥 **combustion_ble**

This package enables communication with [Combustion Inc.](https://combustion.inc) Predictive Thermometers. It uses [`bleak`](https://bleak.readthedocs.io/en/latest/) to provide asychronous, cross-platform support.

Discovered probes show up as instances of the Probe class in the `DeviceManager.probes` dictionary, and their temperatures and other data are continually updated by incoming BLE advertising messages. Additionally, calling connect() on an individual `Probe` object will cause the framework to maintain a connection to that device, and will automatically download all logged temperature records on the device.

This SDH was heavily inspired by [Combustion Inc.'s Swift SDK](https://github.com/combustion-inc/combustion-ios-ble). As such, the API is very similar, and the documentation for that SDK is a good reference for this one. The architecture may not be "pythonic" in every respect, but the primary design goal is to make subsequent updaets to this SDH as easy as possible, by tracking the diffs from the "upstream" Swift SDH.

## Documentation

Docs for this project are in-progress, and are located at https://combustion-ble.readthedocs.io/

## Usage

Docs are still in-progress. In the meantime, see the [examples](https://github.com/legrego/combustion_ble/tree/main/examples) directory for some sample code.