lifx-emulator 2.2.0__py3-none-any.whl → 2.3.0__py3-none-any.whl

lifx_emulator/devices/device.py

@@ -9,7 +9,7 @@ import time
 from typing import Any
 
 from lifx_emulator.constants import LIFX_HEADER_SIZE
-from lifx_emulator.devices.states import DeviceState
+from lifx_emulator.devices.states import DeviceState, TileFramebuffers
 from lifx_emulator.handlers import HandlerRegistry, create_default_registry
 from lifx_emulator.protocol.header import LifxHeader
 from lifx_emulator.protocol.packets import (
@@ -114,6 +114,12 @@ class EmulatedLifxDevice:
                         }
                     )
 
+            # Initialize framebuffer storage for each tile (framebuffers 1-7)
+            # Framebuffer 0 is stored in tile_devices[i]["colors"]
+            if not self.state.tile_framebuffers:
+                for i in range(self.state.tile_count):
+                    self.state.tile_framebuffers.append(TileFramebuffers(tile_index=i))
+
         # Save initial state if persistence is enabled
         # This ensures newly created devices are immediately persisted
         if self.storage:

lifx_emulator/devices/state_serializer.py

@@ -97,6 +97,17 @@ def serialize_device_state(device_state: Any) -> dict[str, Any]:
             }
             for t in device_state.tile_devices
         ]
+        # Serialize tile framebuffers (non-visible framebuffers 1-7)
+        state_dict["tile_framebuffers"] = [
+            {
+                "tile_index": fb.tile_index,
+                "framebuffers": {
+                    str(fb_idx): [serialize_hsbk(c) for c in colors]
+                    for fb_idx, colors in fb.framebuffers.items()
+                },
+            }
+            for fb in device_state.tile_framebuffers
+        ]
 
     return state_dict
 
@@ -127,4 +138,20 @@ def deserialize_device_state(state_dict: dict[str, Any]) -> dict[str, Any]:
         for tile_dict in state_dict["tile_devices"]:
             tile_dict["colors"] = [deserialize_hsbk(c) for c in tile_dict["colors"]]
 
+    # Deserialize tile framebuffers if present (for backwards compatibility)
+    if "tile_framebuffers" in state_dict:
+        from lifx_emulator.devices.states import TileFramebuffers
+
+        deserialized_fbs = []
+        for fb_dict in state_dict["tile_framebuffers"]:
+            tile_fb = TileFramebuffers(tile_index=fb_dict["tile_index"])
+            # Deserialize each framebuffer's colors
+            for fb_idx_str, colors_list in fb_dict["framebuffers"].items():
+                fb_idx = int(fb_idx_str)
+                tile_fb.framebuffers[fb_idx] = [
+                    deserialize_hsbk(c) for c in colors_list
+                ]
+            deserialized_fbs.append(tile_fb)
+        state_dict["tile_framebuffers"] = deserialized_fbs
+
     return state_dict

lifx_emulator/devices/states.py

@@ -82,6 +82,32 @@ class MultiZoneState:
     effect_speed: int = 5  # Duration of one cycle in seconds
 
 
+@dataclass
+class TileFramebuffers:
+    """Internal storage for non-visible tile framebuffers (1-7).
+
+    Framebuffer 0 is stored in tile_devices[i]["colors"] (the visible buffer).
+    Framebuffers 1-7 are stored here for Set64/CopyFrameBuffer operations.
+    Each framebuffer is a list of LightHsbk colors with length = width * height.
+    """
+
+    tile_index: int  # Which tile this belongs to
+    framebuffers: dict[int, list[LightHsbk]] = field(default_factory=dict)
+
+    def get_framebuffer(
+        self, fb_index: int, width: int, height: int
+    ) -> list[LightHsbk]:
+        """Get framebuffer by index, creating it if needed."""
+        if fb_index not in self.framebuffers:
+            # Initialize with default black color
+            pixels = width * height
+            self.framebuffers[fb_index] = [
+                LightHsbk(hue=0, saturation=0, brightness=0, kelvin=3500)
+                for _ in range(pixels)
+            ]
+        return self.framebuffers[fb_index]
+
+
 @dataclass
 class MatrixState:
     """Matrix (tile/candle) capability state."""
@@ -101,6 +127,9 @@ class MatrixState:
     effect_cloud_sat_max: int = (
         0  # Max cloud saturation 0-200 (only when effect_type=5)
     )
+    # Internal storage for non-visible framebuffers (1-7) per tile
+    # Framebuffer 0 remains in tile_devices[i]["colors"]
+    tile_framebuffers: list[TileFramebuffers] = field(default_factory=list)
 
 
 @dataclass
