mirror of
https://git.kernel.org/pub/scm/bluetooth/bluez.git
synced 2024-11-25 21:24:16 +08:00
156 lines
4.2 KiB
Plaintext
156 lines
4.2 KiB
Plaintext
BlueZ D-Bus Adapter API description
|
|
***********************************
|
|
|
|
|
|
Adapter hierarchy
|
|
=================
|
|
|
|
Service org.bluez
|
|
Interface org.bluez.Adapter1
|
|
Object path [variable prefix]/{hci0,hci1,...}
|
|
|
|
Methods void StartDiscovery()
|
|
|
|
This method starts the device discovery session. This
|
|
includes an inquiry procedure and remote device name
|
|
resolving. Use StopDiscovery to release the sessions
|
|
acquired.
|
|
|
|
This process will start creating Device objects as
|
|
new devices are discovered.
|
|
|
|
Possible errors: org.bluez.Error.NotReady
|
|
org.bluez.Error.Failed
|
|
|
|
void StopDiscovery()
|
|
|
|
This method will cancel any previous StartDiscovery
|
|
transaction.
|
|
|
|
Note that a discovery procedure is shared between all
|
|
discovery sessions thus calling StopDiscovery will only
|
|
release a single session.
|
|
|
|
Possible errors: org.bluez.Error.NotReady
|
|
org.bluez.Error.Failed
|
|
org.bluez.Error.NotAuthorized
|
|
|
|
void RemoveDevice(object device)
|
|
|
|
This removes the remote device object at the given
|
|
path. It will remove also the pairing information.
|
|
|
|
Possible errors: org.bluez.Error.InvalidArguments
|
|
org.bluez.Error.Failed
|
|
|
|
Properties string Address [readonly]
|
|
|
|
The Bluetooth device address.
|
|
|
|
string Name [readonly]
|
|
|
|
The Bluetooth system name (pretty hostname).
|
|
|
|
This property is either a static system default
|
|
or controlled by an external daemon providing
|
|
access to the pretty hostname configuration.
|
|
|
|
string Alias [readwrite]
|
|
|
|
The Bluetooth friendly name. This value can be
|
|
changed.
|
|
|
|
In case no alias is set, it will return the system
|
|
provided name. Setting an empty string as alias will
|
|
convert it back to the system provided name.
|
|
|
|
When resetting the alias with an empty string, the
|
|
property will default back to system name.
|
|
|
|
On a well configured system, this property never
|
|
needs to be changed since it defaults to the system
|
|
name and provides the pretty hostname. Only if the
|
|
local name needs to be different from the pretty
|
|
hostname, this property should be used as last
|
|
resort.
|
|
|
|
uint32 Class [readonly]
|
|
|
|
The Bluetooth class of device.
|
|
|
|
This property represents the value that is either
|
|
automatically configured by DMI/ACPI information
|
|
or provided as static configuration.
|
|
|
|
boolean Powered [readwrite]
|
|
|
|
Switch an adapter on or off. This will also set the
|
|
appropriate connectable state of the controller.
|
|
|
|
The value of this property is not persistent. After
|
|
restart of unplugging of the adapter it will reset
|
|
back to false.
|
|
|
|
boolean Discoverable [readwrite]
|
|
|
|
Switch an adapter to discoverable or non-discoverable
|
|
to either make it visible or hide it. This is a global
|
|
setting and should only be used by the settings
|
|
application.
|
|
|
|
If the DiscoverableTimeout is set to a non-zero
|
|
value then the system will set this value back to
|
|
false after the timer expired.
|
|
|
|
In case the adapter is switched off, setting this
|
|
value will fail.
|
|
|
|
When changing the Powered property the new state of
|
|
this property will be updated via a PropertyChanged
|
|
signal.
|
|
|
|
For any new adapter this settings defaults to false.
|
|
|
|
boolean Pairable [readwrite]
|
|
|
|
Switch an adapter to pairable or non-pairable. This is
|
|
a global setting and should only be used by the
|
|
settings application.
|
|
|
|
Note that this property only affects incoming pairing
|
|
requests.
|
|
|
|
For any new adapter this settings defaults to true.
|
|
|
|
uint32 PairableTimeout [readwrite]
|
|
|
|
The pairable timeout in seconds. A value of zero
|
|
means that the timeout is disabled and it will stay in
|
|
pairable mode forever.
|
|
|
|
The default value for pairable timeout should be
|
|
disabled (value 0).
|
|
|
|
uint32 DiscoverableTimeout [readwrite]
|
|
|
|
The discoverable timeout in seconds. A value of zero
|
|
means that the timeout is disabled and it will stay in
|
|
discoverable/limited mode forever.
|
|
|
|
The default value for the discoverable timeout should
|
|
be 180 seconds (3 minutes).
|
|
|
|
boolean Discovering [readonly]
|
|
|
|
Indicates that a device discovery procedure is active.
|
|
|
|
array{string} UUIDs [readonly]
|
|
|
|
List of 128-bit UUIDs that represents the available
|
|
local services.
|
|
|
|
string Modalias [readonly, optional]
|
|
|
|
Local Device ID information in modalias format
|
|
used by the kernel and udev.
|