1
.TH HCITOOL 1 "Nov 12 2002" BlueZ "Linux System Administration"
3
hcitool \- configure Bluetooth connections
7
.B hcitool [-i <hciX>] [command [command parameters]]
13
is used to configure Bluetooth connections and send some special command to
14
Bluetooth devices. If no
17
is given, or if the option
23
prints some usage information and exits.
27
Gives a list of possible commands
30
The command is applied to device
33
, which must be the name of an installed Bluetooth device. If not specified,
34
the command will be sent to the first available Bluetooth device.
41
Inquire remote devices. For each discovered device, Bluetooth device address,
42
clock offset and class are printed.
45
Inquire remote devices. For each discovered device, device name are printed.
48
Print device name of remote device with Bluetooth address
52
Print device name, version and supported features of remote device with
57
Start periodic inquiry process. No inquiry results are printed.
60
Exit periodic inquiry process.
62
.BI cmd " <ogf> <ocf> [parameters]"
63
Submit an arbitrary HCI command to local device.
68
are hexadecimal bytes.
71
Display active baseband connections
73
.BI cc " [--role=m|s] [--pkt-type=<ptype>] <bdaddr>"
74
Create baseband connection to remote device with Bluetooth address
79
specifies a list of allowed packet types.
82
is a comma-separated list of packet types, where the possible packet types are
92
Default is to allow all packet types. Option
98
(do not allow role switch, stay master) or
101
(allow role switch, become slave if the peer asks to become master). Default is
104
.BI dc " <bdaddr> [reason]"
105
Delete baseband connection from remote device with Bluetooth address
107
The reason can be one of the Bluetooth HCI error codes. Default is
109
for user ended connections. The value must be given in decimal.
111
.BI sr " <bdaddr> <role>"
112
Switch role for the baseband connection from the remote device to
117
.BI cpt " <bdaddr> <packet types>"
118
Change packet types for baseband connection to device with Bluetooth address
122
is a comma-separated list of packet types, where the possible packet types are
134
Display received signal strength information for the connection to the device
135
with Bluetooth address
139
Display link quality for the connection to the device with Bluetooth address
142
.BI tpl " <bdaddr> [type]"
143
Display transmit power level for the connection to the device with Bluetooth address
147
for the current transmit power level (which is default) or
149
for the maximum transmit power level.
152
Display AFH channel map for the connection to the device with Bluetooth address
155
.BI lp " <bdaddr> [value]"
158
displays link policy settings for the connection to the device with Bluetooth address
162
is given, sets the link policy settings for that connection to
164
Possible values are RSWITCH, HOLD, SNIFF and PARK.
166
.BI lst " <bdaddr> [value]"
169
displays link supervision timeout for the connection to the device with Bluetooth address
174
is given, sets the link supervision timeout for that connection to
177
slots, or to infinite if
183
Request authentication for the device with Bluetooth address
186
.BI enc " <bdaddr> [encrypt enable]"
187
Enable or disable the encryption for the device with Bluetooth address
191
Change the connection link key for the device with Bluetooth address
194
.BI clkoff " <bdaddr>"
195
Read the clock offset for the device with Bluetooth address
198
.BI clock " [bdaddr] [which clock]"
199
Read the clock for the device with Bluetooth address
203
for the local clock or
205
for the piconet clock (which is default).
207
Written by Maxim Krasnyansky <maxk@qualcomm.com> and Marcel Holtmann <marcel@holtmann.org>
209
man page by Fabrizio Gennari <fabrizio.gennari@philips.com>