2014-03-27 21:10:27

by Lukasz Rymanowski

Subject: [RFC 1/3] mgmt-api: Add Start Remote RSSI Command

---
doc/mgmt-api.txt | 32 ++++++++++++++++++++++++++++++++
1 file changed, 32 insertions(+)

diff --git a/doc/mgmt-api.txt b/doc/mgmt-api.txt
index 78f0bd2..28e7845 100644
--- a/doc/mgmt-api.txt
+++ b/doc/mgmt-api.txt
@@ -1668,6 +1668,38 @@ Load Identity Resolving Keys Command
Invalid Index


+Start Read Remote RSSI Command
+==============================
+
+ Command Code: 0x0031
+ Controller Index: <controller id>
+ Command Parameters: Address (6 Octets)
+ Address_Type (1 Octet)
+ Threshold (1 Octet)
+ Return Parameters: Address (6 Octets)
+ Address_Type (1 Octet)
+ Current_RSSI (1 Octet)
+
+ This command is used to start read remote rssi with given
+ threshold. On this command current remote RSSI is read and
+ is used as starting point for messurements. If threshold is
+ exceeded then Remote RSSI event is sent.
+
+ If threshold is 0 then no Remote RSSI event is generated but
+ only Command Complete with current RSSI.
+
+ This command can be used only when controller is powered on.
+
+ This command generates a Command Complete event on success
+ and on failure.
+
+ Possible errors: Not Connected
+ Busy
+ Invalid Parameters
+ Not Powered
+ Invalid Index
+
+
Command Complete Event
======================

--
1.8.4

2014-03-28 07:13:24

by Marcel Holtmann

Subject: Re: [RFC 2/3] mgmt-api: Add Stop Read Remote RSSI Command

Hi Lukasz,

> ---
> doc/mgmt-api.txt | 21 +++++++++++++++++++++
> 1 file changed, 21 insertions(+)
>
> diff --git a/doc/mgmt-api.txt b/doc/mgmt-api.txt
> index 28e7845..6d3b86b 100644
> --- a/doc/mgmt-api.txt
> +++ b/doc/mgmt-api.txt
> @@ -1700,6 +1700,27 @@ Start Read Remote RSSI Command
> Invalid Index

you really want to send all the mgmt-api changes in one patch to make them easier to review and comment on.

Regards

Marcel

2014-03-27 21:10:28

by Lukasz Rymanowski

Subject: [RFC 2/3] mgmt-api: Add Stop Read Remote RSSI Command

---
doc/mgmt-api.txt | 21 +++++++++++++++++++++
1 file changed, 21 insertions(+)

diff --git a/doc/mgmt-api.txt b/doc/mgmt-api.txt
index 28e7845..6d3b86b 100644
--- a/doc/mgmt-api.txt
+++ b/doc/mgmt-api.txt
@@ -1700,6 +1700,27 @@ Start Read Remote RSSI Command
Invalid Index


+Stop Read Remote RSSI Command
+=============================
+
+ Command Code: 0x0032
+ Controller Index: <controller id>
+ Command Parameters: Address (6 Octets)
+ Adress_Type (1 Octet)
+
+ Return Parametes:
+
+ This command is used to stop read remote RSSI started with
+ Start Read Remote RSSI command.
+
+ This command generates Command Complete event on success
+ and on failure.
+
+ Possible errors: Rejected
+ Invalid Parameters
+ Invalid Index
+
+
Command Complete Event
======================

--
1.8.4

2014-03-27 21:10:29

by Lukasz Rymanowski

Subject: [RFC 3/3] mgmt-api: Add Remote RSSI Event

---
doc/mgmt-api.txt | 30 ++++++++++++++++++++++++++++++
1 file changed, 30 insertions(+)

diff --git a/doc/mgmt-api.txt b/doc/mgmt-api.txt
index 6d3b86b..2ba2a5b 100644
--- a/doc/mgmt-api.txt
+++ b/doc/mgmt-api.txt
@@ -2310,3 +2310,33 @@ New Signature Resolving Key Event

The provided Address and Address_Type are the identity of
a device. So either its public address or static random address.
+
+
+Remote RSSI Event
+=================
+
+ Event Code: 0x0020
+ Controller Index: <controller id>
+ Event Parameters: Address (6 Octets)
+ Address_Type (1 Octet)
+ Active (1 Octet)
+ RSSI (1 Octet)
+
+ This event indicates that a remote RSSI has exceed threshold
+ given on Start Read Remote RSSI command.
+
+ Possible values for the Address_Type parameter:
+ 0 BR/EDR
+ 1 LE Public
+ 2 LE Random
+
+ The valid values for the Active parameter are 0x01
+ (RSSI read active) and 0x00 (RSSI read stopped).
+
+ Possible RSSI values:
+ BR/EDR
+ Range: -128 <= N <= 127 (signed integer)
+ Units: dB
+ LE:
+ Range: -127 to 20, 127 (signed integer)
+ Units: dBm
--
1.8.4