1HCICONFIG(1) Linux System Administration HCICONFIG(1)
2
6 hciconfig - Configure Bluetooth devices
7
9 hciconfig -h
10 hciconfig [-a]
12 hciconfig [-a] hciX [COMMAND [PARAMETERS]]
14
16 hciconfig(1) is used to configure Bluetooth devices. hciX is the name
17 of a Bluetooth device installed in the system. If hciX is not given,
18 hciconfig prints name and basic information about all the Bluetooth de‐
19 vices installed in the system.
20 If hciX is given but no command is given, it prints basic information
22 on device hciX only. Basic information is interface type, BD address,
23 ACL MTU, SCO MTU, flags (up, init, running, raw, page scan enabled, in‐
24 quiry scan enabled, inquiry, authentication enabled, encryption en‐
25 abled).
26
28 -a, --all
29 Print features, packet type, link policy, link mode, class, Ver‐
30 sion other than the basic info.
31 -h, --help
33 Show help options
34
36 up Open and initialize HCI device.
37 down Close HCI device.
39 reset Reset HCI device.
41 rstat Reset statistic counters.
43 auth Enable authentication (sets device to security mode 3).
45 noauth Disable authentication.
47 encrypt
49 Enable encryption (sets device to security mode 3).
50 noencrypt
52 Disable encryption.
53 secmgr Enable security manager (current kernel support is limited).
55 nosecmgr
57 Disable security manager.
58 piscan Enable page and inquiry scan.
60 noscan Disable page and inquiry scan.
62 iscan Enable inquiry scan, disable page scan.
64 pscan Enable page scan, disable inquiry scan.
66 ptype [type]
68 With no type , displays the current packet types. Otherwise,
69 all the packet types specified by type are set. type is a
70 comma-separated list of packet types, where the possible packet
71 types are DM1, DM3, DM5, DH1, DH3, DH5, HV1, HV2, HV3.
72 name [name]
74 With no name, prints local name. Otherwise, sets local name to
75 name.
76 class [class]
78 With no class, prints class of device. Otherwise, sets class of
79 device to class. class is a 24-bit hex number describing the
80 class of device, as specified in section 1.2 of the Bluetooth
81 Assigned Numers document.
82 voice [voice]
84 With no voice, prints voice setting. Otherwise, sets voice set‐
85 ting to voice. voice is a 16-bit hex number describing the voice
86 setting.
87 iac [iac]
89 With no iac, prints the current IAC setting. Otherwise, sets the
90 IAC to iac.
91 inqtpl [level]
93 With no level, prints out the current inquiry transmit power
94 level. Otherwise, sets inquiry transmit power level to level.
95 inqmode [mode]
97 With no mode, prints out the current inquiry mode. Otherwise,
98 sets inquiry mode to mode.
99 ┌─────┬────────────────────────────┐
101 │mode │ Description │
102 ├─────┼────────────────────────────┤
103 │0 │ Standard Inquiry │
104 ├─────┼────────────────────────────┤
105 │1 │ Inquiry with RSSI │
106 ├─────┼────────────────────────────┤
107 │2 │ Inquiry with RSSI or Ex‐ │
108 │ │ tended Inquiry │
109 └─────┴────────────────────────────┘
110 inqdata [data]
112 With no data, prints out the current inquiry data. Otherwise,
113 sets inquiry data to data.
114 inqtype [type]
116 With no type, prints out the current inquiry scan type. Other‐
117 wise, sets inquiry scan type to type.
118 inqparams [win:int]
120 With no win:int, prints inquiry scan window and interval. Other‐
121 wise, sets inquiry scan window to win slots and inquiry scan
122 interval to int slots.
123 pageparms [win:int]
125 With no win:int, prints page scan window and interval. Other‐
126 wise, sets page scan window to win slots and page scan interval
127 to int slots.
128 pageto [to]
130 With no to, prints page timeout. Otherwise, sets page timeout to
131 to slots.
132 afhmode [mode]
134 With no mode, prints out the current AFH mode. Otherwise, sets
135 AFH mode to mode.
136 ┌─────┬─────────────┐
138 │mode │ Description │
139 ├─────┼─────────────┤
140 │0 │ Enable │
141 ├─────┼─────────────┤
142 │1 │ Disable │
143 └─────┴─────────────┘
144 sspmode [mode]
146 With no mode, prints out the current Simple Pairing mode. Other‐
147 wise, sets Simple Pairing mode to mode.
148 ┌─────┬─────────────┐
150 │mode │ Description │
151 ├─────┼─────────────┤
152 │0 │ Enable │
153 ├─────┼─────────────┤
154 │1 │ Disable │
155 └─────┴─────────────┘
156 aclmtu mtu:pkt
158 Sets ACL MTU to mtu bytes and ACL buffer size to pkt packets.
159 scomtu mtu:pkt
161 Sets SCO MTU to mtu bytes and SCO buffer size to pkt packets.
162 delkey <bdaddr>
164 This command deletes the stored link key for bdaddr from the de‐
165 vice.
166 oobdata
168 Get local OOB data (invalidates previously read data).
169 commands
171 Display supported commands.
172 features
174 Display device features.
175 version
177 Display version information.
178 revision
180 Display revision information.
181 lm [mode]
183 With no mode, prints link mode. CENTRAL or PERIPHERAL mean, re‐
184 spectively, to ask to become central or to remain peripheral
185 when a connection request comes in. The additional keyword AC‐
186 CEPT means that baseband connections will be accepted even if
187 there are no listening AF_BLUETOOTH sockets. mode is NONE or a
188 comma-separated list of keywords, where possible keywords are
189 CENTRAL and ACCEPT. NONE sets link policy to the default behav‐
190 iour of remaining peripheral and not accepting baseband connec‐
191 tions when there are no listening AF_BLUETOOTH sockets. If CEN‐
192 TRAL is present, the device will ask to become central if a
193 connection request comes in. If ACCEPT is present, the device
194 will accept baseband connections even when there are no listen‐
195 ing AF_BLUETOOTH sockets.
196 block <bdaddr>
198 Add a device to the reject list
199 unblock <bdaddr>
201 Remove a device from the reject list
202 lerandaddr <bdaddr>
204 Set LE Random Address
205 leadv [type]
207 Enable LE Advertising.
208 ┌─────┬────────────────────────────┐
210 │type │ Description │
211 ├─────┼────────────────────────────┤
212 │0 │ Connectable undirected ad‐ │
213 │ │ vertising (default) │
214 ├─────┼────────────────────────────┤
215 │3 │ Non connectable undirected │
216 │ │ advertising │
217 └─────┴────────────────────────────┘
218 noleadv
220 Disable LE Advertising
221 lestates
223 Display the supported LE states
224
226 http://www.bluez.org
227
229 linux-bluetooth@vger.kernel.org
230
232 Maxim Krasnyansky <maxk@qualcomm.com>, Marcel Holtmann <marcel@holt‐
233 mann.org>, Fabrizio Gennari <fabrizio.gennari@philips.com>
234
236 Free use of this software is granted under ther terms of the GNU Lesser
237 General Public Licenses (LGPL).
238BlueZ Nov 11, 2002 HCICONFIG(1)