From cd6fe58d45672eed4f9ac103ff840ff23951e60a Mon Sep 17 00:00:00 2001
From: "J. Nick Koston" <nick@koston.org>
Date: Sun, 12 Jan 2025 21:29:01 -1000
Subject: [PATCH] Collapse Bluetooth adapters with known issues (#36879)

* Collapse Bluetooth adapters with known issues

Hide these behind details blocks so they are less likely to be purchased.

* Update bluetooth.markdown

* Update bluetooth.markdown

* Update source/_integrations/bluetooth.markdown

* Update bluetooth.markdown

* Update bluetooth.markdown

* Update bluetooth.markdown

* tiny tweak

---------

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
---
 source/_integrations/bluetooth.markdown | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/source/_integrations/bluetooth.markdown b/source/_integrations/bluetooth.markdown
index 05c9970fdfd..64630462973 100644
--- a/source/_integrations/bluetooth.markdown
+++ b/source/_integrations/bluetooth.markdown
@@ -91,6 +91,8 @@ Some systems may not come with Bluetooth and require a USB adapter. Installing a
 
 If you experience an unreliable Bluetooth connection, installing a short USB extension cable between your Bluetooth adapter and your Home Assistant server may improve reliability.
 
+For development and testing, the developers of this Bluetooth integration primarily use a [Feasycom FSC-BP119](https://www.feasycom.com/datasheet/fsc-bp119.pdf) (CSR8510A10) 📶.
+
 ### Known working high-performance adapters
 
 #### Cambridge Silicon Radio (CSR) -based adapters
@@ -133,6 +135,8 @@ These adapters may require additional patch files available at <a href="https://
   
 There is currently no supported method to install these patch files when using Home Assistant Operating System.
 {% endwarning %}
+
+{% details "Broadcom (BCM) based adapters" %}
   
 - ASUS USB-BT400 (BCM20702A0)
 - Cable Matters 604002-BLK (BCM20702A0)
@@ -147,6 +151,8 @@ There is currently no supported method to install these patch files when using H
 - StarTech USBBT2EDR4 (BCM20702A0)
 - Targus ACB10US1 (BCM20702A0)
 
+{% enddetails %}
+
 📶 Denotes external antenna
 
 Most of these adapters can hold seven (7) connections at the same time.
@@ -185,9 +191,11 @@ Known working adapters list adapters that do not meet high-performance requireme
 #### Realtek RTL8761BU adapters
 
 {% warning %}
-These adapters do not have a reset pin. If they stop responding, there is currently no way for the kernel to reset them automatically. A generic USB reset for these adapters has been introduced in Linux kernel 6.1 and later.
+These adapters do not have a reset pin. When they stop responding, there is currently no way for the kernel to reset them automatically, and they may have to be physically unplugged and replugged to restore operation.
 {% endwarning %}
 
+{% details "Realtek RTL8761BU adapters" %}
+
 - ASUS USB-BT500 (RTL8761BU)
 - Avantree DG45 (RTL8761BU)
 - COMCAST CF-B03 (RTL8761BU)
@@ -206,10 +214,14 @@ These adapters do not have a reset pin. If they stop responding, there is curren
 - ZEXMTE Z01 (RTL8761BU) 📶
 - ZETSAGE BH451A (RTL8761BU) 📶
 
+{% enddetails %}
+
 📶 Denotes external antenna
 
 ### Unsupported adapters
 
+{% details "Unsupported adapters" %}
+
 - Alfa AWUS036EACS (RTL8821CU) - Frequent connection failures and drop outs
 - BASEUS BR8651A01 BA04 - Advertisement drops out
 - Belkin F8T003 ver 2. - Fails to setup and add successfully
@@ -229,6 +241,8 @@ These adapters do not have a reset pin. If they stop responding, there is curren
   - Multiple unbranded adapters labeled with CSR 4.0
   - 5 CORE CSR 4.0
 
+{% enddetails %}
+
 📶 Denotes external antenna
 
 ## Multiple adapters