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

NAME

6       hciconfig - Configure Bluetooth devices
7

SYNOPSIS

9       hciconfig -h
10
11       hciconfig [-a]
12
13       hciconfig [-a] hciX [COMMAND [PARAMETERS]]
14

DESCRIPTION

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
21       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

OPTIONS

28       -a, --all
29              Print features, packet type, link policy, link mode, class, Ver‐
30              sion other than the basic info.
31
32       -h, --help
33              Show help options
34

COMMANDS

36       up     Open and initialize HCI device.
37
38       down   Close HCI device.
39
40       reset  Reset HCI device.
41
42       rstat  Reset statistic counters.
43
44       auth   Enable authentication (sets device to security mode 3).
45
46       noauth Disable authentication.
47
48       encrypt
49              Enable encryption (sets device to security mode 3).
50
51       noencrypt
52              Disable encryption.
53
54       secmgr Enable security manager (current kernel support is limited).
55
56       nosecmgr
57              Disable security manager.
58
59       piscan Enable page and inquiry scan.
60
61       noscan Disable page and inquiry scan.
62
63       iscan  Enable inquiry scan, disable page scan.
64
65       pscan  Enable page scan, disable inquiry scan.
66
67       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
73       name [name]
74              With no name, prints local name. Otherwise, sets local  name  to
75              name.
76
77       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
83       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
88       iac [iac]
89              With no iac, prints the current IAC setting. Otherwise, sets the
90              IAC to iac.
91
92       inqtpl [level]
93              With  no  level,  prints  out the current inquiry transmit power
94              level.  Otherwise, sets inquiry transmit power level to level.
95
96       inqmode [mode]
97                 With no mode, prints out the current inquiry mode. Otherwise,
98                 sets inquiry mode to mode.
99
100                            ┌─────┬────────────────────────────┐
101mode │ 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
111       inqdata [data]
112              With no data, prints out the current  inquiry  data.  Otherwise,
113              sets inquiry data to data.
114
115       inqtype [type]
116              With  no  type, prints out the current inquiry scan type. Other‐
117              wise, sets inquiry scan type to type.
118
119       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
124       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
129       pageto [to]
130              With no to, prints page timeout. Otherwise, sets page timeout to
131              to slots.
132
133       afhmode [mode]
134              With  no  mode, prints out the current AFH mode. Otherwise, sets
135              AFH mode to mode.
136
137                                ┌─────┬─────────────┐
138mode │ Description │
139                                ├─────┼─────────────┤
140                                │0    │ Enable      │
141                                ├─────┼─────────────┤
142                                │1    │ Disable     │
143                                └─────┴─────────────┘
144
145       sspmode [mode]
146              With no mode, prints out the current Simple Pairing mode. Other‐
147              wise, sets Simple Pairing mode to mode.
148
149                                ┌─────┬─────────────┐
150mode │ Description │
151                                ├─────┼─────────────┤
152                                │0    │ Enable      │
153                                ├─────┼─────────────┤
154                                │1    │ Disable     │
155                                └─────┴─────────────┘
156
157       aclmtu mtu:pkt
158              Sets ACL MTU to mtu bytes and ACL buffer size to pkt packets.
159
160       scomtu mtu:pkt
161              Sets SCO MTU to mtu bytes and SCO buffer size to pkt packets.
162
163       delkey <bdaddr>
164              This command deletes the stored link key for bdaddr from the de‐
165              vice.
166
167       oobdata
168              Get local OOB data (invalidates previously read data).
169
170       commands
171              Display supported commands.
172
173       features
174              Display device features.
175
176       version
177              Display version information.
178
179       revision
180              Display revision information.
181
182       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
197       block <bdaddr>
198              Add a device to the reject list
199
200       unblock <bdaddr>
201              Remove a device from the reject list
202
203       lerandaddr <bdaddr>
204              Set LE Random Address
205
206       leadv [type]
207              Enable LE Advertising.
208
209                         ┌─────┬────────────────────────────┐
210type │ Description                │
211                         ├─────┼────────────────────────────┤
212                         │0    │ Connectable undirected ad‐ │
213                         │     │ vertising (default)        │
214                         ├─────┼────────────────────────────┤
215                         │3    │ Non connectable undirected │
216                         │     │ advertising                │
217                         └─────┴────────────────────────────┘
218
219       noleadv
220              Disable LE Advertising
221
222       lestates
223              Display the supported LE states
224

RESOURCES

226       http://www.bluez.org
227

REPORTING BUGS

229       linux-bluetooth@vger.kernel.org
230

AUTHOR

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).
238
239
240
241
242BlueZ                            Nov 11, 2002                     HCICONFIG(1)
Impressum