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.