Metadata-Version: 2.4
Name: togrill-bluetooth
Version: 0.8.1
Summary: Module to handle communication with ToGrill compatible temperature probes.
Project-URL: Repository, https://github.com/elupus/togrill-bluetooth
Author-email: Joakim Plate <elupus@ecce.se>
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Typing :: Typed
Requires-Python: <4.0,>=3.11
Requires-Dist: bleak-retry-connector>=4.0.0
Requires-Dist: bleak>=1.0.1
Provides-Extra: cli
Requires-Dist: anyio>=4.9.0; extra == 'cli'
Requires-Dist: asyncclick>=8.1.8; extra == 'cli'
Description-Content-Type: text/markdown

# ToGrill Bluetooth Library

ToGrill is a Python library for communicating with ToGrill Bluetooth-enabled devices, such as smart grilling thermometers. It provides tools for scanning, connecting, and interacting with these devices, including reading probe temperatures, setting timers, and configuring temperature ranges.

It's main target use is for integration into Home Assistant integrations.

## Features

- Scan for ToGrill Bluetooth devices
- Connect and interact with devices using BLE
- Read probe temperatures and device status
- Set timers and temperature ranges
- Command-line interface for easy usage and scripting

## Command-Line Interface

### Commands

- scan
  Scan for nearby ToGrill Bluetooth devices and display their information.

- connect `address`
  Connect to a device by Bluetooth address. This command opens a group of subcommands:
  Commands can be chained to perform multiple actions in one connection.

  - list
    List all GATT services and characteristics, and read available data.

  - timer `probe` `seconds`
    Set a timer on the specified probe for a given number of seconds.

  - range `probe` `minimum` `maximum`
    Set a minimum and maximum temperature range for a probe.

  - target `probe` `target`
    Set a target temperature for a probe.

  - wait
    Wait indefinitely, keeping the connection open.

### Examples

- `togrill-bluetooth scan`
- `togrill-bluetooth connect AA:BB:CC:DD:EE:FF list wait`
- `togrill-bluetooth connect AA:BB:CC:DD:EE:FF timer 1 600`
- `togrill-bluetooth connect AA:BB:CC:DD:EE:FF range 1 50.0 80.0`
- `togrill-bluetooth connect AA:BB:CC:DD:EE:FF target 1 65.0`
- `togrill-bluetooth connect AA:BB:CC:DD:EE:FF wait`