---
name: "hciconfig"
section: "8"
platform: "linux"
package: "bluez"
version: "4.99-2"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/hciconfig/8"
---

# hciconfig(8)

configure Bluetooth devices

## 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\>