[PATCH BlueZ v1 0/3] doc: Add Channel Sounding distance provider documentation

[PATCH BlueZ v1 0/3] doc: Add Channel Sounding distance provider documentation

[Naga Bhavani Akella]

This series documents the D-Bus API that lets an external ranging
daemon compute Channel Sounding distance estimates from the raw
procedure data BlueZ reports, and feed them back for reflection on
the device's Channel Sounding interface

Patch 3 documents ChannelSoundingDistanceProviderManager1, which a
ranging daemon uses to register/unregister itself as a distance
provider.

Patch 2 documents ChannelSoundingDistanceProvider1, the interface the
registered provider implements to expose per-device distance
estimates.

Patch 1 documents ChannelSoundingDistance1, the BlueZ-owned interface
that reflects the provider's DistanceMeters estimate for consumption
by desktop clients.


Naga Bhavani Akella (3):
  doc: Add org.bluez.ChannelSoundingDistance1 documentation
  doc: Add org.bluez.ChannelSoundingDistanceProvider documentation
  doc: Add org.bluez.ChannelSoundingDistanceProviderManager
    documentation

 Makefile.am                                   | 15 +++++-
 doc/org.bluez.ChannelSoundingDistance1.rst    | 36 +++++++++++++
 ....bluez.ChannelSoundingDistanceProvider.rst | 32 +++++++++++
 ...ChannelSoundingDistanceProviderManager.rst | 53 +++++++++++++++++++
 4 files changed, 134 insertions(+), 2 deletions(-)
 create mode 100644 doc/org.bluez.ChannelSoundingDistance1.rst
 create mode 100644 doc/org.bluez.ChannelSoundingDistanceProvider.rst
 create mode 100644 doc/org.bluez.ChannelSoundingDistanceProviderManager.rst

-- 

[PATCH BlueZ v1 1/3] doc: Add org.bluez.ChannelSoundingDistance1 documentation

[Naga Bhavani Akella]

Document the org.bluez.ChannelSoundingDistance1 interface, which
exposes the DistanceMeters estimate computed by an external ranging
provider registered via ChannelSoundingDistanceProviderManager1.
---
 Makefile.am                                |  9 ++++--
 doc/org.bluez.ChannelSoundingDistance1.rst | 36 ++++++++++++++++++++++
 2 files changed, 43 insertions(+), 2 deletions(-)
 create mode 100644 doc/org.bluez.ChannelSoundingDistance1.rst

diff --git a/Makefile.am b/Makefile.am
index 19c468d3a..a5a3c0d30 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -405,7 +405,8 @@ man_MANS += doc/org.bluez.Telephony.5 doc/org.bluez.Call.5
 man_MANS += doc/org.bluez.ThermometerManager.5 \
 		doc/org.bluez.Thermometer.5 \
 		doc/org.bluez.ThermometerWatcher.5
-man_MANS += doc/org.bluez.ChannelSounding1.5
+man_MANS += doc/org.bluez.ChannelSounding1.5 \
+			doc/org.bluez.ChannelSoundingDistance1.5
 endif
 manual_pages += doc/bluetoothd.8
 manual_pages += doc/hci.7 doc/mgmt.7 doc/l2cap.7 doc/rfcomm.7 doc/sco.7 \
@@ -446,7 +447,8 @@ manual_pages += doc/org.bluez.Telephony.5 doc/org.bluez.Call.5
 manual_pages += doc/org.bluez.ThermometerManager.5 \
 		doc/org.bluez.Thermometer.5 \
 		doc/org.bluez.ThermometerWatcher.5
-manual_pages += doc/org.bluez.ChannelSounding1.5
+manual_pages += doc/org.bluez.ChannelSounding1.5 \
+				doc/org.bluez.ChannelSoundingDistance1.5
 
 EXTRA_DIST += src/genbuiltin src/bluetooth.conf \
 			src/main.conf profiles/network/network.conf \
@@ -535,6 +537,9 @@ EXTRA_DIST += doc/org.bluez.ThermometerManager.rst \
 	      doc/org.bluez.Thermometer.rst \
 	      doc/org.bluez.ThermometerWatcher.rst
 
