v1.0.1
Patch release: fixes a shutdown hang when bound to Home Assistant, makes BLE handling more resilient, and adds clearer Raspberry Pi documentation.
Fixed
- Service hung on stop/restart while added to Home Assistant (#7). With an active ESPHome connection, shutdown blocked until the process was SIGKILLed — so the service couldn't be restarted unless the device was first removed in HA. It now closes the connection cleanly and exits in about a second.
Improved
- Scanner start no longer crash-loops or hammers a stuck adapter on transient errors; it retries gently, then re-arms slowly in the background.
- Repeated connect failures back off per-device instead of relaying Home Assistant's retry storm at the controller.
- The scanner is no longer stopped and restarted around every connection, so advertisements keep flowing while devices are connected.
- Detects an unresponsive
bluetoothd(phantom connection / no D-Bus reply) and logs a clear recovery hint.
Docs
- New Scanning modes: active vs passive section, including how to enable passive scanning via a clean
bluetoothd --experimentalsystemd drop-in. - New Reliability on Raspberry Pi section — power/undervoltage is the most common cause of "flaky Bluetooth", how to tell an unresponsive controller from an unresponsive daemon and recover each, and an optional watchdog.
Full Changelog: v1.0.0...v1.0.1