🏝️

[Troubleshooting] How do I know that the Bluetooth Proxy is working and capturing Bluetooth signals?

Date

Aug 18, 2025 2:04 PM

🏝️

This is about troubleshooting. If you need information on how to connect to WiFi and configure to HA, please refer to: Bluetooth Proxy BP1、BLEDongle-1M - Quick Video Guide

While HA has been improving the experience of the Bluetooth functionality, there are some areas that may still be confusing because its settings are spread out in many places and many of the displays are hidden deeper.

Here's a simple demonstration, where a working Bluetooth Proxy is shown for HA, meaning that those changes can be seen.

🏝️

Since Bluetooth Agents can work together or with the HA's own physical Bluetooth adapter, if necessary you can temporarily turn off some Bluetooth receiving devices in Bluetooth to focus on the ones you're interested in.

First of all, if the Bluetooth Proxy is properly connected to the HA, traces of it will be visible in the Bluetooth integration and the ESPHome integration.

🏝️

If it's not working as expected here, consider reinstalling the firmware using our online tool and pairing the network.

https://tool.screek.io/factory_tool/bp1

Now, if the above step is correct, then you can start observing the Bluetooth signal it receives.

1. The entry point may be a little hard to find, click on the gear settings icon in any Bluetooth device.

2. In the settings you will find these two very useful tools.

3. the classic Bluetooth device viewer, they show which Bluetooth device they are coming from.

4. the Bluetooth Visualization visualization card, a cool new feature from HA.

Full Demo

Whether you're running HA in Docker or standalone, Bluetooth Proxy does its job.
With these exclusions, you'll find out if your Bluetooth Proxy is working properly.