Provided by: bluez_5.68-0ubuntu1.1_amd64 bug

NAME

       hciconfig - Configure Bluetooth devices

SYNOPSIS

       hciconfig -h

       hciconfig [-a]

       hciconfig [-a] hciX [COMMAND [PARAMETERS]]

DESCRIPTION

       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

       -a, --all
              Print features, packet type, link policy, link mode, class, Version other than  the
              basic info.

       -h, --help
              Show help options

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.

                                   ┌─────┬──────────────────────────────────┐
                                   │mode │ Description                      │
                                   ├─────┼──────────────────────────────────┤
                                   │0    │ Standard Inquiry                 │
                                   ├─────┼──────────────────────────────────┤
                                   │1    │ Inquiry with RSSI                │
                                   ├─────┼──────────────────────────────────┤
                                   │2    │ Inquiry with  RSSI  or  Extended │
                                   │     │ Inquiry                          │
                                   └─────┴──────────────────────────────────┘

       inqdata [data]
              With  no data, 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 to slots.

       afhmode [mode]
              With no mode, prints out the current AFH mode. Otherwise, sets AFH mode to mode.

                                          ┌─────┬─────────────┐
                                          │mode │ Description │
                                          ├─────┼─────────────┤
                                          │0    │ Enable      │
                                          ├─────┼─────────────┤
                                          │1    │ Disable     │
                                          └─────┴─────────────┘

       sspmode [mode]
              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
              Sets ACL MTU 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.

       delkey <bdaddr>
              This command deletes the stored link key for bdaddr from the device.

       oobdata
              Get local OOB data (invalidates previously read 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. 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>
              Add a device to the reject list

       unblock <bdaddr>
              Remove a device from the reject list

       lerandaddr <bdaddr>
              Set LE Random Address

       leadv [type]
              Enable LE Advertising.

                               ┌─────┬──────────────────────────────────┐
                               │type │ Description                      │
                               ├─────┼──────────────────────────────────┤
                               │0    │ Connectable           undirected │
                               │     │ advertising (default)            │
                               ├─────┼──────────────────────────────────┤
                               │3    │ Non    connectable    undirected │
                               │     │ advertising                      │
                               └─────┴──────────────────────────────────┘

       noleadv
              Disable LE Advertising

       lestates
              Display the supported LE states

RESOURCES

       http://www.bluez.org

REPORTING BUGS

       linux-bluetooth@vger.kernel.org

AUTHOR

       Maxim  Krasnyansky  <maxk@qualcomm.com>,  Marcel  Holtmann <marcel@holtmann.org>, Fabrizio
       Gennari <fabrizio.gennari@philips.com>

COPYRIGHT

       Free use of this software is granted under ther terms of the  GNU  Lesser  General  Public
       Licenses (LGPL).