1HCITOOL(1) Linux System Administration HCITOOL(1)
2
6 hcitool - Configure Bluetooth connections
7
9 hcitool -h
10 hcitool COMMAND --help
12 hcitool [-i hciX] [COMMAND [PARAMETERS]]
14
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
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 -h Gives a list of possible commands
27
29 dev Display local devices
30 inq Inquire remote devices. For each discovered device, Bluetooth
32 device address, clock offset and class are printed.
33 scan Inquire remote devices. For each discovered device, device name
35 are printed.
36 name <bdaddr>
38 Print device name of remote device with Bluetooth address
39 bdaddr.
40 info <bdaddr>
42 Print device name, version and supported features of remote de‐
43 vice with Bluetooth address bdaddr.
44 spinq Start periodic inquiry process. No inquiry results are printed.
46 epinq Exit periodic inquiry process.
48 cmd <ogf> <ocf> [parameters]
50 Submit an arbitrary HCI command to local device. ogf, ocf and
51 parameters are hexadecimal bytes.
52 con Display active baseband connections
54 cc [--role=c|p] [--pkt-type=<ptype>] <bdaddr>
56 Create baseband connection to remote device with Bluetooth ad‐
57 dress bdaddr.
58 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 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 dc <bdaddr> [reason]
69 Delete baseband connection from remote device with Bluetooth ad‐
70 dress bdaddr.
71 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 sr <bdaddr> <role>
77 Switch role for the baseband connection from the remote device
78 to central or peripheral.
79 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 rssi <bdaddr>
87 Display received signal strength information for the connection
88 to the device with Bluetooth address bdaddr.
89 lq <bdaddr>
91 Display link quality for the connection to the device with Blue‐
92 tooth address bdaddr.
93 tpl <bdaddr> [type]
95 Display transmit power level for the connection to the device
96 with Bluetooth address bdaddr.
97 The type can be 0 for the current transmit power level (which is
99 default) or 1 for the maximum transmit power level.
100 afh <bdaddr>
102 Display AFH channel map for the connection to the device with
103 Bluetooth address bdaddr.
104 lp <bdaddr> [value]
106 With no value, displays link policy settings for the connection
107 to the device with Bluetooth address bdaddr.
108 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 lst <bdaddr> [value]
114 With no value, displays link supervision timeout for the connec‐
115 tion to the device with Bluetooth address bdaddr.
116 If value is given, sets the link supervision timeout for that
118 connection to value slots, or to infinite if value is 0.
119 auth <bdaddr>
121 Request authentication for the device with Bluetooth address
122 bdaddr.
123 enc <bdaddr> [encrypt]
125 enable or disable the encryption for the device with Bluetooth
126 address bdaddr.
127 key <bdaddr>
129 Change the connection link key for the device with Bluetooth ad‐
130 dress bdaddr.
131 clkoff <bdaddr>
133 Read the clock offset for the device with Bluetooth address
134 bdaddr.
135 clock [bdaddr] [clock]
137 Read the clock for the device with Bluetooth address bdaddr.
138 The clock can be 0 for the local clock or 1 for the piconet
140 clock (which is default).
141 lescan [--privacy] [--passive] [--acceptlist] [--discovery=g|l] [--du‐
143 plicates]
144 Start LE scan
145 leinfo [--static] [--random] <bdaddr>
147 Get LE remote information
148 lealadd [--random] <bdaddr>
150 Add device to LE Accept List
151 lealrm <bdaddr>
153 Remove device from LE Accept List
154 lealsz Read size of LE Accept List
156 lealclr
158 Clear LE Accept List
159 lerladd [--local_irk] [--peer_irk] [--random] <bdaddr>
161 Add device to LE Resolving List
162 lerlrm <bdaddr>
164 Remove device from LE Resolving List
165 lerlclr
167 Clear LE Resolving List
168 lerlsz Read size of LE Resolving List
170 lerlon Enable LE Address Resolution
172 lerloff
174 Disable LE Address Resolution
175 lecc [--static] [--random] <bdaddr> | [--acceptlist]
177 Create a LE Connection
178 ledc <handle> [reason]
180 Disconnect a LE Connection
181 lecup <handle> <min> <max> <latency> <timeout>
183 LE Connection Update
184
186 http://www.bluez.org
187
189 linux-bluetooth@vger.kernel.org
190
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).
198BlueZ Nov 12, 2002 HCITOOL(1)