Add getLinkPeers XmlRPC method (#1684)

* Add comments

* Update __init__.py

* Update __init__.py

* Update changelog.md

* Update pyproject.toml

changelog.md

@@ -1,3 +1,7 @@
+# Version 2024.9.0 (2024-09-01)
+
+- Add getLinkPeers XmlRPC method
+
 # Version 2024.8.15 (2024-08-29)
 
 - Add check for link paramsets

hahomematic/client/__init__.py

@@ -394,6 +394,10 @@ async def get_install_mode(self) -> int:
             _LOGGER.warning("GET_INSTALL_MODE failed: %s [%s]", ex.name, reduce_args(args=ex.args))
         return 0
 
+    async def get_link_peers(self, address: str) -> tuple[str, ...] | None:
+        """Return a list of link pers."""
+        return tuple(await self._proxy.getLinkPeers(address))
+
     async def get_value(
         self,
         channel_address: str,
@@ -563,8 +567,9 @@ async def put_paramset(
         """
         Set paramsets manually.
 
-        Address is usually the channel_address,
-        but for bidcos devices there is a master paramset at the device.
+        Address is usually the channel_address, but for bidcos devices there is a master paramset at the device.
+        Paramset_key can be a str with a channel address in case of manipulating a direct link.
+        If paramset_key is string and contains a channel address, then the LINK paramset must be used for a check.
         """
         is_link_call: bool = False
         try:
@@ -596,6 +601,7 @@ async def put_paramset(
             else:
                 await self._proxy.putParamset(channel_address, paramset_key, checked_values)
 
+            # if a call is related to a link then no further action is needed
             if is_link_call:
                 return set()
 

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name        = "hahomematic"
-version     = "2024.8.15"
+version     = "2024.9.0"
 license     = {text = "MIT License"}
 description = "Homematic interface for Home Assistant running on Python 3."
 readme      = "README.md"