HCITOOL(1)		 Linux System Administration		   HCITOOL(1)



NAME
       hcitool - configure Bluetooth connections

SYNOPSIS
       hcitool [-h]
       hcitool [-i ] [command [command parameters]]


DESCRIPTION
       hcitool	is used to configure Bluetooth connections and send some spe-
       cial 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 
	      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
	      is printed.

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

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

       cmd   [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=] 
	      Create baseband connection  to  remote  device  with  Bluetooth
	      address  bdaddr.	Option --pkt-type specifies a list of allowed
	      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.	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 
	      Delete  baseband	connection  from remote device with Bluetooth
	      address bdaddr.

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

       cpt  
	      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 
	      Display received signal strength information for the connection
	      to the device with Bluetooth address bdaddr.

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

       tpl  [type]
	      Display transmit power level for the connection to  the  device
	      with  Bluetooth address bdaddr.  The type can be 0 for the cur-
	      rent transmit power level (which is default) or 1 for the maxi-
	      mum transmit power level.

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

       lst  [value]
	      With no value, displays link supervision timeout for  the	 con-
	      nection  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 
	      Request  authentication  for  the device with Bluetooth address
	      bdaddr.

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

AUTHORS
       Written by Maxim Krasnyansky 

       man page by Fabrizio Gennari 



BlueZ				 Nov 12 2002			   HCITOOL(1)

UNIX/Linux commands referenced on this page:

1. which
2. clock
3. info
4. dc
5. link
6. disable
7. man