Bluetooth LE Tracker

01

Příprava

Nejdřív musí být funkční Bluetooth podpora a dostupný lokální adaptér nebo Bluetooth proxy. BLE zařízení musí být v dosahu a musí vysílat tak, aby ho adaptér zachytil.

Zařízení se nepárují. Nalezené adresy se ukládají s prefixem BLE_ do souboru known_devices.yaml. Některá BLE zařízení pravidelně mění MAC adresu nebo jsou viditelná jen pro zařízení, se kterým jsou spárovaná; taková zařízení nemusí tracker spolehlivě zachytit.

02

Konfigurace

Integrace se nastavuje ručně v configuration.yaml. Po uložení konfigurace restartujte RichPear Home a potom zkontrolujte integraci v Nastavení → Zařízení a služby a vytvořené entity v seznamu entit.

device_tracker:
  - platform: bluetooth_le_tracker

Pokud necháte sledování nových zařízení vypnuté a v known_devices.yaml není žádné BLE zařízení ke sledování, tracker nebude mít co sledovat.

03

Volby konfigurace

track_new_devices určuje, zda se mají nově nalezená zařízení sledovat automaticky. Výchozí hodnota je false. Nové zařízení se přidá až po pěti zachyceních, aby se omezily náhodné záznamy.

interval_seconds nastavuje počet sekund mezi skeny. Výchozí hodnota je 12.

track_battery zapíná pokus o čtení baterie sledovaných zařízení. Výchozí hodnota je false. Čtení baterie může mírně zkrátit výdrž zařízení a ne všechna zařízení hodnotu baterie nabízejí.

track_battery_interval určuje nejkratší rozestup mezi čtením baterie. Výchozí hodnota je 24:00:00 a volba se ignoruje, pokud je track_battery vypnuté.

device_tracker:
  - platform: bluetooth_le_tracker
    track_new_devices: false
    track_battery: true
    track_battery_interval: "24:00:00"
    interval_seconds: 12

04

Použití v přítomnosti

Tracker vytváří entity device_tracker, které můžete použít v jednoduchých automatizacích přítomnosti. BLE signál ale není vhodný jako jediný zdroj pro kritické akce, protože dosah, baterie, rušení a rotující MAC adresy mohou způsobit výpadky.

Pro automatizace používejte delší časové okno a kombinujte tracker s dalšími signály domácnosti. Novou automatizaci nechte nejdřív několik dní jen zapisovat stav nebo posílat nenápadné oznámení.

05

Řešení potíží

Když se zařízení neobjevuje, zkontrolujte funkčnost Bluetooth integrace, dosah adaptéru nebo proxy, baterii BLE zařízení a to, zda zařízení vysílá i bez párování. Některé fitness náramky a podobná zařízení jsou viditelná jen pro spárované zařízení.

Pokud používáte track_battery a baterie se neukazuje, zařízení pravděpodobně neposkytuje podporovanou bateriovou charakteristiku. Tracker se v takovém případě nemusí k čtení opakovaně vracet.

V logu hledejte chyby podle bluetooth_le_tracker, bluetooth a podle adaptéru nebo proxy, kterou používáte. U ruční konfigurace zkontrolujte odsazení YAML, restart a skutečný obsah known_devices.yaml.