aiohomematic 2025.10.0__py3-none-any.whl → 2025.10.2__py3-none-any.whl

aiohomematic/central/__init__.py

@@ -105,6 +105,7 @@ from aiohomematic.const import (
     DEFAULT_SYSVAR_MARKERS,
     DEFAULT_TLS,
     DEFAULT_UN_IGNORES,
+    DEFAULT_USE_GROUP_CHANNEL_FOR_COVER_STATE,
     DEFAULT_VERIFY_TLS,
     DEVICE_FIRMWARE_CHECK_INTERVAL,
     DEVICE_FIRMWARE_DELIVERING_CHECK_INTERVAL,
@@ -192,7 +193,7 @@ INTERFACE_EVENT_SCHEMA = vol.Schema(
 class CentralUnit(LogContextMixin, PayloadMixin):
     """Central unit that collects everything to handle communication from/to the backend."""
 
-    def __init__(self, central_config: CentralConfig) -> None:
+    def __init__(self, *, central_config: CentralConfig) -> None:
         """Init the central unit."""
         self._state: CentralUnitState = CentralUnitState.NEW
         self._clients_started: bool = False
@@ -218,7 +219,7 @@ class CentralUnit(LogContextMixin, PayloadMixin):
         # {interface_id, client}
         self._clients: Final[dict[str, hmcl.Client]] = {}
         self._data_point_key_event_subscriptions: Final[
-            dict[DataPointKey, list[Callable[[Any, datetime], Coroutine[Any, Any, None]]]]
+            dict[DataPointKey, list[Callable[..., Coroutine[Any, Any, None]]]]
         ] = {}
         self._data_point_path_event_subscriptions: Final[dict[str, DataPointKey]] = {}
         self._sysvar_data_point_event_subscriptions: Final[dict[str, Callable]] = {}
@@ -228,7 +229,7 @@ class CentralUnit(LogContextMixin, PayloadMixin):
         self._sysvar_data_points: Final[dict[str, GenericSysvarDataPoint]] = {}
         # {sysvar_name, program_button}
         self._program_data_points: Final[dict[str, ProgramDpType]] = {}
-        # Signature: (name, *args)
+        # Signature: (system_event, new_data_points, new_channel_events, **kwargs)
         # e.g. DEVICES_CREATED, HUB_REFRESHED
         self._backend_system_callbacks: Final[set[Callable]] = set()
         # Signature: (interface_id, channel_address, parameter, value)
@@ -420,14 +421,14 @@ class CentralUnit(LogContextMixin, PayloadMixin):
             self._version = max(versions) if versions else None
         return self._version
 
-    def add_sysvar_data_point(self, sysvar_data_point: GenericSysvarDataPoint) -> None:
+    def add_sysvar_data_point(self, *, sysvar_data_point: GenericSysvarDataPoint) -> None:
         """Add new program button."""
         if (vid := sysvar_data_point.vid) is not None:
             self._sysvar_data_points[vid] = sysvar_data_point
         if sysvar_data_point.state_path not in self._sysvar_data_point_event_subscriptions:
             self._sysvar_data_point_event_subscriptions[sysvar_data_point.state_path] = sysvar_data_point.event
 
-    def remove_sysvar_data_point(self, vid: str) -> None:
+    def remove_sysvar_data_point(self, *, vid: str) -> None:
         """Remove a sysvar data_point."""
         if (sysvar_dp := self.get_sysvar_data_point(vid=vid)) is not None:
             sysvar_dp.fire_device_removed_callback()
@@ -435,18 +436,18 @@ class CentralUnit(LogContextMixin, PayloadMixin):
             if sysvar_dp.state_path in self._sysvar_data_point_event_subscriptions:
                 del self._sysvar_data_point_event_subscriptions[sysvar_dp.state_path]
 
-    def add_program_data_point(self, program_dp: ProgramDpType) -> None:
+    def add_program_data_point(self, *, program_dp: ProgramDpType) -> None:
         """Add new program button."""
         self._program_data_points[program_dp.pid] = program_dp
 
-    def remove_program_button(self, pid: str) -> None:
+    def remove_program_button(self, *, pid: str) -> None:
         """Remove a program button."""
         if (program_dp := self.get_program_data_point(pid=pid)) is not None:
             program_dp.button.fire_device_removed_callback()
             program_dp.switch.fire_device_removed_callback()
             del self._program_data_points[pid]
 
-    def identify_channel(self, text: str) -> Channel | None:
+    def identify_channel(self, *, text: str) -> Channel | None:
         """Identify channel within a text."""
         for device in self._devices.values():
             if channel := device.identify_channel(text=text):
@@ -454,7 +455,7 @@ class CentralUnit(LogContextMixin, PayloadMixin):
         return None
 
     async def save_caches(
-        self, save_device_descriptions: bool = False, save_paramset_descriptions: bool = False
+        self, *, save_device_descriptions: bool = False, save_paramset_descriptions: bool = False
     ) -> None:
         """Save persistent caches."""
         if save_device_descriptions:
@@ -495,7 +496,7 @@ class CentralUnit(LogContextMixin, PayloadMixin):
             ):
                 self._xml_rpc_server = xml_rpc_server
                 self._listen_port = xml_rpc_server.listen_port
-                self._xml_rpc_server.add_central(self)
+                self._xml_rpc_server.add_central(central=self)
         except OSError as oserr:
             self._state = CentralUnitState.STOPPED_BY_ERROR
             raise AioHomematicException(
@@ -572,7 +573,7 @@ class CentralUnit(LogContextMixin, PayloadMixin):
             _LOGGER.info("RESTART_CLIENTS: Central %s restarted clients", self.name)
 
     @inspector(re_raise=False)
-    async def refresh_firmware_data(self, device_address: str | None = None) -> None:
+    async def refresh_firmware_data(self, *, device_address: str | None = None) -> None:
         """Refresh device firmware data."""
         if device_address and (device := self.get_device(address=device_address)) is not None and device.is_updatable:
             await self._refresh_device_descriptions(client=device.client, device_address=device_address)
@@ -585,7 +586,7 @@ class CentralUnit(LogContextMixin, PayloadMixin):
                     device.refresh_firmware_data()
 
     @inspector(re_raise=False)
-    async def refresh_firmware_data_by_state(self, device_firmware_states: tuple[DeviceFirmwareState, ...]) -> None:
+    async def refresh_firmware_data_by_state(self, *, device_firmware_states: tuple[DeviceFirmwareState, ...]) -> None:
         """Refresh device firmware data for processing devices."""
         for device in [
             device_in_state
@@ -594,7 +595,7 @@ class CentralUnit(LogContextMixin, PayloadMixin):
         ]:
             await self.refresh_firmware_data(device_address=device.address)
 
-    async def _refresh_device_descriptions(self, client: hmcl.Client, device_address: str | None = None) -> None:
+    async def _refresh_device_descriptions(self, *, client: hmcl.Client, device_address: str | None = None) -> None:
         """Refresh device descriptions."""
         device_descriptions: tuple[DeviceDescription, ...] | None = None
         if (
@@ -687,7 +688,7 @@ class CentralUnit(LogContextMixin, PayloadMixin):
         _LOGGER.debug("CREATE_CLIENTS successful for %s", self.name)
         return True
 
-    async def _create_client(self, interface_config: hmcl.InterfaceConfig) -> bool:
+    async def _create_client(self, *, interface_config: hmcl.InterfaceConfig) -> bool:
         """Create a client."""
         try:
             if client := await hmcl.create_client(
@@ -743,6 +744,7 @@ class CentralUnit(LogContextMixin, PayloadMixin):
     @loop_check
     def fire_interface_event(
         self,
+        *,
         interface_id: str,
         interface_event_type: InterfaceEventType,
         data: dict[str, Any],
@@ -760,7 +762,7 @@ class CentralUnit(LogContextMixin, PayloadMixin):
             event_data=cast(dict[EventKey, Any], INTERFACE_EVENT_SCHEMA(event_data)),
         )
 
-    async def _identify_ip_addr(self, port: int) -> str:
+    async def _identify_ip_addr(self, *, port: int) -> str:
         ip_addr: str | None = None
         while ip_addr is None:
             try:
@@ -810,24 +812,24 @@ class CentralUnit(LogContextMixin, PayloadMixin):
                 system_information = client.system_information
         return system_information
 
-    def get_client(self, interface_id: str) -> hmcl.Client:
+    def get_client(self, *, interface_id: str) -> hmcl.Client:
         """Return a client by interface_id."""
         if not self.has_client(interface_id=interface_id):
             raise AioHomematicException(f"get_client: interface_id {interface_id} does not exist on {self.name}")
         return self._clients[interface_id]
 
-    def get_channel(self, channel_address: str) -> Channel | None:
+    def get_channel(self, *, channel_address: str) -> Channel | None:
         """Return Homematic channel."""
         if device := self.get_device(address=channel_address):
             return device.get_channel(channel_address=channel_address)
         return None
 
-    def get_device(self, address: str) -> Device | None:
+    def get_device(self, *, address: str) -> Device | None:
         """Return Homematic device."""
         d_address = get_device_address(address=address)
         return self._devices.get(d_address)
 
-    def get_data_point_by_custom_id(self, custom_id: str) -> CallbackDataPoint | None:
+    def get_data_point_by_custom_id(self, *, custom_id: str) -> CallbackDataPoint | None:
         """Return Homematic data_point by custom_id."""
         for dp in self.get_data_points(registered=True):
             if dp.custom_id == custom_id:
@@ -836,6 +838,7 @@ class CentralUnit(LogContextMixin, PayloadMixin):
 
     def get_data_points(
         self,
+        *,
         category: DataPointCategory | None = None,
         interface: Interface | None = None,
         exclude_no_create: bool = True,
@@ -852,7 +855,7 @@ class CentralUnit(LogContextMixin, PayloadMixin):
         return tuple(all_data_points)
 
     def get_readable_generic_data_points(
-        self, paramset_key: ParamsetKey | None = None, interface: Interface | None = None
+        self, *, paramset_key: ParamsetKey | None = None, interface: Interface | None = None
     ) -> tuple[GenericDataPoint, ...]:
         """Return the readable generic data points."""
         return tuple(
@@ -874,7 +877,7 @@ class CentralUnit(LogContextMixin, PayloadMixin):
         return client
 
     def get_hub_data_points(
-        self, category: DataPointCategory | None = None, registered: bool | None = None
+        self, *, category: DataPointCategory | None = None, registered: bool | None = None
     ) -> tuple[GenericHubDataPoint, ...]:
         """Return the program data points."""
         return tuple(
@@ -883,7 +886,9 @@ class CentralUnit(LogContextMixin, PayloadMixin):
             if (category is None or he.category == category) and (registered is None or he.is_registered == registered)
         )
 
-    def get_events(self, event_type: EventType, registered: bool | None = None) -> tuple[tuple[GenericEvent, ...], ...]:
+    def get_events(
+        self, *, event_type: EventType, registered: bool | None = None
+    ) -> tuple[tuple[GenericEvent, ...], ...]:
         """Return all channel event data points."""
         hm_channel_events: list[tuple[GenericEvent, ...]] = []
         for device in self.devices:
@@ -901,7 +906,7 @@ class CentralUnit(LogContextMixin, PayloadMixin):
             if cl.get_virtual_remote() is not None
         )
 
-    def has_client(self, interface_id: str) -> bool:
+    def has_client(self, *, interface_id: str) -> bool:
         """Check if client exists in central."""
         return interface_id in self._clients
 
@@ -929,7 +934,7 @@ class CentralUnit(LogContextMixin, PayloadMixin):
         await self._data_cache.load()
         return True
 
-    async def _create_devices(self, new_device_addresses: Mapping[str, set[str]]) -> None:
+    async def _create_devices(self, *, new_device_addresses: Mapping[str, set[str]]) -> None:
         """Trigger creation of the objects that expose the functionality."""
         if not self._clients:
             raise AioHomematicException(
@@ -985,7 +990,7 @@ class CentralUnit(LogContextMixin, PayloadMixin):
                 new_channel_events=new_channel_events,
             )
 
-    async def delete_device(self, interface_id: str, device_address: str) -> None:
+    async def delete_device(self, *, interface_id: str, device_address: str) -> None:
         """Delete devices from central."""
         _LOGGER.debug(
             "DELETE_DEVICE: interface_id = %s, device_address = %s",
@@ -999,7 +1004,7 @@ class CentralUnit(LogContextMixin, PayloadMixin):
         await self.delete_devices(interface_id=interface_id, addresses=[device_address, *list(device.channels.keys())])
 
     @callback_backend_system(system_event=BackendSystemEvent.DELETE_DEVICES)
-    async def delete_devices(self, interface_id: str, addresses: tuple[str, ...]) -> None:
+    async def delete_devices(self, *, interface_id: str, addresses: tuple[str, ...]) -> None:
         """Delete devices from central."""
         _LOGGER.debug(
             "DELETE_DEVICES: interface_id = %s, addresses = %s",
@@ -1012,12 +1017,12 @@ class CentralUnit(LogContextMixin, PayloadMixin):
         await self.save_caches()
 
     @callback_backend_system(system_event=BackendSystemEvent.NEW_DEVICES)
-    async def add_new_devices(self, interface_id: str, device_descriptions: tuple[DeviceDescription, ...]) -> None:
+    async def add_new_devices(self, *, interface_id: str, device_descriptions: tuple[DeviceDescription, ...]) -> None:
         """Add new devices to central unit."""
         await self._add_new_devices(interface_id=interface_id, device_descriptions=device_descriptions)
 
     @inspector(measure_performance=True)
-    async def _add_new_devices(self, interface_id: str, device_descriptions: tuple[DeviceDescription, ...]) -> None:
+    async def _add_new_devices(self, *, interface_id: str, device_descriptions: tuple[DeviceDescription, ...]) -> None:
         """Add new devices to central unit."""
         if not device_descriptions:
             _LOGGER.debug(
@@ -1103,7 +1108,7 @@ class CentralUnit(LogContextMixin, PayloadMixin):
         return new_device_addresses
 
     @callback_event
-    async def data_point_event(self, interface_id: str, channel_address: str, parameter: str, value: Any) -> None:
+    async def data_point_event(self, *, interface_id: str, channel_address: str, parameter: str, value: Any) -> None:
         """If a device emits some sort event, we will handle it here."""
         _LOGGER_EVENT.debug(
             "EVENT: interface_id = %s, channel_address = %s, parameter = %s, value = %s",
@@ -1142,7 +1147,7 @@ class CentralUnit(LogContextMixin, PayloadMixin):
                 received_at = datetime.now()
                 for callback_handler in self._data_point_key_event_subscriptions[dpk]:
                     if callable(callback_handler):
-                        await callback_handler(value, received_at)
+                        await callback_handler(value=value, received_at=received_at)
             except RuntimeError as rterr:  # pragma: no cover
                 _LOGGER_EVENT.debug(
                     "EVENT: RuntimeError [%s]. Failed to call callback for: %s, %s, %s",
@@ -1160,7 +1165,7 @@ class CentralUnit(LogContextMixin, PayloadMixin):
                     extract_exc_args(exc=exc),
                 )
 
-    def data_point_path_event(self, state_path: str, value: str) -> None:
+    def data_point_path_event(self, *, state_path: str, value: str) -> None:
         """If a device emits some sort event, we will handle it here."""
         _LOGGER_EVENT.debug(
             "DATA_POINT_PATH_EVENT: topic = %s, payload = %s",
@@ -1170,7 +1175,7 @@ class CentralUnit(LogContextMixin, PayloadMixin):
 
         if (dpk := self._data_point_path_event_subscriptions.get(state_path)) is not None:
             self._looper.create_task(
-                self.data_point_event(
+                target=self.data_point_event(
                     interface_id=dpk.interface_id,
                     channel_address=dpk.channel_address,
                     parameter=dpk.parameter,
@@ -1179,7 +1184,7 @@ class CentralUnit(LogContextMixin, PayloadMixin):
                 name=f"device-data-point-event-{dpk.interface_id}-{dpk.channel_address}-{dpk.parameter}",
             )
 
-    def sysvar_data_point_path_event(self, state_path: str, value: str) -> None:
+    def sysvar_data_point_path_event(self, *, state_path: str, value: str) -> None:
         """If a device emits some sort event, we will handle it here."""
         _LOGGER_EVENT.debug(
             "SYSVAR_DATA_POINT_PATH_EVENT: topic = %s, payload = %s",
@@ -1193,7 +1198,8 @@ class CentralUnit(LogContextMixin, PayloadMixin):
                 if callable(callback_handler):
                     received_at = datetime.now()
                     self._looper.create_task(
-                        callback_handler(value, received_at), name=f"sysvar-data-point-event-{state_path}"
+                        target=callback_handler(value=value, received_at=received_at),
+                        name=f"sysvar-data-point-event-{state_path}",
                     )
             except RuntimeError as rterr:  # pragma: no cover
                 _LOGGER_EVENT.debug(
@@ -1209,13 +1215,13 @@ class CentralUnit(LogContextMixin, PayloadMixin):
                 )
 
     @callback_backend_system(system_event=BackendSystemEvent.LIST_DEVICES)
-    def list_devices(self, interface_id: str) -> list[DeviceDescription]:
+    def list_devices(self, *, interface_id: str) -> list[DeviceDescription]:
         """Return already existing devices to the backend."""
         result = self._device_descriptions.get_raw_device_descriptions(interface_id=interface_id)
         _LOGGER.debug("LIST_DEVICES: interface_id = %s, channel_count = %i", interface_id, len(result))
         return result
 
-    def add_event_subscription(self, data_point: BaseParameterDataPoint) -> None:
+    def add_event_subscription(self, *, data_point: BaseParameterDataPoint) -> None:
         """Add data_point to central event subscription."""
         if isinstance(data_point, GenericDataPoint | GenericEvent) and (
             data_point.is_readable or data_point.supports_events
@@ -1241,7 +1247,7 @@ class CentralUnit(LogContextMixin, PayloadMixin):
         for device in self.devices:
             await device.remove_central_links()
 
-    def remove_device(self, device: Device) -> None:
+    def remove_device(self, *, device: Device) -> None:
         """Remove device to central collections."""
         if device.address not in self._devices:
             _LOGGER.debug(
@@ -1256,7 +1262,7 @@ class CentralUnit(LogContextMixin, PayloadMixin):
         self._device_details.remove_device(device=device)
         del self._devices[device.address]
 
-    def remove_event_subscription(self, data_point: BaseParameterDataPoint) -> None:
+    def remove_event_subscription(self, *, data_point: BaseParameterDataPoint) -> None:
         """Remove event subscription from central collections."""
         if isinstance(data_point, GenericDataPoint | GenericEvent) and data_point.supports_events:
             if data_point.dpk in self._data_point_key_event_subscriptions:
@@ -1264,39 +1270,40 @@ class CentralUnit(LogContextMixin, PayloadMixin):
             if data_point.state_path in self._data_point_path_event_subscriptions:
                 del self._data_point_path_event_subscriptions[data_point.state_path]
 
-    def get_last_event_seen_for_interface(self, interface_id: str) -> datetime | None:
+    def get_last_event_seen_for_interface(self, *, interface_id: str) -> datetime | None:
         """Return the last event seen for an interface."""
         return self._last_event_seen_for_interface.get(interface_id)
 
-    def set_last_event_seen_for_interface(self, interface_id: str) -> None:
+    def set_last_event_seen_for_interface(self, *, interface_id: str) -> None:
         """Set the last event seen for an interface."""
         self._last_event_seen_for_interface[interface_id] = datetime.now()
 
-    async def execute_program(self, pid: str) -> bool:
+    async def execute_program(self, *, pid: str) -> bool:
         """Execute a program on the backend."""
         if client := self.primary_client:
             return await client.execute_program(pid=pid)
         return False
 
-    async def set_program_state(self, pid: str, state: bool) -> bool:
+    async def set_program_state(self, *, pid: str, state: bool) -> bool:
         """Execute a program on the backend."""
         if client := self.primary_client:
             return await client.set_program_state(pid=pid, state=state)
         return False
 
     @inspector(re_raise=False)
-    async def fetch_sysvar_data(self, scheduled: bool) -> None:
+    async def fetch_sysvar_data(self, *, scheduled: bool) -> None:
         """Fetch sysvar data for the hub."""
         await self._hub.fetch_sysvar_data(scheduled=scheduled)
 
     @inspector(re_raise=False)
-    async def fetch_program_data(self, scheduled: bool) -> None:
+    async def fetch_program_data(self, *, scheduled: bool) -> None:
         """Fetch program data for the hub."""
         await self._hub.fetch_program_data(scheduled=scheduled)
 
     @inspector(measure_performance=True)
     async def load_and_refresh_data_point_data(
         self,
+        *,
         interface: Interface,
         paramset_key: ParamsetKey | None = None,
         direct_call: bool = False,
@@ -1308,13 +1315,13 @@ class CentralUnit(LogContextMixin, PayloadMixin):
             paramset_key=paramset_key, interface=interface, direct_call=direct_call
         )
 
-    async def get_system_variable(self, legacy_name: str) -> Any | None:
+    async def get_system_variable(self, *, legacy_name: str) -> Any | None:
         """Get system variable from the backend."""
         if client := self.primary_client:
-            return await client.get_system_variable(legacy_name)
+            return await client.get_system_variable(name=legacy_name)
         return None
 
-    async def set_system_variable(self, legacy_name: str, value: Any) -> None:
+    async def set_system_variable(self, *, legacy_name: str, value: Any) -> None:
         """Set variable value on the backend."""
         if dp := self.get_sysvar_data_point(legacy_name=legacy_name):
             await dp.send_variable(value=value)
@@ -1323,6 +1330,7 @@ class CentralUnit(LogContextMixin, PayloadMixin):
 
     def get_parameters(
         self,
+        *,
         paramset_key: ParamsetKey,
         operations: tuple[Operations, ...],
         full_format: bool = False,
@@ -1400,7 +1408,7 @@ class CentralUnit(LogContextMixin, PayloadMixin):
 
         return tuple(parameters)
 
-    def _get_virtual_remote(self, device_address: str) -> Device | None:
+    def _get_virtual_remote(self, *, device_address: str) -> Device | None:
         """Get the virtual remote for the Client."""
         for client in self._clients.values():
             virtual_remote = client.get_virtual_remote()
@@ -1409,7 +1417,7 @@ class CentralUnit(LogContextMixin, PayloadMixin):
         return None
 
     def get_generic_data_point(
-        self, channel_address: str, parameter: str, paramset_key: ParamsetKey | None = None
+        self, *, channel_address: str, parameter: str, paramset_key: ParamsetKey | None = None
     ) -> GenericDataPoint | None:
         """Get data_point by channel_address and parameter."""
         if device := self.get_device(address=channel_address):
@@ -1418,20 +1426,20 @@ class CentralUnit(LogContextMixin, PayloadMixin):
             )
         return None
 
-    def get_event(self, channel_address: str, parameter: str) -> GenericEvent | None:
+    def get_event(self, *, channel_address: str, parameter: str) -> GenericEvent | None:
         """Return the hm event."""
         if device := self.get_device(address=channel_address):
             return device.get_generic_event(channel_address=channel_address, parameter=parameter)
         return None
 
-    def get_custom_data_point(self, address: str, channel_no: int) -> CustomDataPoint | None:
+    def get_custom_data_point(self, *, address: str, channel_no: int) -> CustomDataPoint | None:
         """Return the hm custom_data_point."""
         if device := self.get_device(address=address):
             return device.get_custom_data_point(channel_no=channel_no)
         return None
 
     def get_sysvar_data_point(
-        self, vid: str | None = None, legacy_name: str | None = None
+        self, *, vid: str | None = None, legacy_name: str | None = None
     ) -> GenericSysvarDataPoint | None:
         """Return the sysvar data_point."""
         if vid and (sysvar := self._sysvar_data_points.get(vid)):
@@ -1442,7 +1450,7 @@ class CentralUnit(LogContextMixin, PayloadMixin):
                     return sysvar
         return None
 
-    def get_program_data_point(self, pid: str | None = None, legacy_name: str | None = None) -> ProgramDpType | None:
+    def get_program_data_point(self, *, pid: str | None = None, legacy_name: str | None = None) -> ProgramDpType | None:
         """Return the program data points."""
         if pid and (program := self._program_data_points.get(pid)):
             return program
@@ -1460,7 +1468,7 @@ class CentralUnit(LogContextMixin, PayloadMixin):
         """Return the registered sysvar state path."""
         return tuple(self._sysvar_data_point_event_subscriptions)
 
-    def get_un_ignore_candidates(self, include_master: bool = False) -> list[str]:
+    def get_un_ignore_candidates(self, *, include_master: bool = False) -> list[str]:
         """Return the candidates for un_ignore."""
         candidates = sorted(
             # 1. request simple parameter list for values parameters
@@ -1504,20 +1512,20 @@ class CentralUnit(LogContextMixin, PayloadMixin):
         self._device_details.clear()
         self._data_cache.clear()
 
-    def register_homematic_callback(self, cb: Callable) -> CALLBACK_TYPE:
+    def register_homematic_callback(self, *, cb: Callable) -> CALLBACK_TYPE:
         """Register ha_event callback in central."""
         if callable(cb) and cb not in self._homematic_callbacks:
             self._homematic_callbacks.add(cb)
             return partial(self._unregister_homematic_callback, cb=cb)
         return None
 
-    def _unregister_homematic_callback(self, cb: Callable) -> None:
+    def _unregister_homematic_callback(self, *, cb: Callable) -> None:
         """RUn register ha_event callback in central."""
         if cb in self._homematic_callbacks:
             self._homematic_callbacks.remove(cb)
 
     @loop_check
-    def fire_homematic_callback(self, event_type: EventType, event_data: dict[EventKey, str]) -> None:
+    def fire_homematic_callback(self, *, event_type: EventType, event_data: dict[EventKey, str]) -> None:
         """
         Fire homematic_callback in central.
 
@@ -1525,28 +1533,28 @@ class CentralUnit(LogContextMixin, PayloadMixin):
         """
         for callback_handler in self._homematic_callbacks:
             try:
-                callback_handler(event_type, event_data)
+                callback_handler(event_type=event_type, event_data=event_data)
             except Exception as exc:
                 _LOGGER.error(
                     "FIRE_HOMEMATIC_CALLBACK: Unable to call handler: %s",
                     extract_exc_args(exc=exc),
                 )
 
-    def register_backend_parameter_callback(self, cb: Callable) -> CALLBACK_TYPE:
+    def register_backend_parameter_callback(self, *, cb: Callable) -> CALLBACK_TYPE:
         """Register backend_parameter callback in central."""
         if callable(cb) and cb not in self._backend_parameter_callbacks:
             self._backend_parameter_callbacks.add(cb)
             return partial(self._unregister_backend_parameter_callback, cb=cb)
         return None
 
-    def _unregister_backend_parameter_callback(self, cb: Callable) -> None:
+    def _unregister_backend_parameter_callback(self, *, cb: Callable) -> None:
         """Un register backend_parameter callback in central."""
         if cb in self._backend_parameter_callbacks:
             self._backend_parameter_callbacks.remove(cb)
 
     @loop_check
     def fire_backend_parameter_callback(
-        self, interface_id: str, channel_address: str, parameter: str, value: Any
+        self, *, interface_id: str, channel_address: str, parameter: str, value: Any
     ) -> None:
         """
         Fire backend_parameter callback in central.
@@ -1555,27 +1563,29 @@ class CentralUnit(LogContextMixin, PayloadMixin):
         """
         for callback_handler in self._backend_parameter_callbacks:
             try:
-                callback_handler(interface_id, channel_address, parameter, value)
+                callback_handler(
+                    interface_id=interface_id, channel_address=channel_address, parameter=parameter, value=value
+                )
             except Exception as exc:
                 _LOGGER.error(
                     "FIRE_BACKEND_PARAMETER_CALLBACK: Unable to call handler: %s",
                     extract_exc_args(exc=exc),
                 )
 
-    def register_backend_system_callback(self, cb: Callable) -> CALLBACK_TYPE:
+    def register_backend_system_callback(self, *, cb: Callable) -> CALLBACK_TYPE:
         """Register system_event callback in central."""
         if callable(cb) and cb not in self._backend_parameter_callbacks:
             self._backend_system_callbacks.add(cb)
             return partial(self._unregister_backend_system_callback, cb=cb)
         return None
 
-    def _unregister_backend_system_callback(self, cb: Callable) -> None:
+    def _unregister_backend_system_callback(self, *, cb: Callable) -> None:
         """Un register system_event callback in central."""
         if cb in self._backend_system_callbacks:
             self._backend_system_callbacks.remove(cb)
 
     @loop_check
-    def fire_backend_system_callback(self, system_event: BackendSystemEvent, **kwargs: Any) -> None:
+    def fire_backend_system_callback(self, *, system_event: BackendSystemEvent, **kwargs: Any) -> None:
         """
         Fire system_event callback in central.
 
@@ -1583,7 +1593,7 @@ class CentralUnit(LogContextMixin, PayloadMixin):
         """
         for callback_handler in self._backend_system_callbacks:
             try:
-                callback_handler(system_event, **kwargs)
+                callback_handler(system_event=system_event, **kwargs)
             except Exception as exc:
                 _LOGGER.error(
                     "FIRE_BACKEND_SYSTEM_CALLBACK: Unable to call handler: %s",
@@ -1598,7 +1608,7 @@ class CentralUnit(LogContextMixin, PayloadMixin):
 class _Scheduler(threading.Thread):
     """Periodically check connection to the backend, and load data when required."""
 
-    def __init__(self, central: CentralUnit) -> None:
+    def __init__(self, *, central: CentralUnit) -> None:
         """Init the connection checker."""
         threading.Thread.__init__(self, name=f"ConnectionChecker for {central.name}")
         self._central: Final = central
@@ -1643,7 +1653,7 @@ class _Scheduler(threading.Thread):
         )
 
         self._central.looper.create_task(
-            self._run_scheduler_tasks(),
+            target=self._run_scheduler_tasks(),
             name="run_scheduler_tasks",
         )
 
@@ -1798,6 +1808,7 @@ class _SchedulerJob:
 
     def __init__(
         self,
+        *,
         task: Callable,
         run_interval: int,
         next_run: datetime | None = None,
@@ -1826,6 +1837,7 @@ class CentralConfig:
 
     def __init__(
         self,
+        *,
         central_id: str,
         host: str,
         interface_configs: AbstractSet[hmcl.InterfaceConfig],
@@ -1854,6 +1866,7 @@ class CentralConfig:
         sysvar_markers: tuple[DescriptionMarker | str, ...] = DEFAULT_SYSVAR_MARKERS,
         tls: bool = DEFAULT_TLS,
         un_ignore_list: frozenset[str] = DEFAULT_UN_IGNORES,
+        use_group_channel_for_cover_state: bool = DEFAULT_USE_GROUP_CHANNEL_FOR_COVER_STATE,
         verify_tls: bool = DEFAULT_VERIFY_TLS,
     ) -> None:
         """Init the client config."""
@@ -1884,6 +1897,7 @@ class CentralConfig:
         self.sysvar_markers: Final = sysvar_markers
         self.tls: Final = tls
         self.un_ignore_list: Final = un_ignore_list
+        self.use_group_channel_for_cover_state: Final = use_group_channel_for_cover_state
         self.username: Final = username
         self.verify_tls: Final = verify_tls
 
@@ -1936,7 +1950,7 @@ class CentralConfig:
         """Create the central. Throws BaseHomematicException on validation failure."""
         try:
             self.check_config()
-            return CentralUnit(self)
+            return CentralUnit(central_config=self)
         except BaseHomematicException as bhexc:
             raise AioHomematicException(
                 f"CREATE_CENTRAL: Not able to create a central: : {extract_exc_args(exc=bhexc)}"
@@ -1950,7 +1964,7 @@ class CentralConfig:
             url = f"{url}:{self.json_port}"
         return f"{url}"
 
-    def create_json_rpc_client(self, central: CentralUnit) -> JsonRpcAioHttpClient:
+    def create_json_rpc_client(self, *, central: CentralUnit) -> JsonRpcAioHttpClient:
         """Create a json rpc client."""
         return JsonRpcAioHttpClient(
             username=self.username,
@@ -1971,7 +1985,7 @@ class CentralConnectionState:
         self._json_issues: Final[list[str]] = []
         self._xml_proxy_issues: Final[list[str]] = []
 
-    def add_issue(self, issuer: ConnectionProblemIssuer, iid: str) -> bool:
+    def add_issue(self, *, issuer: ConnectionProblemIssuer, iid: str) -> bool:
         """Add issue to collection."""
         if isinstance(issuer, JsonRpcAioHttpClient) and iid not in self._json_issues:
             self._json_issues.append(iid)
@@ -1983,7 +1997,7 @@ class CentralConnectionState:
             return True
         return False
 
-    def remove_issue(self, issuer: ConnectionProblemIssuer, iid: str) -> bool:
+    def remove_issue(self, *, issuer: ConnectionProblemIssuer, iid: str) -> bool:
         """Add issue to collection."""
         if isinstance(issuer, JsonRpcAioHttpClient) and iid in self._json_issues:
             self._json_issues.remove(iid)
@@ -1995,7 +2009,7 @@ class CentralConnectionState:
             return True
         return False
 
-    def has_issue(self, issuer: ConnectionProblemIssuer, iid: str) -> bool:
+    def has_issue(self, *, issuer: ConnectionProblemIssuer, iid: str) -> bool:
         """Add issue to collection."""
         if isinstance(issuer, JsonRpcAioHttpClient):
             return iid in self._json_issues
@@ -2004,6 +2018,7 @@ class CentralConnectionState:
 
     def handle_exception_log(
         self,
+        *,
         issuer: ConnectionProblemIssuer,
         iid: str,
         exception: Exception,
@@ -2035,6 +2050,7 @@ class CentralConnectionState:
 
 
 def _get_new_data_points(
+    *,
     new_devices: set[Device],
 ) -> Mapping[DataPointCategory, AbstractSet[CallbackDataPoint]]:
     """Return new data points by category."""
@@ -2050,7 +2066,7 @@ def _get_new_data_points(
     return data_points_by_category
 
 
-def _get_new_channel_events(new_devices: set[Device]) -> tuple[tuple[GenericEvent, ...], ...]:
+def _get_new_channel_events(*, new_devices: set[Device]) -> tuple[tuple[GenericEvent, ...], ...]:
     """Return new channel events by category."""
     channel_events: list[tuple[GenericEvent, ...]] = []