Coverage for src / bluetooth_sig / gatt / descriptors / process_tolerances.py: 73%

1"""Process Tolerances Descriptor implementation.""" 

2 

3from __future__ import annotations 

4 

5import msgspec 

6 

7from ..characteristics.utils import DataParser 

8from .base import BaseDescriptor 

9 

10 

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

12 """Process Tolerances descriptor data.""" 

13 

14 tolerance_min: int | float 

15 tolerance_max: int | float 

16 

17 

18class ProcessTolerancesDescriptor(BaseDescriptor): 

19 """Process Tolerances Descriptor (0x2914). 

20 

21 Defines process tolerances for characteristic values. 

22 Contains minimum and maximum tolerance values. 

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) -> ProcessTolerancesData: 

32 """Parse Process Tolerances descriptor value. 

33 

34 The format depends on the characteristic's value type. 

35 For simplicity, this implementation assumes uint16 tolerance values. 

36 

37 Args: 

38 data: Raw bytes containing tolerance min and max values 

39 

40 Returns: 

41 ProcessTolerancesData with process tolerances 

42 

43 Raises: 

44 ValueError: If data length is incorrect 

45 """ 

46 # Process Tolerances format: tolerance_min + tolerance_max 

47 # For now, assume 4 bytes total (2 bytes each for uint16) 

48 

49 tolerance_min = DataParser.parse_int16(data, offset=0, endian="little") 

50 tolerance_max = DataParser.parse_int16(data, offset=2, endian="little") 

51 

52 return ProcessTolerancesData( 

53 tolerance_min=tolerance_min, 

54 tolerance_max=tolerance_max, 

55 ) 

56 

57 def get_tolerance_min(self, data: bytes) -> int | float: 

58 """Get the minimum process tolerance.""" 

59 parsed = self._parse_descriptor_value(data) 

60 return parsed.tolerance_min 

61 

62 def get_tolerance_max(self, data: bytes) -> int | float: 

63 """Get the maximum process tolerance.""" 

64 parsed = self._parse_descriptor_value(data) 

65 return parsed.tolerance_max