Coverage for src / bluetooth_sig / gatt / characteristics / report.py: 85%

1"""Report characteristic implementation.""" 

2 

3from __future__ import annotations 

4 

5import msgspec 

6 

7from ..context import CharacteristicContext 

8from .base import BaseCharacteristic 

9 

10 

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

12 """Parsed data from Report characteristic. 

13 

14 Attributes: 

15 data: Report data bytes (variable length) 

16 """ 

17 

18 data: bytes 

19 

20 

21class ReportCharacteristic(BaseCharacteristic[ReportData]): 

22 """Report characteristic (0x2A4D). 

23 

24 org.bluetooth.characteristic.report 

25 

26 Report characteristic. 

27 """ 

28 

29 min_length = 1 

30 expected_type = bytes 

31 

32 def _decode_value( 

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

34 ) -> ReportData: 

35 """Parse report data. 

36 

37 Args: 

38 data: Raw bytearray from BLE characteristic. 

39 ctx: Optional context. 

40 validate: Whether to validate ranges (default True) 

41 

42 Returns: 

43 ReportData containing the report bytes. 

44 """ 

45 return ReportData(data=bytes(data)) 

46 

47 def _encode_value(self, data: ReportData) -> bytearray: 

48 """Encode report data back to bytes. 

49 

50 Args: 

51 data: ReportData instance to encode 

52 

53 Returns: 

54 Encoded bytes 

55 """ 

56 return bytearray(data.data)