NAME
btconfig —
configure bluetooth
devices
SYNOPSIS
btconfig |
[-svz]
[device
[parameters]] |
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
btconfig:
-
-
- 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. In a Bluetooth piconet there is one
Master and up to seven Slaves, and normally the device that initiates a
connection will take the Master role. Enabling this option allows remote
devices to switch connection roles.
-
-
- -switch
- Disable Role Switching.
-
-
- master
- Request the Master role when accepting connections.
-
-
- -master
- Do not request Master role.
-
-
- 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 6
digit hex value the value of which declares the device capabilities. See
the “Assigned Numbers - Baseband” document at
http://www.bluetooth.com/
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.
-
-
- imode
type
- Set inquiry mode type to control which event formats are
generated during a device inquiry. The type can be:
-
-
- std
- Standard Inquiry Result Event format.
-
-
- rssi
- Enable Remote Signal Strength Indicator (RSSI) in
inquiry results. This will only work if the device features indicate
⟨RSSI with inquiry result⟩.
-
-
- ext
- Inquiry Result with RSSI format or Extended Inquiry
Result fomat. This will only work where the device features indicate
⟨extended inquiry⟩, and the Extended Inquiry Result will
only occur when the remote device provides the extended
information.
-
-
- 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, indicating how long the device will attempt to page another
device when opening baseband connections.
-
-
- 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
bcsp(4),
bluetooth(4),
bt3c(4),
btbc(4),
btuart(4),
sbt(4),
ubt(4)
HISTORY
The
btconfig command was written for
NetBSD
4.0 by
Iain Hibbert under the sponsorship of
Itronix, Inc.
BUGS
The output is very messy.