.\" Man page generated from reStructuredText .\" by the Docutils 0.23 manpage writer. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "org.bluez.Ranging1" "5" "August 2026" "BlueZ" "Linux System Administration" .SH Name org.bluez.Ranging1 \- BlueZ D-Bus Ranging API documentation .SH Interface .INDENT 0.0 .TP .B Service org.bluez .TP .B Interface org.bluez.Ranging1 .TP .B Object path [variable prefix]/{hci0,hci1,...}/dev_XX_XX_XX_XX_XX_XX .UNINDENT .SS Properties .SS uint32 Distance [readonly] .sp Estimated distance to the remote device, in millimeters, as last reported by a ranging provider. .sp Providers implementing \fBorg.bluez.RangingProvider1(5)\fP, registered via \fBorg.bluez.RangingProviderManager1(5)\fP, compute this value and report it back to \fBbluetoothd(8)\fP for reflection here. For Channel Sounding based ranging, a provider derives the distance from the raw procedure data reported via the \fBProcedureData\fP signal on \fBorg.bluez.ChannelSounding1(5)\fP, but this interface itself carries no assumption about the underlying ranging technology. .sp This property emits \fBPropertiesChanged\fP whenever a new estimate is reported. .sp This property does not exist until a ranging provider has reported at least one estimate for this device; reading it before then (e.g. via \fBorg.freedesktop.DBus.Properties.Get\fP) fails with \fBorg.freedesktop.DBus.Error.UnknownProperty\fP, and it is omitted from \fBGetAll\fP/\fBGetManagedObjects\fP results. Once a provider unregisters or stops providing ranging for this device, this whole \fBRanging\fP interface — and therefore the \fBDistance\fP property — is removed (\fBInterfacesRemoved\fP); it does not linger with a stale value. .SH Overview .sp \fBRanging\fP is the read side of a three\-party pattern .INDENT 0.0 .INDENT 3.5 .sp .EX Ranging daemon \-\- RangingProvider \-\-> BlueZ \-\- Ranging \-\-> Desktop clients (registered via RangingProviderManager) .EE .UNINDENT .UNINDENT .sp Sequence for a single distance update, once a provider is registered (see \fBorg.bluez.RangingProviderManager1(5)\fP) and has exposed a \fBorg.bluez.RangingProvider1(5)\fP object for the device (see \fBorg.bluez.RangingProvider1(5)\fP): .INDENT 0.0 .INDENT 3.5 .sp .EX Ranging daemon bluetoothd Desktop client | | | | Distance = D on its | | | RangingProvider object | | | | | | PropertiesChanged( | | | RangingProvider, | | | \(dqDistance\(dq, D) | | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\->| | | | updates Ranging on the | | | device path with D | | | | | | PropertiesChanged( | | | Ranging, | | | \(dqDistance\(dq, D) | | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\->| .EE .UNINDENT .UNINDENT .\" End of generated man page.