chefiq-ble

Passive Bluetooth Low Energy advertisement parser for Chef iQ wireless cooking probes (CQ50 / CQ60), built for use with the Home Assistant bluetooth passive update framework.

The probe broadcasts everything needed to read temperatures over plain BLE advertisements - no connection, no cloud, no base/hub required.

Install

pip install chefiq-ble

Usage

from chefiq_ble import ChefIqBluetoothDeviceData

device = ChefIqBluetoothDeviceData()
# service_info is a BluetoothServiceInfo (or BluetoothServiceInfoBleak)
update = device.update(service_info)
for key, value in update.entity_values.items():
    print(key.key, value.native_value)

What it parses

A Chef iQ probe rotates three advertisement packet types in its manufacturer specific data (company id 0x05CD). The low nibble of the first byte selects the type; the remaining header nibbles encode a major.minor.patch advertisement protocol version.

All 16-bit temperatures are signed, little-endian, divided by 10 (Celsius).

Identifying a probe

The manufacturer id alone is not proof of a Chef iQ probe. Some vendors put a sensor reading where the Bluetooth company id belongs: an Inkbird IBS-TH broadcasts its temperature x100 there, so at exactly 14.85 °C it shows up with "manufacturer id" 0x05CD (home-assistant/core#188557). The parser therefore accepts an advertisement, and supported() reports a probe, only when the protocol major version is a known one (2 to 5) and the payload matches the documented layout for its packet type:

• a name packet carries a 12-byte, NUL-padded, printable name, or the device's local name is a known probe model (probes advertise their model, e.g. CQ60, as the BLE local name);
• a temperature packet carries every reading of its layout, each either a plausible Celsius value or the firmware's "no reading" sentinel (raw values of 32000 and above; a CQ60 sends 0x7FFF for an empty ring);
• a status packet (and a legacy temperature packet) carries the probe's own MAC address, which must match the advertising address.

Any single real packet passes, so discovery works whichever of the three packet types is seen first. Rejected advertisements are logged at debug level.

Advertisement formats

Three temperature-payload layouts are supported, selected by the protocol major version carried in the advertisement:

V2 and legacy are supported from the protocol description and are not yet verified against real hardware; captures from a CQ50 or an older-firmware probe are welcome to confirm the layouts and the version boundaries. Other major versions are not known probe protocols and are ignored.

This library decodes the probe's public BLE advertisements for interoperability and builds on the earlier Chef iQ work in ble_monitor. The byte layouts are documented in parser.py.

License

MIT