Coverage for src/bluetooth_sig/gatt/descriptors/manufacturer_limits.py: 78%

1"""Manufacturer Limits Descriptor implementation.""" 

2 

3from __future__ import annotations 

4 

5import msgspec 

6 

7from ..characteristics.utils import DataParser 

8from .base import BaseDescriptor 

9 

10 

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

12 """Manufacturer Limits descriptor data.""" 

13 

14 min_limit: int | float 

15 max_limit: int | float 

16 

17 

18class ManufacturerLimitsDescriptor(BaseDescriptor): 

19 """Manufacturer Limits Descriptor (0x2913). 

20 

21 Defines manufacturer-specified limits for characteristic values. 

22 Contains minimum and maximum limits set by the manufacturer. 

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

32 """Parse Manufacturer Limits descriptor value. 

33 

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

35 For simplicity, this implementation assumes uint16 min/max values. 

36 

37 Args: 

38 data: Raw bytes containing min and max limit values 

39 

40 Returns: 

41 ManufacturerLimitsData with manufacturer limits 

42 

43 Raises: 

44 ValueError: If data length is incorrect 

45 """ 

46 # Manufacturer Limits format: min_limit + max_limit 

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

48 if len(data) != 4: 

49 raise ValueError(f"Manufacturer Limits data expected 4 bytes, got {len(data)}") 

50 

51 min_limit = DataParser.parse_int16(data, offset=0, endian="little") 

52 max_limit = DataParser.parse_int16(data, offset=2, endian="little") 

53 

54 return ManufacturerLimitsData( 

55 min_limit=min_limit, 

56 max_limit=max_limit, 

57 ) 

58 

59 def get_min_limit(self, data: bytes) -> int | float: 

60 """Get the minimum manufacturer limit.""" 

61 parsed = self._parse_descriptor_value(data) 

62 return parsed.min_limit 

63 

64 def get_max_limit(self, data: bytes) -> int | float: 

65 """Get the maximum manufacturer limit.""" 

66 parsed = self._parse_descriptor_value(data) 

67 return parsed.max_limit 

68 

69 def is_value_within_limits(self, data: bytes, value: int | float) -> bool: 

70 """Check if a value is within manufacturer limits.""" 

71 parsed = self._parse_descriptor_value(data) 

72 return parsed.min_limit <= value <= parsed.max_limit