+EXTRA_DIST += doc/org.bluez.ChannelSounding1.rst \
+		doc/org.bluez.ChannelSoundingDistance1.rst \
+
 EXTRA_DIST += doc/pics-opp.txt doc/pixit-opp.txt \
 		doc/pts-opp.txt
 
diff --git a/doc/org.bluez.ChannelSoundingDistance1.rst b/doc/org.bluez.ChannelSoundingDistance1.rst
new file mode 100644
index 000000000..2ce7af2bf
--- /dev/null
+++ b/doc/org.bluez.ChannelSoundingDistance1.rst
@@ -0,0 +1,36 @@
+==================================
+org.bluez.ChannelSoundingDistance1
+==================================
+
+----------------------------------------------------------
+BlueZ D-Bus ChannelSoundingDistance API documentation
+----------------------------------------------------------
+
+:Version: BlueZ
+:Date: July 2026
+:Manual section: 5
+:Manual group: Linux System Administration
+
+Interface
+=========
+
+:Service:	org.bluez
+:Interface:	org.bluez.ChannelSoundingDistance1
+:Object path:	[variable prefix]/{hci0,hci1,...}/dev_XX_XX_XX_XX_XX_XX
+
+Properties
+----------
+
+double DistanceMeters [readonly]
+`````````````````````````````````
+
+Estimated distance to the remote device, in meters, as last computed
+from Channel Sounding measurement data.
+
+Providers from **org.bluez.ChannelSoundingDistanceProvider(5)** compute
+this value from the raw procedure data reported via the **ProcedureData**
+signal on **org.bluez.ChannelSounding1(5)**, and report it back to
+**bluetoothd(8)** for reflection here.
+
+This property emits ``PropertiesChanged`` whenever a new estimate is
+reported.
-- 

[PATCH BlueZ v1 2/3] doc: Add org.bluez.ChannelSoundingDistanceProvider documentation

[Naga Bhavani Akella]

Document the org.bluez.ChannelSoundingDistanceProvider1 interface,
implemented by external clients to expose per-device Channel Sounding
distance estimates that BlueZ reflects onto the corresponding device
object.
---
 Makefile.am                                   |  7 ++--
 ....bluez.ChannelSoundingDistanceProvider.rst | 32 +++++++++++++++++++
 2 files changed, 37 insertions(+), 2 deletions(-)
 create mode 100644 doc/org.bluez.ChannelSoundingDistanceProvider.rst

diff --git a/Makefile.am b/Makefile.am
index a5a3c0d30..e5ecf232f 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -406,7 +406,8 @@ man_MANS += doc/org.bluez.ThermometerManager.5 \
 		doc/org.bluez.Thermometer.5 \
 		doc/org.bluez.ThermometerWatcher.5
 man_MANS += doc/org.bluez.ChannelSounding1.5 \
-			doc/org.bluez.ChannelSoundingDistance1.5
+			doc/org.bluez.ChannelSoundingDistance1.5 \
+			doc/org.bluez.ChannelSoundingDistanceProvider.5
 endif
 manual_pages += doc/bluetoothd.8
 manual_pages += doc/hci.7 doc/mgmt.7 doc/l2cap.7 doc/rfcomm.7 doc/sco.7 \
@@ -448,7 +449,8 @@ manual_pages += doc/org.bluez.ThermometerManager.5 \
 		doc/org.bluez.Thermometer.5 \
 		doc/org.bluez.ThermometerWatcher.5
 manual_pages += doc/org.bluez.ChannelSounding1.5 \
-				doc/org.bluez.ChannelSoundingDistance1.5
+				doc/org.bluez.ChannelSoundingDistance1.5 \
+				doc/org.bluez.ChannelSoundingDistanceProvider.5
 
 EXTRA_DIST += src/genbuiltin src/bluetooth.conf \
 			src/main.conf profiles/network/network.conf \
@@ -539,6 +541,7 @@ EXTRA_DIST += doc/org.bluez.ThermometerManager.rst \
 
 EXTRA_DIST += doc/org.bluez.ChannelSounding1.rst \
 		doc/org.bluez.ChannelSoundingDistance1.rst \
+		doc/org.bluez.ChannelSoundingDistanceProvider.rst
 
 EXTRA_DIST += doc/pics-opp.txt doc/pixit-opp.txt \
 		doc/pts-opp.txt
diff --git a/doc/org.bluez.ChannelSoundingDistanceProvider.rst b/doc/org.bluez.ChannelSoundingDistanceProvider.rst
new file mode 100644
index 000000000..9a7a390bf
--- /dev/null
+++ b/doc/org.bluez.ChannelSoundingDistanceProvider.rst
@@ -0,0 +1,32 @@
+=========================================
+org.bluez.ChannelSoundingDistanceProvider
+=========================================
+
+-------------------------------------------------------------
+BlueZ D-Bus ChannelSoundingDistanceProvider API documentation
+-------------------------------------------------------------
+
+:Version: BlueZ
+:Date: July 2026
+:Manual section: 5
+:Manual group: Linux System Administration
+
+Interface
+=========
+
+:Service:	<client D-Bus address>
+:Interface:	org.bluez.ChannelSoundingDistanceProvider1
+:Object path:	{provider_root}/{unique distance object path}
+
+Properties
+----------
+
+Objects provided on this interface contain the same properties as
+**org.bluez.ChannelSounding1(5)** interface. Additionally, this interface
+needs to have the Device property indicating the object path of the
+device this distance estimate provides.
+
+object Device [readonly]
+````````````````````````
+
+The object path of the device that this distance estimate applies to.
-- 

[PATCH BlueZ v1 3/3] doc: Add org.bluez.ChannelSoundingDistanceProviderManager documentation

[Naga Bhavani Akella]

Document the org.bluez.ChannelSoundingDistanceProviderManager1
interface, used by external clients to register and unregister
themselves as Channel Sounding distance providers via
RegisterDistanceProvider/UnregisterDistanceProvider.
---
 Makefile.am                                   |  9 ++--
 ...ChannelSoundingDistanceProviderManager.rst | 53 +++++++++++++++++++
 2 files changed, 59 insertions(+), 3 deletions(-)
 create mode 100644 doc/org.bluez.ChannelSoundingDistanceProviderManager.rst

diff --git a/Makefile.am b/Makefile.am
index e5ecf232f..fe2bb6f2c 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -407,7 +407,8 @@ man_MANS += doc/org.bluez.ThermometerManager.5 \
 		doc/org.bluez.ThermometerWatcher.5
 man_MANS += doc/org.bluez.ChannelSounding1.5 \
 			doc/org.bluez.ChannelSoundingDistance1.5 \
-			doc/org.bluez.ChannelSoundingDistanceProvider.5
+			doc/org.bluez.ChannelSoundingDistanceProvider.5 \
+			doc/org.bluez.ChannelSoundingDistanceProviderManager.5
 endif
 manual_pages += doc/bluetoothd.8
 manual_pages += doc/hci.7 doc/mgmt.7 doc/l2cap.7 doc/rfcomm.7 doc/sco.7 \
@@ -450,7 +451,8 @@ manual_pages += doc/org.bluez.ThermometerManager.5 \
 		doc/org.bluez.ThermometerWatcher.5
 manual_pages += doc/org.bluez.ChannelSounding1.5 \
 				doc/org.bluez.ChannelSoundingDistance1.5 \
-				doc/org.bluez.ChannelSoundingDistanceProvider.5
+				doc/org.bluez.ChannelSoundingDistanceProvider.5 \
+				doc/org.bluez.ChannelSoundingDistanceProviderManager.5
 
 EXTRA_DIST += src/genbuiltin src/bluetooth.conf \
 			src/main.conf profiles/network/network.conf \
@@ -541,7 +543,8 @@ EXTRA_DIST += doc/org.bluez.ThermometerManager.rst \
 
 EXTRA_DIST += doc/org.bluez.ChannelSounding1.rst \
 		doc/org.bluez.ChannelSoundingDistance1.rst \
-		doc/org.bluez.ChannelSoundingDistanceProvider.rst
+		doc/org.bluez.ChannelSoundingDistanceProvider.rst \
+		doc/org.bluez.ChannelSoundingDistanceProviderManager.rst
 
 EXTRA_DIST += doc/pics-opp.txt doc/pixit-opp.txt \
 		doc/pts-opp.txt
diff --git a/doc/org.bluez.ChannelSoundingDistanceProviderManager.rst b/doc/org.bluez.ChannelSoundingDistanceProviderManager.rst
new file mode 100644
index 000000000..09298fe4a
--- /dev/null
+++ b/doc/org.bluez.ChannelSoundingDistanceProviderManager.rst
@@ -0,0 +1,53 @@
+================================================
+org.bluez.ChannelSoundingDistanceProviderManager
+================================================
+
+--------------------------------------------------------------------
+BlueZ D-Bus ChannelSoundingDistanceProviderManager API documentation
+--------------------------------------------------------------------
+
+:Version: BlueZ
+:Date: July 2026
+:Manual section: 5
+:Manual group: Linux System Administration
+
+Description
+===========
+
+A Channel Sounding distance provider starts by registering itself as a
+distance provider with the **RegisterDistanceProvider()** method passing
+an object path as the provider ID. Then, it can start exposing
+**org.bluez.ChannelSoundingDistanceProvider(5)** objects having the path
+starting with the given provider ID. It can also remove objects at any
+time.
+The objects and their properties exposed by distance providers will be
+reflected on the matching **org.bluez.ChannelSoundingDistance1(5)**
+interface.
+
+**bluetoothd(8)** will stop monitoring these exposed and removed objects
+after UnregisterDistanceProvider is called for that provider ID.
+
+Interface
+=========
+
+:Service:	org.bluez
+:Interface:	org.bluez.ChannelSoundingDistanceProviderManager1
+:Object path:	/org/bluez/{hci0,hci1,...}
+
+Methods
+-------
+
+void RegisterDistanceProvider(object provider)
+``````````````````````````````````````````````
+
+Registers a distance provider. A registered distance provider can then
+expose objects with **org.bluez.ChannelSoundingDistanceProvider(5)**
+interface.
+
+void UnregisterDistanceProvider(object provider)
+````````````````````````````````````````````````
+
+Unregisters a distance provider previously registered with
+**RegisterDistanceProvider()**. After unregistration, the
+**org.bluez.ChannelSoundingDistanceProvider(5)** objects provided by this
+client are ignored by **bluetoothd(8)**.
-- 

RE: doc: Add Channel Sounding distance provider documentation

[bluez.test.bot]

[-- Attachment #1: Type: text/plain, Size: 2084 bytes --]

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/project/bluetooth/list/?series=1137365

---Test result---

Test Summary:
CheckPatch                    PASS      1.85 seconds
GitLint                       FAIL      2.35 seconds
BuildEll                      PASS      21.14 seconds
BluezMake                     PASS      555.86 seconds
MakeCheck                     PASS      19.26 seconds
MakeDistcheck                 PASS      159.94 seconds
CheckValgrind                 PASS      229.16 seconds
CheckSmatch                   PASS      309.20 seconds
bluezmakeextell               PASS      102.46 seconds
IncrementalBuild              FAIL      15.00 seconds
ScanBuild                     FAIL      2.50 seconds

Details
##############################
Test: GitLint - FAIL
Desc: Run gitlint
Output:
[BlueZ,v1,3/3] doc: Add org.bluez.ChannelSoundingDistanceProviderManager documentation

1: T1 Title exceeds max length (86>80): "[BlueZ,v1,3/3] doc: Add org.bluez.ChannelSoundingDistanceProviderManager documentation"
##############################
Test: IncrementalBuild - FAIL
Desc: Incremental build with the patches in the series
Output:

Makefile.am:542: error: blank line following trailing backslash
make: *** [Makefile:4184: Makefile.in] Error 1
[BlueZ,v1,1/3] doc: Add org.bluez.ChannelSoundingDistance1 documentation

Makefile.am:542: error: blank line following trailing backslash
make: *** [Makefile:4184: Makefile.in] Error 1
##############################
Test: ScanBuild - FAIL
Desc: Run Scan Build
Output:

Makefile.am:542: error: blank line following trailing backslash
make: *** [Makefile:4184: Makefile.in] Error 1
configure.ac:21: installing './compile'
configure.ac:5: installing './missing'
Makefile.am:542: error: blank line following trailing backslash
Makefile.am: installing './depcomp'


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

---
Regards,
Linux Bluetooth