From 73b12d807d7b6666e4fa77c79e8c71453eb791e3 Mon Sep 17 00:00:00 2001
From: "J. Nick Koston" <nick@koston.org>
Date: Thu, 24 Sep 2026 15:09:44 +0100
Subject: [PATCH] Add bluetooth API to subscribe to every advertisement of a
 device (#182916)

---
 .../components/bluetooth/__init__.py          |  2 ++
 homeassistant/components/bluetooth/api.py     | 14 +++++++++++
 tests/components/bluetooth/test_manager.py    | 25 +++++++++++++++++++
 3 files changed, 41 insertions(+)

diff --git a/homeassistant/components/bluetooth/__init__.py b/homeassistant/components/bluetooth/__init__.py
index a909bd56bd88..41640d3b4242 100644
--- a/homeassistant/components/bluetooth/__init__.py
+++ b/homeassistant/components/bluetooth/__init__.py
@@ -69,6 +69,7 @@ from .api import (
     async_last_service_info,
     async_process_advertisements,
     async_rediscover_address,
+    async_register_advertisement_callback,
     async_register_callback,
     async_register_scanner,
     async_remove_scanner,
@@ -131,6 +132,7 @@ __all__ = [
     "async_last_service_info",
     "async_process_advertisements",
     "async_rediscover_address",
+    "async_register_advertisement_callback",
     "async_register_callback",
     "async_register_scanner",
     "async_remove_scanner",
diff --git a/homeassistant/components/bluetooth/api.py b/homeassistant/components/bluetooth/api.py
index 1d45d38b9caf..96165890b565 100644
--- a/homeassistant/components/bluetooth/api.py
+++ b/homeassistant/components/bluetooth/api.py
@@ -218,6 +218,20 @@ def async_track_unavailable(
     return _get_manager(hass).async_track_unavailable(callback, address, connectable)
 
 
+@hass_callback
+def async_register_advertisement_callback(
+    hass: HomeAssistant,
+    callback: Callable[[BluetoothServiceInfoBleak], None],
+    address: str,
+) -> Callable[[], None]:
+    """Register to receive every advertisement from an address.
+
+    Fires even when the advertisement data is unchanged, unlike
+    async_register_callback. Returns a callback to cancel the registration.
+    """
+    return _get_manager(hass).async_register_advertisement_callback(callback, address)
+
+
 @hass_callback
 def async_rediscover_address(hass: HomeAssistant, address: str) -> None:
     """Trigger discovery of devices which have already been seen."""
diff --git a/tests/components/bluetooth/test_manager.py b/tests/components/bluetooth/test_manager.py
index 894efd783245..01d648cd5c5d 100644
--- a/tests/components/bluetooth/test_manager.py
+++ b/tests/components/bluetooth/test_manager.py
@@ -28,6 +28,7 @@ from homeassistant.components.bluetooth import (
     async_ble_device_from_address,
     async_get_fallback_availability_interval,
     async_get_learned_advertising_interval,
+    async_register_advertisement_callback,
     async_scanner_count,
     async_set_fallback_availability_interval,
     async_track_unavailable,
@@ -2063,3 +2064,27 @@ async def test_repair_issue_deleted_when_passive_mode_resolved(
     assert issue is None
 
     cancel()
+
+
+@pytest.mark.usefixtures("enable_bluetooth")
+async def test_async_register_advertisement_callback(hass: HomeAssistant) -> None:
+    """Advertisement callbacks fire for every packet, even when unchanged."""
+    address = "44:44:33:11:23:45"
+    device = generate_ble_device(address, "wohand")
+    adv = generate_advertisement_data(local_name="wohand", service_uuids=[])
+    seen: list[str] = []
+
+    @callback
+    def _advertisement_callback(service_info: BluetoothServiceInfoBleak) -> None:
+        seen.append(service_info.address)
+
+    cancel = async_register_advertisement_callback(
+        hass, _advertisement_callback, address
+    )
+    inject_advertisement_with_source(hass, device, adv, "hci0")
+    inject_advertisement_with_source(hass, device, adv, "hci0")
+    assert seen == [address, address]
+
+    cancel()
+    inject_advertisement_with_source(hass, device, adv, "hci0")
+    assert len(seen) == 2