[RFC PATCH BlueZ 1/4] org.bluez.Bearer: Add ReadRSSI method

[Kevin Dewald <kevin@simpleble.org>]

Add a method to read the RSSI of the current connection on LE bearer.
Device1.RSSI only covers inquiry and advertising, so an application
cannot follow the signal strength of a device once it is connected and
no longer advertising.

Assisted-by: Claude:claude-opus-5.5
---
 doc/org.bluez.Bearer.LE.rst | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/doc/org.bluez.Bearer.LE.rst b/doc/org.bluez.Bearer.LE.rst
index 3db5237b4..589b54873 100644
--- a/doc/org.bluez.Bearer.LE.rst
+++ b/doc/org.bluez.Bearer.LE.rst
@@ -57,6 +57,23 @@ Possible errors:
 
 :org.bluez.Error.NotConnected:
 
+int16 ReadRSSI()
+````````````````
+
+Reads the Received Signal Strength Indicator of the current connection on LE
+bearer from the controller, in dBm.
+
+The kernel caches the value for a few seconds, so calls made in quick succession
+may return the same value. Right after the connection is established, while it
+is still being set up, the method fails with org.bluez.Error.NotReady.
+
+Possible errors:
+
+:org.bluez.Error.NotConnected:
+:org.bluez.Error.NotReady:
+:org.bluez.Error.NotAvailable:
+:org.bluez.Error.Failed:
+
 Signals
 -------
 
-- 
2.54.0 (Apple Git-157)