hcitool

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>