Skip to contentSkip to conversation

Add Role property to org.bluez.Bearer.LE1

PATCH Superseded Kevin Dewald 3 participants 8 messages Oct 8 – Oct 9 Bluetooth drivers

v2 of 3 Superseded Latest is v3 →

lore
Share & tools
lore
#0 lore raw

v2 cover Add Role property to org.bluez.Bearer.LE1

Applications acting as a peripheral, or in both roles, cannot tell whether a connected device is a central that connected to the adapter or a peripheral the adapter connected to. When several applications share the adapter, a device object can appear because of any of them, so the order of events does not answer it either.

bluetoothd already tracks this per bearer from the Device Connected event. This series exposes it as a Role property on org.bluez.Bearer.LE1, "central" or "peripheral", present only while the device is connected over LE, and prints it as LE.Role in bluetoothctl info. The documentation states that it is the link layer role and says nothing about GATT client and server roles.

Like the rest of the bearer interfaces, the property is experimental, so applications only see it when bluetoothd runs with -E, which few systems do. Is there a plan to promote the bearer interfaces, or some of their properties, to stable? I would be glad to help with whatever that needs.

Tested with two btvirt controllers, where the advertising side reports the other as "central" and the connecting side reports it as "peripheral", and with a real adapter connecting to an nRF52840. The property goes away when the connection does.

Changes in v2:
- Move the property from org.bluez.Device1 to org.bluez.Bearer.LE1, so it is clearly per connection (Luiz)
- State in the documentation that it says nothing about GATT roles (Luiz)

Kevin Dewald (3):
org.bluez.Bearer: Add Role property
bearer: Add Role property
client: Print LE.Role in info

 client/main.c               |  1 +
 doc/org.bluez.Bearer.LE.rst | 24 +++++++++++++++++++++
 src/bearer.c                | 42 +++++++++++++++++++++++++++++++++++++
 src/device.c                |  5 +++++
 src/device.h                |  1 +
 5 files changed, 73 insertions(+)
Signature · 1 line
2.54.0 (Apple Git-157)
#1 lore raw

PATCH v2 1/3 org.bluez.Bearer: Add Role property

This adds Role property to org.bluez.Bearer.LE1 which indicates whether the remote device is the central or the peripheral of the current LE connection, so applications can tell a central that connected to the adapter from a peripheral the adapter connected to.

Assisted-by Claude:claude-opus-5.5
---
 doc/org.bluez.Bearer.LE.rst | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)
doc/org.bluez.Bearer.LE.rst +24 -0
index ec92a5ce5..dfd809739 100644
@@ -153,3 +153,27 @@ The property is only present once the device has been discovered or connected
 over LE bearer.
 
 A PropertiesChanged signal indicate changes to this status.
+
+string Role [readonly, optional, experimental]
+``````````````````````````````````````````````
+
+Indicates the role of the remote device in the current connection on LE bearer.
+It is only present while the remote device is connected over LE bearer.
+
+It is the link layer role of the connection. It does not imply which side acts
+as GATT client or server, as GATT roles are independent of it and both may be
+used at the same time.
+
+Possible values:
+
+:"central":
+
+	The remote device initiated the connection, and the adapter is the
+	peripheral.
+
+:"peripheral":
+
+	The adapter initiated the connection, and the remote device is the
+	peripheral.
+
+A PropertiesChanged signal indicate changes to this status.
Signature · 1 line
2.54.0 (Apple Git-157)
#2 lore raw

This is automated email and please do not reply to this email!

Dear submitter,

Thank you for submitting the patches to the linux bluetooth mailing list. This is a CI test results with your patch series:
PW Link:https://patchwork.kernel.org/series/1181777/

---Test result---

Test Summary:

CheckPatch                    PASS      1.14 seconds
GitLint                       PASS      0.79 seconds
BuildEll                      PASS      16.14 seconds
BluezMake                     PASS      281.25 seconds
MakeCheck                     PASS      13.74 seconds
MakeDistcheck                 PASS      117.94 seconds
CheckValgrind                 PASS      188.17 seconds
CheckSmatch                   PASS      202.45 seconds
bluezmakeextell               PASS      74.32 seconds
TestFunctional                PASS      961.44 seconds
IncrementalBuild              PENDING   350.27 seconds
ScanBuild                     PASS      822.65 seconds

Details
##############################
Test: IncrementalBuild - PENDING
Desc: Incremental build with the patches in the series Output:

https://github.com/bluez/bluez/pull/2637

---
Regards,
Linux Bluetooth

#3 lore raw

PATCH v2 2/3 bearer: Add Role property

In reply to Kevin Dewald

This implements Role property for the LE bearer using the initiator flag of the Device Connected event, which the kernel sets when the adapter created the connection as central, and emits PropertiesChanged along with Connected.

