Skip to content

Commit

Permalink
Update bluetooth to include a section on selecting how to integrate B…
Browse files Browse the repository at this point in the history
…luetooth first (#28944)

Co-authored-by: J. Nick Koston <[email protected]>
  • Loading branch information
ellnic and bdraco authored Sep 19, 2023
1 parent 38f3310 commit 489a90d
Showing 1 changed file with 6 additions and 0 deletions.
6 changes: 6 additions & 0 deletions source/_integrations/bluetooth.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,12 @@ The Bluetooth integration will detect nearby Bluetooth devices. Discovered devic

{% include integrations/config_flow.md %}

## Before you begin

In many cases, a better approach than a directly connected adapter or card is to use a Bluetooth proxy using an ESP32 since Linux kernel updates have previously broken Bluetooth functionality and Bluetooth driver support Linux generally falls behind other operating systems for newer adapters. A Bluetooth proxy is particularly interesting to users who virtualize their instance, where the USB pass-through may cause additional problems. More information is available in the Remote Adapters section below or by visiting ESPhome's [Bluetooth proxy page](https://esphome.github.io/bluetooth-proxies/).

Suppose a Bluetooth proxy is not a good fit for your use case. Consider using the Home Assistant Operating System when using a local adapter because it includes Bluetooth patches for issues unsolved in other operating systems.

## Configuration

While this integration is part of [`default_config:`](/integrations/default_config/) to enable automatic discovery of the Bluetooth Adapter, it will only be enabled by setting up the configuration flow, or manually adding it to your `configuration.yaml`.
Expand Down

0 comments on commit 489a90d

Please sign in to comment.