NAME¶
hciconfig - configure Bluetooth devices
SYNOPSIS¶
hciconfig -h
hciconfig [
-a]
hciconfig [
-a]
hciX [
command [
command
parameters]]
DESCRIPTION¶
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.
- inqtpl [level]
- With no level, prints out the current inquiry
transmit power level. Otherwise, sets inquiry transmit power level to
level.
- 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.
- aclmtu mtu:pkt
- Sets ACL MTU to to mtu bytes and ACL buffer size to
pkt packets.
- scomtu mtu: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.
AUTHORS¶
Written by Maxim Krasnyansky <maxk@qualcomm.com> and Marcel Holtmann
<marcel@holtmann.org>
man page by Fabrizio Gennari <fabrizio.gennari@philips.com>