feat: add cached property for device configuration and handle UnsupportedOperation in mode change methods

Author: robberwick

src/blinkstick/clients/blinkstick.py

@@ -3,6 +3,7 @@
 import sys
 import time
 import warnings
+from functools import cached_property
 from typing import Callable
 
 from blinkstick.colors import (
@@ -12,10 +13,11 @@
     remap_rgb_value_reverse,
     ColorFormat,
 )
-from blinkstick.decorators import no_backend_required
+from blinkstick.configs import _get_device_config
 from blinkstick.devices import BlinkStickDevice
 from blinkstick.enums import BlinkStickVariant
-from blinkstick.exceptions import NotConnected
+from blinkstick.exceptions import NotConnected, UnsupportedOperation
+from blinkstick.models import Configuration
 from blinkstick.utilities import string_to_info_block_data
 
 if sys.platform == "win32":
@@ -78,6 +80,15 @@ def wrapper(*args, **kwargs):
             return wrapper
         return attr
 
+    @cached_property
+    def _config(self) -> Configuration:
+        """
+        Get the hardware configuration of the connected device, using the reported variant.
+
+        @rtype: Configuration
+        """
+        return _get_device_config(self.get_variant())
+
     def get_serial(self) -> str:
         """
         Returns the serial number of backend.::
@@ -372,6 +383,10 @@ def set_mode(self, mode: int) -> None:
         @type  mode: int
         @param mode: Device mode to set
         """
+        if not self._config.mode_change_support:
+            raise UnsupportedOperation(
+                "This operation is only supported on BlinkStick Pro devices"
+            )
         control_string = bytes(bytearray([4, mode]))
 
         self.backend.control_transfer(0x20, 0x9, 0x0004, 0, control_string)
@@ -391,6 +406,10 @@ def get_mode(self) -> int:
         @rtype: int
         @return: Device mode
         """
+        if not self._config.mode_change_support:
+            raise UnsupportedOperation(
+                "This operation is only supported on BlinkStick Pro devices"
+            )
 
         device_bytes = self.backend.control_transfer(0x80 | 0x20, 0x1, 0x0004, 0, 2)