Merge remote-tracking branch 'origin/wash_towels' into wash_towels

Author: Lash-L

CHANGELOG.md

@@ -2,6 +2,184 @@
 
 <!-- version list -->
 
+## v4.19.0 (2026-03-08)
+
+### Bug Fixes
+
+- Make room name always room num and not unknown
+  ([#780](https://github.com/Python-roborock/python-roborock/pull/780),
+  [`2bd569c`](https://github.com/Python-roborock/python-roborock/commit/2bd569caffe7e85bc08637fd9b8ed70eeade5aa8))
+
+### Chores
+
+- Address comments ([#780](https://github.com/Python-roborock/python-roborock/pull/780),
+  [`2bd569c`](https://github.com/Python-roborock/python-roborock/commit/2bd569caffe7e85bc08637fd9b8ed70eeade5aa8))
+
+### Features
+
+- Use get_rooms to limit issues with missing room names
+  ([#780](https://github.com/Python-roborock/python-roborock/pull/780),
+  [`2bd569c`](https://github.com/Python-roborock/python-roborock/commit/2bd569caffe7e85bc08637fd9b8ed70eeade5aa8))
+
+
+## v4.18.1 (2026-03-07)
+
+### Bug Fixes
+
+- Don't reconnect on no active subscribers
+  ([#779](https://github.com/Python-roborock/python-roborock/pull/779),
+  [`9760519`](https://github.com/Python-roborock/python-roborock/commit/9760519e822d06fac74e4a14bc11003e5fd2ca21))
+
+
+## v4.18.0 (2026-03-06)
+
+### Bug Fixes
+
+- Correct mop intensity code for slider
+  ([#777](https://github.com/Python-roborock/python-roborock/pull/777),
+  [`f83f36a`](https://github.com/Python-roborock/python-roborock/commit/f83f36a8e96bee3eab7e0ee21cd296653546310a))
+
+### Features
+
+- Add the ability to not verify TLS for MQTT connections
+  ([#776](https://github.com/Python-roborock/python-roborock/pull/776),
+  [`fc7cf75`](https://github.com/Python-roborock/python-roborock/commit/fc7cf75e088cf74f6f6f648afb927fdb03bc9e23))
+
+
+## v4.17.2 (2026-03-01)
+
+### Bug Fixes
+
+- Bump pyrate ([#775](https://github.com/Python-roborock/python-roborock/pull/775),
+  [`57083ab`](https://github.com/Python-roborock/python-roborock/commit/57083ab27606af82b5457c82d35e63dd6f5e5754))
+
+
+## v4.17.1 (2026-02-22)
+
+### Bug Fixes
+
+- Remove carpet clean mode ([#772](https://github.com/Python-roborock/python-roborock/pull/772),
+  [`931b68e`](https://github.com/Python-roborock/python-roborock/commit/931b68ea4fcb1d61a310d534cba662a704b6dca3))
+
+
+## v4.17.0 (2026-02-22)
+
+### Chores
+
+- Add dss to status ([#611](https://github.com/Python-roborock/python-roborock/pull/611),
+  [`3e4a0be`](https://github.com/Python-roborock/python-roborock/commit/3e4a0be03cdcc761f91c1cdd20cd5ee3b1f8ceee))
+
+- Add hash ([#611](https://github.com/Python-roborock/python-roborock/pull/611),
+  [`3e4a0be`](https://github.com/Python-roborock/python-roborock/commit/3e4a0be03cdcc761f91c1cdd20cd5ee3b1f8ceee))
+
+- Add more info about the dynamic attributes
+  ([#611](https://github.com/Python-roborock/python-roborock/pull/611),
+  [`3e4a0be`](https://github.com/Python-roborock/python-roborock/commit/3e4a0be03cdcc761f91c1cdd20cd5ee3b1f8ceee))
+
+- Add some docs and a basic test
+  ([#611](https://github.com/Python-roborock/python-roborock/pull/611),
+  [`3e4a0be`](https://github.com/Python-roborock/python-roborock/commit/3e4a0be03cdcc761f91c1cdd20cd5ee3b1f8ceee))
+
+- Add testing ([#611](https://github.com/Python-roborock/python-roborock/pull/611),
+  [`3e4a0be`](https://github.com/Python-roborock/python-roborock/commit/3e4a0be03cdcc761f91c1cdd20cd5ee3b1f8ceee))
+
+- Add warning about hash for RoborockModeEnum
+  ([#611](https://github.com/Python-roborock/python-roborock/pull/611),
+  [`3e4a0be`](https://github.com/Python-roborock/python-roborock/commit/3e4a0be03cdcc761f91c1cdd20cd5ee3b1f8ceee))
+
+- Address comments ([#611](https://github.com/Python-roborock/python-roborock/pull/611),
+  [`3e4a0be`](https://github.com/Python-roborock/python-roborock/commit/3e4a0be03cdcc761f91c1cdd20cd5ee3b1f8ceee))
+
+- Change str ([#611](https://github.com/Python-roborock/python-roborock/pull/611),
+  [`3e4a0be`](https://github.com/Python-roborock/python-roborock/commit/3e4a0be03cdcc761f91c1cdd20cd5ee3b1f8ceee))
+
+- Do dynamic status ([#611](https://github.com/Python-roborock/python-roborock/pull/611),
+  [`3e4a0be`](https://github.com/Python-roborock/python-roborock/commit/3e4a0be03cdcc761f91c1cdd20cd5ee3b1f8ceee))
+
+- Update e2e ([#611](https://github.com/Python-roborock/python-roborock/pull/611),
+  [`3e4a0be`](https://github.com/Python-roborock/python-roborock/commit/3e4a0be03cdcc761f91c1cdd20cd5ee3b1f8ceee))
+
+### Features
+
+- Add more data and region ([#611](https://github.com/Python-roborock/python-roborock/pull/611),
+  [`3e4a0be`](https://github.com/Python-roborock/python-roborock/commit/3e4a0be03cdcc761f91c1cdd20cd5ee3b1f8ceee))
+
+- Make status dynamic ([#611](https://github.com/Python-roborock/python-roborock/pull/611),
+  [`3e4a0be`](https://github.com/Python-roborock/python-roborock/commit/3e4a0be03cdcc761f91c1cdd20cd5ee3b1f8ceee))
+
+
+## v4.16.0 (2026-02-22)
+
+### Chores
+
+- Fix test pydoc lint error ([#771](https://github.com/Python-roborock/python-roborock/pull/771),
+  [`e72d5ca`](https://github.com/Python-roborock/python-roborock/commit/e72d5ca7b7997760498108761d5b9a8c7907addc))
+
+- Update tests/devices/traits/b01/q10/test_status.py
+  ([#771](https://github.com/Python-roborock/python-roborock/pull/771),
+  [`e72d5ca`](https://github.com/Python-roborock/python-roborock/commit/e72d5ca7b7997760498108761d5b9a8c7907addc))
+
+### Features
+
+- Update the status listener API
+  ([#771](https://github.com/Python-roborock/python-roborock/pull/771),
+  [`e72d5ca`](https://github.com/Python-roborock/python-roborock/commit/e72d5ca7b7997760498108761d5b9a8c7907addc))
+
+
+## v4.15.0 (2026-02-21)
+
+### Bug Fixes
+
+- **q10**: Correct typo in docstring for StatusTrait
+  ([#770](https://github.com/Python-roborock/python-roborock/pull/770),
+  [`c0a313b`](https://github.com/Python-roborock/python-roborock/commit/c0a313b385da722a81ffe4aeade3bf104bd254a8))
+
+### Features
+
+- **q10**: Add status update listener API
+  ([#770](https://github.com/Python-roborock/python-roborock/pull/770),
+  [`c0a313b`](https://github.com/Python-roborock/python-roborock/commit/c0a313b385da722a81ffe4aeade3bf104bd254a8))
+
+- **q10**: Add status update listener callback API
+  ([#770](https://github.com/Python-roborock/python-roborock/pull/770),
+  [`c0a313b`](https://github.com/Python-roborock/python-roborock/commit/c0a313b385da722a81ffe4aeade3bf104bd254a8))
+
+
+## v4.14.0 (2026-02-15)
+
+### Chores
+
+- Address review feedback ([#769](https://github.com/Python-roborock/python-roborock/pull/769),
+  [`38d336b`](https://github.com/Python-roborock/python-roborock/commit/38d336b3735dc04e60ba47f0c0041705567e72f6))
+
+- Fix lint errors found by co-pilot reviews
+  ([#769](https://github.com/Python-roborock/python-roborock/pull/769),
+  [`38d336b`](https://github.com/Python-roborock/python-roborock/commit/38d336b3735dc04e60ba47f0c0041705567e72f6))
+
+- Fix typos in files that were renamed
+  ([#769](https://github.com/Python-roborock/python-roborock/pull/769),
+  [`38d336b`](https://github.com/Python-roborock/python-roborock/commit/38d336b3735dc04e60ba47f0c0041705567e72f6))
+
+- Fix typos updated in previous PRs
+  ([#769](https://github.com/Python-roborock/python-roborock/pull/769),
+  [`38d336b`](https://github.com/Python-roborock/python-roborock/commit/38d336b3735dc04e60ba47f0c0041705567e72f6))
+
+### Features
+
+- Add initial Q10 support for Status Trait
+  ([#769](https://github.com/Python-roborock/python-roborock/pull/769),
+  [`38d336b`](https://github.com/Python-roborock/python-roborock/commit/38d336b3735dc04e60ba47f0c0041705567e72f6))
+
+
+## v4.13.0 (2026-02-14)
+
+### Features
+
+- **q10**: Add Roborock Q10 S5+ support with CLI commands
+  ([#766](https://github.com/Python-roborock/python-roborock/pull/766),
+  [`86aeba1`](https://github.com/Python-roborock/python-roborock/commit/86aeba1e3e0a9d51f98ba93c4423a0ee58e3fb55))
+
+
 ## v4.12.0 (2026-02-02)
 
 ### Bug Fixes

docs/DEVICES.md

@@ -15,6 +15,10 @@ Cloud and Network.
     *   **Washers (A01)**: Use `device.a01_properties` for Dyad/Zeo devices.
         *   Use `await device.a01_properties.query_values([...])` to get state.
         *   Use `await device.a01_properties.set_value(protocol, value)` to control.
+    *   **Vacuums (B01 Q10)**: Use `device.b01_q10_properties` for Q10 series devices.
+        *   Use `device.b01_q10_properties.vacuum` to access vacuum commands (start, pause, stop, dock, empty dustbin, set clean mode, set fan level).
+        *   Use `device.b01_q10_properties.command.send()` for raw DP commands.
+    *   **Vacuums (B01 Q7)**: Use `device.b01_q7_properties` for Q7 series devices.
 
 ## Background: Understanding Device Protocols
 
@@ -26,7 +30,7 @@ Cloud and Network.
 |----------|----------------|------|-----------|--------------|-------|
 | **V1** (`pv=1.0`) | Most vacuum robots (S7, S8, Q5, Q7, etc.) | ✅ | ✅ | `V1Channel` with `RpcChannel` | Prefers local, falls back to MQTT |
 | **A01** (`pv=A01`) | Dyad, Zeo washers | ✅ | ❌ | `MqttChannel` + helpers | MQTT only, DPS protocol |
-| **B01** (`pv=B01`) | Some newer models | ✅ | ❌ | `MqttChannel` + helpers | MQTT only, DPS protocol |
+| **B01** (`pv=B01`) | Q7, Q10 series | ✅ | ❌ | `MqttChannel` + helpers | MQTT only, DPS protocol |
 
 **Key Point:** The `DeviceManager` automatically detects the protocol version and creates the appropriate channel type. You don't need to handle this manually.
 
@@ -47,7 +51,7 @@ graph TB
     subgraph "Device Types by Protocol"
         V1Dev[V1 Devices<br/>pv=1.0<br/>Most vacuums]
         A01Dev[A01 Devices<br/>pv=A01<br/>Dyad, Zeo]
-        B01Dev[B01 Devices<br/>pv=B01<br/>Some models]
+        B01Dev[B01 Devices<br/>pv=B01<br/>Q7, Q10 series]
     end
 
     subgraph "Traits Layer"
@@ -148,7 +152,7 @@ graph TB
 |----------|-------------|---------------|--------------|----------|
 | **V1** (`pv=1.0`) | `V1Channel` with `RpcChannel` | ✅ Yes | Multi-strategy (Local → MQTT) | Most vacuum robots |
 | **A01** (`pv=A01`) | `MqttChannel` + helpers | ❌ No | Direct MQTT | Dyad, Zeo washers |
-| **B01** (`pv=B01`) | `MqttChannel` + helpers | ❌ No | Direct MQTT | Some newer models |
+| **B01** (`pv=B01`) | `MqttChannel` + helpers | ❌ No | Direct MQTT | Q7, Q10 series |
 
 ## Account Setup Internals
 
@@ -249,7 +253,7 @@ sequenceDiagram
     RPC-->>App: Status
 ```
 
-#### A01/B01 Devices (Dyad, Zeo) - MQTT Only
+#### A01/B01 Devices (Dyad, Zeo, Q7, Q10) - MQTT Only
 
 ```mermaid
 sequenceDiagram
@@ -302,7 +306,7 @@ sequenceDiagram
 | **Local Support** | ✅ Yes, preferred | ❌ No |
 | **Fallback** | Local → MQTT | N/A |
 | **Connection** | Requires network info fetch | Direct MQTT |
-| **Examples** | Most vacuum robots | Dyad washers, Zeo models |
+| **Examples** | Most vacuum robots | Dyad washers, Zeo, Q7, Q10 |
 
 ### MQTT Connection (All Devices)
 
@@ -510,7 +514,7 @@ Different device models use different protocol versions:
 |----------|---------|----------|
 | V1 | Most vacuum robots | JSON RPC with AES encryption |
 | A01 | Dyad, Zeo | DPS-based protocol |
-| B01 | Some newer models | DPS-based protocol |
+| B01 | Q7, Q10 series | DPS-based protocol |
 | L01 | Local protocol variant | Binary protocol negotiation |
 
 The protocol layer handles encoding/decoding transparently based on the device's `pv` field.
@@ -577,11 +581,14 @@ roborock/
 │   |   ├── b01_q10_channel.py  # B01 Q10 protocol helpers
 │   |   └── ...
 │   └── traits/                 # High-level device-specific command traits
-│       └── v1/                 # V1 device traits
-│           ├── __init__.py     # Trait initialization
-│           ├── clean.py        # Cleaning commands
-│           ├── map.py          # Map management
-│           └── ...
+│       ├── v1/                 # V1 device traits
+│       │   ├── __init__.py     # Trait initialization
+│       │   ├── clean.py        # Cleaning commands
+│       │   ├── map.py          # Map management
+│       │   └── ...
+│       └── b01/                # B01 device traits
+│           ├── q10/            # Q10 series (vacuum, command)
+│           └── q7/             # Q7 series
 ├── mqtt/                      # MQTT session management
 │   ├── session.py             # Base session interface
 │   └── roborock_session.py    # MQTT session with idle timeout

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "python-roborock"
-version = "4.12.0"
+version = "4.19.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"
@@ -26,7 +26,7 @@ dependencies = [
     "paho-mqtt>=1.6.1,<3.0.0",
     "construct>=2.10.57,<3",
     "vacuum-map-parser-roborock",
-    "pyrate-limiter>=3.7.0,<4",
+    "pyrate-limiter>=4.0.0,<5",
     "aiomqtt>=2.5.0,<3",
     "click-shell~=2.1",
 ]