跳转到内容
ESPHome - 让智能家居更简单2026.7.0

ThermoPro BLE 传感器

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

支持的设备

Section titled “支持的设备”

该组件支持多种 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 Temperature"
    humidity:
      name: "ThermoPro Humidity"
    battery_level:
      name: "ThermoPro Battery Level"
    signal_strength:
      name: "ThermoPro Signal Strength"


  # TP96x/TP970/TP972 示例（带外部温度探头）
  # - platform: thermopro_ble
  #   mac_address: YY:YY:YY:YY:YY:YY
  #   temperature:
  #     name: "ThermoPro Internal Temperature"
  #   external_temperature:
  #     name: "ThermoPro External Temperature"
  #   battery_level:
  #     name: "ThermoPro Battery Level"
  #   signal_strength:
  #     name: "ThermoPro Signal Strength"

配置变量

Section titled “配置变量”

  • mac_address (必选, MAC Address): ThermoPro 设备的 MAC 地址。

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

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

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

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

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

设置设备

Section titled “设置设备”

要设置 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 会立即尝试扫描 ThermoPro 等 BLE 设备，因此您会看到如下消息（请注意 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 不会影响设备的电池寿命。

参见

Section titled “参见”