renamed thermopro_tp357 to thermopro_ble, added supported device types

Author: sittner

content/components/_index.md

@@ -291,7 +291,7 @@ Sensors are organized into categories; if a given sensor fits into more than one
 "Mopeka Pro Check LP","components/sensor/mopeka_pro_check","mopeka_pro_check.jpg","Tank level"
 "Mopeka Standard Check LP","components/sensor/mopeka_std_check","mopeka_std_check.jpg","Tank level"
 "RuuviTag","components/sensor/ruuvitag","ruuvitag.jpg","Temperature & Humidity & Accelerometer"
-"ThermoPro TP357","components/sensor/thermopro_tp357","thermopro_tp357.jpg","Temperature & Humidity"
+"ThermoPro BLE","components/sensor/thermopro_ble","thermopro_tp357.jpg","Temperature & Humidity"
 "Xiaomi BLE","components/sensor/xiaomi_ble","xiaomi_mijia_logo.jpg","Various"
 {{< /imgtable >}}
 

content/components/sensor/thermopro_tp357.md renamed to content/components/sensor/thermopro_ble.md

@@ -1,25 +1,28 @@
 ---
-description: "Instructions for setting up ThermoPro TP357 Bluetooth-based temperature and humidity sensors in ESPHome."
-title: "ThermoPro TP357 BLE Sensor"
+description: "Instructions for setting up ThermoPro Bluetooth-based temperature and humidity sensors in ESPHome."
+title: "ThermoPro BLE Sensor"
 params:
   seo:
-    description: Instructions for setting up ThermoPro TP357 Bluetooth-based temperature and humidity sensors in ESPHome.
+    description: Instructions for setting up ThermoPro Bluetooth-based temperature and humidity sensors in ESPHome.
     image: thermopro_tp357.jpg
 ---
 
-The `thermopro_tp357` sensor platform lets you track the output of ThermoPro TP357 Bluetooth
+The `thermopro_ble` sensor platform lets you track the output of ThermoPro Bluetooth
 Low Energy devices using the {{< docref "/components/esp32_ble_tracker" >}}. This component will track the
-temperature, humidity, battery level and signal strength of the TP357 device every time the
+temperature, humidity, battery level and signal strength of the ThermoPro device every time the
 sensor sends out a BLE broadcast.
 
+> [!NOTE]
+> Currently this component is only tested with TP357S devices. However, it should work with TP972, TP970, TP96x and TP3xx.
+
 {{< img src="thermopro_tp357-full.jpg" alt="Image" caption="ThermoPro TP357 Temperature and Humidity Sensor over BLE." width="80.0%" class="align-center" >}}
 
 ```yaml
 # Example configuration entry
 esp32_ble_tracker:
 
 sensor:
-  - platform: thermopro_tp357
+  - platform: thermopro_ble
     mac_address: XX:XX:XX:XX:XX:XX
     temperature:
       name: "ThermoPro Temperature"
@@ -33,12 +36,19 @@ sensor:
 
 ## Configuration variables
 
-- **mac_address** (**Required**, MAC Address): The MAC address of the ThermoPro TP357 device.
+- **mac_address** (**Required**, MAC Address): The MAC address of the ThermoPro device.
+
 - **temperature** (*Optional*): The information for the temperature sensor.
 
   - All options from [Sensor](#config-sensor).
 
+- **external_temperature** (*Optional*): The information for the ambient temperature sensor.
+  This is only aviliable on TP972, TP970 and TP96x devices.
+
+  - All options from [Sensor](#config-sensor).
+
 - **humidity** (*Optional*): The information for the humidity sensor
+  This is only aviliable on TP3xx devices.
 
   - All options from [Sensor](#config-sensor).
 
@@ -52,8 +62,8 @@ sensor:
 
 ## Setting Up Devices
 
-To set up ThermoPro TP357 devices you first need to find their MAC Address so that ESPHome can
-identify them. So first, create a simple configuration without any `thermopro_tp357` entries
+To set up ThermoPro devices you first need to find their MAC Address so that ESPHome can
+identify them. So first, create a simple configuration without any `thermopro_ble` entries
 like so:
 
 ```yaml
@@ -63,25 +73,25 @@ esp32_ble_tracker:
         - lambda: 'ESP_LOGD("ble_adv", "BLE device address: %s name: %s", x.address_str().c_str(), x.get_name().c_str());'
 ```
 
-After uploading the ESP32 will immediately try to scan for BLE devices such as the ThermoPro TP357, so
-you will see messages like this (please note the TP357S name):
+After uploading the ESP32 will immediately try to scan for BLE devices such as the ThermoPro, so
+you will see messages like this (please note the TPxxxx model name):
 
 ```log
 [13:36:43][D][ble_adv:042]: BLE device address: XX:XX:XX:XX:XX:XX name: TP357S (XXXX)
 ```
 
 Note that it can sometimes take some time for the first BLE broadcast to be received.
 
-Then just copy the address (`XX:XX:XX:XX:XX:XX`) into a new `sensor.thermopro_tp357` platform
+Then just copy the address (`XX:XX:XX:XX:XX:XX`) into a new `sensor.thermopro_ble` platform
 entry like in the configuration example at the top.
 
 > [!NOTE]
-> The ThermoPro TP357 component listens passively to packets the device sends by itself.
+> The ThermoPro BLE component listens passively to packets the device sends by itself.
 > ESPHome therefore has no impact on the battery life of the device.
 
 ## See Also
 
 - {{< docref "/components/esp32_ble_tracker" >}}
 - {{< docref "/components/sensor" >}}
 - {{< docref "absolute_humidity/" >}}
-- {{< apiref "thermopro_tp357/thermopro_tp357.h" "thermopro_tp357/thermopro_tp357.h" >}}
+- {{< apiref "thermopro_ble/thermopro_ble.h" "thermopro_ble/thermopro_ble.h" >}}