diff options
author | Johan Hedberg <johan.hedberg@intel.com> | 2012-10-12 10:47:36 +0200 |
---|---|---|
committer | Johan Hedberg <johan.hedberg@intel.com> | 2012-10-12 18:02:34 +0300 |
commit | 293bbb4a47950f9bf1ecacbbf3193047fc5e555a (patch) | |
tree | 80cc8a6f1ad35d285ad88ca3bb75e625f68b8266 /doc/adapter-api.txt | |
parent | f66abea5d817b8407f3d7b1a8ddb29dd5a0370f0 (diff) |
doc: Update adapter and device D-Bus APIs
Diffstat (limited to 'doc/adapter-api.txt')
-rw-r--r-- | doc/adapter-api.txt | 71 |
1 files changed, 6 insertions, 65 deletions
diff --git a/doc/adapter-api.txt b/doc/adapter-api.txt index 23f0a2f1..a72e9df7 100644 --- a/doc/adapter-api.txt +++ b/doc/adapter-api.txt @@ -82,61 +82,10 @@ Methods dict GetProperties() object FindDevice(string address) Returns the object path of device for given address. - The device object needs to be first created via - CreateDevice or CreatePairedDevice. Possible Errors: org.bluez.Error.DoesNotExist org.bluez.Error.InvalidArguments - object CreateDevice(string address) - - Creates a new object path for a remote device. This - method will connect to the remote device and retrieve - all SDP records (or GATT primary services). - - If the object for the remote device already exists - this method will fail. - - Possible errors: org.bluez.Error.InvalidArguments - org.bluez.Error.Failed - - object CreatePairedDevice(string address, object agent, - string capability) - - Creates a new object path for a remote device. This - method will connect to the remote device and retrieve - all SDP records (or GATT primary services) and then - initiate the pairing. - - If previously CreateDevice was used successfully, - this method will only initiate the pairing. - - Compared to CreateDevice this method will fail if - the pairing already exists, but not if the object - path already has been created. This allows applications - to use CreateDevice first and the if needed use - CreatePairedDevice to initiate pairing. - - The agent object path is assumed to reside within the - process (D-Bus connection instance) that calls this - method. No separate registration procedure is needed - for it and it gets automatically released once the - pairing operation is complete. - - The capability parameter is the same as for the - RegisterAgent method. - - Possible errors: org.bluez.Error.InvalidArguments - org.bluez.Error.Failed - - void CancelDeviceCreation(string address) - - Aborts either a CreateDevice call or a - CreatePairedDevice call. - - Possible errors: org.bluez.Error.InvalidArguments - org.bluez.Error.NotInProgress - void RemoveDevice(object device) This removes the remote device object at the given @@ -178,22 +127,14 @@ Signals PropertyChanged(string name, variant value) This signal indicates a changed value of the given property. - DeviceFound(string address, dict values) - - This signal will be sent every time an inquiry result - has been found by the service daemon. In general they - only appear during a device discovery. - - The dictionary can contain basically the same values - that are returned by the GetProperties method - from the org.bluez.Device interface. In addition there - can be values for the RSSI and the TX power level. + DevicesFound(array{object path, dict values}) - DeviceDisappeared(string address) + This signal will be sent every time devices have + been found. In general they only appear during a + device discovery. - This signal will be sent when an inquiry session for - a periodic discovery finishes and previously found - devices are no longer in range or visible. + The dictionary contains the properties from the + org.bluez.Device interface. DeviceCreated(object device) |