September 7, 2007 BTCONFIG 8

### NAME

btconfig - configure bluetooth devices

### SYNOPSIS

btconfig [-svz] [device [parameters]] btconfig [-l]

### DESCRIPTION

btconfig is used to configure Bluetooth devices. If the device is given, but no parameters, then btconfig will print information about the device. If no device is given, a basic list of devices will be printed.

When the -l flag is used, just the device names will be printed.

### COMMANDS

The following parameters may be specified with :

up
  Enable Bluetooth Device.

down
  Disable Bluetooth Device.

pscan
  Enable Page Scan. This enables incoming connections to the device.

-pscan
  Disable Page Scan.

iscan
  Enable Inquiry Scan. This puts the device in Discoverable mode.

-iscan
  Disable Inquiry Scan.

encrypt
  Enable encryption. This will cause the device to request encryption on all baseband connections, and will only work if authentication is also enabled.

-encrypt
  Disable encryption.

auth
  Enable authentication. This will cause the device to request authentication for all baseband connections.

-auth
  Disable authentication.

switch
  Enable Role Switching.

-switch
  Disable Role Switching.

hold
  Enable Hold Mode.

-hold
  Disable Hold Mode.

sniff
  Enable Sniff Mode.

-sniff
  Disable Sniff Mode.

park
  Enable Park Mode.

-park
  Disable Park Mode.

name name
  Set human readable name of device.

ptype type
  Set packet types. type is a 16 bit hex value specifying packet types that will be requested by outgoing ACL connections. By default, all packet types that the device supports are enabled, see bluetooth specifications for more information if you want to change this.

class class
  Set class of device. class is a 3 byte hex value the value of which declares the device capabilities. See Bluetooth Assigned Numbers documents at ```https://www.bluetooth.org/` for details of constructing a "Class of Device" value. As a starter, 0x020104 means Desktop Computer, with Networking available.

fixed
  Set fixed pin type.

variable
  Set variable pin type.

inquiry
  Perform device Discovery from the specified device and print details.

rssi
  Enable Remote Signal Strength Indicator (RSSI) in inquiry results. This will only work if the device features indicate <RSSI with inquiry result>.

-rssi
  Disable Remote Signal Strength Indicator (RSSI) in inquiry results.

reset
  Perform a hard reset on the device and re-initialise system state.

voice
  Set Voice Setting. [This should be 0x0060 for now]

pto
  Set Page Timeout value. This is a decimal value in milliseconds.

scomtu
  Change SCO mtu value. This is a decimal value, see ubt(4) for reasons why you may need to do this.

All parameters are parsed before any device operations take place. Each time the -v flag is given, verbosity levels will be increased.

Super-user privileges are required to change device configurations.

### DIAGNOSTICS

Messages indicating the specified device does not exist, the requested address is unknown, or the user is not privileged and tried to alter an device's configuration.

### SEE ALSO

bluetooth(4), bt3c(4), btuart(4), ubt(4)

### HISTORY

The btconfig command was written for NetBSD4.0 by Iain Hibbert
under the sponsorship of Itronix, Inc.

### BUGS

The output is very messy.