conson-xp 1.46.0__py3-none-any.whl → 1.47.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (179) hide show
  1. {conson_xp-1.46.0.dist-info → conson_xp-1.47.0.dist-info}/METADATA +1 -1
  2. conson_xp-1.47.0.dist-info/RECORD +210 -0
  3. xp/__init__.py +3 -2
  4. xp/cli/commands/conbus/conbus.py +1 -1
  5. xp/cli/commands/conbus/conbus_actiontable_commands.py +33 -15
  6. xp/cli/commands/conbus/conbus_autoreport_commands.py +8 -4
  7. xp/cli/commands/conbus/conbus_blink_commands.py +20 -10
  8. xp/cli/commands/conbus/conbus_config_commands.py +2 -1
  9. xp/cli/commands/conbus/conbus_custom_commands.py +4 -2
  10. xp/cli/commands/conbus/conbus_datapoint_commands.py +10 -5
  11. xp/cli/commands/conbus/conbus_discover_commands.py +8 -4
  12. xp/cli/commands/conbus/conbus_event_commands.py +8 -4
  13. xp/cli/commands/conbus/conbus_export_commands.py +8 -4
  14. xp/cli/commands/conbus/conbus_lightlevel_commands.py +16 -8
  15. xp/cli/commands/conbus/conbus_linknumber_commands.py +8 -4
  16. xp/cli/commands/conbus/conbus_modulenumber_commands.py +8 -4
  17. xp/cli/commands/conbus/conbus_msactiontable_commands.py +78 -40
  18. xp/cli/commands/conbus/conbus_output_commands.py +16 -8
  19. xp/cli/commands/conbus/conbus_raw_commands.py +6 -3
  20. xp/cli/commands/conbus/conbus_receive_commands.py +6 -3
  21. xp/cli/commands/conbus/conbus_scan_commands.py +6 -3
  22. xp/cli/commands/file_commands.py +6 -3
  23. xp/cli/commands/homekit/homekit.py +4 -2
  24. xp/cli/commands/homekit/homekit_start_commands.py +2 -1
  25. xp/cli/commands/module_commands.py +8 -4
  26. xp/cli/commands/reverse_proxy_commands.py +8 -4
  27. xp/cli/commands/server/server_commands.py +6 -3
  28. xp/cli/commands/telegram/telegram_blink_commands.py +4 -2
  29. xp/cli/commands/telegram/telegram_checksum_commands.py +4 -2
  30. xp/cli/commands/telegram/telegram_discover_commands.py +2 -1
  31. xp/cli/commands/telegram/telegram_linknumber_commands.py +4 -2
  32. xp/cli/commands/telegram/telegram_parse_commands.py +4 -2
  33. xp/cli/commands/telegram/telegram_version_commands.py +2 -1
  34. xp/cli/commands/term/term_commands.py +4 -2
  35. xp/cli/main.py +2 -1
  36. xp/cli/utils/click_tree.py +6 -3
  37. xp/cli/utils/datapoint_type_choice.py +4 -2
  38. xp/cli/utils/decorators.py +42 -21
  39. xp/cli/utils/error_handlers.py +16 -8
  40. xp/cli/utils/formatters.py +22 -11
  41. xp/cli/utils/module_type_choice.py +4 -2
  42. xp/cli/utils/serial_number_type.py +4 -2
  43. xp/cli/utils/system_function_choice.py +4 -2
  44. xp/cli/utils/xp_module_type.py +4 -2
  45. xp/models/actiontable/actiontable.py +8 -8
  46. xp/models/actiontable/actiontable_type.py +20 -0
  47. xp/models/actiontable/msactiontable_xp20.py +8 -4
  48. xp/models/actiontable/msactiontable_xp24.py +12 -6
  49. xp/models/actiontable/msactiontable_xp33.py +20 -10
  50. xp/models/conbus/conbus.py +8 -4
  51. xp/models/conbus/conbus_autoreport.py +4 -2
  52. xp/models/conbus/conbus_blink.py +4 -2
  53. xp/models/conbus/conbus_client_config.py +6 -3
  54. xp/models/conbus/conbus_connection_status.py +4 -2
  55. xp/models/conbus/conbus_custom.py +4 -2
  56. xp/models/conbus/conbus_datapoint.py +4 -2
  57. xp/models/conbus/conbus_discover.py +6 -3
  58. xp/models/conbus/conbus_event_list.py +4 -2
  59. xp/models/conbus/conbus_event_raw.py +4 -2
  60. xp/models/conbus/conbus_export.py +2 -1
  61. xp/models/conbus/conbus_lightlevel.py +4 -2
  62. xp/models/conbus/conbus_linknumber.py +4 -2
  63. xp/models/conbus/conbus_logger_config.py +8 -4
  64. xp/models/conbus/conbus_output.py +4 -2
  65. xp/models/conbus/conbus_raw.py +4 -2
  66. xp/models/conbus/conbus_receive.py +4 -2
  67. xp/models/conbus/conbus_writeconfig.py +4 -2
  68. xp/models/config/conson_module_config.py +8 -4
  69. xp/models/homekit/homekit_accessory.py +4 -2
  70. xp/models/homekit/homekit_config.py +12 -6
  71. xp/models/log_entry.py +16 -8
  72. xp/models/protocol/conbus_protocol.py +36 -18
  73. xp/models/response.py +12 -8
  74. xp/models/telegram/action_type.py +4 -2
  75. xp/models/telegram/datapoint_type.py +4 -2
  76. xp/models/telegram/event_telegram.py +14 -7
  77. xp/models/telegram/event_type.py +2 -1
  78. xp/models/telegram/input_action_type.py +2 -1
  79. xp/models/telegram/input_type.py +2 -1
  80. xp/models/telegram/module_type.py +24 -12
  81. xp/models/telegram/module_type_code.py +2 -1
  82. xp/models/telegram/output_telegram.py +16 -10
  83. xp/models/telegram/reply_telegram.py +24 -13
  84. xp/models/telegram/system_function.py +6 -3
  85. xp/models/telegram/system_telegram.py +10 -6
  86. xp/models/telegram/telegram.py +2 -1
  87. xp/models/telegram/telegram_type.py +2 -1
  88. xp/models/telegram/timeparam_type.py +2 -1
  89. xp/models/term/connection_state.py +4 -2
  90. xp/models/term/module_state.py +2 -1
  91. xp/models/term/protocol_keys_config.py +6 -3
  92. xp/models/term/status_message.py +2 -1
  93. xp/models/term/telegram_display.py +2 -1
  94. xp/models/write_config_type.py +4 -2
  95. xp/services/actiontable/actiontable_serializer.py +34 -41
  96. xp/services/{conbus/actiontable/actiontable_download_state_machine.py → actiontable/download_state_machine.py} +13 -8
  97. xp/services/actiontable/msactiontable_xp20_serializer.py +77 -49
  98. xp/services/actiontable/msactiontable_xp24_serializer.py +78 -53
  99. xp/services/actiontable/msactiontable_xp33_serializer.py +39 -9
  100. xp/services/actiontable/serializer_protocol.py +76 -0
  101. xp/services/conbus/actiontable/actiontable_download_service.py +63 -29
  102. xp/services/conbus/actiontable/actiontable_list_service.py +17 -4
  103. xp/services/conbus/actiontable/actiontable_show_service.py +10 -6
  104. xp/services/conbus/actiontable/actiontable_upload_service.py +17 -9
  105. xp/services/conbus/conbus_blink_all_service.py +16 -8
  106. xp/services/conbus/conbus_blink_service.py +14 -7
  107. xp/services/conbus/conbus_custom_service.py +16 -8
  108. xp/services/conbus/conbus_datapoint_queryall_service.py +18 -9
  109. xp/services/conbus/conbus_datapoint_service.py +18 -9
  110. xp/services/conbus/conbus_discover_service.py +24 -13
  111. xp/services/conbus/conbus_event_list_service.py +11 -7
  112. xp/services/conbus/conbus_event_raw_service.py +18 -10
  113. xp/services/conbus/conbus_export_service.py +28 -14
  114. xp/services/conbus/conbus_output_service.py +18 -10
  115. xp/services/conbus/conbus_raw_service.py +16 -8
  116. xp/services/conbus/conbus_receive_service.py +18 -10
  117. xp/services/conbus/conbus_scan_service.py +18 -10
  118. xp/services/conbus/msactiontable/msactiontable_upload_service.py +17 -9
  119. xp/services/conbus/write_config_service.py +18 -9
  120. xp/services/homekit/homekit_cache_service.py +12 -6
  121. xp/services/homekit/homekit_conbus_service.py +12 -6
  122. xp/services/homekit/homekit_config_validator.py +34 -17
  123. xp/services/homekit/homekit_conson_validator.py +18 -9
  124. xp/services/homekit/homekit_dimminglight.py +14 -7
  125. xp/services/homekit/homekit_dimminglight_service.py +14 -7
  126. xp/services/homekit/homekit_hap_service.py +18 -9
  127. xp/services/homekit/homekit_lightbulb.py +10 -5
  128. xp/services/homekit/homekit_lightbulb_service.py +10 -5
  129. xp/services/homekit/homekit_module_service.py +8 -4
  130. xp/services/homekit/homekit_outlet.py +14 -7
  131. xp/services/homekit/homekit_outlet_service.py +12 -6
  132. xp/services/homekit/homekit_service.py +24 -12
  133. xp/services/log_file_service.py +16 -8
  134. xp/services/module_type_service.py +10 -5
  135. xp/services/protocol/conbus_event_protocol.py +46 -24
  136. xp/services/protocol/conbus_protocol.py +36 -19
  137. xp/services/protocol/protocol_factory.py +12 -6
  138. xp/services/protocol/telegram_protocol.py +12 -6
  139. xp/services/reverse_proxy_service.py +26 -14
  140. xp/services/server/base_server_service.py +42 -23
  141. xp/services/server/client_buffer_manager.py +12 -7
  142. xp/services/server/cp20_server_service.py +10 -7
  143. xp/services/server/device_service_factory.py +12 -8
  144. xp/services/server/server_service.py +18 -11
  145. xp/services/server/xp130_server_service.py +11 -8
  146. xp/services/server/xp20_server_service.py +16 -10
  147. xp/services/server/xp230_server_service.py +10 -7
  148. xp/services/server/xp24_server_service.py +22 -13
  149. xp/services/server/xp33_server_service.py +44 -25
  150. xp/services/telegram/telegram_blink_service.py +14 -8
  151. xp/services/telegram/telegram_checksum_service.py +12 -7
  152. xp/services/telegram/telegram_datapoint_service.py +14 -9
  153. xp/services/telegram/telegram_discover_service.py +28 -15
  154. xp/services/telegram/telegram_link_number_service.py +18 -10
  155. xp/services/telegram/telegram_output_service.py +24 -12
  156. xp/services/telegram/telegram_service.py +22 -11
  157. xp/services/telegram/telegram_version_service.py +14 -8
  158. xp/services/term/protocol_monitor_service.py +30 -16
  159. xp/services/term/state_monitor_service.py +39 -21
  160. xp/term/protocol.py +12 -6
  161. xp/term/state.py +12 -7
  162. xp/term/widgets/help_menu.py +6 -3
  163. xp/term/widgets/modules_list.py +20 -10
  164. xp/term/widgets/protocol_log.py +12 -6
  165. xp/term/widgets/status_footer.py +10 -5
  166. xp/utils/checksum.py +6 -3
  167. xp/utils/dependencies.py +25 -30
  168. xp/utils/event_helper.py +6 -4
  169. xp/utils/logging.py +6 -3
  170. xp/utils/serialization.py +30 -16
  171. xp/utils/state_machine.py +16 -9
  172. xp/utils/time_utils.py +6 -3
  173. conson_xp-1.46.0.dist-info/RECORD +0 -211
  174. xp/services/conbus/msactiontable/msactiontable_download_service.py +0 -275
  175. xp/services/conbus/msactiontable/msactiontable_list_service.py +0 -100
  176. xp/services/conbus/msactiontable/msactiontable_show_service.py +0 -89
  177. {conson_xp-1.46.0.dist-info → conson_xp-1.47.0.dist-info}/WHEEL +0 -0
  178. {conson_xp-1.46.0.dist-info → conson_xp-1.47.0.dist-info}/entry_points.txt +0 -0
  179. {conson_xp-1.46.0.dist-info → conson_xp-1.47.0.dist-info}/licenses/LICENSE +0 -0
