lifx-emulator 2.0.0__py3-none-any.whl → 2.1.0__py3-none-any.whl

lifx_emulator/devices/states.py

@@ -90,10 +90,17 @@ class MatrixState:
     tile_devices: list[dict[str, Any]]
     tile_width: int
     tile_height: int
-    effect_type: int = 0  # 0=OFF, 2=MORPH, 3=FLAME
+    effect_type: int = 0  # 0=OFF, 2=MORPH, 3=FLAME, 5=SKY
     effect_speed: int = 5  # Duration of one cycle in seconds
     effect_palette_count: int = 0
     effect_palette: list[LightHsbk] = field(default_factory=list)
+    effect_sky_type: int = 0  # 0=SUNRISE, 1=SUNSET, 2=CLOUDS (only when effect_type=5)
+    effect_cloud_sat_min: int = (
+        0  # Min cloud saturation 0-200 (only when effect_type=5)
+    )
+    effect_cloud_sat_max: int = (
+        0  # Max cloud saturation 0-200 (only when effect_type=5)
+    )
 
 
 @dataclass
@@ -205,6 +212,9 @@ class DeviceState:
         "tile_effect_speed": ("matrix", "effect_speed"),
         "tile_effect_palette_count": ("matrix", "effect_palette_count"),
         "tile_effect_palette": ("matrix", "effect_palette"),
+        "tile_effect_sky_type": ("matrix", "effect_sky_type"),
+        "tile_effect_cloud_sat_min": ("matrix", "effect_cloud_sat_min"),
+        "tile_effect_cloud_sat_max": ("matrix", "effect_cloud_sat_max"),
     }
 
     # Default values for optional state attributes when state object is None
@@ -227,6 +237,9 @@ class DeviceState:
         "tile_effect_speed": 0,
         "tile_effect_palette_count": 0,
         "tile_effect_palette": [],
+        "tile_effect_sky_type": 0,
+        "tile_effect_cloud_sat_min": 0,
+        "tile_effect_cloud_sat_max": 0,
     }
 
     def get_target_bytes(self) -> bytes:

lifx_emulator/handlers/tile_handlers.py

@@ -237,16 +237,24 @@ class GetEffectHandler(PacketHandler):
         while len(palette) < 16:
             palette.append(LightHsbk(hue=0, saturation=0, brightness=0, kelvin=3500))
 
-        # Create effect settings
+        # Create effect settings with Sky parameters
+        from lifx_emulator.protocol.protocol_types import TileEffectSkyType
+
+        # Use defaults for SKY effect (type=5), otherwise use stored values
+        effect_type = device_state.tile_effect_type
+        if effect_type == 5:  # SKY effect
+            sky_type = device_state.tile_effect_sky_type or 2  # Default to CLOUDS
+            cloud_sat_min = device_state.tile_effect_cloud_sat_min or 50
+            cloud_sat_max = device_state.tile_effect_cloud_sat_max or 180
+        else:
+            sky_type = device_state.tile_effect_sky_type
+            cloud_sat_min = device_state.tile_effect_cloud_sat_min
+            cloud_sat_max = device_state.tile_effect_cloud_sat_max
+
         parameter = TileEffectParameter(
-            parameter0=0,
-            parameter1=0,
-            parameter2=0,
-            parameter3=0,
-            parameter4=0,
-            parameter5=0,
-            parameter6=0,
-            parameter7=0,
+            sky_type=TileEffectSkyType(sky_type),
+            cloud_saturation_min=cloud_sat_min,
+            cloud_saturation_max=cloud_sat_max,
         )
         settings = TileEffectSettings(
             instanceid=0,
@@ -285,10 +293,22 @@ class SetEffectHandler(PacketHandler):
             )
             device_state.tile_effect_palette_count = packet.settings.palette_count
 