@@ -215,6 +244,7 @@ class DeviceState:
         "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"),
+        "tile_framebuffers": "matrix",
     }
 
     # Default values for optional state attributes when state object is None
@@ -240,6 +270,7 @@ class DeviceState:
         "tile_effect_sky_type": 0,
         "tile_effect_cloud_sat_min": 0,
         "tile_effect_cloud_sat_max": 0,
+        "tile_framebuffers": [],
     }
 
     def get_target_bytes(self) -> bytes:

lifx_emulator/handlers/tile_handlers.py

@@ -12,6 +12,7 @@ from lifx_emulator.protocol.protocol_types import (
     DeviceStateVersion,
     LightHsbk,
     TileAccelMeas,
+    TileBufferRect,
     TileEffectParameter,
     TileEffectSettings,
     TileEffectType,
@@ -137,6 +138,10 @@ class Get64Handler(PacketHandler):
         tile_width = tile["width"]
         tile_height = tile["height"]
 
+        # Get64 always returns framebuffer 0 (the visible buffer)
+        # regardless of which fb_index is in the request
+        tile_colors = tile["colors"]
+
         # Calculate how many rows fit in 64 pixels
         rows_to_return = 64 // rect.width if rect.width > 0 else 1
         rows_to_return = min(rows_to_return, tile_height - rect.y)
@@ -161,8 +166,8 @@ class Get64Handler(PacketHandler):
 
                 # Calculate pixel index in flat color array
                 pixel_idx = y * tile_width + x
-                if pixel_idx < len(tile["colors"]):
-                    colors.append(tile["colors"][pixel_idx])
+                if pixel_idx < len(tile_colors):
+                    colors.append(tile_colors[pixel_idx])
                 else:
                     colors.append(
                         LightHsbk(hue=0, saturation=0, brightness=0, kelvin=3500)
@@ -173,7 +178,14 @@ class Get64Handler(PacketHandler):
         while len(colors) < 64:
             colors.append(LightHsbk(hue=0, saturation=0, brightness=0, kelvin=3500))
 
-        return [Tile.State64(tile_index=tile_index, rect=rect, colors=colors)]
+        # Return with fb_index forced to 0 (visible buffer)
+        return_rect = TileBufferRect(
+            fb_index=0,  # Always return FB0
+            x=rect.x,
+            y=rect.y,
+            width=rect.width,
+        )
+        return [Tile.State64(tile_index=tile_index, rect=return_rect, colors=colors)]
 
 
 class Set64Handler(PacketHandler):
@@ -188,16 +200,60 @@ class Set64Handler(PacketHandler):
             return []
 
         tile_index = packet.tile_index
+        fb_index = packet.rect.fb_index
 
-        if tile_index < len(device_state.tile_devices):
-            # Update colors from packet
-            for i, color in enumerate(packet.colors[:64]):
-                if i < len(device_state.tile_devices[tile_index]["colors"]):
-                    device_state.tile_devices[tile_index]["colors"][i] = color
+        if tile_index >= len(device_state.tile_devices):
+            return []
 
-            logger.info(
-                f"Tile {tile_index} set 64 colors, duration={packet.duration}ms"
-            )
+        tile = device_state.tile_devices[tile_index]
+        tile_width = tile["width"]
+        tile_height = tile["height"]
+        rect = packet.rect
+
+        # Determine which framebuffer to update
+        if fb_index == 0:
+            # Update visible framebuffer (stored in tile_devices)
+            target_colors = tile["colors"]
+        else:
+            # Update non-visible framebuffer (stored in tile_framebuffers)
+            if tile_index < len(device_state.tile_framebuffers):
+                fb_storage = device_state.tile_framebuffers[tile_index]
+                target_colors = fb_storage.get_framebuffer(
+                    fb_index, tile_width, tile_height
+                )
+            else:
+                logger.warning(f"Tile {tile_index} framebuffer storage not initialized")
+                return []
+
+        # Update colors in the specified rectangle
+        # Calculate how many rows fit in 64 pixels
+        rows_to_write = 64 // rect.width if rect.width > 0 else 1
+        rows_to_write = min(rows_to_write, tile_height - rect.y)
+
+        pixels_written = 0
+        for row in range(rows_to_write):
+            y = rect.y + row
+            if y >= tile_height:
+                break
+
+            for col in range(rect.width):
+                x = rect.x + col
+                if x >= tile_width or pixels_written >= 64:
+                    pixels_written += 1
+                    continue
+
+                # Calculate pixel index in flat color array
+                pixel_idx = y * tile_width + x
+                if pixel_idx < len(target_colors) and pixels_written < len(
+                    packet.colors
+                ):
+                    target_colors[pixel_idx] = packet.colors[pixels_written]
+                pixels_written += 1
+
+        logger.info(
+            f"Tile {tile_index} FB{fb_index} set {pixels_written} colors at "
+            f"({rect.x},{rect.y}), duration={packet.duration}ms"
+        )
 
         # Tiles never return a response to Set64 regardless of res_required
         # https://lan.developer.lifx.com/docs/changing-a-device#set64---packet-715
@@ -212,12 +268,83 @@ class CopyFrameBufferHandler(PacketHandler):
     def handle(
         self, device_state: DeviceState, packet: Any | None, res_required: bool
     ) -> list[Any]:
-        if not device_state.has_matrix:
+        if not device_state.has_matrix or not packet:
+            return []
+
+        tile_index = packet.tile_index
+        if tile_index >= len(device_state.tile_devices):
             return []
 
-        logger.debug("Tile copy frame buffer command received (no-op in emulator)")
-        # In a real device, this would copy the frame buffer to display
-        # In emulator, we don't need to do anything special
+        tile = device_state.tile_devices[tile_index]
+        tile_width = tile["width"]
+        tile_height = tile["height"]
+
+        src_fb_index = packet.src_fb_index
+        dst_fb_index = packet.dst_fb_index
+
+        # Get source framebuffer
+        if src_fb_index == 0:
+            src_colors = tile["colors"]
+        else:
+            if tile_index < len(device_state.tile_framebuffers):
+                fb_storage = device_state.tile_framebuffers[tile_index]
+                src_colors = fb_storage.get_framebuffer(
+                    src_fb_index, tile_width, tile_height
+                )
+            else:
+                logger.warning(f"Tile {tile_index} framebuffer storage not initialized")
+                return []
+
+        # Get destination framebuffer
+        if dst_fb_index == 0:
+            dst_colors = tile["colors"]
+        else:
+            if tile_index < len(device_state.tile_framebuffers):
+                fb_storage = device_state.tile_framebuffers[tile_index]
+                dst_colors = fb_storage.get_framebuffer(
+                    dst_fb_index, tile_width, tile_height
+                )
+            else:
+                logger.warning(f"Tile {tile_index} framebuffer storage not initialized")
+                return []
+
+        # Copy the specified rectangle from source to destination
+        src_x = packet.src_x
+        src_y = packet.src_y
+        dst_x = packet.dst_x
+        dst_y = packet.dst_y
+        width = packet.width
+        height = packet.height
+
+        pixels_copied = 0
+        for row in range(height):
+            src_row = src_y + row
+            dst_row = dst_y + row
+
+            if src_row >= tile_height or dst_row >= tile_height:
+                break
+
+            for col in range(width):
+                src_col = src_x + col
+                dst_col = dst_x + col
+
+                if src_col >= tile_width or dst_col >= tile_width:
+                    continue
+
+                src_idx = src_row * tile_width + src_col
+                dst_idx = dst_row * tile_width + dst_col
+
+                if src_idx < len(src_colors) and dst_idx < len(dst_colors):
+                    dst_colors[dst_idx] = src_colors[src_idx]
+                    pixels_copied += 1
+
+        logger.info(
+            f"Tile {tile_index} copied {pixels_copied} pixels from "
+            f"FB{src_fb_index}({src_x},{src_y}) to "
+            f"FB{dst_fb_index}({dst_x},{dst_y}), "
+            f"size={width}x{height}, duration={packet.duration}ms"
+        )
+
         return []
 
 
@@ -240,12 +367,25 @@ class GetEffectHandler(PacketHandler):
         # 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
+        # Use defaults for SKY effect when values are None, otherwise use stored values
+        # NOTE: Must check for None explicitly, not use 'or', because SUNRISE=0 is falsy
         effect_type = TileEffectType(device_state.tile_effect_type)
         if effect_type == TileEffectType.SKY:
-            sky_type = device_state.tile_effect_sky_type or TileEffectSkyType.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
+            sky_type = (
+                device_state.tile_effect_sky_type
+                if device_state.tile_effect_sky_type is not None
+                else TileEffectSkyType.CLOUDS
+            )
+            cloud_sat_min = (
+                device_state.tile_effect_cloud_sat_min
+                if device_state.tile_effect_cloud_sat_min is not None
+                else 50
+            )
+            cloud_sat_max = (
+                device_state.tile_effect_cloud_sat_max
+                if device_state.tile_effect_cloud_sat_max is not None
+                else 180
+            )
         else:
             sky_type = device_state.tile_effect_sky_type
             cloud_sat_min = device_state.tile_effect_cloud_sat_min

{lifx_emulator-2.2.0.dist-info → lifx_emulator-2.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lifx-emulator
-Version: 2.2.0
+Version: 2.3.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.2.0.dist-info → lifx_emulator-2.3.0.dist-info}/RECORD

@@ -15,13 +15,13 @@ lifx_emulator/api/services/__init__.py,sha256=ttjjZfAxbDQC_Ep0LkXjopNiVZOFPsFDSO
 lifx_emulator/api/services/device_service.py,sha256=r3uFWApC8sVQMCuuzkyjm27K4LDpZnnHmQNgXWX40ok,6294
 lifx_emulator/api/templates/dashboard.html,sha256=YXQ9jrs30DZIxtMWFE4E2HqmsgHQ-NeWTTQxQ-7BfHk,33800
 lifx_emulator/devices/__init__.py,sha256=QlBTPnFErJcSKLvGyeDwemh7xcpjYvB_L5siKsjr3s8,1089
-lifx_emulator/devices/device.py,sha256=LMdg__95n6geG_32j7qp5yl51WNS3ZbCXn-xMfVVikE,13294
+lifx_emulator/devices/device.py,sha256=LIVXURglYsYMC6_88sAWzoJKkq_HSZEOu4xruRtcZKs,13650
 lifx_emulator/devices/manager.py,sha256=XDrT82um5sgNpNihLj5RsNvHqdVI1bK9YY2eBzWIcf0,8162
 lifx_emulator/devices/observers.py,sha256=-KnUgFcKdhlNo7CNVstP-u0wU2W0JAGg055ZPV15Sj0,3874
 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=mVZz7FQeIHLpv2SokmhlQlSBIyVj3GuhGMHBVoFlJqk,10836
+lifx_emulator/devices/state_serializer.py,sha256=aws4LUmXBJS8oBrQziJtlV0XMvCTm5X4dGkGlO_QHcM,6281
+lifx_emulator/devices/states.py,sha256=O__VtgK97-ZHxZ2qgOKp9-fDG8HcmlTVkGYONwot8iQ,12094
 lifx_emulator/factories/__init__.py,sha256=yN8i_Hu_cFEryWZmh0TiOQvWEYFVIApQSs4xeb0EfBk,1170
 lifx_emulator/factories/builder.py,sha256=OaDqQDGkAyZCSO-4HAsFSd5UzsHpHvRyBk-Fotl1mAY,12056
 lifx_emulator/factories/default_config.py,sha256=FTcxKDfeTmO49GTSki8nxnEIZQzR0Lg0hL_PwHUrkVQ,4828
@@ -34,7 +34,7 @@ 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=tQSq5hptq_CWlsc0q_I1D3WLcNmOliR47gY2AZI9AEs,12329
+lifx_emulator/handlers/tile_handlers.py,sha256=tniYndUbtWPTu7YznfMKsWUBu2UmGsSuOYRws5IBL0s,17239
 lifx_emulator/products/__init__.py,sha256=qcNop_kRYFF3zSjNemzQEgu3jPrIxfyQyLv9GsnaLEI,627
 lifx_emulator/products/generator.py,sha256=5zcq0iKgwjtg0gePnBEOdIkumesvfzEcKRdBZFPyGtk,33538
 lifx_emulator/products/registry.py,sha256=qkm2xgGZo_ds3wAbYplLu4gb0cxhjZXjnCc1V8etpHw,46517
@@ -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.2.0.dist-info/METADATA,sha256=IYeBVFaQco74YbRC2s-orGbU4zWnrTrNAnwiT08nxPM,4549
-lifx_emulator-2.2.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-lifx_emulator-2.2.0.dist-info/entry_points.txt,sha256=R9C_K_tTgt6yXEmhzH4r2Yx2Tu1rLlnYzeG4RFUVzSc,62
-lifx_emulator-2.2.0.dist-info/licenses/LICENSE,sha256=eBz48GRA3gSiWn3rYZAz2Ewp35snnhV9cSqkVBq7g3k,1832
-lifx_emulator-2.2.0.dist-info/RECORD,,
+lifx_emulator-2.3.0.dist-info/METADATA,sha256=PsbeOthCdD824wzYnw8vf_rKKze3Yk1DPC6NtpkZv1Q,4549
+lifx_emulator-2.3.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+lifx_emulator-2.3.0.dist-info/entry_points.txt,sha256=R9C_K_tTgt6yXEmhzH4r2Yx2Tu1rLlnYzeG4RFUVzSc,62
+lifx_emulator-2.3.0.dist-info/licenses/LICENSE,sha256=eBz48GRA3gSiWn3rYZAz2Ewp35snnhV9cSqkVBq7g3k,1832
+lifx_emulator-2.3.0.dist-info/RECORD,,