1HCITOOL(1)                Linux System Administration               HCITOOL(1)
2
3
4

NAME

6       hcitool - configure Bluetooth connections
7

SYNOPSIS

9       hcitool [-h]
10       hcitool [-i <hciX>] [command [command parameters]]
11
12

DESCRIPTION

14       hcitool  is  used to configure Bluetooth connections and send some spe‐
15       cial command to Bluetooth devices. If no command is given,  or  if  the
16       option -h is used, hcitool prints some usage information and exits.
17

OPTIONS

19       -h     Gives a list of possible commands
20
21       -i <hciX>
22              The  command  is applied to device hciX , which must be the name
23              of an installed Bluetooth device. If not specified, the  command
24              will be sent to the first available Bluetooth device.
25

COMMANDS

27       dev    Display local devices
28
29       inq    Inquire  remote  devices.  For each discovered device, Bluetooth
30              device address, clock offset and class are printed.
31
32       scan   Inquire remote devices. For each discovered device, device  name
33              are printed.
34
35       name <bdaddr>
36              Print  device  name  of  remote  device  with  Bluetooth address
37              bdaddr.
38
39       info <bdaddr>
40              Print device name, version  and  supported  features  of  remote
41              device with Bluetooth address bdaddr.
42
43       spinq  Start periodic inquiry process. No inquiry results are printed.
44
45       epinq  Exit periodic inquiry process.
46
47       cmd <ogf> <ocf> [parameters]
48              Submit  an  arbitrary HCI command to local device.  ogf, ocf and
49              parameters are hexadecimal bytes.
50
51       con    Display active baseband connections
52
53       cc [--role=m|s] [--pkt-type=<ptype>] <bdaddr>
54              Create baseband  connection  to  remote  device  with  Bluetooth
55              address  bdaddr.   Option --pkt-type specifies a list of allowed
56              packet types.  <ptype>  is  a  comma-separated  list  of  packet
57              types,  where  the possible packet types are DM1, DM3, DM5, DH1,
58              DH3, DH5, HV1, HV2, HV3.  Default is to allow all packet  types.
59              Option  --role  can have value m (do not allow role switch, stay
60              master) or s (allow role switch, become slave if the  peer  asks
61              to become master). Default is m.
62
63       dc <bdaddr> [reason]
64              Delete  baseband  connection  from  remote device with Bluetooth
65              address bdaddr.  The reason can be  one  of  the  Bluetooth  HCI
66              error codes. Default is 19 for user ended connections. The value
67              must be given in decimal.
68
69       sr <bdaddr> <role>
70              Switch role for the baseband connection from the  remote  device
71              to master or slave.
72
73       cpt <bdaddr> <packet types>
74              Change packet types for baseband connection to device with Blue‐
75              tooth address bdaddr.  packet types is a comma-separated list of
76              packet types, where the possible packet types are DM1, DM3, DM5,
77              DH1, DH3, DH5, HV1, HV2, HV3.
78
79       rssi <bdaddr>
80              Display received signal strength information for the  connection
81              to the device with Bluetooth address bdaddr.
82
83       lq <bdaddr>
84              Display link quality for the connection to the device with Blue‐
85              tooth address bdaddr.
86
87       tpl <bdaddr> [type]
88              Display transmit power level for the connection  to  the  device
89              with  Bluetooth  address bdaddr.  The type can be 0 for the cur‐
90              rent transmit power level (which is default) or 1 for the  maxi‐
91              mum transmit power level.
92
93       afh <bdaddr>
94              Display  AFH  channel  map for the connection to the device with
95              Bluetooth address bdaddr.
96
97       lp <bdaddr> [value]
98              With no value, displays link policy settings for the  connection
99              to the device with Bluetooth address bdaddr.  If value is given,
100              sets the link policy settings  for  that  connection  to  value.
101              Possible values are RSWITCH, HOLD, SNIFF and PARK.
102
103       lst <bdaddr> [value]
104              With no value, displays link supervision timeout for the connec‐
105              tion to the device with Bluetooth address bdaddr.  If  value  is
106              given,  sets the link supervision timeout for that connection to
107              value slots, or to infinite if value is 0.
108
109       auth <bdaddr>
110              Request authentication for the  device  with  Bluetooth  address
111              bdaddr.
112
113       enc <bdaddr> [encrypt enable]
114              Enable  or  disable the encryption for the device with Bluetooth
115              address bdaddr.
116
117       key <bdaddr>
118              Change the connection link key for  the  device  with  Bluetooth
119              address bdaddr.
120
121       clkoff <bdaddr>
122              Read  the  clock  offset  for  the device with Bluetooth address
123              bdaddr.
124
125       clock [bdaddr] [which clock]
126              Read the clock for the device  with  Bluetooth  address  bdaddr.
127              The  clock  can  be  0  for the local clock or 1 for the piconet
128              clock (which is default).
129

AUTHORS

131       Written by Maxim Krasnyansky <maxk@qualcomm.com>  and  Marcel  Holtmann
132       <marcel@holtmann.org>
133
134       man page by Fabrizio Gennari <fabrizio.gennari@philips.com>
135
136
137
138BlueZ                             Nov 12 2002                       HCITOOL(1)