Skip to content

Bluetooth needs to be set to Active mode for HA to discover Switchbot devices #40140

@gcoan

Description

@gcoan

Feedback

I don't know if this applies to multiple Switchbot device types as I only have 4 Switchbot Leak Detectors but I have identified that the integration will not auto-discover the devices unless they are in range of a BLE relay that is set to Active mode:

Image

If the Bluetooth mode is set to Passive the devices will not be auto discovered. There is a message about this if you try to manually add a device, but this detail ought to be in the documentation as well:

Image

But, there is another problem, and the message above is I feel misleading. It says 'Active scans can be disabled once the device is configured' but if you do that and set the scanning to Passive, next time HA is rebooted it fails to connect to the Switchbot device and the integration keeps reloading saying "cannot find device, is not broadcasting" - so basically the Bluetooth mode needs to be set to Active all the time or else you'll loose connectivity on the next HA reboot.

This latter behaviour may be a bug because whilst the switchbot integration says it cannot find the device and the leak detector entities are set to unknown, if I click on the BLE MAC address I can see that HA can see the device and its connected to a BLE relay, just the integration can't find it!

URL

https://www.home-assistant.io/integrations/switchbot/

Version

2025.7.3

Additional information

No response

Metadata

Metadata

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions