| 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. |