home-assistant.io/source/_components/bluetooth_tracker.markdown
Franck Nijhof 1833c32a2c Cleans up front matter (#9835)
* Sets front matter defaults

* Removes default front matter from section templates/pages

* Removes default front matter from addon pages

* Removes default front matter from integration pages

* Removes default front matter from posts

* Removes default front matter from docs pages

* Removes default front matter from other pages

* Fixes blog category pages
2019-07-11 14:35:08 -07:00

1.6 KiB

title, description, logo, ha_category, ha_iot_class, ha_release, redirect_from
title description logo ha_category ha_iot_class ha_release redirect_from
Bluetooth Tracker Instructions for integrating Bluetooth tracking within Home Assistant. bluetooth.png
Presence Detection
Local Polling 0.18
/components/device_tracker.bluetooth_tracker/

This tracker discovers new devices on boot and tracks Bluetooth devices periodically based on interval_seconds value. It is not required to pair the devices with each other! Devices discovered are stored with 'bt_' as the prefix for device MAC addresses in known_devices.yaml.

To use the Bluetooth tracker in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
device_tracker:
  - platform: bluetooth_tracker

{% configuration %} request_rssi: description: Performs a request for the "Received signal strength indication" (RSSI) of each tracked device. required: false type: boolean default: false device_id: description: The ID of the bluetooth adapter to be used by the tracker, e.g., use 0 for hci0, 1 for hci1, and so on. required: false type: integer default: "-1 (The first available bluetooth adapter)" {% endconfiguration %}

In some cases it can be that your device is not discovered. In that case let your phone scan for Bluetooth devices while you restart Home Assistant. Just hit Scan on your phone all the time until Home Assistant is fully restarted and the device should appear in known_devices.yaml.

For additional configuration variables check the Device tracker page.