jeans/developers.home-assistant
jeans/developers.home-assistant
1
0
Fork 0
mirror of https://github.com/home-assistant/developers.home-assistant.git synced 2025-07-18 23:06:31 +00:00
Code Issues Packages Projects Releases Wiki Activity

Document changes for bleak 0.15 (#1415)

Browse Source
This commit is contained in:
J. Nick Koston 2022-07-30 10:12:42 -07:00 committed by GitHub
parent 1acdc2f6bb
commit d0ad5934f8
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 27 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
docs/network_discovery.md
View File

@ -35,13 +35,13 @@ from homeassistant.components import bluetooth
... ...
@callback @callback
def _async_discovered_device(service_info: bluetooth.BluetoothServiceInfo, change: bluetooth.BluetoothChange) -> None: def _async_discovered_device(service_info: bluetooth.BluetoothServiceInfoBleak, change: bluetooth.BluetoothChange) -> None:
"""Subscribe to bluetooth changes.""" """Subscribe to bluetooth changes."""
_LOGGER.warning("New service_info: %s", service_info) _LOGGER.warning("New service_info: %s", service_info)
entry.async_on_unload( entry.async_on_unload(
bluetooth.async_register_callback( bluetooth.async_register_callback(
hass, _async_discovered_device, {"service_uuids": {"cba20d00-224d-11e6-9fb8-0002a5d5c51b"}} hass, _async_discovered_device, {"service_uuids": {"cba20d00-224d-11e6-9fb8-0002a5d5c51b"}}, bluetooth.BluetoothScanningMode.ACTIVE
) )
) )
``` ```
@ -55,7 +55,7 @@ from homeassistant.components import bluetooth
entry.async_on_unload( entry.async_on_unload(
bluetooth.async_register_callback( bluetooth.async_register_callback(
hass, _async_discovered_homekit_device, {"manufacturer_id": 76, "manufacturer_data_first_byte": 6} hass, _async_discovered_homekit_device, {"manufacturer_id": 76, "manufacturer_data_first_byte": 6}, bluetooth.BluetoothScanningMode.ACTIVE
) )
) )
``` ```
@ -69,7 +69,7 @@ from homeassistant.components import bluetooth
entry.async_on_unload( entry.async_on_unload(
bluetooth.async_register_callback( bluetooth.async_register_callback(
hass, _async_nespresso_found, {"local_name": "Prodigio_*")} hass, _async_nespresso_found, {"local_name": "Prodigio_*")}, bluetooth.BluetoothScanningMode.ACTIVE
) )
) )
``` ```
@ -84,7 +84,7 @@ from homeassistant.components import bluetooth
entry.async_on_unload( entry.async_on_unload(
bluetooth.async_register_callback( bluetooth.async_register_callback(
hass, _async_specific_device_found, {"address": "44:33:11:22:33:22")} hass, _async_specific_device_found, {"address": "44:33:11:22:33:22")}, bluetooth.BluetoothScanningMode.ACTIVE
) )
) )
``` ```
@ -142,6 +142,28 @@ from homeassistant.components import bluetooth
service_infos = bluetooth.async_discovered_service_info(hass) service_infos = bluetooth.async_discovered_service_info(hass)
``` ```
### Waiting for a specific advertisement
To wait for a specific advertisement, call the `bluetooth.async_process_advertisements` API.
```python
from homeassistant.components import bluetooth
def _process_more_advertisements(
service_info: BluetoothServiceInfoBleak,
) -> bool:
"""Wait for an advertisement with 323 in the manufacturer_data."""
return 323 in service_info.manufacturer_data
service_info = await bluetooth.async_process_advertisements(
hass
_process_more_advertisements,
{"address": discovery_info.address},
BluetoothScanningMode.ACTIVE,
ADDITIONAL_DISCOVERY_TIMEOUT
)
```
## mDNS/Zeroconf ## mDNS/Zeroconf