Coverage for src/bluetooth_sig/gatt/descriptors/time_trigger_setting.py: 89%

1"""Time 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 TimeTriggerSettingData(msgspec.Struct, frozen=True, kw_only=True): 

12 """Time Trigger Setting descriptor data.""" 

13 

14 time_interval: int # in seconds 

15 

16 

17class TimeTriggerSettingDescriptor(BaseDescriptor): 

18 """Time Trigger Setting Descriptor (0x290E). 

19 

20 Defines time-based trigger settings for measurements. 

21 Contains time interval in seconds for periodic triggering. 

22 """ 

23 

24 def _has_structured_data(self) -> bool: 

25 return True 

26 

27 def _get_data_format(self) -> str: 

28 return "uint24" 

29 

30 def _parse_descriptor_value(self, data: bytes) -> TimeTriggerSettingData: 

31 """Parse Time Trigger Setting value. 

32 

33 Args: 

34 data: Raw bytes (should be 3 bytes for uint24) 

35 

36 Returns: 

37 TimeTriggerSettingData with time interval 

38 

39 Raises: 

40 ValueError: If data is not exactly 3 bytes 

41 """ 

42 if len(data) != 3: 

43 raise ValueError(f"Time Trigger Setting data must be exactly 3 bytes, got {len(data)}") 

44 

45 # Parse as uint24 (3 bytes) 

46 time_interval = DataParser.parse_int32(data + b"\x00", endian="little") & 0xFFFFFF 

47 

48 return TimeTriggerSettingData(time_interval=time_interval) 

49 

50 def get_time_interval(self, data: bytes) -> int: 

51 """Get the time interval in seconds.""" 

52 parsed = self._parse_descriptor_value(data) 

53 return parsed.time_interval