Supported devices
inkbird-ble recognises the following INKBIRD models. Each one is exposed as a
member of the Model enum (importable from inkbird_ble); pass it to
INKBIRDBluetoothDeviceData(...) when you know the model up front, otherwise
the parser detects it from the first advertisement (passive devices) or you
must supply it (notify-only devices).
Model |
Family |
Transport |
Detection |
Sensors |
|---|---|---|---|---|
|
Hygrometer |
advertisement |
local name |
temperature, humidity, battery |
|
Hygrometer |
advertisement |
local name |
temperature, humidity, battery |
|
Pool / probe |
advertisement only |
local name |
temperature, battery |
|
Hygrometer |
advertisement |
local name |
temperature, humidity, battery |
|
Hygrometer |
advertisement |
local name |
temperature, humidity, battery |
|
Hygrometer |
advertisement |
local name |
temperature, humidity, battery |
|
Indoor air quality |
GATT notify |
manufacturer-data |
temperature, humidity, CO₂, atmospheric pressure |
|
Indoor air quality |
advertisement |
17-byte payload + MAC prefix |
temperature, humidity, CO₂ |
|
3-probe thermometer |
GATT notify |
local name |
temperature × 3 probes |
|
Connected BBQ probe |
GATT poll |
local name |
probe temperature, ambient temperature, probe battery, case battery |
|
BBQ probe (1 channel) |
advertisement |
name contains |
temperature × 1 |
|
BBQ probe (2 channel) |
advertisement |
name contains |
temperature × 2 |
|
BBQ probe (4 channel) |
advertisement |
name contains |
temperature × 4 |
|
BBQ probe (6 channel) |
advertisement |
name contains |
temperature × 6 |
|
Unknown hygrometer |
advertisement |
18-byte payload + service UUID |
temperature, humidity, battery |
Transport guide
advertisement — passive: feed every
service_infotoINKBIRDBluetoothDeviceData.update()and it returns aSensorUpdate. No connection is opened. TheIBS-THfamily, the eighteen-byte hygrometers and the iBBQ probes work this way;IAM-T2is advertisement-only as well.advertisement only — the device cannot be polled or notified safely (
IBS-P02Bwedges its firmware until a battery reset if you open a GATT connection, see issue #116). All fields are already in the broadcast.GATT poll — the device exposes a readable characteristic; call
async_poll(ble_device)whenpoll_needed()returns true.INT-11P-Bcarries no readings in its advertisement, so it must be polled.GATT notify — the device pushes readings over a notify characteristic; call
async_start(service_info, ble_device)to subscribe.IAM-T1andIHT-2PBuse this transport.IHT-2PBadditionally requires two activation writes (handled transparently) before it starts streaming.
Not supported
A few INKBIRD product lines that come up in the issue tracker are out of scope for this library:
Sous-vide cookers (
ISV-100W,ISV-100W 2.0,ISV-200W,ISV-300W,ISV-101W). These are Wi-Fi / Tuya devices, not BLE, so they cannot be parsed here.
If you have a device that looks like it should work but is not detected,
open an issue with a BLE advertisement capture (e.g. from bluetoothctl or
nrfConnect) so the model can be reverse-engineered.