BLE Client Text Sensor¶
The ble_client
component is a text sensor platform that can
query BLE devices for specific values of service characteristics.
For more information on BLE services and characteristics, see BLE Client.
esp32_ble_tracker:
ble_client:
- mac_address: XX:XX:XX:XX:XX:XX
id: itag_black
text_sensor:
- platform: ble_client
ble_client_id: itag_black
name: "Sensor Location"
service_uuid: '180d'
characteristic_uuid: '2a38'
Configuration variables:¶
ble_client_id (Required, ID): ID of the associated BLE client.
service_uuid (Required, UUID): UUID of the service on the device.
characteristic_uuid (Required, UUID): UUID of the service’s characteristic to query.
descriptor_uuid (Optional, UUID): UUID of the characteristic’s descriptor to query.
notify (Optional, boolean): Instruct the server to send notifications for this characteristic. Defaults to
false
.update_interval (Optional, Time): The interval to poll the device. Defaults to
60s
.All other options from Text Sensor.
Automations:
on_notify (Optional, Automation): An automation to perform when a notify message is received from the device. See on_notify.
BLE Sensor Automation¶
on_notify
¶
This automation is triggered when the device/server sends a notify message for
a characteristic. The config variable notify must be true or this will have
no effect.
A variable x
of type std::string
is passed to the automation for use in lambdas.