Add BleakNoPassiveScanError exception

This exception can be used to e.g. retry scanning with scan_mode
adjusted to "active" on systems not supporting the "passive" scan.

Author: bojanpotocnik

CHANGELOG.rst

@@ -15,6 +15,7 @@ Added
 * Added optional hack to use Bluetooth address instead of UUID on macOS.
 * Added ``BleakScanner.find_device_by_name()`` class method.
 * Added check to verify that BlueZ Advertisement Monitor was actually registered
+* Added ``BleakNoPassiveScanError`` exception
 
 Changed
 -------

bleak/backends/bluezdbus/manager.py

@@ -27,7 +27,7 @@
 from dbus_fast import BusType, Message, MessageType, Variant, unpack_variants
 from dbus_fast.aio.message_bus import MessageBus
 
-from ...exc import BleakError
+from ...exc import BleakError, BleakNoPassiveScanError
 from ..service import BleakGATTServiceCollection
 from . import defs
 from .advertisement_monitor import AdvertisementMonitor, OrPatternLike
@@ -465,8 +465,9 @@ async def passive_scan(
                     reply.message_type == MessageType.ERROR
                     and reply.error_name == "org.freedesktop.DBus.Error.UnknownMethod"
                 ):
-                    raise BleakError(
-                        "passive scanning on Linux requires BlueZ >= 5.55 with --experimental enabled and Linux kernel >= 5.10"
+                    raise BleakNoPassiveScanError(
+                        "passive scanning on Linux requires BlueZ >= 5.55 with --experimental enabled"
+                        " and Linux kernel >= 5.10"
                     )
 
                 assert_reply(reply)
@@ -507,7 +508,7 @@ async def passive_scan(
 
                 # Monitor might not be Activate-d yet, but for sure it shall not be Release-d
                 if monitor.active is False:
-                    raise BleakError(
+                    raise BleakNoPassiveScanError(
                         "Advertising Monitor (required for passive scanning) is not supported by this kernel"
                         " (Linux kernel >= 5.10 is required)"
                     )

bleak/backends/corebluetooth/scanner.py

@@ -11,7 +11,7 @@
 from CoreBluetooth import CBPeripheral
 from Foundation import NSBundle
 
-from ...exc import BleakError
+from ...exc import BleakNoPassiveScanError
 from ..scanner import AdvertisementData, AdvertisementDataCallback, BaseBleakScanner
 from .CentralManagerDelegate import CentralManagerDelegate
 from .utils import cb_uuid_to_str
@@ -77,7 +77,7 @@ def __init__(
         self._use_bdaddr = cb.get("use_bdaddr", False)
 
         if scanning_mode == "passive":
-            raise BleakError("macOS does not support passive scanning")
+            raise BleakNoPassiveScanError("macOS does not support passive scanning")
 
         self._manager = CentralManagerDelegate.alloc().init()
         self._timeout: float = kwargs.get("timeout", 5.0)
@@ -89,7 +89,8 @@ def __init__(
             # See https://github.com/hbldh/bleak/issues/720
             if NSBundle.mainBundle().bundleIdentifier() == "org.python.python":
                 logger.error(
-                    "macOS 12.0, 12.1 and 12.2 require non-empty service_uuids kwarg, otherwise no advertisement data will be received"
+                    "macOS 12.0, 12.1 and 12.2 require non-empty service_uuids kwarg,"
+                    " otherwise no advertisement data will be received"
                 )
 
     async def start(self):

bleak/exc.py

@@ -63,6 +63,14 @@ def __str__(self) -> str:
         return (name + " " + details) if details else name
 
 
+class BleakNoPassiveScanError(BleakError):
+    """
+    Exception raised when passive scan is started on the system not supporting it
+    """
+
+    pass
+
+
 CONTROLLER_ERROR_CODES = {
     0x00: "Success",
     0x01: "Unknown HCI Command",