Coverage for src / bluetooth_sig / gatt / characteristics / five_zone_heart_rate_limits.py: 100%

1"""Five Zone Heart Rate Limits characteristic (0x2A8B).""" 

2 

3from __future__ import annotations 

4 

5import msgspec 

6 

7from ..context import CharacteristicContext 

8from .base import BaseCharacteristic 

9from .utils.data_parser import DataParser 

10 

11 

12class FiveZoneHeartRateLimitsData(msgspec.Struct, frozen=True, kw_only=True): 

13 """Five Zone Heart Rate Limits data structure.""" 

14 

15 very_light_light_limit: int 

16 light_moderate_limit: int 

17 moderate_hard_limit: int 

18 hard_maximum_limit: int 

19 

20 

21class FiveZoneHeartRateLimitsCharacteristic(BaseCharacteristic[FiveZoneHeartRateLimitsData]): 

22 """Five Zone Heart Rate Limits characteristic (0x2A8B). 

23 

24 org.bluetooth.characteristic.five_zone_heart_rate_limits 

25 

26 The Five Zone Heart Rate Limits characteristic is used to represent the limits 

27 between the heart rate zones for the five-zone heart rate definition 

28 (Maximum, Hard, Moderate, Light, and Very Light) of a user. 

29 """ 

30 

31 def _decode_value(self, data: bytearray, ctx: CharacteristicContext | None = None) -> FiveZoneHeartRateLimitsData: 

32 """Decode Five Zone Heart Rate Limits from raw bytes. 

33 

34 Args: 

35 data: Raw bytes from BLE characteristic (4 bytes) 

36 ctx: Optional context for parsing 

37 

38 Returns: 

39 FiveZoneHeartRateLimitsData: Parsed heart rate limits 

40 """ 

41 very_light_light_limit = DataParser.parse_int8(data, 0, signed=False) 

42 light_moderate_limit = DataParser.parse_int8(data, 1, signed=False) 

43 moderate_hard_limit = DataParser.parse_int8(data, 2, signed=False) 

44 hard_maximum_limit = DataParser.parse_int8(data, 3, signed=False) 

45 

46 return FiveZoneHeartRateLimitsData( 

47 very_light_light_limit=very_light_light_limit, 

48 light_moderate_limit=light_moderate_limit, 

49 moderate_hard_limit=moderate_hard_limit, 

50 hard_maximum_limit=hard_maximum_limit, 

51 ) 

52 

53 def _encode_value(self, data: FiveZoneHeartRateLimitsData) -> bytearray: 

54 """Encode Five Zone Heart Rate Limits to raw bytes. 

55 

56 Args: 

57 data: FiveZoneHeartRateLimitsData to encode 

58 

59 Returns: 

60 bytearray: Encoded bytes 

61 """ 

62 result = bytearray() 

63 result.extend(DataParser.encode_int8(data.very_light_light_limit, signed=False)) 

64 result.extend(DataParser.encode_int8(data.light_moderate_limit, signed=False)) 

65 result.extend(DataParser.encode_int8(data.moderate_hard_limit, signed=False)) 

66 result.extend(DataParser.encode_int8(data.hard_maximum_limit, signed=False)) 

67 return result