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>
This commit is contained in:
J. Nick Koston 2025-01-12 21:29:01 -10:00 committed by GitHub
parent b07e61ce6a
commit cd6fe58d45
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -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