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

NAME

6       hciconfig - configure Bluetooth devices
7

SYNOPSIS

9       hciconfig -h
10       hciconfig [-a]
11       hciconfig [-a] hciX [command [command parameters]]
12
13

DESCRIPTION

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

OPTIONS

25       -h, --help
26              Gives a list of possible commands.
27
28       -a, --all
29              Other than the basic info, print  features,  packet  type,  link
30              policy, link mode, name, class, version.
31

COMMANDS

33       up     Open and initialize HCI device.
34
35       down   Close HCI device.
36
37       reset  Reset HCI device.
38
39       rstat  Reset statistic counters.
40
41       auth   Enable authentication (sets device to security mode 3).
42
43       noauth Disable authentication.
44
45       encrypt
46              Enable encryption (sets device to security mode 3).
47
48       noencrypt
49              Disable encryption.
50
51       secmgr Enable security manager (current kernel support is limited).
52
53       nosecmgr
54              Disable security manager.
55
56       piscan Enable page and inquiry scan.
57
58       noscan Disable page and inquiry scan.
59
60       iscan  Enable inquiry scan, disable page scan.
61
62       pscan  Enable page scan, disable inquiry scan.
63
64       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
70       name [name]
71              With no name, prints local name. Otherwise, sets local  name  to
72              name.
73
74       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
80       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
85       iac [iac]
86              With no iac, prints the current IAC setting. Otherwise, sets the
87              IAC to iac.
88
89       inqtpl [level]
90              With  no  level,  prints  out the current inquiry transmit power
91              level. Otherwise, sets inquiry transmit power level to level.
92
93       inqmode [mode]
94              With no mode, prints out the current  inquiry  mode.  Otherwise,
95              sets inquiry mode to mode.
96
97       inqdata [data]
98              With  no  name,  prints out the current inquiry data. Otherwise,
99              sets inquiry data to data.
100
101       inqtype [type]
102              With no type, prints out the current inquiry scan  type.  Other‐
103              wise, sets inquiry scan type to type.
104
105       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
110       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
115       pageto [to]
116              With no to, prints page timeout. Otherwise, sets page timeout to
117              .I to slots.
118
119       afhmode [mode]
120              With no mode, prints out the current AFH mode.  Otherwise,  sets
121              AFH mode to mode.
122
123       sspmode [mode]
124              With no mode, prints out the current Simple Pairing mode. Other‐
125              wise, sets Simple Pairing mode to mode.
126
127       aclmtu mtu:pkt
128              Sets ACL MTU to to mtu bytes and ACL buffer size to pkt packets.
129
130       scomtu mtu:pkt
131              Sets SCO MTU to mtu bytes and SCO buffer size to pkt packets.
132
133       putkey <bdaddr>
134              This command stores the link key for bdaddr on the device.
135
136       delkey <bdaddr>
137              This command deletes the stored link key  for  bdaddr  from  the
138              device.
139
140       oobdata
141              Display local OOB data.
142
143       commands
144              Display supported commands.
145
146       features
147              Display device features.
148
149       version
150              Display version information.
151
152       revision
153              Display revision information.
154
155       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

AUTHORS

171       Written  by  Maxim  Krasnyansky <maxk@qualcomm.com> and Marcel Holtmann
172       <marcel@holtmann.org>
173
174       man page by Fabrizio Gennari <fabrizio.gennari@philips.com>
175
176
177
178BlueZ                             Nov 11 2002                     HCICONFIG(8)
Impressum