* [PATCH BlueZ v1 1/3] doc: Add org.bluez.ChannelSoundingDistance1 documentation
2026-07-30 11:43 [PATCH BlueZ v1 0/3] doc: Add Channel Sounding distance provider documentation Naga Bhavani Akella
@ 2026-07-30 11:43 ` Naga Bhavani Akella
2026-07-30 12:42 ` doc: Add Channel Sounding distance provider documentation bluez.test.bot
2026-07-30 11:43 ` [PATCH BlueZ v1 2/3] doc: Add org.bluez.ChannelSoundingDistanceProvider documentation Naga Bhavani Akella
2026-07-30 11:43 ` [PATCH BlueZ v1 3/3] doc: Add org.bluez.ChannelSoundingDistanceProviderManager documentation Naga Bhavani Akella
2 siblings, 1 reply; 5+ messages in thread
From: Naga Bhavani Akella @ 2026-07-30 11:43 UTC (permalink / raw)
To: linux-bluetooth
Cc: luiz.dentz, quic_mohamull, quic_hbandi, quic_anubhavg,
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.
--
^ permalink raw reply related [flat|nested] 5+ messages in thread* RE: doc: Add Channel Sounding distance provider documentation
2026-07-30 11:43 ` [PATCH BlueZ v1 1/3] doc: Add org.bluez.ChannelSoundingDistance1 documentation Naga Bhavani Akella
@ 2026-07-30 12:42 ` bluez.test.bot
0 siblings, 0 replies; 5+ messages in thread
From: bluez.test.bot @ 2026-07-30 12:42 UTC (permalink / raw)
To: linux-bluetooth, naga.akella
[-- 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
^ permalink raw reply [flat|nested] 5+ messages in thread
* [PATCH BlueZ v1 2/3] doc: Add org.bluez.ChannelSoundingDistanceProvider documentation
2026-07-30 11:43 [PATCH BlueZ v1 0/3] doc: Add Channel Sounding distance provider documentation Naga Bhavani Akella
2026-07-30 11:43 ` [PATCH BlueZ v1 1/3] doc: Add org.bluez.ChannelSoundingDistance1 documentation Naga Bhavani Akella
@ 2026-07-30 11:43 ` Naga Bhavani Akella
2026-07-30 11:43 ` [PATCH BlueZ v1 3/3] doc: Add org.bluez.ChannelSoundingDistanceProviderManager documentation Naga Bhavani Akella
2 siblings, 0 replies; 5+ messages in thread
From: Naga Bhavani Akella @ 2026-07-30 11:43 UTC (permalink / raw)
To: linux-bluetooth
Cc: luiz.dentz, quic_mohamull, quic_hbandi, quic_anubhavg,
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.
--
^ permalink raw reply related [flat|nested] 5+ messages in thread* [PATCH BlueZ v1 3/3] doc: Add org.bluez.ChannelSoundingDistanceProviderManager documentation
2026-07-30 11:43 [PATCH BlueZ v1 0/3] doc: Add Channel Sounding distance provider documentation Naga Bhavani Akella
2026-07-30 11:43 ` [PATCH BlueZ v1 1/3] doc: Add org.bluez.ChannelSoundingDistance1 documentation Naga Bhavani Akella
2026-07-30 11:43 ` [PATCH BlueZ v1 2/3] doc: Add org.bluez.ChannelSoundingDistanceProvider documentation Naga Bhavani Akella
@ 2026-07-30 11:43 ` Naga Bhavani Akella
2 siblings, 0 replies; 5+ messages in thread
From: Naga Bhavani Akella @ 2026-07-30 11:43 UTC (permalink / raw)
To: linux-bluetooth
Cc: luiz.dentz, quic_mohamull, quic_hbandi, quic_anubhavg,
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)**.
--
^ permalink raw reply related [flat|nested] 5+ messages in thread