1HCICONFIG(8) Linux System Administration HCICONFIG(8)
2
6 hciconfig - configure Bluetooth devices
7
9 hciconfig -h
10 hciconfig [-a]
11 hciconfig [-a] hciX [command [command parameters]]
12
15 hciconfig is used to configure Bluetooth devices. hciX is the name of
16 a Bluetooth device installed in the system. If hciX is not given, hci‐
17 config prints name and basic information about all the Bluetooth
18 devices installed in the system. If hciX is given but no command is
19 given, it prints basic information on device hciX only. Basic informa‐
20 tion is interface type, BD address, ACL MTU, SCO MTU, flags (up, init,
21 running, raw, page scan enabled, inquiry scan enabled, inquiry, authen‐
22 tication enabled, encryption enabled).
23
25 -h, --help
26 Gives a list of possible commands.
27 -a, --all
29 Other than the basic info, print features, packet type, link
30 policy, link mode, name, class, version.
31
33 up Open and initialize HCI device.
34 down Close HCI device.
36 reset Reset HCI device.
38 rstat Reset statistic counters.
40 auth Enable authentication (sets device to security mode 3).
42 noauth Disable authentication.
44 encrypt
46 Enable encryption (sets device to security mode 3).
47 noencrypt
49 Disable encryption.
50 secmgr Enable security manager (current kernel support is limited).
52 nosecmgr
54 Disable security manager.
55 piscan Enable page and inquiry scan.
57 noscan Disable page and inquiry scan.
59 iscan Enable inquiry scan, disable page scan.
61 pscan Enable page scan, disable inquiry scan.
63 ptype [type]
65 With no type , displays the current packet types. Otherwise, all
66 the packet types specified by type are set. type is a comma-
67 separated list of packet types, where the possible packet types
68 are DM1, DM3, DM5, DH1, DH3, DH5, HV1, HV2, HV3.
69 name [name]
71 With no name, prints local name. Otherwise, sets local name to
72 name.
73 class [class]
75 With no class, prints class of device. Otherwise, sets class of
76 device to class. class is a 24-bit hex number describing the
77 class of device, as specified in section 1.2 of the Bluetooth
78 Assigned Numers document.
79 voice [voice]
81 With no voice, prints voice setting. Otherwise, sets voice set‐
82 ting to voice. voice is a 16-bit hex number describing the
83 voice setting.
84 iac [iac]
86 With no iac, prints the current IAC setting. Otherwise, sets the
87 IAC to iac.
88 inqtpl [level]
90 With no level, prints out the current inquiry transmit power
91 level. Otherwise, sets inquiry transmit power level to level.
92 inqmode [mode]
94 With no mode, prints out the current inquiry mode. Otherwise,
95 sets inquiry mode to mode.
96 inqdata [data]
98 With no name, prints out the current inquiry data. Otherwise,
99 sets inquiry data to data.
100 inqtype [type]
102 With no type, prints out the current inquiry scan type. Other‐
103 wise, sets inquiry scan type to type.
104 inqparams [win:int]
106 With no win:int, prints inquiry scan window and interval. Other‐
107 wise, sets inquiry scan window to win slots and inquiry scan
108 interval to int slots.
109 pageparms [win:int]
111 With no win:int, prints page scan window and interval. Other‐
112 wise, sets page scan window to win slots and page scan interval
113 to int slots.
114 pageto [to]
116 With no to, prints page timeout. Otherwise, sets page timeout to
117 .I to slots.
118 afhmode [mode]
120 With no mode, prints out the current AFH mode. Otherwise, sets
121 AFH mode to mode.
122 sspmode [mode]
124 With no mode, prints out the current Simple Pairing mode. Other‐
125 wise, sets Simple Pairing mode to mode.
126 aclmtu mtu:pkt
128 Sets ACL MTU to to mtu bytes and ACL buffer size to pkt packets.
129 scomtu mtu:pkt
131 Sets SCO MTU to mtu bytes and SCO buffer size to pkt packets.
132 putkey <bdaddr>
134 This command stores the link key for bdaddr on the device.
135 delkey <bdaddr>
137 This command deletes the stored link key for bdaddr from the
138 device.
139 oobdata
141 Display local OOB data.
142 commands
144 Display supported commands.
145 features
147 Display device features.
148 version
150 Display version information.
151 revision
153 Display revision information.
154 lm [mode]
156 With no mode , prints link mode. MASTER or SLAVE mean, respec‐
157 tively, to ask to become master or to remain slave when a con‐
158 nection request comes in. The additional keyword ACCEPT means
159 that baseband connections will be accepted even if there are no
160 listening AF_BLUETOOTH sockets. mode is NONE or a comma-sepa‐
161 rated list of keywords, where possible keywords are MASTER and
162 ACCEPT . NONE sets link policy to the default behaviour of
163 remaining slave and not accepting baseband connections when
164 there are no listening AF_BLUETOOTH sockets. If MASTER is
165 present, the device will ask to become master if a connection
166 request comes in. If ACCEPT is present, the device will accept
167 baseband connections even when there are no listening AF_BLUE‐
168 TOOTH sockets.
169
171 Written by Maxim Krasnyansky <maxk@qualcomm.com> and Marcel Holtmann
172 <marcel@holtmann.org>
173 man page by Fabrizio Gennari <fabrizio.gennari@philips.com>
175BlueZ Nov 11 2002 HCICONFIG(8)