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.  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 <maxkATqualcomm.com> and Marcel Holtmann <marcelATholtmann.org>

       man page by Fabrizio Gennari <fabrizio.gennariATphilips.com>



BlueZ                                                      Nov 11 2002                                              HCICONFIG(8)