From 00b3d67751387a8791dff46deaef86d52bfaf1f7 Mon Sep 17 00:00:00 2001 From: "J. Nick Koston" Date: Tue, 20 Jun 2023 16:39:03 +0100 Subject: [PATCH] Add more information about slow bluetooth connections (#27869) * Add more information about slow bluetooth connections * Update source/_integrations/bluetooth.markdown * Apply suggestions from code review * Apply suggestions from code review * Update source/_integrations/bluetooth.markdown * Update source/_integrations/bluetooth.markdown * Update source/_integrations/bluetooth.markdown * Update source/_integrations/bluetooth.markdown * Update source/_integrations/bluetooth.markdown * Update source/_integrations/bluetooth.markdown * Apply suggestions from code review * Update source/_integrations/bluetooth.markdown * tiny tweak * Update source/_integrations/bluetooth.markdown --------- Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/bluetooth.markdown | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/source/_integrations/bluetooth.markdown b/source/_integrations/bluetooth.markdown index d90d65d119fc..466c5b6162ea 100644 --- a/source/_integrations/bluetooth.markdown +++ b/source/_integrations/bluetooth.markdown @@ -163,6 +163,10 @@ Performance testing used the following hardware: ### Known working adapters +
+Known working adapters list adapters that do not meet high-performance requirements but will generally work. These adapters vary widely in performance and may take as long as thirty seconds or more to establish a connection. These adapters may also miss advertisements such as button presses or temperature updates. +
+ #### Realtek RTL8761BU adapters
@@ -251,6 +255,21 @@ The following remote adapters are supported: ## Troubleshooting +### Improving connection times + +The connection time and performance vary greatly based on the Bluetooth adapter and interference. The below adapters are listed from best-performing to worst-performing: + +- [Ethernet-connected Bluetooth proxies](#remote-adapters-bluetooth-proxies) running ESPHome 2023.6.0 or later with [passive scanning](https://esphome.io/components/esp32_ble_tracker.html#configuration-variables) +- [USB High performance adapter](#known-working-high-performance-adapters) with [passive scanning](#passive-scanning) +- [Wi-Fi-connected Bluetooth proxies](#remote-adapters-bluetooth-proxies) running ESPHome 2023.6.0 or later with [passive scanning](https://esphome.io/components/esp32_ble_tracker.html#configuration-variables) +- [Ethernet-connected Bluetooth proxies](#remote-adapters-bluetooth-proxies) running ESPHome 2023.6.0 or later with [active scanning](https://esphome.io/components/esp32_ble_tracker.html#configuration-variables) +- [USB High performance adapter](#known-working-high-performance-adapters) with active scanning +- [Wi-Fi-connected Bluetooth proxies](#remote-adapters-bluetooth-proxies) running ESPHome 2023.6.0 or later with [active scanning](https://esphome.io/components/esp32_ble_tracker.html#configuration-variables) +- [Onboard high performance adapter](#cypress-based-adapters) with [passive scanning](#passive-scanning) +- [Onboard high performance adapter](#cypress-based-adapters) with active scanning +- [Known working adapters](#known-working-adapters) with [passive scanning](#passive-scanning) +- [Known working adapters](#known-working-adapters) with active scanning + ### Integrations that require exclusive use of the Bluetooth Adapter While newer integrations can share the Bluetooth Adapter, some legacy integrations require exclusive use of the adapter. Enabling this integration may prevent an integration that has not been updated to use newer methods from functioning.