src.bluetooth_sig.gatt.characteristics.uncertainty

Uncertainty characteristic implementation.

Classes

Name

Description

UncertaintyCharacteristic

Uncertainty characteristic (0x2AB4).

Module Contents

class src.bluetooth_sig.gatt.characteristics.uncertainty.UncertaintyCharacteristic

Bases: src.bluetooth_sig.gatt.characteristics.base.BaseCharacteristic[float]

Uncertainty characteristic (0x2AB4).

org.bluetooth.characteristic.uncertainty

Uncertainty characteristic for Indoor Positioning Service.

This characteristic represents the uncertainty or accuracy of the indoor positioning measurements. It provides an estimate of the error margin for the position coordinates (Local North Coordinate, Local East Coordinate, and Altitude).

The uncertainty value indicates the radius of a circle (in 2D) or sphere (in 3D) within which the actual position is expected to lie with a certain confidence level. The value is encoded as a scaled uint8 with 0.1 meter resolution, providing a range of 0-25.5 meters.

A value of 0 indicates the highest accuracy (no uncertainty), while higher values indicate increasing uncertainty in the position measurements.

Parameters:

  • data – Raw bytes from BLE characteristic (exactly 1 byte, uint8)

  • ctx – Optional context for parsing

Returns:

Uncertainty radius in meters (0.0 to 25.5)

Raises:
Spec Reference:

Bluetooth SIG Assigned Numbers, Uncertainty characteristic (0x2AB4) Indoor Positioning Service specification