Platform bluetooth tracker home assistant

Bluetooth LE трекер

Трекер периодически обнаруживает новые устройства при загрузке и регулярно отслеживает устройства с низким энергопотреблением Bluetooth на основе значения interval_seconds. Нет необходимости связывать устройства друг с другом.

Обнаруженные устройства сохраняются с префиксом «BLE_» в MAC-адресе устройства. known_devices.yaml 。

Для этой платформы требуется установка pybluez. При установке на основе Debian запустите

$ sudo apt install bluetooth 

Прежде чем начать использовать эту платформу, обратите внимание:

• Эта платформа несовместима с Windows
• Эта платформа требует доступа к стеку Bluetooth, см. Нет раздела корневых настроек Чтобы получить больше информации

Чтобы использовать Bluetooth-трекер при установке, добавьте в свой configuration.yaml В файле:

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

Переменная конфигурации

（ Логическое значение ） (Необязательный) Если по умолчанию отслеживаются вновь обнаруженные устройства.

Значение по умолчанию: true

（ Целое число ） (Необязательный) Количество секунд между каждым сканированием нового устройства.

Поскольку некоторые устройства BT LE регулярно меняют свои MAC-адреса, новые устройства будут обнаружены только тогда, когда они будут обнаружены 5 раз. Некоторые устройства BTLE (например, фитнес-трекеры) видны только устройству, с которым они сопряжены. В этом случае BTLE-трекер не увидит это устройство.

Нет настройки root

