src.bluetooth_sig.gatt.characteristics.preferred_units¶

Preferred Units characteristic (0x2B46).

Classes¶

Name	Description
`PreferredUnitsCharacteristic`	Preferred Units characteristic (0x2B46).
`PreferredUnitsData`	Preferred Units data structure.

Module Contents¶

class src.bluetooth_sig.gatt.characteristics.preferred_units.PreferredUnitsCharacteristic¶

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

Preferred Units characteristic (0x2B46).

org.bluetooth.characteristic.preferred_units

The Preferred Units characteristic is the list of units the user prefers. Each unit is represented by a 16-bit Bluetooth UUID from the Bluetooth SIG units registry.

get_units(data: PreferredUnitsData) → list[src.bluetooth_sig.types.registry.units.UnitInfo]¶

Get unit information for the preferred units.

Parameters:: data – PreferredUnitsData containing unit UUIDs
Returns:: List of UnitInfo objects, with placeholder UnitInfo for unrecognized UUIDs

validate_units(data: PreferredUnitsData) → list[str]¶

Validate that all units in the data are recognized Bluetooth SIG units.

Parameters:: data – PreferredUnitsData to validate
Returns:: List of validation errors (empty if all units are valid)

allow_variable_length = True¶

min_length = 0¶

class src.bluetooth_sig.gatt.characteristics.preferred_units.PreferredUnitsData¶

Bases: msgspec.Struct

Preferred Units data structure.

units: list[src.bluetooth_sig.types.uuid.BluetoothUUID]¶