Assisted-by Claude:claude-opus-5.5
---
 src/bearer.c | 42 ++++++++++++++++++++++++++++++++++++++++++
 src/device.c |  5 +++++
 src/device.h |  1 +
 3 files changed, 48 insertions(+)
src/bearer.c +42 -0
index f3b7a2337..25224dcc7 100644
@@ -274,6 +274,34 @@ static gboolean bearer_connectable_exists(const GDBusPropertyTable *property,
 	return btd_device_bdaddr_type_seen(bearer->device, bearer->type);
 }
 
+static gboolean bearer_get_role(const GDBusPropertyTable *property,
+					DBusMessageIter *iter, void *data)
+{
+	struct btd_bearer *bearer = data;
+	const char *role;
+
+	/* The initiator of an LE connection is always the central */
+	if (btd_device_bdaddr_type_initiator(bearer->device, bearer->type))
+		role = "peripheral";
+	else
+		role = "central";
+
+	dbus_message_iter_append_basic(iter, DBUS_TYPE_STRING, &role);
+
+	return TRUE;
+}
+
+static gboolean bearer_role_exists(const GDBusPropertyTable *property,
+								void *data)
+{
+	struct btd_bearer *bearer = data;
+
+	if (bearer->type == BDADDR_BREDR)
+		return FALSE;
+
+	return btd_device_bdaddr_type_connected(bearer->device, bearer->type);
+}
+
 static const GDBusSignalTable bearer_signals[] = {
 	{ GDBUS_SIGNAL("Disconnected",
 			GDBUS_ARGS({ "name", "s" }, { "message", "s" })) },
@@ -292,6 +320,8 @@ static const GDBusPropertyTable bearer_properties[] = {
 	{ "Connectable", "b", bearer_get_connectable, NULL,
 			bearer_connectable_exists,
 			G_DBUS_PROPERTY_FLAG_EXPERIMENTAL },
+	{ "Role", "s", bearer_get_role, NULL, bearer_role_exists,
+			G_DBUS_PROPERTY_FLAG_EXPERIMENTAL },
 	{}
 };
 
@@ -416,6 +446,12 @@ void btd_bearer_connected(struct btd_bearer *bearer, int err)
 	g_dbus_emit_property_changed(btd_get_dbus_connection(), bearer->path,
 					bearer_interface(bearer->type),
 					"Connected");
+
+	if (!err && bearer->type != BDADDR_BREDR)
+		g_dbus_emit_property_changed(btd_get_dbus_connection(),
+					bearer->path,
+					bearer_interface(bearer->type),
+					"Role");
 }
 
 void btd_bearer_disconnected(struct btd_bearer *bearer, uint8_t reason)
@@ -444,6 +480,12 @@ void btd_bearer_disconnected(struct btd_bearer *bearer, uint8_t reason)
 					bearer_interface(bearer->type),
 					"Connected");
 
+	if (bearer->type != BDADDR_BREDR)
+		g_dbus_emit_property_changed(btd_get_dbus_connection(),
+					bearer->path,
+					bearer_interface(bearer->type),
+					"Role");
+
 	switch (reason) {
 	case MGMT_DEV_DISCONN_UNKNOWN:
 		name = "org.bluez.Reason.Unknown";
src/device.c +5 -0
index 1ab4e5342..4ccafd15a 100644
@@ -3869,6 +3869,11 @@ bool btd_device_bdaddr_type_seen(struct btd_device *dev, uint8_t type)
 	return get_state(dev, type)->last_seen != 0;
 }
 
