feat: typed commands, settings & status for Zeo devices

roborock/data/zeo/zeo_containers.py

@@ -1,6 +1,6 @@
 """Data containers for Zeo (washing machine / dryer) devices."""
 
-from dataclasses import dataclass
+from dataclasses import dataclass, field
 
 from ..containers import RoborockBase
 from .zeo_code_mappings import (
@@ -17,27 +17,91 @@
 )
 
 
+@dataclass
+class ZeoWashRecord(RoborockBase):
+    """A single entry in the device's wash-history log (DP 10008)."""
+
+    ctrl_type: int = 0
+    """Control type of the programme (2 = app, 1 = panel)."""
+
+    prog_type: ZeoProgram | None = None
+
+    category: ZeoMode | None = None
+
+    end_type: int = 0
+    """End type (1 = completed, 2 = cancelled/failed)."""
+
+    duration: int = 0
+    """Programme duration in minutes (0 for entries that never ran)."""
+
+    t: int = 0
+    """Start timestamp (Unix seconds)."""
+
+    end_t: int = 0
+    """End timestamp (Unix seconds)."""
+
+
+@dataclass
+class ZeoWashLog(RoborockBase):
+    """Wash-history log reported at DP 10008 (JSON string)."""
+
+    cnt: int = 0
+    """Total number of log entries."""
+
+    wash_cnt: int = 0
+    """Total wash count."""
+
+    dry_cnt: int = 0
+    """Total dry count."""
+
+    wash_dry_cnt: int = 0
+    """Total wash-and-dry count."""
+
+    washes: list[ZeoWashRecord] = field(default_factory=list)
+    """The individual wash records (oldest → newest)."""
+
+
 @dataclass
 class ZeoStartParams(RoborockBase):
-    """Parameters that must be bundled with a START command.
+    """All parameters that may be bundled with a START command.
 
-    All Zeo devices require ``mode`` and ``program`` to be sent together
-    with the start signal. The remaining fields are optional and only
-    included when the device reports a non-None value.
+    ``mode`` and ``program`` are mandatory for every device.  Every other
+    field is optional — when ``None`` it is simply omitted from the MQTT
+    payload, so the same superset works for washers and dryers alike.
     """
 
     mode: ZeoMode
     program: ZeoProgram
+
+    # Washer
     temperature: ZeoTemperature | None = None
     rinse: ZeoRinse | None = None
     spin: ZeoSpin | None = None
     drying_mode: ZeoDryingMode | None = None
 
+    # Dryer
+    drying_method: ZeoDryingMethod | None = None
+    steam_volume: ZeoSteamVolume | None = None
+    # Timed-program running duration in minutes (DP 234).
+    # This is a fixed parameter of the programme config.
+    # TODO(program-config): once a programme table exists, this should be
+    # auto-populated from the programme config instead of passed by the caller.
+    total_time: int | None = None  # depends on programme configs
+
+    # Optional across both device families
+    soak: ZeoSoak | None = None
+    dry_and_care: ZeoDryAndCare | None = None
+
+    # Feature-gated start options (DP 258 / DP 255). In the Bundle these are
+    # the programme's config ``defaultIonStatus`` and the UI's
+    # ``wash_dry_linked`` state
+    ion_deodorization: bool | None = None
+    wash_dry_linked: bool | None = None
+
 
 # ── DP 222 (LoadCloudProgram) bitfield decoder ──────────────────────────
-# The official app packs all custom-program parameters into a single
-# 32-bit integer at DP 222.  This mirrors WasherDpsCache.customMode in
-# module 725 of the React Native plugin bundle.
+# All custom-program parameters are packed into a single
+# 32-bit integer at DP 222.
 
 
 @dataclass
@@ -101,8 +165,7 @@ class ZeoDryerCustomMode(RoborockBase):
     """Decoded custom programme from DP 222 for a standalone dryer.
 
     Dryers pack a different (shorter) bitfield than washers — only 5
-    fields after program/mode.  Mirrors ``WasherDpsCache.dryerCustomMode``
-    in module 725 of the plugin bundle.
+    fields after program/mode.
     """
 
     program: ZeoProgram