Bluetooth

01

Příprava

U větších instalací, virtualizace nebo serveru umístěného mimo obytnou část bývá spolehlivější Bluetooth proxy na ESP32 než USB adaptér přímo v serveru. Proxy umístěte blíž k senzorům a spínačům, které mají být přes Bluetooth dostupné.

Pokud používáte lokální USB adaptér, zapojte ho mimo kovovou skříň, disky a USB 3 porty. Krátký stíněný USB prodlužovací kabel často zlepší příjem výrazně víc než výměna samotného adaptéru.

02

Nastavení v RichPear Home

Otevřete Nastavení → Zařízení a služby → Přidat integraci, vyhledejte Bluetooth a projděte průvodce. Pokud je k dispozici více adaptérů, vyberte adaptér, který chcete přidat.

Alternativně lze integraci zapnout ručně v konfiguraci a po změně RichPear Home restartovat.

bluetooth:

Po přidání sledujte část objevených integrací. Bluetooth samo obvykle nepřidává koncové senzory, ale umožní jejich zjištění dalším integracím.

03

Požadavky na Linux

Lokální Bluetooth na Linuxu potřebuje dostupný D-Bus socket, adaptér dostupný přes BlueZ alespoň 5.43 a spolehlivější je BlueZ 5.63 nebo novější. Doporučený je také dbus-broker a kernel 5.15.62 nebo novější.

U kontejnerového provozu musí hostitel spouštět BlueZ a kontejner musí vidět D-Bus, typicky přes /run/dbus:/run/dbus:ro. Pro plnou správu adaptéru přidejte schopnosti NET_ADMIN a NET_RAW.

Bez těchto oprávnění může Bluetooth běžet v omezeném režimu: adaptér se nemusí automaticky zotavit, některé příkazy správy selžou a u zařízení mohou chybět surová reklamní data.

04

Výběr adaptéru

USB adaptér může po prvním zapojení potřebovat několik restartů, než ho systém začne používat stabilně. Pro rychlé připojování jsou vhodné hlavně známé funkční adaptéry s čipem CSR8510A10; většina z nich zvládá pět současných spojení.

Adaptéry s čipem Broadcom mohou pro stabilní provoz vyžadovat dodatečný firmware. Adaptéry Realtek RTL8761BU sice patří mezi známé funkční, ale nemají resetovací pin, takže při zatuhnutí je někdy nutné je fyzicky odpojit a znovu připojit.

Vyhněte se adaptérům uvedeným mezi nepodporovanými, například tp-link UB400, tp-link UB500, Bluegiga BLED112 nebo neoznačeným klonům CSR 4.0 s USB ID 0a12:0001.

05

Režimy skenování

Většině instalací vyhovuje režim Auto. Většinu času poslouchá pasivně a na aktivní skenování přepíná jen krátce, když zařízení nebo integrace potřebuje více údajů.

Active získává údaje nejrychleji, ale více zatěžuje baterie okolních zařízení. Passive jen poslouchá a šetří baterie nejvíc, některé integrace ale bez aktivního skenování neuvidí všechny údaje.

Režim změníte v Nastavení → Bluetooth → Adaptéry přes ozubené kolo u konkrétního adaptéru. Když ozubené kolo chybí, adaptér volby nepodporuje. Auto a Passive vyžadují podporu pasivního skenování; pokud ji adaptér nemá, Auto spadne zpět na Active.

06

Vzdálené adaptéry a proxy

Bluetooth umí přijímat data ze vzdálených adaptérů pro zařízení a senzory, které nepotřebují aktivní spojení, a u podporovaných proxy také navazovat aktivní spojení. Počet vzdálených skenerů omezuje hlavně výkon hostitelského systému.

ESPHome proxy podporuje poslech reklam od firmwaru 2022.8.2, sdružování reklam od 2023.6.0, jedno aktivní spojení od 2022.9.3 a více aktivních spojení od 2022.11.0. Shelly Gen2+ podporuje poslech a sdružování reklam, aktivní spojení ale nepodporuje.

Při použití více proxy je nedávejte těsně vedle sebe. Pro větší dům je rozložte podle místností nebo pater, aby se pokrytí doplňovalo a adaptéry se navzájem nerušily.

07

Řešení potíží

Pro kontrolu dosahu použijte v RichPear Home nástroje pro Bluetooth reklamy a aktuální spojení. Pokud zařízení mizí, sledujte baterii zařízení, vzdálenost, režim skenování a to, zda zařízení vůbec vysílá reklamní pakety.

Nejčastější zdroje rušení jsou USB 3 porty, nestíněné kabely, kovové skříně, SSD disky, Wi-Fi přístupové body, napájecí zdroje a špatná orientace antény. Zkuste USB 2 port, napájený USB 2 hub, delší stíněný kabel a jiné umístění adaptéru.

Některé starší Bluetooth integrace potřebují výhradní přístup k adaptéru. Pokud takovou integraci používáte, přidejte druhý adaptér nebo přejděte na novější integraci, která umí adaptér sdílet.