Two commands has been introduced: Start Read Remote RSSI Command Stop Read Remote RSSI Command And one Event: Remote RSSI Changed Event Idea is that it is possible to start/stop read remote RSSI session and register for RSSI Change event with given theshold. This API gives a possibility to do one time RSSI read in case userspace really needs that. --- doc/mgmt-api.txt | 82 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 82 insertions(+) diff --git a/doc/mgmt-api.txt b/doc/mgmt-api.txt index 78f0bd2..58b1ebe 100644 --- a/doc/mgmt-api.txt +++ b/doc/mgmt-api.txt @@ -1668,6 +1668,58 @@ 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 Changed event is sent. + + If threshold is 0 then no Remote RSSI Changed 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 + Invalid Parameters + Not Powered + 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 ====================== @@ -2257,3 +2309,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 Changed 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 -- To unsubscribe from this list: send the line "unsubscribe linux-bluetooth" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
