Coverage for src/bluetooth_sig/gatt/descriptors/environmental_sensing_trigger_setting.py: 82%

1"""Environmental Sensing Trigger Setting Descriptor implementation.""" 

2 

3from __future__ import annotations 

4 

5import msgspec 

6 

7from ..characteristics.utils import DataParser 

8from .base import BaseDescriptor 

9 

10 

11class EnvironmentalSensingTriggerSettingData(msgspec.Struct, frozen=True, kw_only=True): 

12 """Environmental Sensing Trigger Setting descriptor data.""" 

13 

14 condition: int 

15 operand: int 

16 

17 

18class EnvironmentalSensingTriggerSettingDescriptor(BaseDescriptor): 

19 """Environmental Sensing Trigger Setting Descriptor (0x290D). 

20 

21 Defines trigger conditions for environmental sensing measurements. 

22 Contains condition and operand for triggering measurements. 

23 """ 

24 

25 def _has_structured_data(self) -> bool: 

26 return True 

27 

28 def _get_data_format(self) -> str: 

29 return "struct" 

30 

31 def _parse_descriptor_value(self, data: bytes) -> EnvironmentalSensingTriggerSettingData: 

32 """Parse Environmental Sensing Trigger Setting value. 

33 

34 Format: 3 bytes 

35 - Condition (1 byte) 

36 - Operand (2 bytes, uint16) 

37 

38 Args: 

39 data: Raw bytes (should be 3 bytes) 

40 

41 Returns: 

42 EnvironmentalSensingTriggerSettingData with condition and operand 

43 

44 Raises: 

45 ValueError: If data is not exactly 3 bytes 

46 """ 

47 if len(data) != 3: 

48 raise ValueError(f"Environmental Sensing Trigger Setting data must be exactly 3 bytes, got {len(data)}") 

49 

50 return EnvironmentalSensingTriggerSettingData( 

51 condition=DataParser.parse_int8(data, offset=0), 

52 operand=DataParser.parse_int16(data, offset=1, endian="little"), 

53 ) 

54 

55 def get_condition(self, data: bytes) -> int: 

56 """Get the trigger condition.""" 

57 parsed = self._parse_descriptor_value(data) 

58 return parsed.condition 

59 

60 def get_operand(self, data: bytes) -> int: 

61 """Get the trigger operand.""" 

62 parsed = self._parse_descriptor_value(data) 

63 return parsed.operand