+            # Save Sky effect parameters
+            device_state.tile_effect_sky_type = int(packet.settings.parameter.sky_type)
+            device_state.tile_effect_cloud_sat_min = (
+                packet.settings.parameter.cloud_saturation_min
+            )
+            device_state.tile_effect_cloud_sat_max = (
+                packet.settings.parameter.cloud_saturation_max
+            )
+
             logger.info(
                 f"Tile effect set: type={packet.settings.type}, "
                 f"speed={packet.settings.speed}ms, "
-                f"palette_count={packet.settings.palette_count}"
+                f"palette_count={packet.settings.palette_count}, "
+                f"sky_type={packet.settings.parameter.sky_type}, "
+                f"cloud_sat=[{packet.settings.parameter.cloud_saturation_min}, "
+                f"{packet.settings.parameter.cloud_saturation_max}]"
             )
 
         if res_required:

lifx_emulator/protocol/base.py

@@ -10,10 +10,13 @@ Performance optimizations:
 
 from __future__ import annotations
 
+import logging
 import re
-from dataclasses import dataclass
+from dataclasses import asdict, dataclass
 from typing import Any, ClassVar
 
+_LOGGER = logging.getLogger(__name__)
+
 # Performance optimization: Pre-compiled regex patterns
 _CAMEL_TO_SNAKE_PATTERN = re.compile(r"(?<!^)(?=[A-Z])")
 _ARRAY_TYPE_PATTERN = re.compile(r"\[(\d+)\](.+)")
@@ -39,6 +42,11 @@ class Packet:
     _fields: ClassVar[list[dict[str, Any]]]
     _field_info: ClassVar[list[tuple[str, str, int]] | None] = None
 
+    @property
+    def as_dict(self) -> dict[str, Any]:
+        """Return packet as dictionary."""
+        return asdict(self)
+
     def pack(self) -> bytes:
         """Pack packet to bytes using field metadata.
 
@@ -76,9 +84,25 @@ class Packet:
             offset: Offset in bytes to start unpacking
 
         Returns:
-            Packet instance
+            Packet instance with label fields decoded to strings
         """
         packet, _ = cls._unpack_internal(data, offset)
+
+        # Decode label fields from bytes to string in-place
+        # This ensures all State packets have human-readable labels
+        cls._decode_labels_inplace(packet)
+
+        # Log packet values after unpacking and decoding labels
+        packet_values = asdict(packet)
+        _LOGGER.debug(
+            {
+                "class": "Packet",
+                "method": "unpack",
+                "packet_type": type(packet).__name__,
+                "values": packet_values,
+            }
+        )
+
         return packet
 
     @classmethod
@@ -177,6 +201,9 @@ class Packet:
             "MultiZoneApplicationRequest",
             "MultiZoneEffectType",
             "MultiZoneExtendedApplicationRequest",
+            "TileEffectSkyPalette",
+            "TileEffectSkyType",
+            "TileEffectType",
         }
         is_enum = is_nested and base_type in enum_types
 
@@ -320,6 +347,9 @@ class Packet:
             MultiZoneApplicationRequest,
             MultiZoneEffectType,
             MultiZoneExtendedApplicationRequest,
+            TileEffectSkyPalette,
+            TileEffectSkyType,
+            TileEffectType,
         )
 
         base_type, array_count, is_nested = cls._parse_field_type(field_type)
@@ -331,6 +361,9 @@ class Packet:
             "MultiZoneApplicationRequest": MultiZoneApplicationRequest,
             "MultiZoneEffectType": MultiZoneEffectType,
             "MultiZoneExtendedApplicationRequest": MultiZoneExtendedApplicationRequest,
+            "TileEffectSkyPalette": TileEffectSkyPalette,
+            "TileEffectSkyType": TileEffectSkyType,
+            "TileEffectType": TileEffectType,
         }
 
         if array_count:
@@ -386,3 +419,28 @@ class Packet:
         # Cache the result
         _FIELD_TYPE_CACHE[field_type] = result
         return result
