Coverage for src / bluetooth_sig / gatt / characteristics / plx_features.py: 100%

1"""PLX Features characteristic implementation.""" 

2 

3from __future__ import annotations 

4 

5from enum import IntFlag 

6 

7from bluetooth_sig.gatt.context import CharacteristicContext 

8 

9from .base import BaseCharacteristic 

10from .utils import DataParser 

11 

12 

13class PLXFeatureFlags(IntFlag): 

14 """PLX Features flags per Bluetooth SIG specification. 

15 

16 Spec: Bluetooth SIG Assigned Numbers, PLX Features characteristic 

17 """ 

18 

19 MEASUREMENT_STATUS_SUPPORT = 0x0001 

20 DEVICE_AND_SENSOR_STATUS_SUPPORT = 0x0002 

21 MEASUREMENT_STORAGE_SUPPORT = 0x0004 

22 TIMESTAMP_SUPPORT = 0x0008 

23 SPO2PR_FAST_SUPPORT = 0x0010 

24 SPO2PR_SLOW_SUPPORT = 0x0020 

25 PULSE_AMPLITUDE_INDEX_SUPPORT = 0x0040 

26 MULTIPLE_BONDS_SUPPORT = 0x0080 

27 # Bits 8-15 are reserved for future use 

28 

29 

30class PLXFeaturesCharacteristic(BaseCharacteristic[PLXFeatureFlags]): 

31 """PLX Features characteristic (0x2A60). 

32 

33 Describes the supported features of a pulse oximeter device. 

34 Returns a 16-bit feature flags value. 

35 

36 Spec: Bluetooth SIG Assigned Numbers, PLX Features characteristic 

37 """ 

38 

39 _is_bitfield = True 

40 

41 expected_length: int | None = 2 

42 

43 def _decode_value( 

44 self, data: bytearray, ctx: CharacteristicContext | None = None, *, validate: bool = True 

45 ) -> PLXFeatureFlags: 

46 """Decode PLX features from raw bytes. 

47 

48 Args: 

49 data: Raw bytes from BLE characteristic (2 bytes) 

50 ctx: Unused, for signature compatibility 

51 validate: Whether to validate ranges (default True) 

52 

53 Returns: 

54 PLXFeatureFlags enum with supported features 

55 

56 """ 

57 del ctx # Unused parameter 

58 

59 raw_value = DataParser.parse_int16(data, 0, signed=False) 

60 return PLXFeatureFlags(raw_value) 

61 

62 def _encode_value(self, data: PLXFeatureFlags | int) -> bytearray: 

63 """Encode PLX features to bytes. 

64 

65 Args: 

66 data: PLXFeatureFlags enum or 16-bit feature flags as integer 

67 

68 Returns: 

69 Encoded bytes (2 bytes, little-endian) 

70 

71 """ 

72 value = data.value if isinstance(data, PLXFeatureFlags) else data 

73 return DataParser.encode_int16(value, signed=False)