python-roborock 7.15.1__py3-none-any.whl → 7.15.3__py3-none-any.whl

{python_roborock-7.15.1.dist-info → python_roborock-7.15.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: python-roborock
-Version: 7.15.1
+Version: 7.15.3
 Summary: A package to control Roborock vacuums.
 Project-URL: Repository, https://github.com/python-roborock/python-roborock
 Project-URL: Documentation, https://python-roborock.readthedocs.io/

{python_roborock-7.15.1.dist-info → python_roborock-7.15.3.dist-info}/RECORD

@@ -11,7 +11,6 @@ roborock/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 roborock/roborock_message.py,sha256=1PHla68g6o0SZjRFJp8QvVipnW-t-ZUmVY9ay_p7MJo,11915
 roborock/roborock_typing.py,sha256=xppavdf57-Cu6elj3MP403uT75Tjw5Zs6bLGPLQmZf4,15483
 roborock/util.py,sha256=4zibjn2MgPrLCiha66LUXZj907LOXUtNzugbbb0NIlo,1634
-roborock/web_api.py,sha256=G42qiPdTGx4LhMA4uTDASAMYw1HIipDnD6_eziwCPqs,43202
 roborock/data/__init__.py,sha256=mmFs7SGa1ciqXME5Al9gfIKiCnbhgu1V84wa4j5mdfs,300
 roborock/data/camera.py,sha256=AaTsDqNlUwV_6zdIX9wQkPXGFzyt2EiiKnitcnfQJA4,5792
 roborock/data/code_mappings.py,sha256=j-ZZRtQQdIMJQAgEwDAxWKreNhD6U36oIhBKr_nLbis,9783
@@ -23,11 +22,11 @@ roborock/data/b01_q7/__init__.py,sha256=D-Cd8eB0njf1PQPM6Exl_9A0AhpzIjrL0hapGOCE
 roborock/data/b01_q7/b01_q7_code_mappings.py,sha256=OY5ShERmGh4hKp9SCUohYEbU6FgRJuw34ucYJpjnEiI,11615
 roborock/data/b01_q7/b01_q7_containers.py,sha256=1PEPyKuaMsPXSOtUw8OQu6aSo5BBgQqMVnAE_rTvZ7w,10428
 roborock/data/dyad/__init__.py,sha256=Ksx7Ri1alsAYAyILOpj9iNbCC_6sF7xvETFRnTO4rdM,65
-roborock/data/dyad/dyad_code_mappings.py,sha256=PGzEpkdc1jsR5RLRnjVnI2Y87O_HFAFulwOjjjbT4B0,2872
+roborock/data/dyad/dyad_code_mappings.py,sha256=HqtqppHTgNUhmJQrCiMQpB4gwrrThZvUuzAvSxhlGKo,3061
 roborock/data/dyad/dyad_containers.py,sha256=klJD2wV-2McjAoSN8Bthuyeid59L7M8nzSvc3MtmqOI,434
 roborock/data/mower/__init__.py,sha256=RXFcOE0-rchWViq3F-cLXB9Jnx4nKrn98TUR917szWM,114
-roborock/data/mower/mower_code_mappings.py,sha256=dKHgZxpNVaO-uFZvqjPouYbpzgukAlnFgHa8vGsNxKs,14110
-roborock/data/mower/mower_containers.py,sha256=s8xzDOW7Pgoipw7P2ROjj-4-c0qZRHuZ-kw_Zu-Aqt0,4938
+roborock/data/mower/mower_code_mappings.py,sha256=QTMW3rfw3pnuTHLwj5RORj44QGjjNjQE3jCDSeGorQE,14251
+roborock/data/mower/mower_containers.py,sha256=zsGJOIKs9Y95hHzOEBC85qy1RYC8V-StCZLR4SpTf8c,5019
 roborock/data/v1/__init__.py,sha256=3cdjyhCkD4EmEn9JVlSakGusnEgzGajpn8tAvzB3FkI,121
 roborock/data/v1/v1_clean_modes.py,sha256=uePsc82-7C6tjybYmnYtxA6WAOPS9ofnJXMEP218KTQ,15767
 roborock/data/v1/v1_code_mappings.py,sha256=9lbpJ5Ugzb0IhjiHjNNQvgLBxEsjZdfq1sEOHkjJIfI,12970
@@ -105,9 +104,9 @@ roborock/devices/transport/mqtt_channel.py,sha256=dpL1mZIoI4Glk3hfUO9JweWFHG1tZW
 roborock/map/__init__.py,sha256=L3WHujuxUHCTTPaOElkJsTN_FkYhw01drfR-W4blgFc,146
 roborock/map/b01_grid_layers.py,sha256=b87MsGXslqLR_5H_4z4aj1wQqYgeTuULWqt4_txOF-M,12303
 roborock/map/b01_map_parser.py,sha256=y4Qlgiwre3bn5_UpL6R-ytjg8kQqwkbvhIYFOtpAM3s,14814
-roborock/map/b01_q10_map_parser.py,sha256=3DawtwPqyKhLUAW5Y4D6Ebm16l6RdWYiti0McELJCYQ,37066
+roborock/map/b01_q10_map_parser.py,sha256=O0y3uM7q3ve5_BFQzE1KxudpMxksuPLGR4AOJPc_GEI,32040
 roborock/map/b01_q10_overlays.py,sha256=JmriUbT4-oe6NiE94VttMplFc1HHQrAGNQIiZHj5QKk,6640
-roborock/map/b01_q10_render.py,sha256=PFAYqFxRANCH141drkHnB_0hNGsH5RR-jtkYIo7b46Y,13626
+roborock/map/b01_q10_render.py,sha256=XALrXIMi44Odi0IQKH_OJlU_hjGkls6riW-Wki346r8,17086
 roborock/map/dynamic_blocks.py,sha256=bz_M6qL2bK50URvyamtU50LHfHFqVUaEpCrcsun4_5I,9096
 roborock/map/map_parser.py,sha256=EcJcz9yld_wu7d5QrmxR2BTfJ801F6SaEgJkbIIap4w,5111
 roborock/map/room_colors.py,sha256=YvjuqsUPPAH5exJ16V72OTikDT-KEjgF7vd91l78Pjs,2627
@@ -130,9 +129,21 @@ roborock/testing/b01_q10_simulator.py,sha256=7k2poUIDI0akTw0rEcCpTUZq0gjr8z3kfTk
 roborock/testing/channel.py,sha256=vjulT5MHBe8lAq6XITUqcxJVcCILWx7ZEcw5imTx0Tk,7243
 roborock/testing/cloud.py,sha256=L2L0KlZDYaMuoV19KUQUoq5EAUDeNQ1lJ8Ew5YaOgjo,11946
 roborock/testing/simulator.py,sha256=g8ZUWVSjgAzuRRxWOCeOq-7deodyEItwUpqEw9RzCmQ,4347
-roborock/testing/v1_simulator.py,sha256=dDlaaCqKMrE-IotSqaENGf-mZYLDFVelozDJAXnet0s,18929
-python_roborock-7.15.1.dist-info/METADATA,sha256=imRBbVjrD6yR90t7kIAW6XpX_jg_3X8pQ87w9TVZXQg,5279
-python_roborock-7.15.1.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
-python_roborock-7.15.1.dist-info/entry_points.txt,sha256=EvC1nMqi9ZXKgZnqlNXA33v_3nzgPNjnM0mzWlrehnY,47
-python_roborock-7.15.1.dist-info/licenses/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
-python_roborock-7.15.1.dist-info/RECORD,,
+roborock/testing/v1_simulator.py,sha256=CbASO1D1vIo_aex7qpOa2R1ZvE5lEmPFKGOxNwVLjm4,20905
+roborock/web_api/__init__.py,sha256=e7x68amhcDG-z4qS-Et2DvqSxuD1OFa42VIb1lg16S8,1200
+roborock/web_api/_base.py,sha256=1nibOL4b29vWHsKhNQzg4ALxdWxt0yRTKFfRosTR6yI,6551
+roborock/web_api/_hawk.py,sha256=A-P0Zj3EH8gAcZNY1xImcE-kc4fkcJiSSrzkeVrVxqE,1649
+roborock/web_api/_request.py,sha256=enMTzaOhK5fs6toYK9qO6jY5oC4PoGh7CAEAiwhUOiU,1792
+roborock/web_api/auth.py,sha256=xks4IOwMkPndrfkiWoZ0_nik4qW6oKfP3XfL8YPOnrs,12920
+roborock/web_api/client.py,sha256=1VLwVQX3-K4dobtM69rQSNzQRwgOcFUu36OrnoS6HxY,3070
+roborock/web_api/devices.py,sha256=pRJjUJyILR0vFZom_tcaVecegnqh_WGzOLoYcYjJCK4,3205
+roborock/web_api/homes.py,sha256=m1L6SDVuyHohsQIucZ9ZFgHlHPR4uBW8YnA5mRX43T8,4008
+roborock/web_api/jobs.py,sha256=ksOBzBDVPpF8-dFADNeToHfo014dvS-5BDP6OUR25y4,2561
+roborock/web_api/ota.py,sha256=mktoCjCI0UeGrQWkTxbk1C-HD2aOGo6NWd1l8orL0r0,2220
+roborock/web_api/products.py,sha256=1rEuPKKnhVO1MA1lrfPTMKtBb62P_uXDbIF9edp8yE0,2085
+roborock/web_api/scenes.py,sha256=m1iuwEbJdNs5JePptEkyeK_CTuCUsXijb2QrFJYrg1c,1283
+python_roborock-7.15.3.dist-info/METADATA,sha256=YBsRJdQ_ipahZcDNFfK75XgW_SPHGmf_gt3F04GsZCA,5279
+python_roborock-7.15.3.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+python_roborock-7.15.3.dist-info/entry_points.txt,sha256=EvC1nMqi9ZXKgZnqlNXA33v_3nzgPNjnM0mzWlrehnY,47
+python_roborock-7.15.3.dist-info/licenses/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
+python_roborock-7.15.3.dist-info/RECORD,,

roborock/data/dyad/dyad_code_mappings.py

@@ -45,10 +45,14 @@ class DyadMode(RoborockEnum):
 
 
 class DyadCleanMode(RoborockEnum):
+    unknown = -1
     auto = 1
     max = 2
-    dehydration = 3
+    dehydration = 3  # The F25 Ultra reports its "Sponge" mode with this code.
     power_saving = 4
+    # Heated modes on the F25 Ultra, confirmed by switching modes on the device.
+    hot_water = 5
+    steam = 6
 
 
 class DyadSuction(RoborockEnum):

roborock/data/mower/mower_code_mappings.py

@@ -1,9 +1,12 @@
 """Code mappings for Roborock mower devices."""
 
+import logging
 from typing import Self, cast
 
 from roborock.data.code_mappings import RoborockModeEnum
 
+_LOGGER = logging.getLogger(__name__)
+
 __all__ = [
     "MowerAfsStatus",
     "MowerChargeState",
@@ -38,6 +41,7 @@ class MowerEnum(RoborockModeEnum):
         """Resolve a wire value by name, string value, or integer code."""
         if (member := cls.from_any_optional(code)) is not None:
             return member
+        _LOGGER.debug("Unknown %s code %r; defaulting to UNKNOWN", cls.__name__, code)
         return cast(Self, cls.UNKNOWN)  # type: ignore[attr-defined]
 
 

roborock/data/mower/mower_containers.py

@@ -48,6 +48,7 @@ class MowerStatus(RoborockBase):
     """Core mower status backed by mower DPS updates (data points 120-145)."""
 
     error_code: MowerErrorCode | None = field(default=None, metadata={"dps": RoborockMowerDataProtocol.ERROR_CODE})
+    """None means no error code was supplied; UNKNOWN means an unknown error."""
     battery: int | None = field(default=None, metadata={"dps": RoborockMowerDataProtocol.BATTERY})
     mow_type: MowerMowType | None = field(default=None, metadata={"dps": RoborockMowerDataProtocol.MOW_TYPE})
     mow_state: MowerDetailState | None = field(default=None, metadata={"dps": RoborockMowerDataProtocol.MOW_STATE})

roborock/map/b01_q10_map_parser.py

@@ -20,17 +20,11 @@ documentation that informed this clean-room implementation comes from the
 https://github.com/v1b3c0d3x3r/roborock-qseries-map-bridge
 """
 
-import io
 import math
 import statistics
 import struct
 from dataclasses import dataclass, field, replace
 
-from PIL import Image
-from vacuum_map_parser_base.config.color import ColorsPalette, SupportedColor
-from vacuum_map_parser_base.config.image_config import ImageConfig
-from vacuum_map_parser_base.map_data import ImageData, MapData, Point
-
 from roborock.data.b01_q10.b01_q10_containers import Q10RoborockPoint
 from roborock.data.code_mappings import RoborockEnum
 from roborock.data.containers import RoborockBase
@@ -44,10 +38,6 @@ from .b01_grid_layers import (
     GridLayers,
     decompose_grid,
 )
-from .map_parser import ParsedMapData
-from .room_colors import adjacency_aware_room_colors
-
-_MAP_FILE_FORMAT = "PNG"
 
 # Semantic raster classes, confirmed against real ss07 captures (rendered and
 # eyeballed): 243 is the background outside the home (~half the grid), 240 is
@@ -776,111 +766,3 @@ class B01Q10MapParserConfig:
 
     map_scale: int = 4
     """Scale factor for the rendered map image."""
-
-
-class B01Q10MapParser:
-    """Decoder/renderer for Q10 ``MAP_RESPONSE`` (protocol 301) payloads."""
-
-    def __init__(self, config: B01Q10MapParserConfig | None = None) -> None:
-        self._config = config or B01Q10MapParserConfig()
-
-    @property
-    def config(self) -> B01Q10MapParserConfig:
-        """The parser configuration (image scale, ...)."""
-        return self._config
-
-    def parse(self, payload: bytes) -> ParsedMapData:
-        """Parse a raw Q10 map packet into a rendered PNG + ``MapData``."""
-        return self.parsed_from_packet(parse_map_packet(payload))
-
-    def parse_packet(self, packet: Q10MapPacket) -> ParsedMapData:
-        """Render an already-decoded packet.
-
-        This preserves the public API used by the existing map trait. Callers
-        rendering a modified packet can use :meth:`parsed_from_packet` directly.
-        """
-        return self.parsed_from_packet(packet)
-
-    def map_data_from_packet(self, packet: Q10MapPacket) -> MapData:
-        """Build MapData with a rendered base image, without PNG serialization."""
-        image = self._render(packet)
-
-        map_data = MapData()
-        map_data.image = ImageData(
-            size=packet.width * packet.height,
-            top=0,
-            left=0,
-            height=packet.height,
-            width=packet.width,
-            image_config=ImageConfig(scale=self._config.map_scale),
-            data=image,
-            # ImageDimensions uses V1's bottom-up map convention before
-            # projecting into the top-down PNG. Q10 points are already
-            # top-down grid pixels, so this adapter cancels that standard flip
-            # and lets Q10 use the shared V1 ImageGenerator without moving
-            # overlays vertically.
-            img_transformation=lambda p: Point(p.x, packet.height - p.y - 1, p.a),
-        )
-        room_names = {room.id: room.name for room in packet.rooms}
-        if room_names:
-            map_data.additional_parameters["room_names"] = room_names
-
-        # Carpet cells are flat grid indices (y*width + x) in the same top-down
-        # pixel space as the rendered raster, so they line up with the image.
-        if packet.carpet_mask is not None:
-            map_data.carpet_map = {i for i, value in enumerate(packet.carpet_mask) if value}
-
-        return map_data
-
-    def parsed_from_packet(self, packet: Q10MapPacket) -> ParsedMapData:
-        """Render a (possibly erase-modified) packet into a PNG + ``MapData``."""
-        map_data = self.map_data_from_packet(packet)
-        image_bytes = io.BytesIO()
-        if map_data.image is not None:
-            map_data.image.data.save(image_bytes, format=_MAP_FILE_FORMAT)
-        return ParsedMapData(image_content=image_bytes.getvalue(), map_data=map_data)
-
-    def _render(self, packet: Q10MapPacket) -> Image.Image:
-        """Render the Q10 grid with the V1 map palette."""
-        palette = _build_palette(packet.grid, packet.width)
-        flat_palette = [channel for color in palette for channel in color]
-        p_img = Image.frombytes("P", (packet.width, packet.height), packet.grid)
-        p_img.putpalette(flat_palette, rawmode="RGBA")
-        img = p_img.convert("RGBA")
-        # The ss07 grid is stored top-down (row 0 = top of the home), so it is
-        # rendered as-is -- unlike the V1/Q7 convention, no vertical flip.
-        scale = self._config.map_scale
-        if scale > 1:
-            img = img.resize((packet.width * scale, packet.height * scale), resample=Image.Resampling.NEAREST)
-        return img
-
-
-def _opaque(color: tuple[int, ...]) -> tuple[int, int, int, int]:
-    """Return a palette color as RGBA."""
-    return (color[0], color[1], color[2], color[3] if len(color) == 4 else 255)
-
-
-def _build_palette(grid: bytes, width: int) -> list[tuple[int, int, int, int]]:
-    """Map Q10 cells onto the same colors used by the V1 map renderer."""
-
-    def room_id(value: int) -> int | None:
-        return max(1, value // 4) if 0 < value < _WALL_THRESHOLD else None
-
-    colors = ColorsPalette()
-    room_colors = adjacency_aware_room_colors(
-        grid,
-        width,
-        colors,
-        room_id,
-    )
-    outside = (0, 0, 0, 0)
-    palette = [outside] * 256
-    for value in {value for value in grid if 0 < value < _WALL_THRESHOLD}:
-        palette[value] = _opaque(room_colors[max(1, value // 4)])
-    wall = _opaque(colors.get_color(SupportedColor.GREY_WALL))
-    for value in range(_WALL_THRESHOLD, 256):
-        palette[value] = wall
-    palette[_UNSEGMENTED_FLOOR_VALUE] = _opaque(colors.get_color(SupportedColor.MAP_INSIDE))
-    palette[_BACKGROUND_VALUE] = outside
-    palette[0] = outside
-    return palette

roborock/map/b01_q10_render.py

@@ -1,7 +1,7 @@
 """Compose a Q10 (B01/ss07) map into a single rendered result.
 
-The :class:`~roborock.map.b01_q10_map_parser.B01Q10MapParser` turns wire bytes
-into a :class:`~roborock.map.b01_q10_map_parser.Q10MapPacket`; this module
+The :func:`~roborock.map.b01_q10_map_parser.parse_map_packet` function turns wire
+bytes into a :class:`~roborock.map.b01_q10_map_parser.Q10MapPacket`; this module
 combines that map-protocol packet with the latest trace-protocol packet and DPS
 overlay snapshot. Calibration, path and position are derived from those source
 objects rather than managed independently by callers.
@@ -18,9 +18,12 @@ import math
 from collections.abc import Sequence
 from dataclasses import dataclass
 
+from PIL import Image
+from vacuum_map_parser_base.config.color import ColorsPalette, SupportedColor
 from vacuum_map_parser_base.config.drawable import Drawable
+from vacuum_map_parser_base.config.image_config import ImageConfig
 from vacuum_map_parser_base.config.size import Size, Sizes
-from vacuum_map_parser_base.map_data import Area, MapData, Path, Point, Wall
+from vacuum_map_parser_base.map_data import Area, ImageData, MapData, Path, Point, Wall
 
 from roborock.exceptions import RoborockException
 
@@ -31,7 +34,9 @@ from .b01_grid_layers import (
     solve_calibration_with_origin,
 )
 from .b01_q10_map_parser import (
-    B01Q10MapParser,
+    _BACKGROUND_VALUE,
+    _UNSEGMENTED_FLOOR_VALUE,
+    _WALL_THRESHOLD,
     B01Q10MapParserConfig,
     Q10EraseZone,
     Q10HistoricalTracePacket,
@@ -41,6 +46,7 @@ from .b01_q10_map_parser import (
 )
 from .b01_q10_overlays import ZONE_TYPE_NO_GO, ZONE_TYPE_NO_MOP, Q10Zone
 from .map_parser import DEFAULT_DRAWABLES, MapParserConfig, _create_image_generator
+from .room_colors import adjacency_aware_room_colors
 
 # Path-units-per-pixel candidates for calibration. A dense ss07 path lands a
 # best fit of 20.0 around the header origin -- ground-truthed June 2026 on the
@@ -97,7 +103,6 @@ def render_q10_map(
     available trace and DPS overlays are projected and drawn in pixel space.
     Raises :class:`RoborockException` if map rendering fails.
     """
-    parser = B01Q10MapParser(config)
     trace_calibration = solve_q10_calibration(packet, trace)
     vector_calibration = _vector_calibration(packet, trace_calibration)
 
@@ -109,7 +114,7 @@ def render_q10_map(
             # areas disappear (as the app shows).
             render_packet = erased_packet(packet, cells)
 
-    map_data = parser.map_data_from_packet(render_packet)
+    map_data = _map_data_from_packet(render_packet, config=config)
     if map_data.image is None:
         raise RoborockException("Failed to render Q10 map image")
 
@@ -335,3 +340,84 @@ def _draw_map_content(
     buffer = io.BytesIO()
     map_data.image.data.save(buffer, format="PNG")
     return buffer.getvalue()
+
+
+def _map_data_from_packet(
+    packet: Q10MapPacket,
+    *,
+    config: B01Q10MapParserConfig,
+) -> MapData:
+    """Build MapData with a rendered base image, without PNG serialization."""
+    image = _render_base_grid(packet, scale=config.map_scale)
+
+    map_data = MapData()
+    map_data.image = ImageData(
+        size=packet.width * packet.height,
+        top=0,
+        left=0,
+        height=packet.height,
+        width=packet.width,
+        image_config=ImageConfig(scale=config.map_scale),
+        data=image,
+        # ImageDimensions uses V1's bottom-up map convention before
+        # projecting into the top-down PNG. Q10 points are already
+        # top-down grid pixels, so this adapter cancels that standard flip
+        # and lets Q10 use the shared V1 ImageGenerator without moving
+        # overlays vertically.
+        img_transformation=lambda p: Point(p.x, packet.height - p.y - 1, p.a),
+    )
+    room_names = {room.id: room.name for room in packet.rooms}
+    if room_names:
+        map_data.additional_parameters["room_names"] = room_names
+
+    # Carpet cells are flat grid indices (y*width + x) in the same top-down
+    # pixel space as the rendered raster, so they line up with the image.
+    if packet.carpet_mask is not None:
+        map_data.carpet_map = {i for i, value in enumerate(packet.carpet_mask) if value}
+
+    return map_data
+
+
+def _render_base_grid(packet: Q10MapPacket, *, scale: int) -> Image.Image:
+    """Render the Q10 grid with the V1 map palette."""
+    palette = _build_palette(packet.grid, packet.width)
+    flat_palette = [channel for color in palette for channel in color]
+    p_img = Image.frombytes("P", (packet.width, packet.height), packet.grid)
+    p_img.putpalette(flat_palette, rawmode="RGBA")
+    img = p_img.convert("RGBA")
+    # The ss07 grid is stored top-down (row 0 = top of the home), so it is
+    # rendered as-is -- unlike the V1/Q7 convention, no vertical flip.
+    if scale > 1:
+        img = img.resize((packet.width * scale, packet.height * scale), resample=Image.Resampling.NEAREST)
+    return img
+
+
+def _opaque(color: tuple[int, ...]) -> tuple[int, int, int, int]:
+    """Return a palette color as RGBA."""
+    return (color[0], color[1], color[2], color[3] if len(color) == 4 else 255)
+
+
+def _build_palette(grid: bytes, width: int) -> list[tuple[int, int, int, int]]:
+    """Map Q10 cells onto the same colors used by the V1 map renderer."""
+
+    def room_id(value: int) -> int | None:
+        return max(1, value // 4) if 0 < value < _WALL_THRESHOLD else None
+
+    colors = ColorsPalette()
+    room_colors = adjacency_aware_room_colors(
+        grid,
+        width,
+        colors,
+        room_id,
+    )
+    outside = (0, 0, 0, 0)
+    palette = [outside] * 256
+    for value in {value for value in grid if 0 < value < _WALL_THRESHOLD}:
+        palette[value] = _opaque(room_colors[max(1, value // 4)])
+    wall = _opaque(colors.get_color(SupportedColor.GREY_WALL))
+    for value in range(_WALL_THRESHOLD, 256):
+        palette[value] = wall
+    palette[_UNSEGMENTED_FLOOR_VALUE] = _opaque(colors.get_color(SupportedColor.MAP_INSIDE))
+    palette[_BACKGROUND_VALUE] = outside
+    palette[0] = outside
+    return palette

roborock/testing/v1_simulator.py

@@ -10,7 +10,7 @@ import json
 import logging
 import struct
 import time
-from collections.abc import Callable
+from collections.abc import Callable, Sequence
 from dataclasses import asdict, replace
 from enum import Enum
 from typing import Any
@@ -45,6 +45,7 @@ from roborock.protocols.v1_protocol import SecurityData
 from roborock.roborock_message import RoborockDataProtocol, RoborockMessage, RoborockMessageProtocol
 from roborock.testing.channel import FakeChannel
 from roborock.testing.simulator import RoborockDeviceSimulator
+from roborock.util import get_next_int
 
 _LOGGER = logging.getLogger(__name__)
 
@@ -255,8 +256,12 @@ class V1VacuumSimulator(RoborockDeviceSimulator):
 
         # The simulated robot's own view of its map. Tests extend the path
         # with advance_path() and move the robot via robot_position.
+        # Set map_parts > 1 (and optionally map_part_order) to split map
+        # responses across MAP_RESPONSE_PART (300) and MAP_RESPONSE (301) frames.
         self.path_length = 0
         self.robot_position = (25000, 24000, 90)
+        self.map_parts = 1
+        self.map_part_order: Sequence[int] | None = None
 
         self.device_cache = DeviceCache(self.duid, InMemoryCache())
         # The endpoint must fit the eight byte map response header field and the
@@ -416,11 +421,44 @@ class V1VacuumSimulator(RoborockDeviceSimulator):
         data = header + body + digest_header
         return data + hashlib.sha1(data, usedforsecurity=False).digest()
 
-    def _map_response_message(self, request_id: int, map_bytes: bytes) -> RoborockMessage:
-        """Frame the map as the encrypted binary response the device sends."""
+    def _map_response_messages(self, request_id: int, map_bytes: bytes) -> list[RoborockMessage]:
+        """Frame the map as one or more encrypted binary messages as the device sends."""
+        if self.map_parts < 1:
+            raise ValueError("map_parts must be at least 1")
         body = Utils.encrypt_cbc(gzip.compress(map_bytes), self.security_data.nonce)
         header = struct.pack("<8s8sH6s", self.security_data.endpoint.encode(), bytes(8), request_id & 0xFFFF, bytes(6))
-        return RoborockMessage(protocol=RoborockMessageProtocol.MAP_RESPONSE, payload=header + body)
+        if self.map_parts == 1:
+            if self.map_part_order is not None and list(self.map_part_order) != [0]:
+                raise ValueError("map_part_order must be a permutation of range(map_parts)")
+            return [RoborockMessage(protocol=RoborockMessageProtocol.MAP_RESPONSE, payload=header + body)]
+        if self.map_parts > len(body):
+            raise ValueError("map_parts cannot exceed encrypted map body length")
+
+        # Keep the 24-byte header intact on the first part and split the encrypted
+        # body evenly into map_parts non-empty contiguous slices.
+        total = len(body)
+        boundaries = [(i * total) // self.map_parts for i in range(self.map_parts + 1)]
+        chunks = [body[boundaries[i] : boundaries[i + 1]] for i in range(self.map_parts)]
+        chunks[0] = header + chunks[0]
+        random_id = get_next_int(10000, 99999)
+        timestamp = int(time.time())
+        messages = [
+            RoborockMessage(
+                protocol=RoborockMessageProtocol.MAP_RESPONSE
+                if idx == len(chunks) - 1
+                else RoborockMessageProtocol.MAP_RESPONSE_PART,
+                payload=chunk,
+                seq=idx + 1,
+                random=random_id,
+                timestamp=timestamp,
+            )
+            for idx, chunk in enumerate(chunks)
+        ]
+        if self.map_part_order is not None:
+            if sorted(self.map_part_order) != list(range(self.map_parts)):
+                raise ValueError("map_part_order must be a permutation of range(map_parts)")
+            messages = [messages[i] for i in self.map_part_order]
+        return messages
 
     async def _handle_publish(self, message: RoborockMessage, channel: FakeChannel) -> None:
         if not message.payload:
@@ -455,7 +493,8 @@ class V1VacuumSimulator(RoborockDeviceSimulator):
 
         if method == "get_map_v1" and error is None and isinstance(result, bytes):
             # Custom handlers return decompressed map bytes, just like the default.
-            channel.notify_subscribers(self._map_response_message(msg_id, result))
+            for map_msg in self._map_response_messages(msg_id, result):
+                channel.notify_subscribers(map_msg)
             return
 
         response_data = {

roborock/web_api/__init__.py

@@ -0,0 +1,37 @@
+"""Roborock cloud REST API clients.
+
+The public entry points are :class:`RoborockApiClient` and :class:`UserWebApiClient`.
+Endpoints are grouped by resource into submodules (``auth``, ``homes``, ``devices``,
+``scenes``, ``jobs``, ``ota``, ``products``); each exposes a mixin that
+``RoborockApiClient`` composes. Everything that was importable from the former
+``roborock.web_api`` module is re-exported here for backwards compatibility.
+"""
+
+from ._base import BASE_URLS, IotLoginInfo, RoborockApiBase
+from ._request import PreparedRequest
+from .auth import DEFAULT_AGREEMENT_MAJOR_VERSION, DEFAULT_AGREEMENT_MINOR_VERSION, AuthApi
+from .client import RoborockApiClient, UserWebApiClient
+from .devices import DevicesApi
+from .homes import HomesApi
+from .jobs import JobsApi
+from .ota import OtaApi
+from .products import ProductsApi
+from .scenes import ScenesApi
+
+__all__ = [
+    "BASE_URLS",
+    "DEFAULT_AGREEMENT_MAJOR_VERSION",
+    "DEFAULT_AGREEMENT_MINOR_VERSION",
+    "AuthApi",
+    "DevicesApi",
+    "HomesApi",
+    "IotLoginInfo",
+    "JobsApi",
+    "OtaApi",
+    "PreparedRequest",
+    "ProductsApi",
+    "RoborockApiBase",
+    "RoborockApiClient",
+    "ScenesApi",
+    "UserWebApiClient",
+]