summaryrefslogtreecommitdiffstats
path: root/tools/hciconfig.8
blob: 96990b06ac9e51e12db489d0366d1cc250e24536 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
.TH HCICONFIG 8 "Nov 11 2002" BlueZ "Linux System Administration"
.SH NAME
hciconfig \- configure Bluetooth devices
.SH SYNOPSIS
.B hciconfig -h
.br
.B hciconfig [-a]
.br
.B hciconfig [-a] <hciX> [command [command parameters]]

.SH DESCRIPTION
.LP
.B
hciconfig
is used to configure Bluetooth devices. <hciX> is the name of a Bluetooth
device installed in the system. If <hciX> is not given,
.B
hciconfig
prints name and basic information about all the Bluetooth devices installed in
the system. If <hciX> is given but no command is given,
it prints basic information on device <hciX> only. Basic information is 
interface type, BD address, ACL MTU, SCO MTU, flags (up, init, running, raw,
page scan enabled, inquiry scan enabled, inquiry, authentication enabled,
encryption enabled).
.SH OPTIONS
.TP
.BI -h
Gives a list of possible commands.
.TP
.BI -a
Other than the basic info, print features, packet type, link policy, link mode,
name, class, version.
.SH COMMANDS
.TP
.BI up
Open and initialize HCI device.
.TP
.BI down
Close HCI device.
.TP
.BI reset
Reset HCI device.
.TP
.BI rstat
Reset statistic counters.
.TP
.BI auth
Enable authentication (sets device to security mode 3).
.TP
.BI noauth
Disable authentication.
.TP
.BI encrypt
Enable encryption (sets device to security mode 3).
.TP
.BI noencrypt
Disable encryption.
.TP
.BI secmgr
Enable security manager (current kernel support is limited).
.TP
.BI nosecmgr
Disable security manager.
.TP
.BI piscan
Enable page and inquiry scan.
.TP
.BI noscan
Disable page and inquiry scan.
.TP
.BI iscan
Enable inquiry scan, disable page scan.
.TP
.BI pscan
Enable page scan, disable inquiry scan.
.TP
.BI ptype " [type]"
With no
.I
type
, displays the current packet types. Otherwise, all the packet types specified
by
.I
type
are set.
.I
type
is a comma-separated list of packet types, where the possible packet types are
.BR DM1 ,
.BR DM3 ,
.BR DM5 ,
.BR DH1 ,
.BR DH3 ,
.BR DH5 ,
.BR HV1 ,
.BR HV2 ,
.BR HV3 .
.TP
.BI name " [name]"
With no
.IR name ,
prints local name. Otherwise, sets local name to
.IR name .
.TP
.BI class " [class]"
With no
.IR class ,
prints class of device. Otherwise, sets class of device to
.IR class .
.I
class
is a 24-bit hex number describing the class of device, as specified in section
1.2 of the Bluetooth Assigned Numers document.
.TP
.BI voice " [voice]"
With no
.IR voice ,
prints voice setting. Otherwise, sets voice setting to
.IR voice .
.I
voice
is a 16-bit hex number describing the voice setting.
.TP
.BI iac " [iac]"
With no
.IR iac ,
prints the current IAC setting. Otherwise, sets the IAC to
.IR iac .
.TP
.BI inqmode " [mode]"
With no
.IR mode ,
prints out the current inquiry mode. Otherwise, sets inquiry mode to
.IR mode .
.TP
.BI inqdata " [data]"
With no
.IR name ,
prints out the current inquiry data. Otherwise, sets inquiry data to
.IR data .
.TP
.BI inqtype " [type]"
With no
.IR type ,
prints out the current inquiry scan type. Otherwise, sets inquiry scan type to
.IR type .
.TP
.BI inqparms " [win:int]"
With no
.IR win:int ,
prints inquiry scan window and interval. Otherwise, sets inquiry scan window
to
.I win
slots and inquiry scan interval to
.I int
slots.
.TP
.BI pageparms " [win:int]"
With no
.IR win:int ,
prints page scan window and interval. Otherwise, sets page scan window to
.I
win
slots and page scan interval to
.I 
int
slots.
.TP
.BI pageto " [to]"
With no
.IR to ,
prints page timeout. Otherwise, sets page timeout
to
.I
to
slots.
.TP
.BI afhmode " [mode]"
With no
.IR mode ,
prints out the current AFH mode. Otherwise, sets AFH mode to
.IR mode .
.TP
.BI aclmtu " <mtu:pkt>"
Sets ACL MTU to
to
.I
mtu
bytes and ACL buffer size to
.I
pkt
packets.
.TP
.BI scomtu " <mtu:pkt>"
Sets SCO MTU to
to
.I mtu
bytes and SCO buffer size to
.I pkt
packets.
.TP
.BI putkey " <bdaddr>"
This command stores the link key for
.I bdaddr
on the device.
.TP
.BI delkey " <bdaddr>"
This command deletes the stored link key for
.I bdaddr
from the device.
.TP
.BI commands
Display supported commands.
.TP
.BI features
Display device features.
.TP
.BI version
Display version information.
.TP
.BI revision
Display revision information.
.TP
.BI lm " [mode]"
With no
.I
mode
, prints link mode.
.B
MASTER
or
.B
SLAVE
mean, respectively, to ask to become master or to remain slave when a
connection request comes in. The additional keyword
.B
ACCEPT
means that baseband  connections will be accepted even if there are no
listening
.I AF_BLUETOOTH
sockets.
.I mode
is
.B
NONE
or a comma-separated list of keywords, where possible keywords are
.B 
MASTER
and
.B "ACCEPT" .
.B
NONE
sets link policy to the default behaviour of remaining slave and not accepting
baseband connections when there are no listening
.I AF_BLUETOOTH
sockets. If
.B
MASTER
is present, the device will ask to become master if a connection request comes
in. If
.B
ACCEPT
is present, the device will accept baseband connections even when there are no
listening
.I AF_BLUETOOTH
sockets.
.SH AUTHORS
Written by Maxim Krasnyansky <maxk@qualcomm.com> and Marcel Holtmann <marcel@holtmann.org>
.PP
man page by Fabrizio Gennari <fabrizio.gennari@philips.com>