1BLUETOOTHCTL-SCAN(1)      Linux System Administration     BLUETOOTHCTL-SCAN(1)
2
3
4

NAME

6       bluetoothctl-scan - Scan Submenu
7

SYNOPSIS

9       bluetoothctl [--options] [scan.commands]
10

SCAN COMMANDS

12   uuids
13       Set/Get UUIDs filter.
14
15       Usage  # uuids [all/uuid1 uuid2 ...]
16
17   rssi
18       Set/Get RSSI filter, and clears pathloss.
19
20       This sets the minimum rssi value for reporting device advertisements.
21
22       The value is in dBm.
23
24       If  one or more discovery filters have been set, the RSSI delta-thresh‐
25       old imposed by starting discovery by default will not be applied.
26
27       Usage  # rssi [rssi]
28
29       Example
30              # rssi -60
31
32   pathloss
33       Set/Get Pathloss filter, and clears RSSI.
34
35       This sets the maximum pathloss value for  reporting  device  advertise‐
36       ments.
37
38       The value is in dB.
39
40       If  one or more discovery filters have been set, the RSSI delta-thresh‐
41       old imposed by starting discovery by default will not be applied.
42
43       Usage  # pathloss [pathloss]
44
45       Example
46              # pathloss 4
47
48   transport
49       Set/Get transport filter.
50
51       Transport parameter determines the type of scan.
52
53       The default is auto.
54
55       Possible values:
56
57       • "auto": interleaved scan
58
59       • "bredr": BR/EDR inquiry
60
61       • "le": LE scan only
62
63       If "le" or "bredr" Transport is requested and  the  controller  doesn't
64       support it, an org.bluez.Error.Failed error will be returned.
65
66       If "auto" transport is requested, the scan will use LE, BREDR, or both,
67       depending on what's currently enabled on the controller.
68
69       Usage  # transport [auto/bredr/le]
70
71   duplicate-data
72       Set/Get duplicate data filter.
73
74       Disables duplicate detection of advertisement data.
75
76       When enabled, PropertiesChanged signals will be generated for  Manufac‐
77       turerData and ServiceData every time they are discovered.
78
79       Usage  # duplicate-data [on/off]
80
81   discoverable
82       Set/Get discoverable filter.
83
84       Makes the adapter discoverable while discovering.
85
86       If  the adapter is already discoverable, setting this filter won't have
87       any effect.
88
89       Usage  # discoverable [on/off]
90
91   pattern
92       Set/Get pattern filter.
93
94       Discover devices where the pattern matches either the prefix of the ad‐
95       dress or the device name, which is a convenient way to limit the number
96       of device objects created during a discovery.
97
98       When set, it disregards device discoverable flags.
99
100       Note   The pattern matching is ignored if there are other clients  that
101              don't  set  any pattern, as it works as a logical OR. Also, set‐
102              ting an empty string "" pattern will match any device found.
103
104       Usage  # pattern [value]
105
106   clear
107       Clears discovery filter.
108
109       Usage  # clear  [uuids/rssi/pathloss/transport/duplicate-data/discover‐
110              able/pattern]
111

RESOURCES

113       http://www.bluez.org
114

REPORTING BUGS

116       linux-bluetooth@vger.kernel.org
117

119       Free use of this software is granted under ther terms of the GNU Lesser
120       General Public Licenses (LGPL).
121
122
123
124
125BlueZ                              July 2023              BLUETOOTHCTL-SCAN(1)
Impressum