* [PATCH BlueZ v4 1/4] org.bluez.Bearer: Add ReadRSSI method
2026-11-16 7:16 [PATCH BlueZ v4 0/4] Bearer.LE1: Add ReadRSSI Kevin Dewald
@ 2026-11-16 7:16 ` Kevin Dewald
2026-11-16 7:16 ` [PATCH BlueZ v4 2/4] adapter: Add btd_adapter_get_conn_info Kevin Dewald
` (2 subsequent siblings)
3 siblings, 0 replies; 5+ messages in thread
From: Kevin Dewald @ 2026-11-16 7:16 UTC (permalink / raw)
To: linux-bluetooth; +Cc: Luiz Augusto von Dentz, Kevin Dewald
Add a testing method to read the RSSI of the current connection on LE
bearer, for diagnostics and production testing. It is only available
when D-Bus testing interfaces are enabled.
Assisted-by: Claude:claude-opus-5.5
---
doc/org.bluez.Bearer.LE.rst | 19 +++++++++++++++++++
1 file changed, 19 insertions(+)
diff --git a/doc/org.bluez.Bearer.LE.rst b/doc/org.bluez.Bearer.LE.rst
index 3db5237b4..803adb401 100644
--- a/doc/org.bluez.Bearer.LE.rst
+++ b/doc/org.bluez.Bearer.LE.rst
@@ -57,6 +57,25 @@ Possible errors:
:org.bluez.Error.NotConnected:
+int16 ReadRSSI() [testing]
+``````````````````````````
+
+Reads the Received Signal Strength Indicator of the current connection on LE
+bearer from the controller, in dBm, for diagnostics and production testing.
+
+Available only when D-Bus testing interfaces are enabled.
+
+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)
^ permalink raw reply related [flat|nested] 5+ messages in thread* [PATCH BlueZ v4 2/4] adapter: Add btd_adapter_get_conn_info
2026-11-16 7:16 [PATCH BlueZ v4 0/4] Bearer.LE1: Add ReadRSSI Kevin Dewald
2026-11-16 7:16 ` [PATCH BlueZ v4 1/4] org.bluez.Bearer: Add ReadRSSI method Kevin Dewald
@ 2026-11-16 7:16 ` Kevin Dewald
2026-11-16 7:16 ` [PATCH BlueZ v4 3/4] bearer: Add ReadRSSI method Kevin Dewald
2026-11-16 7:16 ` [PATCH BlueZ v4 4/4] test: functional: add bearer ReadRSSI test Kevin Dewald
3 siblings, 0 replies; 5+ messages in thread
From: Kevin Dewald @ 2026-11-16 7:16 UTC (permalink / raw)
To: linux-bluetooth; +Cc: Luiz Augusto von Dentz, Kevin Dewald
Add a function to send Get Connection Information for a connection.
Assisted-by: Claude:claude-opus-5.5
---
src/adapter.c | 18 ++++++++++++++++++
src/adapter.h | 7 +++++++
2 files changed, 25 insertions(+)
diff --git a/src/adapter.c b/src/adapter.c
index ea438375c..7c40a0460 100644
--- a/src/adapter.c
+++ b/src/adapter.c
@@ -11628,3 +11628,21 @@ unsigned int btd_adapter_send_cmd_event_sync(struct btd_adapter *adapter,
adapter->dev_id, sizeof(pkt.cp) + length,
&pkt, callback, user_data, destroy);
}
+
+unsigned int btd_adapter_get_conn_info(struct btd_adapter *adapter,
+ const bdaddr_t *bdaddr,
+ uint8_t bdaddr_type,
+ btd_adapter_reply_event_t callback,
+ void *user_data,
+ btd_adapter_destroy_func_t destroy)
+{
+ struct mgmt_cp_get_conn_info cp;
+
+ memset(&cp, 0, sizeof(cp));
+ bacpy(&cp.addr.bdaddr, bdaddr);
+ cp.addr.type = bdaddr_type;
+
+ return mgmt_send(adapter->mgmt, MGMT_OP_GET_CONN_INFO,
+ adapter->dev_id, sizeof(cp), &cp,
+ callback, user_data, destroy);
+}
diff --git a/src/adapter.h b/src/adapter.h
index 583168f4b..18e6eaa78 100644
--- a/src/adapter.h
+++ b/src/adapter.h
@@ -328,3 +328,10 @@ unsigned int btd_adapter_send_cmd_event_sync(struct btd_adapter *adapter,
void *user_data,
btd_adapter_destroy_func_t destroy,
uint8_t timeout);
+
+unsigned int btd_adapter_get_conn_info(struct btd_adapter *adapter,
+ const bdaddr_t *bdaddr,
+ uint8_t bdaddr_type,
+ btd_adapter_reply_event_t callback,
+ void *user_data,
+ btd_adapter_destroy_func_t destroy);
--
2.54.0 (Apple Git-157)
^ permalink raw reply related [flat|nested] 5+ messages in thread* [PATCH BlueZ v4 3/4] bearer: Add ReadRSSI method
2026-11-16 7:16 [PATCH BlueZ v4 0/4] Bearer.LE1: Add ReadRSSI Kevin Dewald
2026-11-16 7:16 ` [PATCH BlueZ v4 1/4] org.bluez.Bearer: Add ReadRSSI method Kevin Dewald
2026-11-16 7:16 ` [PATCH BlueZ v4 2/4] adapter: Add btd_adapter_get_conn_info Kevin Dewald
@ 2026-11-16 7:16 ` Kevin Dewald
2026-11-16 7:16 ` [PATCH BlueZ v4 4/4] test: functional: add bearer ReadRSSI test Kevin Dewald
3 siblings, 0 replies; 5+ messages in thread
From: Kevin Dewald @ 2026-11-16 7:16 UTC (permalink / raw)
To: linux-bluetooth; +Cc: Luiz Augusto von Dentz, Kevin Dewald
Implement Bearer.LE1.ReadRSSI with Get Connection Information, as a
testing method. The kernel reads the RSSI from the controller, or
returns the value it read last if that is recent enough
(conn_info_min_age and conn_info_max_age, 1 to 3 seconds by default).
The kernel reports a connection as soon as it is established but only
answers Get Connection Information once it has set it up, so a call made
right after Connect returns fails with NotReady rather than NotConnected.
Calls made while a request is pending get its result rather than sending
another one, as the kernel would answer that with its cached value,
which a new connection does not have yet.
A request still pending when the bearer is destroyed is left to complete
rather than cancelled, as the kernel replies to it anyway and the reply
would be taken for the reply to the next request.
The method is only on Bearer.LE1, as the RSSI of a BR/EDR connection is
relative to the golden receive power range rather than in dBm.
Assisted-by: Claude:claude-opus-5.5
---
src/bearer.c | 132 ++++++++++++++++++++++++++++++++++++++++++++++++++-
1 file changed, 130 insertions(+), 2 deletions(-)
diff --git a/src/bearer.c b/src/bearer.c
index ebcdc2b4c..779f6ea3c 100644
--- a/src/bearer.c
+++ b/src/bearer.c
@@ -44,6 +44,12 @@
#define DISCONNECT_TIMER 2
+/* Get Connection Information request of ReadRSSI */
+struct rssi_req {
+ struct btd_bearer *bearer; /* NULL once the bearer is destroyed */
+ struct queue *msgs; /* ReadRSSI calls waiting for the reply */
+};
+
struct btd_bearer {
struct btd_device *device;
uint8_t type;
@@ -57,6 +63,8 @@ struct btd_bearer {
*/
DBusMessage *connect; /* connect message */
+ struct rssi_req *rssi_req;
+
/* LE connection parameters, only valid while connected */
bool conn_params;
uint32_t interval; /* in microseconds */
@@ -213,13 +221,117 @@ static DBusMessage *bearer_disconnect(DBusConnection *conn, DBusMessage *msg,
return NULL;
}
-static const GDBusMethodTable bearer_methods[] = {
+static DBusMessage *rssi_reply(struct btd_bearer *bearer, DBusMessage *msg,
+ uint8_t status, uint16_t length,
+ const struct mgmt_rp_get_conn_info *rp)
+{
+ dbus_int16_t rssi;
+
+ /* The kernel reports the connection as soon as it is established, but
+ * only answers once it has set it up, e.g. read the remote features.
+ */
+ if (status == MGMT_STATUS_NOT_CONNECTED) {
+ if (btd_device_bdaddr_type_connected(bearer->device,
+ bearer->type))
+ return btd_error_not_ready(msg);
+
+ return btd_error_not_connected(msg);
+ }
+
+ if (status != MGMT_STATUS_SUCCESS)
+ return btd_error_failed(msg, mgmt_errstr(status));
+
+ if (length < sizeof(*rp))
+ return btd_error_failed(msg, "Invalid response");
+
+ /* 127 means the controller has no RSSI for the connection */
+ if (rp->rssi == 127)
+ return btd_error_not_available(msg);
+
+ rssi = rp->rssi;
+
+ return g_dbus_create_reply(msg, DBUS_TYPE_INT16, &rssi,
+ DBUS_TYPE_INVALID);
+}
+
+static void rssi_req_complete(uint8_t status, uint16_t length,
+ const void *param, void *user_data)
+{
+ struct rssi_req *req = user_data;
+ struct btd_bearer *bearer = req->bearer;
+ DBusMessage *msg;
+
+ if (!bearer)
+ return;
+
+ while ((msg = queue_pop_head(req->msgs))) {
+ g_dbus_send_message(btd_get_dbus_connection(),
+ rssi_reply(bearer, msg, status, length, param));
+ dbus_message_unref(msg);
+ }
+}
+
+static void rssi_req_free(void *data)
+{
+ struct rssi_req *req = data;
+
+ if (req->bearer)
+ req->bearer->rssi_req = NULL;
+
+ queue_destroy(req->msgs, bearer_free_dbus_message);
+ free(req);
+}
+
+static DBusMessage *bearer_read_rssi(DBusConnection *conn, DBusMessage *msg,
+ void *user_data)
+{
+ struct btd_bearer *bearer = user_data;
+ struct btd_device *device = bearer->device;
+ struct rssi_req *req;
+
+ if (!btd_device_bdaddr_type_connected(device, bearer->type))
+ return btd_error_not_connected(msg);
+
+ /* Calls made while a read is pending get the same result */
+ if (!bearer->rssi_req) {
+ req = new0(struct rssi_req, 1);
+ req->bearer = bearer;
+ req->msgs = queue_new();
+
+ if (!btd_adapter_get_conn_info(device_get_adapter(device),
+ device_get_address(device),
+ device_get_le_address_type(device),
+ rssi_req_complete, req,
+ rssi_req_free)) {
+ rssi_req_free(req);
+ return btd_error_failed(msg, "Unable to read RSSI");
+ }
+
+ bearer->rssi_req = req;
+ }
+
+ queue_push_tail(bearer->rssi_req->msgs, dbus_message_ref(msg));
+
+ return NULL;
+}
+
+static const GDBusMethodTable bearer_bredr_methods[] = {
{ GDBUS_ASYNC_METHOD("Connect", NULL, NULL, bearer_connect) },
{ GDBUS_ASYNC_METHOD("Disconnect", NULL, NULL,
bearer_disconnect) },
{}
};
+static const GDBusMethodTable bearer_le_methods[] = {
+ { GDBUS_ASYNC_METHOD("Connect", NULL, NULL, bearer_connect) },
+ { GDBUS_ASYNC_METHOD("Disconnect", NULL, NULL,
+ bearer_disconnect) },
+ { GDBUS_TESTING_ASYNC_METHOD("ReadRSSI", NULL,
+ GDBUS_ARGS({ "rssi", "n" }),
+ bearer_read_rssi) },
+ {}
+};
+
static gboolean bearer_get_adapter(const GDBusPropertyTable *property,
DBusMessageIter *iter, void *data)
{
@@ -404,6 +516,14 @@ static const char *bearer_interface(uint8_t type)
return BTD_BEARER_LE_INTERFACE;
}
+static const GDBusMethodTable *bearer_methods(uint8_t type)
+{
+ if (type == BDADDR_BREDR)
+ return bearer_bredr_methods;
+ else
+ return bearer_le_methods;
+}
+
struct btd_bearer *btd_bearer_new(struct btd_device *device, uint8_t type)
{
struct btd_bearer *bearer;
@@ -429,7 +549,7 @@ struct btd_bearer *btd_bearer_new(struct btd_device *device, uint8_t type)
if (!g_dbus_register_interface(btd_get_dbus_connection(),
bearer->path, bearer_interface(type),
- bearer_methods, bearer_signals,
+ bearer_methods(type), bearer_signals,
bearer_properties,
bearer, bearer_free)) {
error("Unable to register BREDR interface");
@@ -459,6 +579,14 @@ void btd_bearer_destroy(struct btd_bearer *bearer)
bearer->connect = NULL;
}
+ /* Let a pending request complete rather than cancel it, as the kernel
+ * replies to it anyway and the reply would complete the next request.
+ */
+ if (bearer->rssi_req) {
+ bearer->rssi_req->bearer = NULL;
+ bearer->rssi_req = NULL;
+ }
+
g_dbus_unregister_interface(btd_get_dbus_connection(), bearer->path,
bearer_interface(bearer->type));
}
--
2.54.0 (Apple Git-157)
^ permalink raw reply related [flat|nested] 5+ messages in thread* [PATCH BlueZ v4 4/4] test: functional: add bearer ReadRSSI test
2026-11-16 7:16 [PATCH BlueZ v4 0/4] Bearer.LE1: Add ReadRSSI Kevin Dewald
` (2 preceding siblings ...)
2026-11-16 7:16 ` [PATCH BlueZ v4 3/4] bearer: Add ReadRSSI method Kevin Dewald
@ 2026-11-16 7:16 ` Kevin Dewald
3 siblings, 0 replies; 5+ messages in thread
From: Kevin Dewald @ 2026-11-16 7:16 UTC (permalink / raw)
To: linux-bluetooth; +Cc: Luiz Augusto von Dentz, Kevin Dewald
Read the RSSI of the LE connection from a host with testing interfaces
enabled, check ReadRSSI fails with NotConnected once disconnected, and
check a host without testing interfaces does not expose it.
Assisted-by: Claude:claude-opus-5.5
---
test/functional/test_bearer.py | 58 ++++++++++++++++++++++++++++++++++
1 file changed, 58 insertions(+)
diff --git a/test/functional/test_bearer.py b/test/functional/test_bearer.py
index 59ce8ef7d..3f1033b35 100644
--- a/test/functional/test_bearer.py
+++ b/test/functional/test_bearer.py
@@ -54,6 +54,9 @@ UPDATE_CONF = LE_CONF + "[LE]\nMinConnectionInterval = 80\nMaxConnectionInterval
CONN_PARAMS = ("Interval", "Latency", "SupervisionTimeout", "Subrate")
+# ReadRSSI is a testing method
+TESTING_CONF = LE_CONF + "Testing = true\n"
+
class Bearers(HostPlugin, EventPluginMixin):
"""
@@ -206,6 +209,22 @@ def conn_params(host, remote):
return dict(zip(CONN_PARAMS, map(int, values)))
+def read_rssi(host, remote):
+ """
+ The RSSI ReadRSSI returns for the LE bearer host has for remote, or
+ None if the kernel has not finished setting up the connection yet.
+ """
+ host.bearers.call(remote.bdaddr, LE_INTERFACE, "ReadRSSI")
+ event = host.bearers.expect(
+ (f"{LE_INTERFACE}.ReadRSSI:reply", f"{LE_INTERFACE}.ReadRSSI:error")
+ )
+ if event.kind.endswith(":error"):
+ assert event.error.get_dbus_name() == "org.bluez.Error.NotReady"
+ return None
+
+ return int(event.values[0])
+
+
def connect_le(host0, host1):
discover(host0, host1)
@@ -283,6 +302,45 @@ def test_bearer_le_conn_params(hosts):
assert host.bearers.get(remote.bdaddr, LE_INTERFACE, name) is None
+@host_config(
+ [
+ Bluetoothd(conf=TESTING_CONF, args=ARGS),
+ Agent(capability="NoInputNoOutput"),
+ Bearers(),
+ ],
+ [
+ Bluetoothd(conf=LE_CONF, args=ARGS),
+ LeAdvertiser(),
+ Agent(capability="NoInputNoOutput"),
+ Bearers(),
+ ],
+)
+def test_bearer_le_read_rssi(hosts):
+ host0, host1 = hosts
+
+ connect_le(host0, host1)
+
+ for host, remote in peers(host0, host1):
+ wait_until(
+ lambda: host.bearers.get(remote.bdaddr, LE_INTERFACE, "Connected") is True
+ )
+
+ wait_until(lambda: read_rssi(host0, host1) is not None)
+
+ # Controllers report the RSSI of a connection from -127 to 20 dBm
+ assert -127 <= read_rssi(host0, host1) <= 20
+
+ host1.bearers.call(host0.bdaddr, LE_INTERFACE, "ReadRSSI")
+ error = host1.bearers.expect(f"{LE_INTERFACE}.ReadRSSI:error").error
+ assert error.get_dbus_name() == "org.freedesktop.DBus.Error.UnknownMethod"
+
+ disconnect(host0, host1, LE_INTERFACE)
+
+ host0.bearers.call(host1.bdaddr, LE_INTERFACE, "ReadRSSI")
+ error = host0.bearers.expect(f"{LE_INTERFACE}.ReadRSSI:error").error
+ assert error.get_dbus_name() == "org.bluez.Error.NotConnected"
+
+
@host_config(
[
Bluetoothd(conf=LE_CONF, args=ARGS),
--
2.54.0 (Apple Git-157)
^ permalink raw reply related [flat|nested] 5+ messages in thread