Blob: bluetoothctl-scan.rst

Blob id: cee2551316224afb7acc123618672dd0e16d638c

Size: 3.1 KB

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
=================
bluetoothctl-scan
=================

------------
Scan Submenu
------------

:Version: BlueZ
:Copyright: Free use of this software is granted under the terms of the GNU
            Lesser General Public Licenses (LGPL).
:Date: July 2023
:Manual section: 1
:Manual group: Linux System Administration

SYNOPSIS
========

**bluetoothctl** [--options] [scan.commands]

Scan Commands
=============

uuids
-----

Set/Get UUIDs filter.

:Usage: **> uuids [all/uuid1 uuid2 ...]**

rssi
----

Set/Get RSSI filter, and clears pathloss.

This sets the minimum rssi value for reporting device advertisements.

The value is in dBm.

If one or more discovery filters have been set, the RSSI delta-threshold imposed
by starting discovery by default will not be applied.

:Usage: **> rssi [rssi]**
:Example: **> rssi -60**

pathloss
--------
Set/Get Pathloss filter, and clears RSSI.

This sets the maximum pathloss value for reporting device advertisements.

The value is in dB.

If one or more discovery filters have been set, the RSSI delta-threshold
imposed by starting discovery by default will not be applied.

:Usage: **> pathloss [pathloss]**
:Example: **> pathloss 4**

transport
---------

Set/Get transport filter.

Transport parameter determines the type of scan.

The default is auto.

Possible values:

- "auto": interleaved scan
- "bredr": BR/EDR inquiry
- "le": LE scan only

If "le" or "bredr" Transport is requested and the controller doesn't support it,
an org.bluez.Error.Failed error will be returned.

If "auto" transport is requested, the scan will use LE, BREDR, or both,
depending on what's currently enabled on the controller.

:Usage: **> transport [auto/bredr/le]**

duplicate-data
--------------

Set/Get duplicate data filter.

Disables duplicate detection of advertisement data.

When enabled, PropertiesChanged signals will be generated for ManufacturerData
and ServiceData every time they are discovered.

:Usage: **> duplicate-data [on/off]**

discoverable
------------

Set/Get discoverable filter.

Makes the adapter discoverable while discovering.

If the adapter is already discoverable, setting this filter won't have any
effect.

:Usage: **> discoverable [on/off]**

pattern
-------

Set/Get pattern filter.

Discover devices where the pattern matches either the prefix of the address or
the device name, which is a convenient way to limit the number of device objects
created during a discovery.

When set, it disregards device discoverable flags.

:Note: The pattern matching is ignored if there are other clients that don't
       set any pattern, as it works as a logical OR. Also, setting an empty
       string "" pattern will match any device found.

:Usage: **> pattern [value]**


auto-connect
------------

Set/Get auto-connect filter.

Connect to discovered devices automatically if pattern filter has been set and
it matches the device address or name and the device is connectable.

:Usage: **> auto-connect [on/off]**

clear
-----

Clears discovery filter.

:Usage: **> clear [uuids/rssi/pathloss/transport/duplicate-data/discoverable/pattern]**

RESOURCES
=========

http://www.bluez.org

REPORTING BUGS
==============

linux-bluetooth@vger.kernel.org