Обычно доступ к стеку Bluetooth зарезервирован для root, но запуск программ, которые подключаются к Интернету как root, является плохим аспектом безопасности. Чтобы разрешить пользователям без полномочий root доступ к стеку Bluetooth, мы можем предоставить Python 3 и hcitool с отсутствием доступа к стеку Bluetooth. Так же, как установка бита setuid ( Чтобы получить больше информации, Видеть Stack Exchange ）。

$ sudo apt-get install libcap2-bin $ sudo setcap 'cap_net_raw,cap_net_admin+eip' `readlink -f \`which python3\`` $ sudo setcap 'cap_net_raw+ep' `readlink -f \`which hcitool\`` 

Вам необходимо перезапустить Home Assistant.

Для других переменных конфигурации проверьте Страница отслеживания устройств 。

Источник

Bluetooth LE Tracker

This tracker discovers new devices on boot and in regular intervals and tracks Bluetooth low-energy devices periodically based on interval_seconds value. It is not required to pair the devices with each other.

Devices discovered are stored with ‘BLE_’ as the prefix for device mac addresses in known_devices.yaml .

Setup

This integration requires the Bluetooth integration to be enabled and functional.

Configuration

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

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

Configuration Variables

If new discovered devices are tracked by default.

Whether the integration should try to read the battery status for tracked devices.

Minimum interval to ask the device for its battery status. The battery status will be checked at most once every interval. If track_battery is false, this will be ignored.

Seconds between each scan for new devices.

As some BT LE devices change their MAC address regularly, a new device is only discovered when it has been seen 5 times. Some BTLE devices (e.g., fitness trackers) are only visible to the devices that they are paired with. In this case, the BTLE tracker won’t see this device.

Enabling the battery tracking might slightly decrease the duration of the battery, but since this is only done at most once a day, this shouldn’t be noticeable. Not all devices offer battery status information; if the information is not available, the integration will only try once at startup.

For additional configuration variables check the Device tracker page.

Help us to improve our documentation

The Bluetooth LE Tracker integration was introduced in Home Assistant 0.27, and it’s used by 219 active installations. Its IoT class is Local Push.

Categories

Источник

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 .

This platform requires pybluez to be installed. On Debian based installs, run

sudo apt install bluetooth libbluetooth-dev 

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 Variables

Performs a request for the “Received signal strength indication” (RSSI) of each tracked device.

The ID of the Bluetooth adapter to be used by the tracker, e.g., use 0 for hci0 , 1 for hci1 , and so on.

-1 (The first available Bluetooth adapter)

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 (or keep the Bluetooth device view open on an iOS device) until Home Assistant is fully restarted and the device should appear in known_devices.yaml .

The integration will try to create an entity using the device name that is detected. If such an entity already exists (for example because you are already using the Companion App for this device) no entity will be created and the log file will show an error that the The see service is not supported for this entity device_tracker.device (as it is not a device_tracker entity). You can rename the other conflicting entity, next time the device is detected a new entity with the same name will be created.

For additional configuration variables check the Device tracker page.

bluetooth_tracker.update service

The bluetooth_tracker.update service can be used to manually trigger a Bluetooth scan. An example of when this service can be useful is to trigger scans based on other events like doors being opened, beacons are in range or buttons are pressed.

Help us to improve our documentation

The Bluetooth Tracker integration was introduced in Home Assistant 0.18, and it’s used by 454 active installations. Its IoT class is Local Polling.

Categories

On this page

Источник

Включаем блютуз в HASSOS под управлением Home Assistant.

Мы уже разбирали в данной статье как подключить по блютузу датчики температуры и влажности от компании Xiaomi. Но там способ описан специфический и подходящий только для некоторых устройств, конкретно от фирмы xiaomi.

В данной же статье я расскажу как включить блютуз и отслеживать обычные блютуз устройства, которые не имеют шифрования.

На самом деле все довольно просто и включается парой команд. Для этого в Configuration.yaml нужно добавить следующее:

device_tracker: - platform: bluetooth_tracker

Все, после этого необходимо перезапустить север зайдя в Настройки->Сервер->Перезапустить и после перезагрузки начнется сканирование блютуз устройств и записывание их в файл “known_devices.yaml” ( Если конечно же на вашем сервере имеется блютуз. В моем случае HassOS установлена на raspberry pi 4, у нее с этим нет проблем.

Выглядеть файл “known_devices.yaml” будет следующим образом после нахождения неких устройств:

oneplus_5: name: OnePlus 5 mac: BT_94:65:2D:A8:36:27 icon: picture: track: true desktop_820q8e3: name: DESKTOP-820Q8E3 mac: BT_B4:6B:FC:C3:46:56 icon: picture: track: true

В данном случае нашел несколько устройств, а именно мой смартфон и ноутбук. Как видите, здесь указано имя найденного устройства, а также его мак адрес. Эти данные нам могут послужить при добавлении данных устройств.

Например бывают устройства как телевизор Sony Bravia он может управляться в Home Assistant какраз по Bluetooth. И в этом случае нам какраз и понадобится данный способ сканирования устройств.

Источник

Bluetooth LE Tracker

We have received numerous reports that this integration will have a big impact on the performance of the server.

This tracker discovers new devices on boot and in regular intervals and tracks Bluetooth low-energy devices periodically based on interval_seconds value. It is not required to pair the devices with each other.

Devices discovered are stored with ‘BLE_’ as the prefix for device mac addresses in known_devices.yaml .

This platform requires pybluez to be installed. On Debian based installs, run

$ sudo apt install bluetooth libbluetooth-dev pkg-config libboost-python-dev libboost-thread-dev libglib2.0-dev python-dev 

Before you get started with this platform, please note that:

• This platform is incompatible with Windows
• This platform requires access to the bluetooth stack, see Rootless Setup section for further information

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

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

• device_id (Optional): The device ID for the Bluetooth device to be used for tracking. Defaults to hci0 .
• track_new_devices (Optional): If new discovered devices are tracked by default. Defaults to True .
• scan_duration (Optional): How long should the scanner be looking for BLE devices. Defaults to 10 seconds.
• interval_seconds (Optional): Seconds between each scan for new devices. Defaults to 12 seconds.

As some BT LE devices change their MAC address regularly, a new device is only discovered when it has been seen 5 times. Some BTLE devices (e.g. fitness trackers) are only visible to the devices that they are paired with. In this case, the BTLE tracker won’t see this device.

Rootless Setup

Normally accessing the Bluetooth stack is reserved for root, but running programs that are networked as root is a bad security wise. To allow non-root access to the Bluetooth stack we can give Python 3 the missing capabilities to access the Bluetooth stack. Quite like setting the setuid bit (see Stack Exchange for more information).

$ sudo apt-get install libcap2-bin $ sudo setcap 'cap_net_raw,cap_net_admin+eip' `readlink -f \`which python3\`` 

If you have installed Home Assistant with AIO, you need to do the following command, this will grant access to Home Assistant to run the required command.

$ sudo setcap cap_net_raw,cap_net_admin+eip /srv/homeassistant/homeassistant_venv/bin/python3 

A restart of Home Assistant is required.

For additional configuration variables check the Device tracker page.

Источник