feat(q10): add Roborock Q10 S5+ support with CLI commands

Add vacuum trait methods (empty_dustbin, set_clean_mode, set_fan_level),
dedicated Q10 CLI session commands, and ROBOROCK_Q10 constant.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: lboue

roborock/cli.py

@@ -43,13 +43,14 @@
 
 from roborock import RoborockCommand
 from roborock.data import RoborockBase, UserData
-from roborock.data.b01_q10.b01_q10_code_mappings import B01_Q10_DP
+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.device_features import DeviceFeatures
 from roborock.devices.cache import Cache, CacheData
 from roborock.devices.device import RoborockDevice
 from roborock.devices.device_manager import DeviceManager, UserParams, create_device_manager
 from roborock.devices.traits import Trait
+from roborock.devices.traits.b01.q10.vacuum import VacuumTrait
 from roborock.devices.traits.v1 import V1TraitMixin
 from roborock.devices.traits.v1.consumeable import ConsumableAttribute
 from roborock.devices.traits.v1.map_content import MapContentTrait
@@ -438,6 +439,15 @@ async def _display_v1_trait(context: RoborockContext, device_id: str, display_fu
     click.echo(dump_json(trait.as_dict()))
 
 
+async def _q10_vacuum_trait(context: RoborockContext, device_id: str) -> VacuumTrait:
+    """Get VacuumTrait from Q10 device."""
+    device_manager = await context.get_device_manager()
+    device = await device_manager.get_device(device_id)
+    if device.b01_q10_properties is None:
+        raise RoborockUnsupportedFeature("Device does not support B01 Q10 protocol. Is it a Q10?")
+    return device.b01_q10_properties.vacuum
+
+
 @session.command()
 @click.option("--device_id", required=True)
 @click.pass_context
@@ -1172,6 +1182,154 @@ def write_markdown_table(product_features: dict[str, dict[str, any]], all_featur
 cli.add_command(network_info)
 
 
+# --- Q10 session commands ---
+
+
+@session.command()
+@click.option("--device_id", required=True, help="Device ID")
+@click.pass_context
+@async_command
+async def q10_vacuum_start(ctx: click.Context, device_id: str) -> None:
+    """Start vacuum cleaning on Q10 device."""
+    context: RoborockContext = ctx.obj
+    try:
+        trait = await _q10_vacuum_trait(context, device_id)
+        await trait.start_clean()
+        click.echo("Starting vacuum cleaning...")
+    except RoborockUnsupportedFeature:
+        click.echo("Device does not support B01 Q10 protocol. Is it a Q10?")
+    except RoborockException as e:
+        click.echo(f"Error: {e}")
+
+
+@session.command()
+@click.option("--device_id", required=True, help="Device ID")
+@click.pass_context
+@async_command
+async def q10_vacuum_pause(ctx: click.Context, device_id: str) -> None:
+    """Pause vacuum cleaning on Q10 device."""
+    context: RoborockContext = ctx.obj
+    try:
+        trait = await _q10_vacuum_trait(context, device_id)
+        await trait.pause_clean()
+        click.echo("Pausing vacuum cleaning...")
+    except RoborockUnsupportedFeature:
+        click.echo("Device does not support B01 Q10 protocol. Is it a Q10?")
+    except RoborockException as e:
+        click.echo(f"Error: {e}")
+
+
+@session.command()
+@click.option("--device_id", required=True, help="Device ID")
+@click.pass_context
+@async_command
+async def q10_vacuum_resume(ctx: click.Context, device_id: str) -> None:
+    """Resume vacuum cleaning on Q10 device."""
+    context: RoborockContext = ctx.obj
+    try:
+        trait = await _q10_vacuum_trait(context, device_id)
+        await trait.resume_clean()
+        click.echo("Resuming vacuum cleaning...")
+    except RoborockUnsupportedFeature:
+        click.echo("Device does not support B01 Q10 protocol. Is it a Q10?")
+    except RoborockException as e:
+        click.echo(f"Error: {e}")
+
+
+@session.command()
+@click.option("--device_id", required=True, help="Device ID")
+@click.pass_context
+@async_command
+async def q10_vacuum_stop(ctx: click.Context, device_id: str) -> None:
+    """Stop vacuum cleaning on Q10 device."""
+    context: RoborockContext = ctx.obj
+    try:
+        trait = await _q10_vacuum_trait(context, device_id)
+        await trait.stop_clean()
+        click.echo("Stopping vacuum cleaning...")
+    except RoborockUnsupportedFeature:
+        click.echo("Device does not support B01 Q10 protocol. Is it a Q10?")
+    except RoborockException as e:
+        click.echo(f"Error: {e}")
+
+
+@session.command()
+@click.option("--device_id", required=True, help="Device ID")
+@click.pass_context
+@async_command
+async def q10_vacuum_dock(ctx: click.Context, device_id: str) -> None:
+    """Return vacuum to dock on Q10 device."""
+    context: RoborockContext = ctx.obj
+    try:
+        trait = await _q10_vacuum_trait(context, device_id)
+        await trait.return_to_dock()
+        click.echo("Returning vacuum to dock...")
+    except RoborockUnsupportedFeature:
+        click.echo("Device does not support B01 Q10 protocol. Is it a Q10?")
+    except RoborockException as e:
+        click.echo(f"Error: {e}")
+
+
+@session.command()
+@click.option("--device_id", required=True, help="Device ID")
+@click.pass_context
+@async_command
+async def q10_empty_dustbin(ctx: click.Context, device_id: str) -> None:
+    """Empty the dustbin at the dock on Q10 device."""
+    context: RoborockContext = ctx.obj
+    try:
+        trait = await _q10_vacuum_trait(context, device_id)
+        await trait.empty_dustbin()
+        click.echo("Emptying dustbin...")
+    except RoborockUnsupportedFeature:
+        click.echo("Device does not support B01 Q10 protocol. Is it a Q10?")
+    except RoborockException as e:
+        click.echo(f"Error: {e}")
+
+
+@session.command()
+@click.option("--device_id", required=True, help="Device ID")
+@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:
+    """Set the cleaning mode on Q10 device (vacuum, mop, or both)."""
+    context: RoborockContext = ctx.obj
+    try:
+        trait = await _q10_vacuum_trait(context, device_id)
+        clean_mode = YXCleanType.from_value(mode)
+        await trait.set_clean_mode(clean_mode)
+        click.echo(f"Clean mode set to {mode}")
+    except RoborockUnsupportedFeature:
+        click.echo("Device does not support B01 Q10 protocol. Is it a Q10?")
+    except RoborockException as e:
+        click.echo(f"Error: {e}")
+
+
+@session.command()
+@click.option("--device_id", required=True, help="Device ID")
+@click.option(
+    "--level",
+    required=True,
+    type=click.Choice(["close", "quite", "normal", "strong", "max", "super"]),
+    help="Fan suction level",
+)
+@click.pass_context
+@async_command
+async def q10_set_fan_level(ctx: click.Context, device_id: str, level: str) -> None:
+    """Set the fan suction level on Q10 device."""
+    context: RoborockContext = ctx.obj
+    try:
+        trait = await _q10_vacuum_trait(context, device_id)
+        fan_level = YXFanLevel.from_value(level)
+        await trait.set_fan_level(fan_level)
+        click.echo(f"Fan level set to {level}")
+    except RoborockUnsupportedFeature:
+        click.echo("Device does not support B01 Q10 protocol. Is it a Q10?")
+    except RoborockException as e:
+        click.echo(f"Error: {e}")
+
+
 def main():
     return cli()
 

roborock/const.py

@@ -33,6 +33,7 @@
 ROBOROCK_QREVO_MASTER = "roborock.vacuum.a117"
 ROBOROCK_QREVO_CURV = "roborock.vacuum.a135"
 ROBOROCK_Q8_MAX = "roborock.vacuum.a73"
+ROBOROCK_Q10 = "roborock.vacuum.ss07"
 ROBOROCK_G10S_PRO = "roborock.vacuum.a26"
 ROBOROCK_G20S_Ultra = "roborock.vacuum.a143"  # cn saros_r10
 ROBOROCK_G10S = "roborock.vacuum.a46"
@@ -76,6 +77,7 @@
     ROBOROCK_S4_MAX,
     ROBOROCK_S7,
     ROBOROCK_P10,
+    ROBOROCK_Q10,
     ROCKROBO_G10_SG,
 ]
 

roborock/devices/traits/b01/q10/vacuum.py

@@ -1,6 +1,10 @@
 """Traits for Q10 B01 devices."""
 
-from roborock.data.b01_q10.b01_q10_code_mappings import B01_Q10_DP
+from roborock.data.b01_q10.b01_q10_code_mappings import (
+    B01_Q10_DP,
+    YXCleanType,
+    YXFanLevel,
+)
 
 from .command import CommandTrait
 
@@ -54,3 +58,24 @@ async def return_to_dock(self) -> None:
             command=B01_Q10_DP.START_DOCK_TASK,
             params={},
         )
+
+    async def empty_dustbin(self) -> None:
+        """Empty the dustbin at the dock."""
+        await self._command.send(
+            command=B01_Q10_DP.START_DOCK_TASK,
+            params=2,
+        )
+
+    async def set_clean_mode(self, mode: YXCleanType) -> None:
+        """Set the cleaning mode (vacuum, mop, or both)."""
+        await self._command.send(
+            command=B01_Q10_DP.CLEAN_MODE,
+            params=mode.code,
+        )
+
+    async def set_fan_level(self, level: YXFanLevel) -> None:
+        """Set the fan suction level."""
+        await self._command.send(
+            command=B01_Q10_DP.FAN_LEVEL,
+            params=level.code,
+        )