@@ -1,4 +1,5 @@
1
- """Conson Configuration Validator for HomeKit.
1
+ """
2
+ Conson Configuration Validator for HomeKit.
2
3
 
3
4
  This module validates conson.yml configuration files for HomeKit integration.
4
5
  """
@@ -15,7 +16,8 @@ class ConsonConfigValidator:
15
16
  """Validates conson.yml configuration file for HomeKit integration."""
16
17
 
17
18
  def __init__(self, config: ConsonModuleListConfig):
18
- """Initialize the Conson config validator.
19
+ """
20
+ Initialize the Conson config validator.
19
21
 
20
22
  Args:
21
23
  config: Conson module list configuration to validate.
@@ -23,7 +25,8 @@ class ConsonConfigValidator:
23
25
  self.config = config
24
26
 
25
27
  def validate_unique_names(self) -> List[str]:
26
- """Validate that all module names are unique.
28
+ """
29
+ Validate that all module names are unique.
27
30
 
28
31
  Returns:
29
32
  List of validation error messages.
@@ -39,7 +42,8 @@ class ConsonConfigValidator:
39
42
  return errors
40
43
 
41
44
  def validate_unique_serial_numbers(self) -> List[str]:
42
- """Validate that all serial numbers are unique.
45
+ """
46
+ Validate that all serial numbers are unique.
43
47
 
44
48
  Returns:
45
49
  List of validation error messages.
@@ -55,7 +59,8 @@ class ConsonConfigValidator:
55
59
  return errors
56
60
 
57
61
  def validate_module_type_codes(self) -> List[str]:
58
- """Validate module type code ranges.
62
+ """
63
+ Validate module type code ranges.
59
64
 
60
65
  Returns:
61
66
  List of validation error messages.
@@ -69,7 +74,8 @@ class ConsonConfigValidator:
69
74
  return errors
70
75
 
71
76
  def validate_network_config(self) -> List[str]:
72
- """Validate IP/port configuration.
77
+ """
78
+ Validate IP/port configuration.
73
79
 
74
80
  Returns:
75
81
  List of validation error messages.
@@ -83,7 +89,8 @@ class ConsonConfigValidator:
83
89
  return errors
84
90
 
85
91
  def validate_all(self) -> List[str]:
86
- """Run all validations and return combined errors.
92
+ """
93
+ Run all validations and return combined errors.
87
94
 
88
95
  Returns:
89
96
  List of all validation error messages.
@@ -96,7 +103,8 @@ class ConsonConfigValidator:
96
103
  return all_errors
97
104
 
98
105
  def get_module_by_serial(self, serial_number: str) -> ConsonModuleConfig:
99
- """Get module configuration by serial number.
106
+ """
107
+ Get module configuration by serial number.
100
108
 
101
109
  Args:
102
110
  serial_number: Serial number of the module to find.
@@ -113,7 +121,8 @@ class ConsonConfigValidator:
113
121
  raise ValueError(f"Module with serial number {serial_number} not found")
114
122
 
115
123
  def get_all_serial_numbers(self) -> Set[str]:
116
- """Get all serial numbers from the configuration.
124
+ """
125
+ Get all serial numbers from the configuration.
117
126
 
118
127
  Returns:
119
128
  Set of all serial numbers in the configuration.
@@ -1,4 +1,5 @@
1
- """HomeKit Dimming Light Accessory.
1
+ """
2
+ HomeKit Dimming Light Accessory.
2
3
 
3
4
  This module provides a dimming light accessory for HomeKit integration.
4
5
  """
