Skip to content
ESPHome - Smart Home Made Simple2026.7.4

BTHome MiThermometer Sensor

The bthome_mithermometer sensor platform lets you receive measurements from Xiaomi/Mijia thermometers broadcasting in BTHome v2 format — that is, devices flashed with PVVX MiThermometer firmware and set to the “BTHome v2” advertisement type. The component listens passively to the advertisements, so it does not pair with the device and has no impact on its battery life.

It requires a BLE tracker, for example the ESP32 BLE Tracker, to receive the advertisements.

For choosing between the firmware options of these thermometers (stock MiBeacon, ATC, PVVX and their advertisement formats) and for flashing/bindkey instructions, see LYWSD03MMC on the Xiaomi BLE page — this page is the option reference for the bthome_mithermometer platform itself.

# Example configuration entry
esp32_ble_tracker:


sensor:
  - platform: bthome_mithermometer
    mac_address: "XX:XX:XX:XX:XX:XX"
    bindkey: "00112233445566778899aabbccddeeff"
    temperature:
      name: "BTHome Temperature"
    humidity:
      name: "BTHome Humidity"
    battery_level:
      name: "BTHome Battery Level"

NOTE

A bindkey is only required for devices configured to encrypt their BTHome advertisements; unencrypted devices work without one. It is the same 32-character (16-byte) hex key you set when enabling encryption on the device (for example in the ATC/PVVX web configurator).

Configuration variables

Section titled “Configuration variables”
  • mac_address (Required, MAC Address): The MAC address of the device to receive data from.
  • bindkey (Optional, 32-character hex string): The encryption key for devices that broadcast encrypted BTHome advertisements. Omit it for unencrypted devices.
  • temperature (Optional): The temperature, in °C. All options from Sensor.
  • humidity (Optional): The relative humidity, in %. All options from Sensor.
  • battery_level (Optional): The battery level, in %. All options from Sensor.
  • battery_voltage (Optional): The battery voltage, in V. All options from Sensor.
  • signal_strength (Optional): The signal strength (RSSI), in dBm. All options from Sensor.
  • esp32_ble_id (Optional, ID): The ID of the ESP32 BLE Tracker to receive advertisements from. Only needed when more than one tracker is configured.

See Also

Section titled “See Also”