python-roborock 7.7.0__tar.gz → 7.8.0__tar.gz

{python_roborock-7.7.0 → python_roborock-7.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: python-roborock
-Version: 7.7.0
+Version: 7.8.0
 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.7.0 → python_roborock-7.8.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "python-roborock"
-version = "7.7.0"
+version = "7.8.0"
 description = "A package to control Roborock vacuums."
 authors = [{ name = "humbertogontijo", email = "humbertogontijo@users.noreply.github.com" }, {name="Lash-L"}, {name="allenporter"}]
 requires-python = ">=3.11, <4"

{python_roborock-7.7.0 → python_roborock-7.8.0}/roborock/data/b01_q10/b01_q10_code_mappings.py

@@ -101,13 +101,8 @@ class B01_Q10_DP(RoborockModeEnum):
     VOICE_VERSION = ("dpVoiceVersion", 108)
     ROBOT_COUNTRY_CODE = ("dpRobotCountryCode", 109)
     HEARTBEAT = ("dpHeartbeat", 110)
-    # NOTE: ss07 hardware also pushes data points 112 and 113 in its full status
-    # dump. They are absent from the official app's vacuum plugin and stayed 0
-    # across every observed state (docked/charging, segment cleaning, lifted-off-
-    # ground fault, returning to dock, dustbin removed), so their meaning is not
-    # yet known. They are intentionally left unmapped; ``decode_rpc_response``
-    # silently ignores unknown codes via ``from_code_optional``, so they do not
-    # produce "not a valid code" warnings. Map them here once identified.
+    UNKNOWN_112 = ("dpUnknown112", 112)
+    UNKNOWN_113 = ("dpUnknown113", 113)
     STATUS = ("dpStatus", 121)
     BATTERY = ("dpBattery", 122)
     FAN_LEVEL = ("dpFanLevel", 123)  # NOTE: typo "dpfunLevel" in source code

{python_roborock-7.7.0 → python_roborock-7.8.0}/roborock/data/b01_q7/b01_q7_code_mappings.py

@@ -1,6 +1,6 @@
 from typing import Self, cast
 
-from ..code_mappings import RoborockModeEnum
+from ..code_mappings import RoborockEnum, RoborockModeEnum
 
 
 class WorkStatusMapping(RoborockModeEnum):
@@ -121,6 +121,22 @@ class WorkModeMapping(RoborockModeEnum):
     EXPLORE_IDLE = ("explore_idle", 49)
 
 
+class StationStateMapping(RoborockEnum):
+    """Known dock activity states observed on the Q7 M5+."""
+
+    unknown = -1
+    idle = 0
+    collecting_dust = 3
+
+
+class DustCollectionStateMapping(RoborockEnum):
+    """Known dust collection states observed on the Q7 M5+."""
+
+    unknown = -1
+    idle = 0
+    collecting_dust = 1
+
+
 class StationActionMapping(RoborockModeEnum):
     """Maps actions for the cleaning/drying station."""
 

{python_roborock-7.7.0 → python_roborock-7.8.0}/roborock/data/b01_q7/b01_q7_containers.py

@@ -10,7 +10,9 @@ from .b01_q7_code_mappings import (
     CleanPathPreferenceMapping,
     CleanRepeatMapping,
     CleanTypeMapping,
+    DustCollectionStateMapping,
     SCWindMapping,
+    StationStateMapping,
     WaterLevelMapping,
     WorkModeMapping,
     WorkStatusMapping,
@@ -137,11 +139,11 @@ class B01Props(RoborockBase):
     custom_type: int | None = None
     sound: int | None = None
     work_mode: WorkModeMapping | None = None
-    station_act: int | None = None  # dock activity; 3 while collecting dust, 0 idle. hw-confirmed (Q7 M5+)
+    station_act: StationStateMapping | None = None
     charge_state: int | None = None
     current_map_id: int | None = None
     map_num: int | None = None
-    dust_action: int | None = None  # 1 while the dock is collecting dust; read-only (prop.set rejected, code 1)
+    dust_action: DustCollectionStateMapping | None = None  # Read-only; prop.set is rejected with code 1 on the Q7 M5+.
     quiet_is_open: int | None = None
     quiet_begin_time: int | None = None
     quiet_end_time: int | None = None