NAME
hcitool - configure Bluetooth connections
SYNOPSIS
hcitool [-h]
hcitool [-i <hciX>] [command [command parameters]]
DESCRIPTION
hcitool
is used to configure Bluetooth connections and send some special command to
Bluetooth devices. If no
command
is given, or if the option
-h
is used,
hcitool
prints some usage information and exits.
OPTIONS
I -h
Gives a list of possible commands
I -i <hciX>
The command is applied to device
hciX
, which must be the name of an installed Bluetooth device. If not specified,
the command will be sent to the first available Bluetooth device.
COMMANDS
I dev
Display local devices
I inq
Inquire remote devices. For each discovered device, Bluetooth device address,
clock offset and class are printed.
I scan
Inquire remote devices. For each discovered device, device name are printed.
I name <bdaddr>
Print device name of remote device with Bluetooth address
R bdaddr .
I info <bdaddr>
Print device name, version and supported features of remote device with
Bluetooth address
R bdaddr .
I spinq
Start periodic inquiry process. No inquiry results are printed.
I epinq
Exit periodic inquiry process.
I cmd <ogf> <ocf> [parameters]
Submit an arbitrary HCI command to local device.
R ogf ,
R ocf
and
R parameters
are hexadecimal bytes.
I con
Display active baseband connections
I cc [--role=m|s] [--pkt-type=<ptype>] <bdaddr>
Create baseband connection to remote device with Bluetooth address
R bdaddr .
Option
--pkt-type
specifies a list of allowed packet types.
<ptype>
is a comma-separated list of packet types, where the possible packet types are
R DM1 ,
R DM3 ,
R DM5 ,
R DH1 ,
R DH3 ,
R DH5 ,
R HV1 ,
R HV2 ,
R HV3 .
Default is to allow all packet types. Option
--role
can have value
m
(do not allow role switch, stay master) or
s
(allow role switch, become slave if the peer asks to become master). Default is
R m .
I dc <bdaddr>
Delete baseband connection from remote device with Bluetooth address
R bdaddr .
I sr <bdaddr> <role>
Switch role for the baseband connection from the remote device to
R master
or
R slave .
I cpt <bdaddr> <packet types>
Change packet types for baseband connection to device with Bluetooth address
R bdaddr .
packet types
is a comma-separated list of packet types, where the possible packet types are
R DM1 ,
R DM3 ,
R DM5 ,
R DH1 ,
R DH3 ,
R DH5 ,
R HV1 ,
R HV2 ,
R HV3 .
I rssi <bdaddr>
Display received signal strength information for the connection to the device
with Bluetooth address
R bdaddr .
I lq <bdaddr>
Display link quality for the connection to the device with Bluetooth address
R bdaddr .
I tpl <bdaddr> [type]
Display transmit power level for the connection to the device with Bluetooth address
R bdaddr .
The type can be
R 0
for the current transmit power level (which is default) or
R 1
for the maximum transmit power level.
I afh <bdaddr>
Display AFH channel map for the connection to the device with Bluetooth address
R bdaddr .
I lst <bdaddr> [value]
With no
R value ,
displays link supervision timeout for the connection to the device with Bluetooth address
R bdaddr .
If
value
is given, sets the link supervision timeout for that connection to
value
slots, or to infinite if
value
is 0.
I auth <bdaddr>
Request authentication for the device with Bluetooth address
R bdaddr .
I enc <bdaddr> [encrypt enable]
Enable or disable the encryption for the device with Bluetooth address
R bdaddr .
I key <bdaddr>
Change the connection link key for the device with Bluetooth address
R bdaddr .
I clkoff <bdaddr>
Read the clock offset for the device with Bluetooth address
R bdaddr .
I clock [bdaddr] [which clock]
Read the clock for the device with Bluetooth address
R bdaddr .
The clock can be
R 0
for the local clock or
R 1
for the piconet clock (which is default).
AUTHORS
Written by Maxim Krasnyansky <maxk@qualcomm.com> and Marcel Holtmann <marcel@holtmann.org>
man page by Fabrizio Gennari <fabrizio.gennari@philips.com>