@@ -21,7 +22,8 @@ from xp.models.protocol.conbus_protocol import (
21
22
 
22
23
 
23
24
  class DimmingLight(Accessory):
24
- """HomeKit dimming light accessory.
25
+ """
26
+ HomeKit dimming light accessory.
25
27
 
26
28
  Attributes:
27
29
  category: HomeKit category (CATEGORY_LIGHTBULB).
@@ -46,7 +48,8 @@ class DimmingLight(Accessory):
46
48
  accessory: HomekitAccessoryConfig,
47
49
  event_bus: EventBus,
48
50
  ):
49
- """Initialize the dimming light accessory.
51
+ """
52
+ Initialize the dimming light accessory.
50
53
 
51
54
  Args:
52
55
  driver: HAP accessory driver.
@@ -102,7 +105,8 @@ class DimmingLight(Accessory):
102
105
  )
103
106
 
104
107
  def set_on(self, value: bool) -> None:
105
- """Set the on/off state of the dimming light.
108
+ """
109
+ Set the on/off state of the dimming light.
106
110
 
107
111
  Args:
108
112
  value: True to turn on, False to turn off.
@@ -124,7 +128,8 @@ class DimmingLight(Accessory):
124
128
  )
125
129
 
126
130
  def get_on(self) -> bool:
