Skip to content

BTHome / Mi Thermometer Sensor

The bthome_mithermometer sensor platform reads temperature, humidity, and battery data from BTHome v2 compatible devices and ATC Mi Thermometer custom firmware variants over Bluetooth Low Energy.

This platform works with ESP32 BLE Tracker and LN882H BLE Tracker.

# Example configuration entry
esp32_ble_tracker:
sensor:
- platform: bthome_mithermometer
mac_address: "XX:XX:XX:XX:XX:XX"
temperature:
name: "Temperature"
humidity:
name: "Humidity"
battery_level:
name: "Battery Level"
signal_strength:
name: "RSSI"

NOTE

On LN882H, replace esp32_ble_tracker: with ln882h_ble_tracker: in your configuration. AES-CCM encrypted advertisements are not supported on LN882H — see bindkey below.

  • mac_address (Required, MAC Address): The Bluetooth MAC address of the sensor device.

  • temperature (Optional): Report the temperature in °C.

  • humidity (Optional): Report the relative humidity in %.

  • battery_level (Optional): Report the battery level as a percentage.

  • battery_voltage (Optional): Report the battery voltage in volts (V).

  • signal_strength (Optional): Report the received signal strength (RSSI) in dBm.

  • bindkey (Optional, list of bytes): 16-byte AES-CCM decryption key for encrypted BTHome v2 advertisements. Only supported on ESP32. On LN882H this option is accepted by the YAML parser but logs a warning at boot and encrypted frames are silently skipped, since the LN882H BLE implementation does not include the AES-CCM decryption stack.