1HCITOOL(1) Linux System Administration HCITOOL(1)
2
3
4
6 hcitool - Configure Bluetooth connections
7
9 hcitool -h
10
11 hcitool COMMAND --help
12
13 hcitool [-i hciX] [COMMAND [PARAMETERS]]
14
16 hcitool(1) is used to configure Bluetooth connections and send some
17 special command to Bluetooth devices. If no command is given, or if the
18 option -h is used, hcitool prints some usage information and exits.
19
21 -i <hciX>
22 The command is applied to device hciX, which must be the name of
23 an installed Bluetooth device. If not specified, the command
24 will be sent to the first available Bluetooth device.
25
26 -h Gives a list of possible commands
27
29 dev Display local devices
30
31 inq Inquire remote devices. For each discovered device, Bluetooth
32 device address, clock offset and class are printed.
33
34 scan Inquire remote devices. For each discovered device, device name
35 are printed.
36
37 name <bdaddr>
38 Print device name of remote device with Bluetooth address
39 bdaddr.
40
41 info <bdaddr>
42 Print device name, version and supported features of remote de‐
43 vice with Bluetooth address bdaddr.
44
45 spinq Start periodic inquiry process. No inquiry results are printed.
46
47 epinq Exit periodic inquiry process.
48
49 cmd <ogf> <ocf> [parameters]
50 Submit an arbitrary HCI command to local device. ogf, ocf and
51 parameters are hexadecimal bytes.
52
53 con Display active baseband connections
54
55 cc [--role=c|p] [--pkt-type=<ptype>] <bdaddr>
56 Create baseband connection to remote device with Bluetooth ad‐
57 dress bdaddr.
58
59 Option --pkt-type specifies a list of allowed packet types.
60 <ptype> is a comma-separated list of packet types, where the
61 possible packet types are DM1, DM3, DM5, DH1, DH3, DH5, HV1,
62 HV2, HV3. Default is to allow all packet types.
63
64 Option --role can have value c (do not allow role switch, stay
65 central) or p (allow role switch, become peripheral if the peer
66 asks to become central). Default is c.
67
68 dc <bdaddr> [reason]
69 Delete baseband connection from remote device with Bluetooth ad‐
70 dress bdaddr.
71
72 The reason can be one of the Bluetooth HCI error codes. Default
73 is 19 for user ended connections. The value must be given in
74 decimal.
75
76 sr <bdaddr> <role>
77 Switch role for the baseband connection from the remote device
78 to central or peripheral.
79
80 cpt <bdaddr> <ptypes>
81 Change packet types for baseband connection to device with Blue‐
82 tooth address bdaddr. ptypes is a comma-separated list of packet
83 types, where the possible packet types are DM1, DM3, DM5, DH1,
84 DH3, DH5, HV1, HV2, HV3.
85
86 rssi <bdaddr>
87 Display received signal strength information for the connection
88 to the device with Bluetooth address bdaddr.
89
90 lq <bdaddr>
91 Display link quality for the connection to the device with Blue‐
92 tooth address bdaddr.
93
94 tpl <bdaddr> [type]
95 Display transmit power level for the connection to the device
96 with Bluetooth address bdaddr.
97
98 The type can be 0 for the current transmit power level (which is
99 default) or 1 for the maximum transmit power level.
100
101 afh <bdaddr>
102 Display AFH channel map for the connection to the device with
103 Bluetooth address bdaddr.
104
105 lp <bdaddr> [value]
106 With no value, displays link policy settings for the connection
107 to the device with Bluetooth address bdaddr.
108
109 If value is given, sets the link policy settings for that con‐
110 nection to value. Possible values are RSWITCH, HOLD, SNIFF and
111 PARK.
112
113 lst <bdaddr> [value]
114 With no value, displays link supervision timeout for the connec‐
115 tion to the device with Bluetooth address bdaddr.
116
117 If value is given, sets the link supervision timeout for that
118 connection to value slots, or to infinite if value is 0.
119
120 auth <bdaddr>
121 Request authentication for the device with Bluetooth address
122 bdaddr.
123
124 enc <bdaddr> [encrypt]
125 enable or disable the encryption for the device with Bluetooth
126 address bdaddr.
127
128 key <bdaddr>
129 Change the connection link key for the device with Bluetooth ad‐
130 dress bdaddr.
131
132 clkoff <bdaddr>
133 Read the clock offset for the device with Bluetooth address
134 bdaddr.
135
136 clock [bdaddr] [clock]
137 Read the clock for the device with Bluetooth address bdaddr.
138
139 The clock can be 0 for the local clock or 1 for the piconet
140 clock (which is default).
141
142 lescan [--privacy] [--passive] [--acceptlist] [--discovery=g|l] [--du‐
143 plicates]
144 Start LE scan
145
146 leinfo [--static] [--random] <bdaddr>
147 Get LE remote information
148
149 lealadd [--random] <bdaddr>
150 Add device to LE Accept List
151
152 lealrm <bdaddr>
153 Remove device from LE Accept List
154
155 lealsz Read size of LE Accept List
156
157 lealclr
158 Clear LE Accept List
159
160 lerladd [--local_irk] [--peer_irk] [--random] <bdaddr>
161 Add device to LE Resolving List
162
163 lerlrm <bdaddr>
164 Remove device from LE Resolving List
165
166 lerlclr
167 Clear LE Resolving List
168
169 lerlsz Read size of LE Resolving List
170
171 lerlon Enable LE Address Resolution
172
173 lerloff
174 Disable LE Address Resolution
175
176 lecc [--static] [--random] <bdaddr> | [--acceptlist]
177 Create a LE Connection
178
179 ledc <handle> [reason]
180 Disconnect a LE Connection
181
182 lecup <handle> <min> <max> <latency> <timeout>
183 LE Connection Update
184
186 http://www.bluez.org
187
189 linux-bluetooth@vger.kernel.org
190
192 Maxim Krasnyansky <maxk@qualcomm.com>, Marcel Holtmann <marcel@holt‐
193 mann.org>, Fabrizio Gennari <fabrizio.gennari@philips.com>
194
196 Free use of this software is granted under ther terms of the GNU Lesser
197 General Public Licenses (LGPL).
198
199
200
201
202BlueZ Nov 12, 2002 HCITOOL(1)