127
- """Get the on/off state of the dimming light.
131
+ """
132
+ Get the on/off state of the dimming light.
128
133
 
129
134
  Returns:
130
135
  True if on, False if off.
@@ -144,7 +149,8 @@ class DimmingLight(Accessory):
144
149
  return self.is_on
145
150
 
146
151
  def set_brightness(self, value: int) -> None:
147
- """Set the brightness level of the dimming light.
152
+ """
153
+ Set the brightness level of the dimming light.
148
154
 
149
155
  Args:
150
156
  value: Brightness level (0-100).
@@ -163,7 +169,8 @@ class DimmingLight(Accessory):
163
169
  )
164
170
 
165
171
  def get_brightness(self) -> int:
166
- """Get the brightness level of the dimming light.
172
+ """
173
+ Get the brightness level of the dimming light.
167
174
 
168
175
  Returns:
169
176
  Current brightness level (0-100).
@@ -1,4 +1,5 @@
1
- """HomeKit Dimming Light Service.
1
+ """
2
+ HomeKit Dimming Light Service.
2
3
 
3
4
  This module provides service implementation for dimming light accessories.
4
5
  """
@@ -19,7 +20,8 @@ from xp.models.telegram.datapoint_type import DataPointType
19
20
 
20
21
 
21
22
  class HomeKitDimmingLightService:
22
- """Dimming light service for HomeKit.
23
+ """
24
+ Dimming light service for HomeKit.
23
25
 
24
26
  Attributes:
25
27
  event_bus: Event bus for inter-service communication.
@@ -29,7 +31,8 @@ class HomeKitDimmingLightService:
29
31
  event_bus: EventBus
30
32
 
31
33
  def __init__(self, event_bus: EventBus) -> None:
32
- """Initialize the dimming light service.
34
+ """
35
+ Initialize the dimming light service.
33
36
 
34
37
  Args:
35
38
  event_bus: Event bus instance.
@@ -48,7 +51,8 @@ class HomeKitDimmingLightService:
48
51
  )
49
52
 
50
53
  def handle_dimminglight_get_on(self, event: DimmingLightGetOnEvent) -> None:
51
- """Handle dimming light get on event.
54
+ """
55
+ Handle dimming light get on event.
52
56
 
53
57
  Args:
54
58
  event: Dimming light get on event.
@@ -67,7 +71,8 @@ class HomeKitDimmingLightService:
67
71
  self.logger.debug(f"Dispatched ReadDatapointEvent for {event.serial_number}")
68
72
 
69
73
  def handle_dimminglight_set_on(self, event: DimmingLightSetOnEvent) -> None:
70
- """Handle dimming light set on event.
74
+ """
75
+ Handle dimming light set on event.
71
76
 
72
77
  Args:
73
78
  event: Dimming light set on event.
@@ -98,7 +103,8 @@ class HomeKitDimmingLightService:
98
103
  def handle_dimminglight_set_brightness(
99
104
  self, event: DimmingLightSetBrightnessEvent
100
105
  ) -> None:
101
- """Handle dimming light set brightness event.
106
+ """
107
+ Handle dimming light set brightness event.
102
108
 
103
109
  Args:
104
110
  event: Dimming light set brightness event.
@@ -126,7 +132,8 @@ class HomeKitDimmingLightService:
126
132
  def handle_dimminglight_get_brightness(
127
133
  self, event: DimmingLightGetBrightnessEvent
128
134
  ) -> None:
129
- """Handle dimming light get brightness event.
135
+ """
136
+ Handle dimming light get brightness event.
130
137
 
131
138
  Args:
132
139
  event: Dimming light get brightness event.
@@ -1,4 +1,5 @@
1
- """HomeKit HAP Service for Apple HomeKit integration.
1
+ """
2
+ HomeKit HAP Service for Apple HomeKit integration.
2
3
 
3
4
  This module provides the main HAP (HomeKit Accessory Protocol) service.
4
5
  """
@@ -35,7 +36,8 @@ from xp.services.homekit.homekit_outlet import Outlet
35
36
 
36
37
 
37
38
  class HomekitHapService:
38
- """HomeKit HAP service.
39
+ """
40
+ HomeKit HAP service.
39
41
 
40
42
  Manages HAP accessory protocol, handles bridge and accessory setup,
41
43
  and processes HomeKit events for device state synchronization.
@@ -59,7 +61,8 @@ class HomekitHapService:
59
61
  module_service: HomekitModuleService,
60
62
  event_bus: EventBus,
61
63
  ):
62
- """Initialize the HomeKit HAP service.
64
+ """
65
+ Initialize the HomeKit HAP service.
63
66
 
64
67
  Args:
65
68
  homekit_config: HomeKit configuration.
@@ -122,7 +125,8 @@ class HomekitHapService:
122
125
  self.logger.error(f"HAP-python driver error: {e}", exc_info=True)
123
126
 
124
127
  def handle_output_state_received(self, event: OutputStateReceivedEvent) -> str:
125
- """Handle output state received event.
128
+ """
129
+ Handle output state received event.
126
130
 
127
131
  Args:
128
132
  event: Output state received event.
@@ -152,7 +156,8 @@ class HomekitHapService:
152
156
  return event.data_value
153
157
 
154
158
  def handle_light_level_received(self, event: LightLevelReceivedEvent) -> str:
155
- """Handle light level received event.
159
+ """
160
+ Handle light level received event.
156
161
 
157
162
  Args:
158
163
  event: Light level received event.
@@ -206,7 +211,8 @@ class HomekitHapService:
206
211
  self.driver.add_accessory(accessory=bridge)
207
212
 
208
213
  def add_room(self, bridge: Bridge, room: RoomConfig) -> None:
209
- """Add a room with its accessories to the bridge.
214
+ """
215
+ Add a room with its accessories to the bridge.
210
216
 
211
217
  Args:
212
218
  bridge: HAP bridge instance.
@@ -239,7 +245,8 @@ class HomekitHapService:
239
245
  def get_accessory(
240
246
  self, homekit_accessory: HomekitAccessoryConfig
241
247
  ) -> Union[LightBulb, Outlet, DimmingLight, None]:
242
- """Get an accessory instance from configuration.
248
+ """
249
+ Get an accessory instance from configuration.
243
250
 
244
251
  Args:
245
252
  homekit_accessory: HomeKit accessory configuration.
@@ -282,7 +289,8 @@ class HomekitHapService:
282
289
  return None
283
290
 
284
291
  def get_accessory_by_name(self, name: str) -> Optional[HomekitAccessoryConfig]:
285
- """Get an accessory configuration by name.
292
+ """
293
+ Get an accessory configuration by name.
286
294
 
287
295
  Args:
288
296
  name: Name of the accessory to find.
@@ -295,7 +303,8 @@ class HomekitHapService:
295
303
  )
296
304
 
297
305
  def handle_module_state_changed(self, event: ModuleStateChangedEvent) -> None:
298
- """Handle module state change by refreshing affected accessories.
306
+ """
307
+ Handle module state change by refreshing affected accessories.
299
308
 
300
309
  Args:
301
310
  event: Module state changed event.
@@ -1,4 +1,5 @@
1
- """HomeKit Light Bulb Accessory.
1
+ """
2
+ HomeKit Light Bulb Accessory.
2
3
 
3
4
  This module provides a light bulb accessory for HomeKit integration.
4
5
  """
@@ -19,7 +20,8 @@ from xp.models.protocol.conbus_protocol import (
19
20
 
20
21
 
21
22
  class LightBulb(Accessory):
22
- """HomeKit light bulb accessory.
23
+ """
24
+ HomeKit light bulb accessory.
23
25
 
24
26
  Attributes:
25
27
  category: HomeKit category (CATEGORY_LIGHTBULB).
@@ -42,7 +44,8 @@ class LightBulb(Accessory):
42
44
  accessory: HomekitAccessoryConfig,
43
45
  event_bus: EventBus,
44
46
  ):
45
- """Initialize the light bulb accessory.
47
+ """
48
+ Initialize the light bulb accessory.
46
49
 
47
50
  Args:
48
51
  driver: HAP accessory driver.
@@ -80,7 +83,8 @@ class LightBulb(Accessory):
80
83
  )
81
84
 
82
85
  def set_on(self, value: bool) -> None:
83
- """Set the on/off state of the light bulb.
86
+ """
87
+ Set the on/off state of the light bulb.
84
88
 
85
89
  Args:
86
90
  value: True to turn on, False to turn off.
@@ -100,7 +104,8 @@ class LightBulb(Accessory):
100
104
  )
101
105
 
102
106
  def get_on(self) -> bool:
103
- """Get the on/off state of the light bulb.
107
+ """
108
+ Get the on/off state of the light bulb.
104
109
 
105
110
  Returns:
106
111
  True if on, False if off.
@@ -1,4 +1,5 @@
1
- """HomeKit Light Bulb Service.
1
+ """
2
+ HomeKit Light Bulb Service.
2
3
 
3
4
  This module provides service implementation for light bulb accessories.
4
5
  """
@@ -17,7 +18,8 @@ from xp.models.telegram.datapoint_type import DataPointType
17
18
 
18
19
 
19
20
  class HomeKitLightbulbService:
20
- """Lightbulb service for HomeKit.
21
+ """
22
+ Lightbulb service for HomeKit.
21
23
 
22
24
  Attributes:
23
25
  event_bus: Event bus for inter-service communication.
@@ -27,7 +29,8 @@ class HomeKitLightbulbService:
27
29
  event_bus: EventBus
28
30
 
29
31
  def __init__(self, event_bus: EventBus):
30
- """Initialize the lightbulb service.
32
+ """
33
+ Initialize the lightbulb service.
31
34
 
32
35
  Args:
33
36
  event_bus: Event bus instance.
@@ -40,7 +43,8 @@ class HomeKitLightbulbService:
40
43
  self.event_bus.on(LightBulbSetOnEvent, self.handle_lightbulb_set_on)
41
44
 
42
45
  def handle_lightbulb_get_on(self, event: LightBulbGetOnEvent) -> None:
43
- """Handle lightbulb get on event.
46
+ """
47
+ Handle lightbulb get on event.
44
48
 
45
49
  Args:
46
50
  event: Lightbulb get on event.
@@ -60,7 +64,8 @@ class HomeKitLightbulbService:
60
64
  self.logger.debug(f"Dispatched ReadDatapointEvent for {event.serial_number}")
61
65
 
62
66
  def handle_lightbulb_set_on(self, event: LightBulbSetOnEvent) -> None:
63
- """Handle lightbulb set on event.
67
+ """
68
+ Handle lightbulb set on event.
64
69
 
65
70
  Args:
66
71
  event: Lightbulb set on event.
@@ -1,4 +1,5 @@
1
- """HomeKit Module Service.
1
+ """
2
+ HomeKit Module Service.
2
3
 
3
4
  This module provides service implementation for HomeKit module management.
4
5
  """
@@ -13,7 +14,8 @@ from xp.models.config.conson_module_config import (
13
14
 
14
15
 
15
16
  class HomekitModuleService:
16
- """Service for managing HomeKit module configurations.
17
+ """
18
+ Service for managing HomeKit module configurations.
17
19
 
18
20
  Attributes:
19
21
  logger: Logger instance.
@@ -24,7 +26,8 @@ class HomekitModuleService:
24
26
  self,
25
27
  conson_modules_config: ConsonModuleListConfig,
26
28
  ):
27
- """Initialize the HomeKit module service.
29
+ """
30
+ Initialize the HomeKit module service.
28
31
 
29
32
  Args:
30
33
  conson_modules_config: Conson module list configuration.
@@ -34,7 +37,8 @@ class HomekitModuleService:
34
37
  self.conson_modules_config = conson_modules_config
35
38
 
36
39
  def get_module_by_serial(self, serial_number: str) -> Optional[ConsonModuleConfig]:
37
- """Get a module by its serial number.
40
+ """
41
+ Get a module by its serial number.
38
42
 
39
43
  Args:
40
44
  serial_number: Serial number of the module to find.
@@ -1,4 +1,5 @@
1
- """HomeKit Outlet Accessory.
1
+ """
2
+ HomeKit Outlet Accessory.
2
3
 
3
4
  This module provides an outlet accessory for HomeKit integration.
4
5
  """
@@ -21,7 +22,8 @@ from xp.models.protocol.conbus_protocol import (
21
22
 
22
23
 
23
24
  class Outlet(Accessory):
24
- """HomeKit outlet accessory.
25
+ """
26
+ HomeKit outlet accessory.
25
27
 
26
28
  Attributes:
27
29
  category: HomeKit category (CATEGORY_OUTLET).
@@ -46,7 +48,8 @@ class Outlet(Accessory):
46
48
  accessory: HomekitAccessoryConfig,
47
49
  event_bus: EventBus,
48
50
  ):
49
- """Initialize the outlet accessory.
51
+ """
52
+ Initialize the outlet accessory.
50
53
 
51
54
  Args:
52
55
  driver: HAP accessory driver.
@@ -88,7 +91,8 @@ class Outlet(Accessory):
88
91
  )
89
92
 
90
93
  def set_outlet_in_use(self, value: bool) -> None:
91
- """Set the in-use state of the outlet.
94
+ """
95
+ Set the in-use state of the outlet.
92
96
 
93
97
  Args:
94
98
  value: True if in use, False otherwise.
@@ -108,7 +112,8 @@ class Outlet(Accessory):
108
112
  self.logger.debug(f"set_outlet_in_use {value} end")
109
113
 
110
114
  def get_outlet_in_use(self) -> bool:
111
- """Get the in-use state of the outlet.
115
+ """
116
+ Get the in-use state of the outlet.
112
117
 
113
118
  Returns:
114
119
  True if in use, False otherwise.
@@ -128,7 +133,8 @@ class Outlet(Accessory):
128
133
  return self.is_in_use
129
134
 
130
135
  def set_on(self, value: bool) -> None:
131
- """Set the on/off state of the outlet.
136
+ """
137
+ Set the on/off state of the outlet.
132
138
 
133
139
  Args:
134
140
  value: True to turn on, False to turn off.
@@ -148,7 +154,8 @@ class Outlet(Accessory):
148
154
  )
149
155
 
150
156
  def get_on(self) -> bool:
151
- """Get the on/off state of the outlet.
157
+ """
158
+ Get the on/off state of the outlet.
152
159
 
153
160
  Returns:
154
161
  True if on, False if off.
@@ -1,4 +1,5 @@
1
- """HomeKit Outlet Service.
1
+ """
2
+ HomeKit Outlet Service.
2
3
 
3
4
  This module provides service implementation for outlet accessories.
4
5
  """
@@ -18,7 +19,8 @@ from xp.models.telegram.datapoint_type import DataPointType
18
19
 
19
20
 
20
21
  class HomeKitOutletService:
21
- """Outlet service for HomeKit.
22
+ """
23
+ Outlet service for HomeKit.
22
24
 
23
25
  Attributes:
24
26
  event_bus: Event bus for inter-service communication.
@@ -28,7 +30,8 @@ class HomeKitOutletService:
28
30
  event_bus: EventBus
29
31
 
30
32
  def __init__(self, event_bus: EventBus):
31
- """Initialize the outlet service.
33
+ """
34
+ Initialize the outlet service.
32
35
 
33
36
  Args:
34
37
  event_bus: Event bus instance.
@@ -42,7 +45,8 @@ class HomeKitOutletService:
42
45
  self.event_bus.on(OutletGetInUseEvent, self.handle_outlet_get_in_use)
43
46
 
44
47
  def handle_outlet_get_on(self, event: OutletGetOnEvent) -> bool:
45
- """Handle outlet get on event.
48
+ """
49
+ Handle outlet get on event.
46
50
 
47
51
  Args:
48
52
  event: Outlet get on event.
@@ -65,7 +69,8 @@ class HomeKitOutletService:
65
69
  return True
66
70
 
67
71
  def handle_outlet_set_on(self, event: OutletSetOnEvent) -> bool:
68
- """Handle outlet set on event.
72
+ """
73
+ Handle outlet set on event.
69
74
 
70
75
  Args:
71
76
  event: Outlet set on event.
@@ -97,7 +102,8 @@ class HomeKitOutletService:
97
102
  return True
98
103
 
99
104
  def handle_outlet_get_in_use(self, event: OutletGetInUseEvent) -> bool:
100
- """Handle outlet get in-use event.
105
+ """
106
+ Handle outlet get in-use event.
101
107
 
102
108
  Args:
103
109
  event: Outlet get in-use event.
@@ -1,4 +1,5 @@
1
- """HomeKit Service for Apple HomeKit integration.
1
+ """
2
+ HomeKit Service for Apple HomeKit integration.
2
3
 
3
4
  This module provides the main service for HomeKit integration.
4
5
  """
@@ -34,7 +35,8 @@ from xp.services.protocol.protocol_factory import TelegramFactory
34
35
 
35
36
 
36
37
  class HomeKitService:
37
- """Main HomeKit service for Apple HomeKit integration.
38
+ """
39
+ Main HomeKit service for Apple HomeKit integration.
38
40
 
39
41
  Attributes:
40
42
  cli_config: Conbus client configuration.
@@ -66,7 +68,8 @@ class HomeKitService:
66
68
  module_factory: HomekitHapService,
67
69
  telegram_service: TelegramService,
68
70
  ):
69
- """Initialize the HomeKit service.
71
+ """
72
+ Initialize the HomeKit service.
70
73
 
71
74
  Args:
72
75
  cli_config: Conbus client configuration.
@@ -142,7 +145,8 @@ class HomeKitService:
142
145
  self.reactor.run()
143
146
 
144
147
  def _start_module_factory(self) -> None:
145
- """Start module factory after reactor starts.
148
+ """
149
+ Start module factory after reactor starts.
146
150
 
147
151
  Creates and schedules an async task to start the HAP service.
148
152
  """
@@ -181,7 +185,8 @@ class HomeKitService:
181
185
  event.protocol.sendFrame(b"S0000000000F01D00")
182
186
 
183
187
  def handle_connection_failed(self, event: ConnectionFailedEvent) -> None:
184
- """Handle connection failed.
188
+ """
189
+ Handle connection failed.
185
190
 
186
191
  Args:
187
192
  event: Connection failed event.
@@ -189,7 +194,8 @@ class HomeKitService:
189
194
  self.logger.error(f"Connection failed: {event.reason}")
190
195
 
191
196
  def handle_connection_lost(self, event: ConnectionLostEvent) -> None:
192
- """Handle connection lost.
197
+ """
198
+ Handle connection lost.
193
199
 
194
200
  Args:
195
201
  event: Connection lost event.
@@ -199,7 +205,8 @@ class HomeKitService:
199
205
  )
200
206
 
201
207
  def handle_telegram_received(self, event: TelegramReceivedEvent) -> str:
202
- """Handle received telegram events.
208
+ """
209
+ Handle received telegram events.
203
210
 
204
211
  Args:
205
212
  event: Telegram received event.
@@ -236,7 +243,8 @@ class HomeKitService:
236
243
  return event.frame
237
244
 
238
245
  def dispatch_light_level_event(self, event: TelegramReceivedEvent) -> None:
239
- """Dispatch light level received event.
246
+ """
247
+ Dispatch light level received event.
240
248
 
241
249
  Args:
242
250
  event: Telegram received event.
@@ -260,7 +268,8 @@ class HomeKitService:
260
268
  self.logger.debug("LightLevelReceivedEvent dispatched successfully")
261
269
 
262
270
  def dispatch_output_state_event(self, event: TelegramReceivedEvent) -> None:
263
- """Dispatch output state received event.
271
+ """
272
+ Dispatch output state received event.
264
273
 
265
274
  Args:
266
275
  event: Telegram received event.
@@ -286,7 +295,8 @@ class HomeKitService:
286
295
  def dispatch_event_telegram_received_event(
287
296
  self, event: TelegramReceivedEvent
288
297
  ) -> None:
289
- """Dispatch event telegram received event.
298
+ """
299
+ Dispatch event telegram received event.
290
300
 
291
301
  Args:
292
302
  event: Telegram received event.
@@ -319,7 +329,8 @@ class HomeKitService:
319
329
  self.logger.debug("ModuleStateChangedEvent dispatched successfully")
320
330
 
321
331
  def dispatch_module_discovered_event(self, event: TelegramReceivedEvent) -> None:
322
- """Dispatch module discovered event.
332
+ """
333
+ Dispatch module discovered event.
323
334
 
324
335
  Args:
325
336
  event: Telegram received event.
@@ -339,7 +350,8 @@ class HomeKitService:
339
350
  self.logger.debug("ModuleDiscoveredEvent dispatched successfully")
340
351
 
341
352
  def handle_module_discovered(self, event: ModuleDiscoveredEvent) -> str:
342
- """Handle module discovered event.
353
+ """
354
+ Handle module discovered event.
343
355
 
344
356
  Args:
345
357
  event: Module discovered event.