hciconfig
is used to configure Bluetooth devices.
hciX
is the name of a Bluetooth device installed in the system. If
hciX
is not given,
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).
OPTIONS
-h, --help
Gives a list of possible commands.
-a, --all
Other than the basic info, print features, packet type, link policy, link mode,
name, class, version.
COMMANDS
up
Open and initialize HCI device.
down
Close HCI device.
reset
Reset HCI device.
rstat
Reset statistic counters.
auth
Enable authentication (sets device to security mode 3).
noauth
Disable authentication.
encrypt
Enable encryption (sets device to security mode 3).
noencrypt
Disable encryption.
secmgr
Enable security manager (current kernel support is limited).
nosecmgr
Disable security manager.
piscan
Enable page and inquiry scan.
noscan
Disable page and inquiry scan.
iscan
Enable inquiry scan, disable page scan.
pscan
Enable page scan, disable inquiry scan.
ptype [type]
With no
type
, displays the current packet types. Otherwise, all the packet types specified
by
type
are set.
type
is a comma-separated list of packet types, where the possible packet types are
DM1,
DM3,
DM5,
DH1,
DH3,
DH5,
HV1,
HV2,
HV3.
name [name]
With no
name,
prints local name. Otherwise, sets local name to
name.
class [class]
With no
class,
prints class of device. Otherwise, sets class of device to
class.
class
is a 24-bit hex number describing the class of device, as specified in section
1.2 of the Bluetooth Assigned Numers document.
voice [voice]
With no
voice,
prints voice setting. Otherwise, sets voice setting to
voice.
voice
is a 16-bit hex number describing the voice setting.
iac [iac]
With no
iac,
prints the current IAC setting. Otherwise, sets the IAC to
iac.
inqmode [mode]
With no
mode,
prints out the current inquiry mode. Otherwise, sets inquiry mode to
mode.
inqdata [data]
With no
name,
prints out the current inquiry data. Otherwise, sets inquiry data to
data.
inqtype [type]
With no
type,
prints out the current inquiry scan type. Otherwise, sets inquiry scan type to
type.
inqparams [win:int]
With no
win:int,
prints inquiry scan window and interval. Otherwise, sets inquiry scan window
to
win
slots and inquiry scan interval to
int
slots.
pageparms [win:int]
With no
win:int,
prints page scan window and interval. Otherwise, sets page scan window to
win
slots and page scan interval to
int
slots.
pageto [to]
With no
to,
prints page timeout. Otherwise, sets page timeout
to .I
to
slots.
afhmode [mode]
With no
mode,
prints out the current AFH mode. Otherwise, sets AFH mode to
mode.
sspmode [mode]
With no
mode,
prints out the current Simple Pairing mode. Otherwise, sets Simple Pairing mode to
mode.
aclmtumtu:pkt
Sets ACL MTU to
to
mtu
bytes and ACL buffer size to
pkt
packets.
scomtumtu:pkt
Sets SCO MTU to
mtu
bytes and SCO buffer size to
pkt
packets.
putkey <bdaddr>
This command stores the link key for
bdaddr
on the device.
delkey <bdaddr>
This command deletes the stored link key for
bdaddr
from the device.
oobdata
Display local OOB data.
commands
Display supported commands.
features
Display device features.
version
Display version information.
revision
Display revision information.
lm [mode]
With no
mode
, prints link mode.
MASTER
or
SLAVE
mean, respectively, to ask to become master or to remain slave when a
connection request comes in. The additional keyword
ACCEPT
means that baseband connections will be accepted even if there are no
listening
AF_BLUETOOTH
sockets.
mode
is
NONE
or a comma-separated list of keywords, where possible keywords are
MASTER
and
ACCEPT .NONE
sets link policy to the default behaviour of remaining slave and not accepting
baseband connections when there are no listening
AF_BLUETOOTH
sockets. If
MASTER
is present, the device will ask to become master if a connection request comes
in. If
ACCEPT
is present, the device will accept baseband connections even when there are no
listening
AF_BLUETOOTH
sockets.
