Learn the UNIX/Linux command line
Home Man Pages
HCICONFIG(8) Linux System Administration HCICONFIG(8)
NAME
hciconfig - configure Bluetooth devices
SYNOPSIS
hciconfig -h
hciconfig [-a]
hciconfig [-a] [command [command parameters]]
DESCRIPTION
hciconfig is used to configure Bluetooth devices. is the name
of a Bluetooth device installed in the system. If is not given,
hciconfig prints name and basic information about all the Bluetooth
devices installed in the system. If is given but no command is
given, it prints basic information on device only. Basic infor-
mation 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 Gives a list of possible commands
-a 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
noauth Disable authentication
encrypt
Enable encryption
noencrypt
Disable encryption
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 set-
ting 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.
inqparms [win:int]
With no win:int, prints inquiry scan window and interval. Oth-
erwise, 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. Other-
wise, 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 to slots.
afhmode [mode]
With no mode, prints out the current AFH mode. Otherwise, sets
AFH mode to mode.
aclmtu
Sets ACL MTU to to mtu bytes and ACL buffer size to pkt pack-
ets.
scomtu
Sets SCO MTU to to mtu bytes and SCO buffer size to pkt pack-
ets.
features
Display device features
version
Display version information
revision
Display revision information
lm [mode]
With no mode , prints link mode. MASTER or SLAVE mean, respec-
tively, to ask to become master or to remain slave when a con-
nection 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_BLUE-
TOOTH sockets
AUTHORS
Written by Maxim Krasnyansky
man page by Fabrizio Gennari
BlueZ Nov 11 2002 HCICONFIG(8)
UNIX/Linux commands referenced on this page: