.\" 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.RangingProvider1" "5" "August 2026" "BlueZ" "Linux System Administration" .SH Name org.bluez.RangingProvider1 \- BlueZ D-Bus RangingProvider API documentation .SH Interface .INDENT 0.0 .TP .B Service .TP .B Interface org.bluez.RangingProvider1 .TP .B Object path {provider_root}/{unique ranging object path} .UNINDENT .SS Properties .SS object Device [readonly] .sp The object path of the device that this distance estimate applies to. .SS uint32 Distance [readonly, optional] .sp Estimated distance to the device identified by \fBDevice\fP, in millimeters. May be absent when the object is first exposed and set once the provider has computed an initial estimate; \fBbluetoothd(8)\fP watches for it via \fBPropertiesChanged\fP\&. .SH Error handling .sp This interface has no methods; it is implemented by the ranging daemon and consumed by \fBbluetoothd(8)\fP via \fBorg.freedesktop.DBus.ObjectManager\fP and property\-change watches, so there is no D\-Bus method call to return an error from. Instead, \fBbluetoothd(8)\fP validates each exposed object and silently ignores (logging a warning) any that fail validation: .INDENT 0.0 .IP \(bu 2 An object path outside the provider\(aqs registered root path is ignored. .IP \(bu 2 An object missing the \fBDevice\fP property, or whose \fBDevice\fP property is not an object path, is ignored. .IP \(bu 2 An object whose \fBDevice\fP does not match an existing, non\-temporary device is ignored. .IP \(bu 2 A \fBDistance\fP value (initial or updated) that is not a uint32 is ignored; the previously reported value, if any, is left unchanged. .IP \(bu 2 If the provider has already exposed a \fBRangingProvider\fP object for a given device (e.g. a stale or duplicate object), any further object it exposes for that same device is ignored — each device may only be represented by one \fBRangingProvider\fP object at a time. Note that only one provider may be registered per adapter at all (see \fBorg.bluez.RangingProviderManager1(5)\fP), so this situation can only arise from the same provider re\-exposing a device, not from a second, distinct provider racing for it. .UNINDENT .sp Removing an ignored object, or fixing it and re\-adding it, is treated the same as any other \fBInterfacesAdded\fP/\fBInterfacesRemoved\fP event. .SH Overview .sp A ranging daemon exposes one \fBRangingProvider\fP object per device it is tracking, under the root path it registered with \fBorg.bluez.RangingProviderManager1(5)\fP: .INDENT 0.0 .INDENT 3.5 .sp .EX Ranging daemon bluetoothd | | | export {provider_root}/dev_XX (RangingProvider) | | { Device: } | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\->| | | reflects a | | Ranging object | | on the device path | | | Distance = D | | PropertiesChanged(\(dqDistance\(dq, D) | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\->| | | updates | | Ranging.Distance | | and notifies clients | | (see org.bluez.Ranging1(5)) .EE .UNINDENT .UNINDENT .sp Removing the object (or disconnecting from D\-Bus) causes \fBbluetoothd(8)\fP to remove the matching \fBorg.bluez.Ranging1(5)\fP interface from the device. .\" End of generated man page.