+
+    @staticmethod
+    def _decode_labels_inplace(packet: object) -> None:
+        """Decode label fields from bytes to string in-place.
+
+        Automatically finds and decodes any field named 'label' or ending with '_label'
+        for all State packets. This ensures human-readable labels in all contexts.
+
+        Args:
+            packet: Packet instance to process (modified in-place)
+        """
+        from dataclasses import fields, is_dataclass
+
+        if not is_dataclass(packet):
+            return
+
+        for field_info in fields(packet):
+            # Check if this looks like a label field
+            if field_info.name == "label" or field_info.name.endswith("_label"):
+                value = getattr(packet, field_info.name)
+                if isinstance(value, bytes):
+                    # Decode: strip null terminator, decode UTF-8
+                    decoded = value.rstrip(b"\x00").decode("utf-8")
+                    # Use object.__setattr__ to bypass frozen dataclass if needed
+                    object.__setattr__(packet, field_info.name, decoded)

lifx_emulator/protocol/protocol_types.py

@@ -505,16 +505,11 @@ class TileBufferRect:
 
 @dataclass
 class TileEffectParameter:
-    """Auto-generated field structure."""
+    """Auto-generated field structure for Sky effects."""
 
-    parameter0: int
-    parameter1: int
-    parameter2: int
-    parameter3: int
-    parameter4: int
-    parameter5: int
-    parameter6: int
-    parameter7: int
+    sky_type: TileEffectSkyType
+    cloud_saturation_min: int
+    cloud_saturation_max: int
 
     def pack(self) -> bytes:
         """Pack to bytes."""
@@ -522,22 +517,18 @@ class TileEffectParameter:
 
         result = b""
 
-        # parameter0: uint32
-        result += serializer.pack_value(self.parameter0, "uint32")
-        # parameter1: uint32
-        result += serializer.pack_value(self.parameter1, "uint32")
-        # parameter2: uint32
-        result += serializer.pack_value(self.parameter2, "uint32")
-        # parameter3: uint32
-        result += serializer.pack_value(self.parameter3, "uint32")
-        # parameter4: uint32
-        result += serializer.pack_value(self.parameter4, "uint32")
-        # parameter5: uint32
-        result += serializer.pack_value(self.parameter5, "uint32")
-        # parameter6: uint32
-        result += serializer.pack_value(self.parameter6, "uint32")
-        # parameter7: uint32
-        result += serializer.pack_value(self.parameter7, "uint32")
+        # sky_type: TileEffectSkyType (enum)
+        result += serializer.pack_value(int(self.sky_type), "uint8")
+        # Reserved 3 bytes
+        result += serializer.pack_reserved(3)
+        # cloud_saturation_min: uint8
+        result += serializer.pack_value(self.cloud_saturation_min, "uint8")
+        # Reserved 3 bytes
+        result += serializer.pack_reserved(3)
+        # cloud_saturation_max: uint8
+        result += serializer.pack_value(self.cloud_saturation_max, "uint8")
+        # Reserved 23 bytes
+        result += serializer.pack_reserved(23)
 
         return result
 
@@ -547,49 +538,31 @@ class TileEffectParameter:
         from lifx_emulator.protocol import serializer
 
         current_offset = offset
