4.2.2. discover_devices

bluetooth.discover_devices(duration=8, flush_cache=True, lookup_names=False, lookup_class=False, device_id=-1, iac=10390323)

Perform a Bluetooth device discovery.

This function uses the first available Bluetooth resource to discover Bluetooth devices.

Parameters:
  • lookup_names (bool) – When set to True discover_devices() also attempts to look up the display name of each detected device. (the default is False).
  • lookup_class (bool) – When set to True discover_devices() attempts to look up the class of each detected device. (the default is False).
Returns:

Returns a list of device addresses as strings or a list of tuples. The content of the tuples depends on the values of lookup_names and lookup_class as detailed below.

lookup_class lookup_names Return
False False list of device addresses
False True list of (address, name) tuples
True False list of (address, class) tuples
True True list of (address, name, class) tuples

Return type:

list