feat: add support for Roborock Qrevo Curv 2 Flow (a245)

Author: Coldaine

.pre-commit-config.yaml

@@ -1,10 +1,6 @@
 # See https://pre-commit.com for more information
 # See https://pre-commit.com/hooks.html for more hooks
-exclude: >
-    (?x)^(
-        CHANGELOG\.md|
-        roborock/map/proto/.*_pb2\.py
-    )$
+exclude: "CHANGELOG.md"
 default_stages: [ pre-commit ]
 
 repos:
@@ -46,7 +42,7 @@ repos:
         hooks:
             -   id: mypy
                 exclude: cli.py
-                additional_dependencies: [ "types-paho-mqtt", "types-protobuf" ]
+                additional_dependencies: [ "types-paho-mqtt" ]
     -   repo: https://github.com/alessandrojcm/commitlint-pre-commit-hook
         rev: v9.23.0
         hooks:

CHANGELOG.md

@@ -8,11 +8,7 @@ export default {
         // Disable the rule that enforces lowercase in subject
         "subject-case": [0], // 0 = disable, 1 = warn, 2 = error
         // Disable the rule that enforces a maximum line length in the body
-        "body-max-line-length": [0, "always"],
-        // Disable header max length for AI-generated commits
-        "header-max-length": [0],
-        // Disable the rule that prevents periods at the end of subjects
-        "header-full-stop": [0]
+        "body-max-line-length": [0, "always"]
     },
 
 };

SUPPORTED_FEATURES.md

@@ -239,6 +239,149 @@ roborock.vacuum.a15:
       code: offline_status
       mode: ro
       type: RAW
+roborock.vacuum.a245:
+  protocol_version: '1.0'
+  product_nickname: VIVIANS
+  new_feature_info: 4499197267967999
+  new_feature_info_str: 00000000000200058CC57FFDA86836DD5BBFAF7F7EFEFFFF
+  feature_info:
+  - 111
+  - 112
+  - 113
+  - 114
+  - 115
+  - 116
+  - 117
+  - 118
+  - 119
+  - 120
+  - 121
+  - 122
+  - 123
+  - 124
+  - 125
+  product:
+    id: 64Pgg7cwjxHqT2qQrEh7Ib
+    name: Qrevo Curv 2 Flow
+    model: roborock.vacuum.a245
+    category: robot.vacuum.cleaner
+    capability: 0
+    schema:
+    - id: 101
+      name: rpc_request
+      code: rpc_request
+      mode: rw
+      type: RAW
+    - id: 102
+      name: rpc_response
+      code: rpc_response
+      mode: rw
+      type: RAW
+    - id: 120
+      name: "\u9519\u8BEF\u4EE3\u7801"
+      code: error_code
+      mode: ro
+      type: ENUM
+      property: '{"range": [""]}'
+    - id: 121
+      name: "\u8BBE\u5907\u72B6\u6001"
+      code: state
+      mode: ro
+      type: ENUM
+      property: '{"range": [""]}'
+    - id: 122
+      name: "\u8BBE\u5907\u7535\u91CF"
+      code: battery
+      mode: ro
+      type: ENUM
+      property: '{"range": [""]}'
+    - id: 123
+      name: "\u6E05\u626B\u6A21\u5F0F"
+      code: fan_power
+      mode: rw
+      type: ENUM
+      property: '{"range": [""]}'
+    - id: 124
+      name: "\u62D6\u5730\u6A21\u5F0F"
+      code: water_box_mode
+      mode: rw
+      type: ENUM
+      property: '{"range": [""]}'
+    - id: 125
+      name: "\u4E3B\u5237\u5BFF\u547D"
+      code: main_brush_life
+      mode: rw
+      type: VALUE
+      property: '{"max": 100, "min": 0, "step": 1, "unit": "null", "scale": 1}'
+    - id: 126
+      name: "\u8FB9\u5237\u5BFF\u547D"
+      code: side_brush_life
+      mode: rw
+      type: VALUE
+      property: '{"max": 100, "min": 0, "step": 1, "unit": "null", "scale": 1}'
+    - id: 127
+      name: "\u6EE4\u7F51\u5BFF\u547D"
+      code: filter_life
+      mode: rw
+      type: VALUE
+      property: '{"max": 100, "min": 0, "step": 1, "unit": "null", "scale": 1}'
+    - id: 128
+      name: "\u989D\u5916\u72B6\u6001"
+      code: additional_props
+      mode: ro
+      type: RAW
+    - id: 130
+      name: "\u5B8C\u6210\u4E8B\u4EF6"
+      code: task_complete
+      mode: ro
+      type: RAW
+    - id: 131
+      name: "\u7535\u91CF\u4E0D\u8DB3\u4EFB\u52A1\u53D6\u6D88"
+      code: task_cancel_low_power
+      mode: ro
+      type: RAW
+    - id: 132
+      name: "\u8FD0\u52A8\u4E2D\u4EFB\u52A1\u53D6\u6D88"
+      code: task_cancel_in_motion
+      mode: ro
+      type: RAW
+    - id: 133
+      name: "\u5145\u7535\u72B6\u6001"
+      code: charge_status
+      mode: ro
+      type: RAW
+    - id: 134
+      name: "\u70D8\u5E72\u72B6\u6001"
+      code: drying_status
+      mode: ro
+      type: RAW
+    - id: 135
+      name: "\u79BB\u7EBF\u539F\u56E0\u7EC6\u5206"
+      code: offline_status
+      mode: ro
+      type: RAW
+    - id: 138
+      name: "\u5DE5\u4F5C\u4EFB\u52A1\u7C7B\u578B"
+      code: clean_task_type
+      mode: ro
+      type: ENUM
+      property: '{"range": ["0", "1", "2", "3", "4", "5", "6", "7", "8", "9"]}'
+    - id: 139
+      name: "\u56DE\u57FA\u7AD9\u76EE\u7684"
+      code: back_type
+      mode: ro
+      type: RAW
+    - id: 141
+      name: "\u6E05\u6D01\u8FDB\u5EA6"
+      code: cleaning_progress
+      mode: ro
+      type: VALUE
+      property: '{"max": 100, "min": 0, "step": 1, "scale": 1}'
+    - id: 142
+      name: publish_dsp
+      code: publish_dsp
+      mode: ro
+      type: RAW
 roborock.vacuum.a87:
   protocol_version: '1.0'
   product_nickname: PEARLPLUS