-        # parameter0: uint32
-        parameter0, current_offset = serializer.unpack_value(
-            data, "uint32", current_offset
-        )
-        # parameter1: uint32
-        parameter1, current_offset = serializer.unpack_value(
-            data, "uint32", current_offset
-        )
-        # parameter2: uint32
-        parameter2, current_offset = serializer.unpack_value(
-            data, "uint32", current_offset
-        )
-        # parameter3: uint32
-        parameter3, current_offset = serializer.unpack_value(
-            data, "uint32", current_offset
-        )
-        # parameter4: uint32
-        parameter4, current_offset = serializer.unpack_value(
-            data, "uint32", current_offset
-        )
-        # parameter5: uint32
-        parameter5, current_offset = serializer.unpack_value(
-            data, "uint32", current_offset
+        # sky_type: TileEffectSkyType (enum)
+        sky_type_raw, current_offset = serializer.unpack_value(
+            data, "uint8", current_offset
         )
-        # parameter6: uint32
-        parameter6, current_offset = serializer.unpack_value(
-            data, "uint32", current_offset
+        sky_type = TileEffectSkyType(sky_type_raw)
+        # Skip reserved 3 bytes
+        current_offset += 3
+        # cloud_saturation_min: uint8
+        cloud_saturation_min, current_offset = serializer.unpack_value(
+            data, "uint8", current_offset
         )
-        # parameter7: uint32
-        parameter7, current_offset = serializer.unpack_value(
-            data, "uint32", current_offset
+        # Skip reserved 3 bytes
+        current_offset += 3
+        # cloud_saturation_max: uint8
+        cloud_saturation_max, current_offset = serializer.unpack_value(
+            data, "uint8", current_offset
         )
+        # Skip reserved 23 bytes
+        current_offset += 23
 
         return (
             cls(
-                parameter0=parameter0,
-                parameter1=parameter1,
-                parameter2=parameter2,
-                parameter3=parameter3,
-                parameter4=parameter4,
-                parameter5=parameter5,
-                parameter6=parameter6,
-                parameter7=parameter7,
+                sky_type=sky_type,
+                cloud_saturation_min=cloud_saturation_min,
+                cloud_saturation_max=cloud_saturation_max,
             ),
             current_offset,
         )

lifx_emulator/server.py

@@ -217,7 +217,7 @@ class EmulatedLifxServer:
             resp_packet_name = _get_packet_type_name(resp_header.pkt_type)
             resp_fields_str = _format_packet_fields(resp_packet)
             logger.debug(
-                "→ TX %s to %s:%s (device=%s, seq=%s) [%s]",
+                "→ TX %s to %s:%s (target=%s, seq=%s) [%s]",
                 resp_packet_name,
                 addr[0],
                 addr[1],
@@ -303,7 +303,9 @@ class EmulatedLifxServer:
 
             # Log received packet with details
             packet_name = _get_packet_type_name(header.pkt_type)
-            target_str = "broadcast" if header.tagged else header.target.hex()
+            target_str = (
+                "broadcast" if header.tagged else header.target.hex().rstrip("0000")
+            )
             fields_str = _format_packet_fields(packet)
             logger.debug(
                 "← RX %s from %s:%s (target=%s, seq=%s) [%s]",

{lifx_emulator-2.0.0.dist-info → lifx_emulator-2.1.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lifx-emulator
-Version: 2.0.0
+Version: 2.1.0
 Summary: LIFX Emulator for testing LIFX LAN protocol libraries
 Author-email: Avi Miller <me@dje.li>
 Maintainer-email: Avi Miller <me@dje.li>

{lifx_emulator-2.0.0.dist-info → lifx_emulator-2.1.0.dist-info}/RECORD

@@ -1,7 +1,7 @@
 lifx_emulator/__init__.py,sha256=vjhtpAQRSsUZtaUGCQKbmPALvwZ_BF8Mko8w6jzVqBw,819
 lifx_emulator/__main__.py,sha256=zaul9OQhN5csqOqxGWXkVrlurfo2R_-YvM6URk4QAME,21680
 lifx_emulator/constants.py,sha256=DFZkUsdewE-x_3MgO28tMGkjUCWPeYc3xLj_EXViGOw,1032
-lifx_emulator/server.py,sha256=0bn7oDIlC6TTOJj9ULXLp9rCFAFcW4vM4whor7VTuRU,16391
+lifx_emulator/server.py,sha256=r2JYFcpZIqqhue-Nfq7FbN0KfC3XDf3XDb6b43DsiCk,16438
 lifx_emulator/api/__init__.py,sha256=FoEPw_In5-H_BDQ-XIIONvgj-UqIDVtejIEVRv9qmV8,647
 lifx_emulator/api/app.py,sha256=IxK8sC7MgdtkoLz8iXcEt02nPDaVgdKJgEiGnzTs-YE,4880
 lifx_emulator/api/models.py,sha256=eBx80Ece_4Wv6aqxb1CsZEob9CF0WmR9oJGz3hh14x8,3973
@@ -21,7 +21,7 @@ lifx_emulator/devices/observers.py,sha256=-KnUgFcKdhlNo7CNVstP-u0wU2W0JAGg055ZPV
 lifx_emulator/devices/persistence.py,sha256=9Mhj46-xrweOmyzjORCi2jKIwa8XJWpQ5CgaKcw6U98,10513
 lifx_emulator/devices/state_restorer.py,sha256=eDsRSW-2RviP_0Qlk2DHqMaB-zhV0X1cNQECv2lD1qc,9809
 lifx_emulator/devices/state_serializer.py,sha256=O4Cp3bbGkd4eZf5jzb0MKzWDTgiNhrSGgypmMWaB4dg,5097
-lifx_emulator/devices/states.py,sha256=ealrShXAqEeKYnyNclTGgWxV9uDf3VYyw4SbRHe1xEk,10205
+lifx_emulator/devices/states.py,sha256=mVZz7FQeIHLpv2SokmhlQlSBIyVj3GuhGMHBVoFlJqk,10836
 lifx_emulator/factories/__init__.py,sha256=yN8i_Hu_cFEryWZmh0TiOQvWEYFVIApQSs4xeb0EfBk,1170
 lifx_emulator/factories/builder.py,sha256=ZSz5apcorsKpuPsdjFE4VLC1p41jVY8MWs1-nRBOLMk,11996
 lifx_emulator/factories/default_config.py,sha256=FTcxKDfeTmO49GTSki8nxnEIZQzR0Lg0hL_PwHUrkVQ,4828
@@ -34,19 +34,19 @@ lifx_emulator/handlers/device_handlers.py,sha256=1AmslA4Ut6L7b3SfduDdvnQizTpzUB3
 lifx_emulator/handlers/light_handlers.py,sha256=Ryz-_fzoVCT6DBkXhW9YCOYJYaMRcBOIguL3HrQXhAw,11471
 lifx_emulator/handlers/multizone_handlers.py,sha256=2dYsitq0KzEaxEAJmz7ixtir1tvFMOAnfkBQqslqbPM,7914
 lifx_emulator/handlers/registry.py,sha256=s1ht4PmPhXhAcwu1hoY4yW39wy3SPJBMY-9Uxd0FWuE,3292
-lifx_emulator/handlers/tile_handlers.py,sha256=D23dQVwukfKccryNEFrojMFhubcg4p-onMCXEDRyTlc,10039
+lifx_emulator/handlers/tile_handlers.py,sha256=-DU4PufPgE7vfvKsZfxP_7vBtI3EtAeBF3-U2-1zyaQ,11294
 lifx_emulator/products/__init__.py,sha256=qcNop_kRYFF3zSjNemzQEgu3jPrIxfyQyLv9GsnaLEI,627
 lifx_emulator/products/generator.py,sha256=NYInVSGyYIxAYMpTihqBtXP06lAYVfbSYe0Wv5Hg9vQ,31758
 lifx_emulator/products/registry.py,sha256=qkm2xgGZo_ds3wAbYplLu4gb0cxhjZXjnCc1V8etpHw,46517
 lifx_emulator/products/specs.py,sha256=pfmQMrQxlCGqORs3MbsH_vmCvxdaDwjVzXUCVZCjFCI,7093
 lifx_emulator/products/specs.yml,sha256=uxzdKFREAHphk8XSPiCHvQE2vwoPfT2m1xy-zC4ZIl4,8552
 lifx_emulator/protocol/__init__.py,sha256=-wjC-wBcb7fxi5I-mJr2Ad8K2YRflJFdLLdobfD-W1Q,56
-lifx_emulator/protocol/base.py,sha256=8DyJBhJi9k5LH4qRe-9P-XBC0iUEH01lGodoADH6Za8,13209
+lifx_emulator/protocol/base.py,sha256=V6t0baSgIXjrsz2dBuUn_V9xwradSqMxBFJHAUtnfCs,15368
 lifx_emulator/protocol/const.py,sha256=ilhv-KcQpHtKh2MDCaIbMLQAsxKO_uTaxyR63v1W8cc,226
 lifx_emulator/protocol/generator.py,sha256=LUkf-1Z5570Vg5iA1QhDZDWQOrABqmukUgk9qH-IJmg,49524
 lifx_emulator/protocol/header.py,sha256=RXMJ5YZG1jyxl4Mz46ZGJBYX41Jdp7J95BHuY-scYC0,5499
 lifx_emulator/protocol/packets.py,sha256=Yv4O-Uqbj0CR7n04vXhfalJVCmTTvJTWkvZBkcwPx-U,41553
-lifx_emulator/protocol/protocol_types.py,sha256=2Mccm9717EuTXQYaW44W_yReI4EtnlPp3-WEVASgdGY,24820
+lifx_emulator/protocol/protocol_types.py,sha256=WX1p4fmFcNJURmEV_B7ubi7fgu-w9loXQ89q8DdbeSA,23970
 lifx_emulator/protocol/serializer.py,sha256=2bZz7TddxaMRO4_6LujRGCS1w7GxD4E3rRk3r-hpEIE,10738
 lifx_emulator/repositories/__init__.py,sha256=x-ncM6T_Q7jNrwhK4a1uAyMrTGHHGeUzPSLC4O-kEUw,645
 lifx_emulator/repositories/device_repository.py,sha256=KsXVg2sg7PGSTsK_PvDYeHHwEPM9Qx2ZZF_ORncBrYQ,3929
@@ -55,8 +55,8 @@ lifx_emulator/scenarios/__init__.py,sha256=CGjudoWvyysvFj2xej11N2cr3mYROGtRb9zVH
 lifx_emulator/scenarios/manager.py,sha256=1esxRdz74UynNk1wb86MGZ2ZFAuMzByuu74nRe3D-Og,11163
 lifx_emulator/scenarios/models.py,sha256=BKS_fGvrbkGe-vK3arZ0w2f9adS1UZhiOoKpu7GENnc,4099
 lifx_emulator/scenarios/persistence.py,sha256=3vjtPNFYfag38tUxuqxkGpWhQ7uBitc1rLroSAuw9N8,8881
-lifx_emulator-2.0.0.dist-info/METADATA,sha256=u29qYpMQ0IbZju5mormUZu6Nye04gpQnxBMWnmSYNiM,4549
-lifx_emulator-2.0.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-lifx_emulator-2.0.0.dist-info/entry_points.txt,sha256=R9C_K_tTgt6yXEmhzH4r2Yx2Tu1rLlnYzeG4RFUVzSc,62
-lifx_emulator-2.0.0.dist-info/licenses/LICENSE,sha256=eBz48GRA3gSiWn3rYZAz2Ewp35snnhV9cSqkVBq7g3k,1832
-lifx_emulator-2.0.0.dist-info/RECORD,,
+lifx_emulator-2.1.0.dist-info/METADATA,sha256=cen3ovCv4G8WJyDQpy46bpFndEZ1OZH09NFuaoE0-mw,4549
+lifx_emulator-2.1.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+lifx_emulator-2.1.0.dist-info/entry_points.txt,sha256=R9C_K_tTgt6yXEmhzH4r2Yx2Tu1rLlnYzeG4RFUVzSc,62
+lifx_emulator-2.1.0.dist-info/licenses/LICENSE,sha256=eBz48GRA3gSiWn3rYZAz2Ewp35snnhV9cSqkVBq7g3k,1832
+lifx_emulator-2.1.0.dist-info/RECORD,,