HCICONFIG

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: 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 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.
inqparms [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 to slots.
afhmode [mode]: With no mode, prints out the current AFH mode. Otherwise, sets AFH 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 to mtu bytes and SCO buffer size to pkt packets.
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>

man page by Fabrizio Gennari <fabrizio.gennari@philips.com>