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

NAME

6       hcitool - Configure Bluetooth connections
7

SYNOPSIS

9       hcitool -h
10
11       hcitool COMMAND --help
12
13       hcitool [-i hciX] [COMMAND [PARAMETERS]]
14

DESCRIPTION

16       hcitool(1)  is  used  to  configure Bluetooth connections and send some
17       special command to Bluetooth devices. If no command is given, or if the
18       option -h is used, hcitool prints some usage information and exits.
19

OPTIONS

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

COMMANDS

29       dev    Display local devices
30
31       inq    Inquire  remote  devices.  For each discovered device, Bluetooth
32              device address, clock offset and class are printed.
33
34       scan   Inquire remote devices. For each discovered device, device  name
35              are printed.
36
37       name <bdaddr>
38              Print  device  name  of  remote  device  with  Bluetooth address
39              bdaddr.
40
41       info <bdaddr>
42              Print device name, version and supported features of remote  de‐
43              vice with Bluetooth address bdaddr.
44
45       spinq  Start periodic inquiry process. No inquiry results are printed.
46
47       epinq  Exit periodic inquiry process.
48
49       cmd <ogf> <ocf> [parameters]
50              Submit  an  arbitrary  HCI command to local device. ogf, ocf and
51              parameters are hexadecimal bytes.
52
53       con    Display active baseband connections
54
55       cc [--role=c|p] [--pkt-type=<ptype>] <bdaddr>
56              Create baseband connection to remote device with  Bluetooth  ad‐
57              dress bdaddr.
58
59              Option  --pkt-type  specifies  a list  of  allowed packet types.
60              <ptype> is a comma-separated list of  packet  types,  where  the
61              possible  packet  types  are  DM1, DM3, DM5, DH1, DH3, DH5, HV1,
62              HV2, HV3. Default is to allow all packet types.
63
64              Option  --role can have value c (do not allow role switch,  stay
65              central)  or p (allow role switch, become peripheral if the peer
66              asks to become central). Default is c.
67
68       dc <bdaddr> [reason]
69              Delete baseband connection from remote device with Bluetooth ad‐
70              dress bdaddr.
71
72              The reason can be one of the Bluetooth HCI error codes.  Default
73              is 19 for user ended connections. The value  must  be  given  in
74              decimal.
75
76       sr <bdaddr> <role>
77              Switch  role  for the baseband connection from the remote device
78              to central or peripheral.
79
80       cpt <bdaddr> <ptypes>
81              Change packet types for baseband connection to device with Blue‐
82              tooth address bdaddr. ptypes is a comma-separated list of packet
83              types, where the possible packet types are DM1, DM3,  DM5,  DH1,
84              DH3, DH5, HV1, HV2, HV3.
85
86       rssi <bdaddr>
87              Display  received signal strength information for the connection
88              to the device with Bluetooth address bdaddr.
89
90       lq <bdaddr>
91              Display link quality for the connection to the device with Blue‐
92              tooth address bdaddr.
93
94       tpl <bdaddr> [type]
95              Display  transmit  power  level for the connection to the device
96              with Bluetooth address bdaddr.
97
98              The type can be 0 for the current transmit power level (which is
99              default) or 1 for the maximum transmit power level.
100
101       afh <bdaddr>
102              Display  AFH  channel  map for the connection to the device with
103              Bluetooth address bdaddr.
104
105       lp <bdaddr> [value]
106              With no value, displays link policy settings for the  connection
107              to the device with Bluetooth address bdaddr.
108
109              If  value  is given, sets the link policy settings for that con‐
110              nection to value. Possible values are RSWITCH, HOLD,  SNIFF  and
111              PARK.
112
113       lst <bdaddr> [value]
114              With no value, displays link supervision timeout for the connec‐
115              tion to the device with Bluetooth address bdaddr.
116
117              If value is given, sets the link supervision  timeout  for  that
118              connection to value slots, or to infinite if value is 0.
119
120       auth <bdaddr>
121              Request  authentication  for  the  device with Bluetooth address
122              bdaddr.
123
124       enc <bdaddr> [encrypt]
125              enable or disable the encryption for the device  with  Bluetooth
126              address bdaddr.
127
128       key <bdaddr>
129              Change the connection link key for the device with Bluetooth ad‐
130              dress bdaddr.
131
132       clkoff <bdaddr>
133              Read the clock offset for  the  device  with  Bluetooth  address
134              bdaddr.
135
136       clock [bdaddr] [clock]
137              Read the clock for the device with Bluetooth address bdaddr.
138
139              The  clock  can  be  0  for the local clock or 1 for the piconet
140              clock (which is default).
141
142       lescan [--privacy] [--passive] [--acceptlist] [--discovery=g|l]  [--du‐
143       plicates]
144              Start LE scan
145
146       leinfo [--static] [--random] <bdaddr>
147              Get LE remote information
148
149       lealadd [--random] <bdaddr>
150              Add device to LE Accept List
151
152       lealrm <bdaddr>
153              Remove device from LE Accept List
154
155       lealsz Read size of LE Accept List
156
157       lealclr
158              Clear LE Accept List
159
160       lerladd [--local_irk] [--peer_irk] [--random] <bdaddr>
161              Add device to LE Resolving List
162
163       lerlrm <bdaddr>
164              Remove device from LE Resolving List
165
166       lerlclr
167              Clear LE Resolving List
168
169       lerlsz Read size of LE Resolving List
170
171       lerlon Enable LE Address Resolution
172
173       lerloff
174              Disable LE Address Resolution
175
176       lecc [--static] [--random] <bdaddr> | [--acceptlist]
177              Create a LE Connection
178
179       ledc <handle> [reason]
180              Disconnect a LE Connection
181
182       lecup <handle> <min> <max> <latency> <timeout>
183              LE Connection Update
184

RESOURCES

186       http://www.bluez.org
187

REPORTING BUGS

189       linux-bluetooth@vger.kernel.org
190

AUTHOR

192       Maxim  Krasnyansky  <maxk@qualcomm.com>,  Marcel Holtmann <marcel@holt‐
193       mann.org>, Fabrizio Gennari <fabrizio.gennari@philips.com>
194
196       Free use of this software is granted under ther terms of the GNU Lesser
197       General Public Licenses (LGPL).
198
199
200
201
202BlueZ                            Nov 12, 2002                       HCITOOL(1)
Impressum