Return-Path: From: Anderson Lizardo To: linux-bluetooth@vger.kernel.org Cc: Anderson Lizardo Subject: [PATCH RFC BlueZ v2 1/1] doc: Document Broadcaster/Observer API Date: Thu, 26 Apr 2012 17:03:26 -0400 Message-Id: <1335474206-21914-2-git-send-email-anderson.lizardo@openbossa.org> In-Reply-To: <1335474206-21914-1-git-send-email-anderson.lizardo@openbossa.org> References: <1334192668-21433-1-git-send-email-anderson.lizardo@openbossa.org> <1335474206-21914-1-git-send-email-anderson.lizardo@openbossa.org> Sender: linux-bluetooth-owner@vger.kernel.org List-ID: --- doc/adapter-api.txt | 71 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 files changed, 71 insertions(+), 0 deletions(-) diff --git a/doc/adapter-api.txt b/doc/adapter-api.txt index 0cded8c..346e7c3 100644 --- a/doc/adapter-api.txt +++ b/doc/adapter-api.txt @@ -181,6 +181,55 @@ Methods dict GetProperties() Possible errors: org.bluez.Error.DoesNotExist + void RegisterBroadcaster(dict values) + + Set Advertising data for broadcast. Different + applications can register different Adv. data types, + and they are all concatenated to form the Adv. data. + Broadcasting is enabled as soon as the first + RegisterBroadcaster() call is made. + + Use UnregisterBroadcaster() to release Adv. data for + the application. Advertising data is also released when + application exits, and once the last Broadcaster exits, + advertising is disabled. + + Possible Errors: org.bluez.Error.InvalidArguments + org.bluez.Error.Failed + + void UpdateBroadcastData(dict values) + + Replace Advertising data for broadcast. This method can + only be called after RegisterBroadcaster(). + + Possible errors: org.bluez.Error.Failed + + void UnregisterBroadcaster() + + This method will release any previously set Advertising + data. + + Note that a broadcast procedure is shared between all + sessions, thus calling UnregisterBroadcaster() will + only release a single session. + + Possible errors: org.bluez.Error.Failed + + void RegisterObserver(object agent, array{byte} data_types) + + Registers an observer agent to monitor broadcasts. This + agent will be notified whenever a broadcast is received + that contains any of selected Advertising data types. + + Possible errors: org.bluez.Error.InvalidArguments + + void UnregisterObserver(object agent) + + Unregisters an observer. Broadcasts will not be + notified to this agent anymore. + + Possible errors: org.bluez.Error.InvalidArguments + Signals PropertyChanged(string name, variant value) This signal indicates a changed value of the given @@ -276,6 +325,14 @@ Properties string Address [readonly] Indicates that a device discovery procedure is active. + boolean Broadcasting [readonly] + + Indicates that a broadcast procedure is active. + + boolean Observing [readonly] + + Indicates that an observation procedure is active. + array{object} Devices [readonly] List of device object paths. @@ -284,3 +341,17 @@ Properties string Address [readonly] List of 128-bit UUIDs that represents the available local services. + + +Observer hierarchy +================== + +Service unique name +Interface org.bluez.Observer +Object path freely definable + +Methods void BroadcastReceived(string address, byte data_type, + variant value) + + This callback gets called when a broadcast data has + arrived with selected Advertising Data type. -- 1.7.5.4