commitlint.config.mjs

@@ -2,7 +2,7 @@
 
 This page is still under construction. All of the following are the commands we have reverse engineered. It is not an exhaustive list of all the possible commands.
 
-Commands do not immediately make it to this page. You can find more commands [here](https://github.com/Python-roborock/python-roborock/blob/main/roborock/roborock_typing.py#L18)
+Commands do not immediately make it to this page. You can find more commands [here](https://github.com/humbertogontijo/python-roborock/blob/main/roborock/roborock_typing.py#L18)
 
 Commands can have multiple parameters that can change from one model to another.
 

device_info.yaml

@@ -1,6 +1,6 @@
 [project]
 name = "python-roborock"
-version = "5.4.1"
+version = "4.17.2"
 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"
@@ -25,15 +25,14 @@ dependencies = [
     "pycryptodomex~=3.18 ; sys_platform == 'darwin'",
     "paho-mqtt>=1.6.1,<3.0.0",
     "construct>=2.10.57,<3",
-    "protobuf>=6.31.1,<7",
     "vacuum-map-parser-roborock",
     "pyrate-limiter>=4.0.0,<5",
     "aiomqtt>=2.5.0,<3",
     "click-shell~=2.1",
 ]
 
 [project.urls]
-Repository = "https://github.com/python-roborock/python-roborock"
+Repository = "https://github.com/humbertogontijo/python-roborock"
 Documentation = "https://python-roborock.readthedocs.io/"
 
 [project.scripts]
@@ -98,15 +97,9 @@ major_tags= ["refactor"]
 lint.ignore = ["F403", "E741"]
 lint.select=["E", "F", "UP", "I"]
 line-length = 120
-extend-exclude = ["roborock/map/proto/*_pb2.py"]
 
 [tool.ruff.lint.per-file-ignores]
 "*/__init__.py" = ["F401"]
-"roborock/map/proto/*_pb2.py" = ["E501", "I001", "UP009"]
-
-[[tool.mypy.overrides]]
-module = ["roborock.map.proto.*"]
-ignore_errors = true
 
 [tool.pytest.ini_options]
 asyncio_mode = "auto"

docs/V1_API_COMMANDS.md

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import asyncio
 import hashlib
 import json

pyproject.toml

@@ -44,7 +44,7 @@
 from roborock import RoborockCommand
 from roborock.data import RoborockBase, UserData
 from roborock.data.b01_q10.b01_q10_code_mappings import B01_Q10_DP, YXCleanType, YXFanLevel
-from roborock.data.code_mappings import SHORT_MODEL_TO_ENUM
+from roborock.data.code_mappings import SHORT_MODEL_TO_ENUM, RoborockProductNickname
 from roborock.device_features import DeviceFeatures
 from roborock.devices.cache import Cache, CacheData
 from roborock.devices.device import RoborockDevice
@@ -764,6 +764,21 @@ async def network_info(ctx, device_id: str):
     await _display_v1_trait(context, device_id, lambda v1: v1.network_info)
 
 
+def _parse_b01_q10_command(cmd: str) -> B01_Q10_DP:
+    """Parse B01_Q10 command from either enum name or value."""
+    try:
+        return B01_Q10_DP(int(cmd))
+    except ValueError:
+        try:
+            return B01_Q10_DP.from_name(cmd)
+        except ValueError:
+            try:
+                return B01_Q10_DP.from_value(cmd)
+            except ValueError:
+                pass
+    raise RoborockException(f"Invalid command {cmd} for B01_Q10 device")
+
+
 @click.command()
 @click.option("--device_id", required=True)
 @click.option("--cmd", required=True)
@@ -780,8 +795,7 @@ async def command(ctx, cmd, device_id, params):
         if result:
             click.echo(dump_json(result))
     elif device.b01_q10_properties is not None:
-        if cmd_value := B01_Q10_DP.from_any_optional(cmd) is None:
-            raise RoborockException(f"Invalid command {cmd} for B01_Q10 device")
+        cmd_value = _parse_b01_q10_command(cmd)
         command_trait: Trait = device.b01_q10_properties.command
         await command_trait.send(cmd_value, json.loads(params) if params is not None else None)
         click.echo("Command sent successfully; Enable debug logging (-d) to see responses.")
@@ -1066,11 +1080,13 @@ def update_docs(data_file: str, output_file: str):
     # Process the raw data from YAML to build the feature map
     for model, data in product_data_from_yaml.items():
         # Reconstruct the DeviceFeatures object from the raw data in the YAML file
+        product_nickname_str = data.get("product_nickname")
+        product_nickname = RoborockProductNickname[product_nickname_str] if product_nickname_str else None
         device_features = DeviceFeatures.from_feature_flags(
             new_feature_info=data.get("new_feature_info"),
             new_feature_info_str=data.get("new_feature_info_str"),
             feature_info=data.get("feature_info"),
-            product_nickname=data.get("product_nickname"),
+            product_nickname=product_nickname,
         )
         features_dict = asdict(device_features)
 
@@ -1080,11 +1096,15 @@ def update_docs(data_file: str, output_file: str):
             "protocol_version": data.get("protocol_version", ""),
             "new_feature_info": data.get("new_feature_info", ""),
             "new_feature_info_str": data.get("new_feature_info_str", ""),
+            "feature_info": data.get("feature_info", ""),
         }
 
         # Populate features from the calculated DeviceFeatures object
         for feature, is_supported in features_dict.items():
             all_feature_names.add(feature)
+            if feature in current_product_data:
+                # Skip populating the metadata keys as booleans, as they are already set.
+                continue
             if is_supported:
                 current_product_data[feature] = "X"
 
@@ -1106,6 +1126,7 @@ def write_markdown_table(product_features: dict[str, dict[str, any]], all_featur
             "protocol_version",
             "new_feature_info",
             "new_feature_info_str",
+            "feature_info",
         ]
         # Regular features are the remaining keys, sorted alphabetically
         # We filter out the special rows to avoid duplicating them.
@@ -1275,12 +1296,7 @@ async def q10_empty_dustbin(ctx: click.Context, device_id: str) -> None:
 
 @session.command()
 @click.option("--device_id", required=True, help="Device ID")
-@click.option(
-    "--mode",
-    required=True,
-    type=click.Choice(["vac_and_mop", "vacuum", "mop"], case_sensitive=False),
-    help='Clean mode (preferred: "vac_and_mop", "vacuum", "mop")',
-)
+@click.option("--mode", required=True, type=click.Choice(["bothwork", "onlysweep", "onlymop"]), help="Clean mode")
 @click.pass_context
 @async_command
 async def q10_set_clean_mode(ctx: click.Context, device_id: str, mode: str) -> None:

roborock/broadcast_protocol.py

@@ -53,6 +53,17 @@
 ROBOROCK_QREVO_MAXV = "roborock.vacuum.a87"
 ROBOROCK_SAROS_10R = "roborock.vacuum.a144"
 ROBOROCK_SAROS_10 = "roborock.vacuum.a147"
+ROBOROCK_QREVO_CURV_2_FLOW = "roborock.vacuum.a245"  # Qrevo Curv 2 Flow (CES 2026) — confirmed via live device probe
+
+# Vivian series — a155/a156 unconfirmed CN/global Vivian variants.
+# NOTE: a245 (Qrevo Curv 2 Flow) was confirmed separately; it is NOT one of these.
+ROBOROCK_QREVO_CURV_A155 = "roborock.vacuum.a155"  # Unconfirmed Vivian variant (CN)
+ROBOROCK_QREVO_CURV_A156 = "roborock.vacuum.a156"  # Unconfirmed Vivian variant
+
+# VivianC series (a158/a159) — single-line camera, spin-mop, max_plus clean mode.
+# Model names unconfirmed; update once device data is available.
+ROBOROCK_VIVIAN_C_A158 = "roborock.vacuum.a158"
+ROBOROCK_VIVIAN_C_A159 = "roborock.vacuum.a159"
 
 ROBOROCK_DYAD_AIR = "roborock.wetdryvac.a107"
 ROBOROCK_DYAD_PRO_COMBO = "roborock.wetdryvac.a83"