Feature Request: add a lock to disable relay-switch-changes (energy devices only)

CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## v0.43.0
+
+- Feature Request: add a lock to disable relay-switch-changes (energy devices only) [#254](https://github.com/plugwise/python-plugwise-usb/pull/254)
+- Fix cache-related bugs, improve related functions
+
 ## v0.42.1
 
 - Implement code improvements, extend debug message [#253](https://github.com/plugwise/python-plugwise-usb/pull/247)

plugwise_usb/api.py

@@ -50,6 +50,7 @@ class NodeFeature(str, Enum):
     POWER = "power"
     RELAY = "relay"
     RELAY_INIT = "relay_init"
+    RELAY_LOCK = "relay_lock"
     SWITCH = "switch"
     TEMPERATURE = "temperature"
 
@@ -171,6 +172,13 @@ class RelayConfig:
     init_state: bool | None = None
 
 
+@dataclass(frozen=True)
+class RelayLock:
+    """Status of relay lock."""
+
+    state: bool | None = None
+
+
 @dataclass(frozen=True)
 class RelayState:
     """Status of relay."""
@@ -369,6 +377,13 @@ def relay(self) -> bool:
         Raises NodeError when relay feature is not present at device.
         """
 
+    @property
+    def relay_lock(self) -> RelayLock:
+        """Last known relay lock state information.
+
+        Raises NodeError when relay lock feature is not present at device.
+        """
+
     @property
     def relay_state(self) -> RelayState:
         """Last known relay state information.
@@ -420,6 +435,9 @@ async def set_relay(self, state: bool) -> bool:
 
         """
 
+    async def set_relay_lock(self, state: bool) -> bool:
+        """Change the state of the relay-lock."""
+
     # endregion
 
     # region configuration properties