From: Kevin Dewald <kevin@simpleble.org>
To: linux-bluetooth@vger.kernel.org
Cc: Luiz Augusto von Dentz <luiz.dentz@gmail.com>,
Kevin Dewald <kevin@simpleble.org>
Subject: [PATCH BlueZ 1/3] org.bluez.Bearer: Promote to stable
Date: Fri, 23 Oct 2026 15:37:06 -0700 [thread overview]
Message-ID: <20261023223708.76232-2-kevin@simpleble.org> (raw)
In-Reply-To: <20261023223708.76232-1-kevin@simpleble.org>
Promote the methods, signal and properties of org.bluez.Bearer.LE1 and
org.bluez.Bearer.BREDR1 to stable, so they can be used by upper layers
without having to enable experimental. They are now covered by the
bearer functional tests.
Assisted-by: Claude:claude-opus-5.5
---
doc/org.bluez.Bearer.BREDR.rst | 32 +++++++++++++++---------------
doc/org.bluez.Bearer.LE.rst | 36 +++++++++++++++++-----------------
2 files changed, 34 insertions(+), 34 deletions(-)
diff --git a/doc/org.bluez.Bearer.BREDR.rst b/doc/org.bluez.Bearer.BREDR.rst
index a1477a2d2..370ea6e6c 100644
--- a/doc/org.bluez.Bearer.BREDR.rst
+++ b/doc/org.bluez.Bearer.BREDR.rst
@@ -21,8 +21,8 @@ Interface
Methods
-------
-void Connect() [experimental]
-`````````````````````````````
+void Connect()
+``````````````
Connects all BREDR profiles the remote device supports that can be connected to
and have been flagged as auto-connectable. If only subset of profiles is already
@@ -38,8 +38,8 @@ Possible errors:
:org.bluez.Error.InProgress:
:org.bluez.Error.AlreadyConnected:
-void Disconnect() [experimental]
-````````````````````````````````
+void Disconnect()
+`````````````````
Disconnects all connected profiles and then terminates low-level ACL connection.
@@ -59,8 +59,8 @@ Possible errors:
Signals
-------
-void Disconnected(string reason, string message) [experimental]
-```````````````````````````````````````````````````````````````
+void Disconnected(string reason, string message)
+````````````````````````````````````````````````
This signal is launched when a device is disconnected, with the reason of the
disconnection.
@@ -113,37 +113,37 @@ Possible reasons:
Properties
----------
-object Adapter [readonly, experimental]
-```````````````````````````````````````
+object Adapter [readonly]
+`````````````````````````
The object path of the adapter the set belongs to.
-boolean Paired [readonly, experimental]
-```````````````````````````````````````
+boolean Paired [readonly]
+`````````````````````````
Indicates if the remote device is paired to BREDR bearer.
Paired means the pairing process where devices exchange the information to
establish an encrypted connection has been completed.
-boolean Bonded [readonly, experimental]
-```````````````````````````````````````
+boolean Bonded [readonly]
+`````````````````````````
Indicates if the remote device is bonded to BREDR bearer.
Bonded means the information exchanged on pairing process has been stored and
will be persisted.
-boolean Connected [readonly, experimental]
-``````````````````````````````````````````
+boolean Connected [readonly]
+````````````````````````````
Indicates if the remote device is currently connected to BREDR bearer.
A PropertiesChanged signal indicate changes to this status.
-boolean Connectable [readonly, experimental]
-````````````````````````````````````````````
+boolean Connectable [readonly]
+``````````````````````````````
Indicates if the remote device accepts connections on BREDR bearer. BREDR
devices are always considered connectable.
diff --git a/doc/org.bluez.Bearer.LE.rst b/doc/org.bluez.Bearer.LE.rst
index dfd809739..6d3df3fcf 100644
--- a/doc/org.bluez.Bearer.LE.rst
+++ b/doc/org.bluez.Bearer.LE.rst
@@ -21,8 +21,8 @@ Interface
Methods
-------
-void Connect() [experimental]
-`````````````````````````````
+void Connect()
+``````````````
Connects all LE profiles the remote device supports that can be connected to and
have been flagged as auto-connectable. If only subset of profiles is already
@@ -38,8 +38,8 @@ Possible errors:
:org.bluez.Error.InProgress:
:org.bluez.Error.AlreadyConnected:
-void Disconnect() [experimental]
-````````````````````````````````
+void Disconnect()
+`````````````````
Disconnects all connected profiles and then terminates low-level ACL-LE
connection.
@@ -60,8 +60,8 @@ Possible errors:
Signals
-------
-void Disconnected(string reason, string message) [experimental]
-```````````````````````````````````````````````````````````````
+void Disconnected(string reason, string message)
+````````````````````````````````````````````````
This signal is launched when a device is disconnected, with the reason of the
disconnection.
@@ -114,36 +114,36 @@ Possible reasons:
Properties
----------
-object Adapter [readonly, experimental]
-```````````````````````````````````````
+object Adapter [readonly]
+`````````````````````````
The object path of the adapter the set belongs to.
-boolean Paired [readonly, experimental]
-```````````````````````````````````````
+boolean Paired [readonly]
+`````````````````````````
Indicates if the remote device is paired to LE bearer.
Paired means the pairing process where devices exchange the information to
establish an encrypted connection has been completed.
-boolean Bonded [readonly, experimental]
-```````````````````````````````````````
+boolean Bonded [readonly]
+`````````````````````````
Indicates if the remote device is bonded to LE bearer.
Bonded means the information exchanged on pairing process has been stored and
will be persisted.
-boolean Connected [readonly, experimental]
-``````````````````````````````````````````
+boolean Connected [readonly]
+````````````````````````````
Indicates if the remote device is currently connected to LE bearer.
A PropertiesChanged signal indicate changes to this status.
-boolean Connectable [readonly, optional, experimental]
-``````````````````````````````````````````````````````
+boolean Connectable [readonly, optional]
+````````````````````````````````````````
Indicates if the remote device accepts connections on LE bearer, based on the
most recent advertising report. It is false when the last advertising report
@@ -154,8 +154,8 @@ over LE bearer.
A PropertiesChanged signal indicate changes to this status.
-string Role [readonly, optional, experimental]
-``````````````````````````````````````````````
+string Role [readonly, optional]
+````````````````````````````````
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.
--
2.54.0 (Apple Git-157)
next prev parent reply other threads:[~2026-10-23 22:37 UTC|newest]
Thread overview: 6+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-10-23 22:37 [PATCH BlueZ 0/3] Promote the bearer interfaces to stable Kevin Dewald
2026-10-23 22:37 ` Kevin Dewald [this message]
2026-10-24 1:14 ` bluez.test.bot
2026-10-23 22:37 ` [PATCH BlueZ 2/3] bearer: Promote " Kevin Dewald
2026-10-23 22:37 ` [PATCH BlueZ 3/3] test: functional: run bearer tests without experimental Kevin Dewald
2026-10-26 21:40 ` [PATCH BlueZ 0/3] Promote the bearer interfaces to stable patchwork-bot+bluetooth
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20261023223708.76232-2-kevin@simpleble.org \
--to=kevin@simpleble.org \
--cc=linux-bluetooth@vger.kernel.org \
--cc=luiz.dentz@gmail.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox