Bluetooth Low Energy Scanner

The ble_scanner text sensor platform lets you track reachable BLE devices.

See your BLE tracker’s configuration variables (for example ESP32 BLE Tracker) for instructions for setting up scan parameters.

The sensor platform is similar to Ble Rssi but in contrast to that platform, this text sensor sends out all raw BLE scan information and does not filter devices.

The data this sensor publishes is intended to be processed by the remote (for example an MQTT client) and sends the data in JSON format.

WARNING

The BLE software stack on the ESP32 consumes a significant amount of RAM on the device.

Crashes are likely to occur if you include too many additional components in your device’s configuration. Memory-intensive components such as Voice Assistant and other audio components are most likely to cause issues.

# Example configuration entry
esp32_ble_tracker:

text_sensor:
  - platform: ble_scanner
    name: "BLE Devices Scanner"

Example json log:

{
    "timestamp":1578254525,
    "address": "XX:XX:XX:XX:XX:XX",
    "rssi":"-80",
    "name":"MI Band 2"
}

Configuration variables

ble_hub_id (Optional, ID): The BLE tracker hub to receive advertisements from. Auto-generated when only one tracker is configured; set it explicitly to disambiguate multiple trackers. Replaces the former esp32_ble_id key, which still works as a deprecated alias until ESPHome 2027.2.0.
All options from Text Sensor.

Bluetooth Low Energy Scanner

Configuration variables

See Also