Upstream/esphome-docs
1
0
Fork 0
mirror of https://github.com/esphome/esphome-docs.git synced 2024-12-26 17:27:47 +01:00
Code Issues Projects Releases Wiki Activity

Update Inkbird TH1 docs to show support for TH2 sensors (#2073)

Browse Source
This commit is contained in:
Chris Johnson 2022-05-12 16:21:02 -05:00 committed by GitHub
parent 412e8ca4c2
commit a4498e36b2
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 14 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
components/sensor/inkbird_ibsth1_mini.rst
View File

@ -1,22 +1,26 @@
Inkbird IBS-TH1 and IBS-TH1 Mini BLE Sensor
===========================================
Inkbird IBS-TH1, IBS-TH1 Mini, and IBS-TH2 BLE Sensor
=====================================================
.. seo::
:description: Instructions for setting up Inkbird IBS-TH1 Bluetooth-based temperature and humidity sensors in ESPHome.
:description: Instructions for setting up Inkbird IBS-TH1/TH2 Bluetooth-based temperature and humidity sensors in ESPHome.
:image: inkbird_isbth1_mini.jpg
:keywords: Inkbird, BLE, Bluetooth, IBS-TH1
:keywords: Inkbird, BLE, Bluetooth, IBS-TH1, IBS-TH2
The ``inkbird_ibsth1_mini`` sensor platform lets you track the output of Inkbird IBS-TH1 and IBS-TH1 Mini Bluetooth
The ``inkbird_ibsth1_mini`` sensor platform lets you track the output of Inkbird IBS-TH1, IBS-TH1 Mini, and IBS-TH2 Bluetooth
Low Energy devices using the :doc:`/components/esp32_ble_tracker`. This component will track the
temperature, external temperature (non mini only), humidity and the battery level of the IBS-TH1 device every time the
sensor sends out a BLE broadcast. Note that contrary to other implementations, ESPHome can track as
many IBS-TH1 devices at once as you want.
many IBS-TH1/TH2 devices at once as you want.
.. note::
If an external temperature sensor is connected to the IBS-TH1, measurement from the internal sensor is not sent.
Only one sensor will work at a time.
.. note::
The external temperature sensor is not supported on the IBS-TH1 Mini or IBS-TH2
.. figure:: images/inkbird_isbth1_mini-full.jpg
:align: center
:width: 80.0%
@ -76,7 +80,7 @@ Configuration variables:
Setting Up Devices
------------------
To set up Inkbird IBS-TH1 devices you first need to find their MAC Address so that ESPHome can
To set up Inkbird IBS-TH1/TH2 devices you first need to find their MAC Address so that ESPHome can
identify them. So first, create a simple configuration without any ``inkbird_ibsth1_mini`` entries
like so:
@ -84,7 +88,7 @@ like so:
esp32_ble_tracker:
After uploading the ESP32 will immediately try to scan for BLE devices such as the Inkbird IBS-TH1.
After uploading the ESP32 will immediately try to scan for BLE devices such as the Inkbird IBS-TH1/TH2.
When it detects these sensors, it will automatically parse the BLE message print a
message like this one:
@ -95,7 +99,7 @@ message like this one:
[13:36:43][D][esp32_ble_tracker:567]: Name: 'sps'
Note that it can sometimes take some time for the first BLE broadcast to be received. Please note that address type
should say 'PUBLIC' and the device name should be 'sps', this is how you find the Inkbird IBS-TH1 among all the
should say 'PUBLIC' and the device name should be 'sps', this is how you find the Inkbird IBS-TH1/TH2 among all the
other devices.
Then just copy the address (``38:81:D7:0A:9C:11``) into a new ``sensor.inkbird_ibsth1_mini`` platform
@ -103,7 +107,7 @@ entry like in the configuration example at the top.
.. note::
The ESPHome Inkbird IBS-TH1 integration listens passively to packets the device sends by itself.
The ESPHome Inkbird IBS-TH1/TH2 integration listens passively to packets the device sends by itself.
ESPHome therefore has no impact on the battery life of the device.
See Also