+bool btd_device_bdaddr_type_initiator(struct btd_device *dev, uint8_t type)
+{
+	return get_state(dev, type)->initiator;
+}
+
 static void clear_temporary_timer(struct btd_device *dev)
 {
 	if (dev->temporary_timer) {
src/device.h +1 -0
index 756540056..5ead73958 100644
@@ -129,6 +129,7 @@ bool btd_device_bearer_is_connected(struct btd_device *dev);
 bool btd_device_bdaddr_type_connected(struct btd_device *dev, uint8_t type);
 bool btd_device_bdaddr_type_connectable(struct btd_device *dev, uint8_t type);
 bool btd_device_bdaddr_type_seen(struct btd_device *dev, uint8_t type);
+bool btd_device_bdaddr_type_initiator(struct btd_device *dev, uint8_t type);
 uint8_t btd_device_get_bdaddr_type(struct btd_device *dev);
 bool device_is_retrying(struct btd_device *device);
 void device_bonding_complete(struct btd_device *device, uint8_t bdaddr_type,
Signature · 1 line
2.54.0 (Apple Git-157)
#4 lore raw

PATCH v2 3/3 client: Print LE.Role in info

In reply to Kevin Dewald

This prints the Role property of the LE bearer with the likes of info command:

bluetoothctl> info <addr>
...
LE.Connected: yes
LE.Connectable: yes
LE.Role: central

Assisted-by Claude:claude-opus-5.5
---
 client/main.c | 1 +
 1 file changed, 1 insertion(+)
client/main.c +1 -0
index f5fdd7d12..d2d25b9f4 100644
@@ -2097,6 +2097,7 @@ static void cmd_info(int argc, char *argv[])
 		print_property_with_label(bearer, "Connected", "LE.Connected");
 		print_property_with_label(bearer, "Connectable",
 							"LE.Connectable");
+		print_property_with_label(bearer, "Role", "LE.Role");
 	}
 
 	return bt_shell_noninteractive_quit(EXIT_SUCCESS);
Signature · 1 line
2.54.0 (Apple Git-157)
#5 lore raw
In reply to Kevin Dewald

Hi Kevin,

Quoted 14 lines · Kevin Dewald

Applications acting as a peripheral, or in both roles, cannot tell whether a connected device is a central that connected to the adapter or a peripheral the adapter connected to. When several applications share the adapter, a device object can appear because of any of them, so the order of events does not answer it either.

bluetoothd already tracks this per bearer from the Device Connected event. This series exposes it as a Role property on org.bluez.Bearer.LE1, "central" or "peripheral", present only while the device is connected over LE, and prints it as LE.Role in bluetoothctl info. The documentation states that it is the link layer role and says nothing about GATT client and server roles.

Quoted 5 lines

Like the rest of the bearer interfaces, the property is experimental, so applications only see it when bluetoothd runs with -E, which few systems do. Is there a plan to promote the bearer interfaces, or some of their properties, to stable? I would be glad to help with whatever that needs.

Good question. Perhaps we should consider marking them stable, but first we need to implement test automation using test-functional to ensure they are truly stable.

Quoted 4 lines

Tested with two btvirt controllers, where the advertising side reports the other as "central" and the connecting side reports it as "peripheral", and with a real adapter connecting to an nRF52840. The property goes away when the connection does.

For this type of testing we can use the test-functional framework nowadays, so we just have to create a few tests to validate our expectations. Prototyping something like doc/functional-bearer.rst for testing the interfaces.

Quoted 21 lines

Changes in v2:
- Move the property from org.bluez.Device1 to org.bluez.Bearer.LE1, so it is clearly per connection (Luiz)
- State in the documentation that it says nothing about GATT roles (Luiz)

Kevin Dewald (3):
org.bluez.Bearer: Add Role property
bearer: Add Role property
client: Print LE.Role in info

 client/main.c               |  1 +
 doc/org.bluez.Bearer.LE.rst | 24 +++++++++++++++++++++
 src/bearer.c                | 42 +++++++++++++++++++++++++++++++++++++
 src/device.c                |  5 +++++
 src/device.h                |  1 +
 5 files changed, 73 insertions(+)

--
2.54.0 (Apple Git-157)

Signature · 1 line
Luiz Augusto von Dentz
#6 lore raw

Hi Luiz,

Quoted 8 lines · Luiz Augusto von Dentz

Good question. Perhaps we should consider marking them stable, but first we need to implement test automation using test-functional to ensure they are truly stable.

For this type of testing we can use the test-functional framework nowadays, so we just have to create a few tests to validate our expectations. Prototyping something like doc/functional-bearer.rst for testing the interfaces.

I can write those: a test/functional/test_bearer.py with a matching doc/functional-bearer.rst, covering Connect and Disconnect, Connected and the Disconnected signal, Paired and Bonded on both bearers, Connectable, and Role.

Would you like them added to this series as a v3, or sent separately so this one can go in as it is?

Kevin

#7 lore raw

Hi Kevin,

Quoted 13 lines · Kevin Dewald

Hi Luiz,

Quoted 8 lines · Luiz Augusto von Dentz

Good question. Perhaps we should consider marking them stable, but first we need to implement test automation using test-functional to ensure they are truly stable.

For this type of testing we can use the test-functional framework nowadays, so we just have to create a few tests to validate our expectations. Prototyping something like doc/functional-bearer.rst for testing the interfaces.

Quoted 7 lines

I can write those: a test/functional/test_bearer.py with a matching doc/functional-bearer.rst, covering Connect and Disconnect, Connected and the Disconnected signal, Paired and Bonded on both bearers, Connectable, and Role.

Would you like them added to this series as a v3, or sent separately so this one can go in as it is?

Either approach works; we only recommend splitting the series if it grows too large (20+ commits).

Quoted 1 line

Kevin

Signature · 1 line
Luiz Augusto von Dentz