跳转到内容

ThermoPro BLE 传感器

thermopro_ble 传感器平台允许您使用 Esp32 Ble Tracker 跟踪 ThermoPro 蓝牙低功耗设备的输出。 该组件会在 ThermoPro 设备每次发送 BLE 广播时跟踪其温度、湿度、电池电量和信号强度。

该组件支持多种 ThermoPro BLE 传感器型号:

  • TP3xx 系列(如 TP357S):温度、湿度和电池电量传感器。测试主要针对 TP357S 设备进行。
  • TP96x 系列:内部和外部温度传感器,支持电池电量监测。
  • TP970:内部和外部温度传感器,支持电池电量监测。
  • TP972:内部和外部温度传感器,支持电池电量监测。

所有型号都支持信号强度 (RSSI) 监测。

通过 BLE 连接的 ThermoPro TP357 温湿度传感器。
# 示例配置条目
esp32_ble_tracker:
sensor:
# TP3xx 系列示例(带湿度功能的 TP357S)
- platform: thermopro_ble
mac_address: XX:XX:XX:XX:XX:XX
temperature:
name: "ThermoPro 温度"
humidity:
name: "ThermoPro 湿度"
battery_level:
name: "ThermoPro 电池电量"
signal_strength:
name: "ThermoPro 信号强度"
# TP96x/TP970/TP972 示例(带外部温度探头)
# - platform: thermopro_ble
# mac_address: YY:YY:YY:YY:YY:YY
# temperature:
# name: "ThermoPro 内部温度"
# external_temperature:
# name: "ThermoPro 外部温度"
# battery_level:
# name: "ThermoPro 电池电量"
# signal_strength:
# name: "ThermoPro 信号强度"
  • mac_address (必需, MAC 地址): ThermoPro 设备的 MAC 地址。

  • temperature (可选): 温度传感器的信息。

  • external_temperature (可选): 外部/探头温度传感器的信息。 某些型号(TP972、TP970、TP96x)支持双温度读数 - 一个内部读数和一个来自外部探头的读数。

  • humidity (可选): 湿度传感器的信息。仅 TP3xx 设备可用。

  • battery_level (可选): 电池电量传感器的信息。

  • signal_strength (可选): 信号强度 (RSSI) 传感器的信息。

要设置 ThermoPro 设备,首先需要找到它们的 MAC 地址,以便 ESPHome 能够识别它们。 首先,创建一个不包含任何 thermopro_ble 条目的简单配置,如下所示:

esp32_ble_tracker:
on_ble_advertise:
- then:
- lambda: 'ESP_LOGD("ble_adv", "BLE device address: %s name: %s", x.address_str().c_str(), x.get_name().c_str());'

上传后,ESP32 将立即开始扫描 BLE 设备(如 ThermoPro),因此您会看到类似以下的消息 (请注意 TPxxxx 型号名称):

[13:36:43][D][ble_adv:042]: BLE device address: XX:XX:XX:XX:XX:XX name: TP357S (XXXX)

请注意,有时可能需要一些时间才能收到第一个 BLE 广播。

然后将地址(XX:XX:XX:XX:XX:XX)复制到新的 sensor.thermopro_ble 平台条目中, 如顶部的配置示例所示。

NOTE

ThermoPro BLE 组件被动监听设备自行发送的数据包。 因此 ESPHome 不会影响设备的电池寿命。