Add more information about slow bluetooth connections (home-assistant…

…#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 <[email protected]>
EnergieID · Jun 20, 2023 · 00b3d67 · 00b3d67
1 parent a77a8e7
commit 00b3d67
Showing 1 changed file with 19 additions and 0 deletions.
diff --git a/source/_integrations/bluetooth.markdown b/source/_integrations/bluetooth.markdown
@@ -163,6 +163,10 @@ Performance testing used the following hardware:
 
 ### Known working adapters
 
+<div class='note'>
+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.
+</div>
+
 #### Realtek RTL8761BU adapters
 
 <div class='note warning'>
@@ -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.