Return-Path: From: Claudio Takahasi To: linux-bluetooth@vger.kernel.org Cc: Claudio Takahasi Subject: [RFC BlueZ] Proximity API simplification Date: Mon, 18 Jul 2011 14:35:04 -0300 Message-Id: <1311010504-15060-1-git-send-email-claudio.takahasi@openbossa.org> Sender: linux-bluetooth-owner@vger.kernel.org List-ID: Delegates the Immediate Alert Level control to the caller(client). Immediate Alert Service is shared between Path Loss and Find Me. Cons: distributed actions may impact qualification. Client needs to control when to write the Immediate Alert based on the received SignalLevel received. --- I'd like to collect feedbacks before proceeding with this change. Does it look more clear than the previous API version? The ideia is to move to the kernel the RSSI value polling. The userspace will receive notifications when one of the SignalLevel threshold is triggered: "good", "regular", "week". Regards, Claudio doc/proximity-api.txt | 36 ++++++------------------------------ 1 files changed, 6 insertions(+), 30 deletions(-) diff --git a/doc/proximity-api.txt b/doc/proximity-api.txt index ed78fb5..cf64bbf 100644 --- a/doc/proximity-api.txt +++ b/doc/proximity-api.txt @@ -30,29 +30,11 @@ Signals PropertyChanged(string name, variant value) property. Properties - uint8 PathLoss[readonly] - If Tx Power Service is available, this property value - will be reported on regular intervals when the peer is - connected. Range: 0 - 100. The number is a relative - value to represent inaccurately the signal strength, - where 0 represents out of range and 100 close to the - reporter. + string SignalLevel[readonly] - string Threshold [readwrite] - - Persistent property. Trigger for immediate alert. - Values: "low", "medium", "high". Enabled only if Tx - Power and Immediate Alert services are available in - the reporter. Controls when the immediate alert is - triggered in the reporter. - - boolean ThresholdAlert[readonly] - - Alert indicating that threshold has been reached or the - path loss returned to a value below the threshold. It is - up to the implementation catch this property value and - emit a sound in the proximity monitor. + Alert indicating that a threshold has been reached. + Possible values: "unknown", "good", "regular", "weak" string LinkLossAlertLevel [readwrite] @@ -60,16 +42,10 @@ Properties proximity reporter for link loss scenario. Values: "none", "mild", "high". - string PathLossAlertLevel [readwrite] - - Persistent property. Alert level for path loss scenario. - It's a LOCAL property value written in the Alert Level of - the Immediate Alert service when the threshold alert is - triggered. Values: "none", "mild", "high". - - string FindMeAlertLevel [readwrite] + string ImmediateAlertLevel [readwrite] - Alert level to be written in the Find Me Target. + Alert level to be written in the Immediate Alert Level. + Property shared between Path Loss and Find Me. Values: "none", "mild", "high". Default value is "none". Applications can disable the alert setting the value to "none". If the "Target" is not found, -- 1.7.6