hciconfig(1) Linux System Administration hciconfig(1) # [Name](#Name) hciconfig - Configure Bluetooth devices # [SYNOPSIS](#SYNOPSIS) **hciconfig** -h **hciconfig** \[-a] **hciconfig** \[-a] *hciX* \[*COMMAND* \[*PARAMETERS*]] # [DESCRIPTION](#DESCRIPTION) [**hciconfig(1)**](/man/os/bluez/hciconfig.1) 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](#OPTIONS) [**-a*,* --all**](#a) Print features, packet type, link policy, link mode, class, Version other than the basic info. [**-h, --help**](#h) Show help options # [COMMANDS](#COMMANDS) [**up**](#up) Open and initialize HCI device. [**down**](#down) Close HCI device. [**reset**](#reset) Reset HCI device. [**rstat**](#rstat) Reset statistic counters. [**auth**](#auth) Enable authentication (sets device to security mode 3). [**noauth**](#noauth) Disable authentication. [**encrypt**](#encrypt) Enable encryption (sets device to security mode 3). [**noencrypt**](#noencrypt) Disable encryption. [**secmgr**](#secmgr) Enable security manager (current kernel support is limited). [**nosecmgr**](#nosecmgr) Disable security manager. [**piscan**](#piscan) Enable page and inquiry scan. [**noscan**](#noscan) Disable page and inquiry scan. [**iscan**](#iscan) Enable inquiry scan, disable page scan. [**pscan**](#pscan) Enable page scan, disable inquiry scan. [**ptype \[*type*\]**](#ptype) 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*\]**](#name) With no *name*, prints local name. Otherwise, sets local name to *name*. [**class \[*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 Numbers document. [**voice \[*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*\]**](#iac) With no *iac*, prints the current IAC setting. Otherwise, sets the IAC to *iac*. [**inqtpl \[*level*\]**](#inqtpl) With no *level*, prints out the current inquiry transmit power level. Otherwise, sets inquiry transmit power level to *level*. [**inqmode \[*mode*\]**](#inqmode) With no *mode*, prints out the current inquiry mode. Otherwise, sets inquiry mode to *mode*. *mode* Description 0 Standard Inquiry 1 Inquiry with RSSI 2 Inquiry with RSSI or Extended Inquiry [**inqdata \[*data*\]**](#inqdata) With no *data*, prints out the current inquiry data. Otherwise, sets inquiry data to *data*. [**inqtype \[*type*\]**](#inqtype) With no *type*, prints out the current inquiry scan type. Otherwise, sets inquiry scan type to *type*. [**inqparams \[*win:int*\]**](#inqparams) 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*\]**](#pageparms) 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*\]**](#pageto) With no *to*, prints page timeout. Otherwise, sets page timeout *to* to slots. [**afhmode \[*mode*\]**](#afhmode) With no *mode*, prints out the current AFH mode. Otherwise, sets AFH mode to *mode*. *mode* Description 0 Enable 1 Disable [**sspmode \[*mode*\]**](#sspmode) With no *mode*, prints out the current Simple Pairing mode. Otherwise, sets Simple Pairing mode to *mode*. *mode* Description 0 Enable 1 Disable [**aclmtu *mtu:pkt***](#aclmtu) Sets ACL MTU to *mtu* bytes and ACL buffer size to *pkt* packets. [**scomtu *mtu:pkt***](#scomtu) Sets SCO MTU to *mtu* bytes and SCO buffer size to *pkt* packets. [**delkey <*bdaddr*>**](#delkey) This command deletes the stored link key for *bdaddr* from the device. [**oobdata**](#oobdata) Get local OOB data (invalidates previously read data). [**commands**](#commands) Display supported commands. [**features**](#features) Display device features. [**version**](#version) Display version information. [**revision**](#revision) Display revision information. [**lm \[*mode*\]**](#lm) With no *mode*, prints link mode. **CENTRAL** or **PERIPHERAL** mean, respectively, to ask to become central or to remain peripheral 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 **CENTRAL** and **ACCEPT**. **NONE** sets link policy to the default behaviour of remaining peripheral and not accepting baseband connections when there are no listening *AF\_BLUETOOTH* sockets. If **CENTRAL** is present, the device will ask to become central 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. [**block <*bdaddr*>**](#block) Add a device to the reject list [**unblock <*bdaddr*>**](#unblock) Remove a device from the reject list [**lerandaddr <*bdaddr*>**](#lerandaddr) Set LE Random Address [**leadv \[*type*\]**](#leadv) Enable LE Advertising. *type* Description 0 Connectable undirected advertising (default) 3 Non connectable undirected advertising [**noleadv**](#noleadv) Disable LE Advertising [**lestates**](#lestates) Display the supported LE states # [RESOURCES](#RESOURCES) <http://www.bluez.org> # [REPORTING BUGS](#REPORTING_BUGS) <linux-bluetooth@vger.kernel.org> # [Author](#Author) Maxim Krasnyansky <maxk@qualcomm.com>, Marcel Holtmann <marcel@holtmann.org>, Fabrizio Gennari <fabrizio.gennari@philips.com> # [Copyright](#Copyright) Free use of this software is granted under the terms of the GNU Lesser General Public Licenses (LGPL). November 11, 2002 BlueZ --- Document: hciconfig(1) from bluez 5.87-r4 (Chainguard OS) Source: https://github.com/bluez/bluez