Man Linux: Main Page and Category List

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

       -h     Gives a list of possible commands

       -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

       dev    Display local devices

       inq    Inquire  remote  devices.  For each discovered device, Bluetooth
              device address, clock offset and class are printed.

       scan   Inquire remote devices. For each discovered device, device  name
              are printed.

       name <bdaddr>
              Print  device  name  of  remote  device  with  Bluetooth address
              bdaddr.

       info <bdaddr>
              Print device name, version  and  supported  features  of  remote
              device with Bluetooth address bdaddr.

       spinq  Start  periodic inquiry process. No inquiry results are printed.

       epinq  Exit periodic inquiry process.

       cmd <ogf> <ocf> [parameters]
              Submit an arbitrary HCI command to local device.  ogf,  ocf  and
              parameters are hexadecimal bytes.

       con    Display active baseband connections

       cc [--role=m|s] [--pkt-type=<ptype>] <bdaddr>
              Create  baseband  connection  to  remote  device  with Bluetooth
              address 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 DM1, DM3,  DM5,  DH1,
              DH3,  DH5, HV1, HV2, 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 m.

       dc <bdaddr> [reason]
              Delete baseband connection from  remote  device  with  Bluetooth
              address  bdaddr.   The  reason  can  be one of the Bluetooth HCI
              error codes. Default is 19 for user ended connections. The value
              must be given in decimal.

       sr <bdaddr> <role>
              Switch  role  for the baseband connection from the remote device
              to master or slave.

       cpt <bdaddr> <packet types>
              Change packet types  for  baseband  connection  to  device  with
              Bluetooth  address  bdaddr.   packet  types is a comma-separated
              list of packet types, where the possible packet types  are  DM1,
              DM3, DM5, DH1, DH3, DH5, HV1, HV2, HV3.

       rssi <bdaddr>
              Display  received signal strength information for the connection
              to the device with Bluetooth address bdaddr.

       lq <bdaddr>
              Display link quality for  the  connection  to  the  device  with
              Bluetooth address bdaddr.

       tpl <bdaddr> [type]
              Display  transmit  power  level for the connection to the device
              with Bluetooth address bdaddr.   The  type  can  be  0  for  the
              current  transmit  power  level  (which is default) or 1 for the
              maximum transmit power level.

       afh <bdaddr>
              Display AFH channel map for the connection to  the  device  with
              Bluetooth address bdaddr.

       lp <bdaddr> [value]
              With  no value, displays link policy settings for the connection
              to the device with Bluetooth address bdaddr.  If value is given,
              sets  the  link  policy  settings  for that connection to value.
              Possible values are RSWITCH, HOLD, SNIFF and PARK.

       lst <bdaddr> [value]
              With  no  value,  displays  link  supervision  timeout  for  the
              connection  to  the  device  with  Bluetooth address bdaddr.  If
              value is given, sets  the  link  supervision  timeout  for  that
              connection to value slots, or to infinite if value is 0.

       auth <bdaddr>
              Request  authentication  for  the  device with Bluetooth address
              bdaddr.

       enc <bdaddr> [encrypt enable]
              Enable or disable the encryption for the device  with  Bluetooth
              address bdaddr.

       key <bdaddr>
              Change  the  connection  link  key for the device with Bluetooth
              address bdaddr.

       clkoff <bdaddr>
              Read the clock offset for  the  device  with  Bluetooth  address
              bdaddr.

       clock [bdaddr] [which clock]
              Read  the  clock  for  the device with Bluetooth address bdaddr.
              The clock can be 0 for the local clock  or  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>