homebridge-roborock-matter 3.17.1 → 3.17.2

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 3.17.2
+
+**The Qrevo CurvX's dock can now offer the Empty Bin switch.** Reported with a diagnostics export, and then settled by hand, by [@jcoz00](https://github.com/jcoz00) in [#6](https://github.com/mathiashornbek/homebridge-roborock-matter/issues/6). His a185 reports `dock_type: 20`, and the dock table this plugin inherited stops at 9 — so the CurvX fell through to "unknown dock" and was treated as having no auto-empty capability, which kept the optional Empty Bin switch added in 3.17.0 from ever being offered for it. Dock type 20 is now a named, recognised auto-empty dock.
+
+The switch is still opt-in and still off by default, so nothing changes for anyone who has not asked for it.
+
+**Only the auto-empty is granted, and only because its owner confirmed it.** Upstream also names a dozen dock codes above 9 that this project has had no report for, and none of those was added — a capability granted on a table alone is what cost a Q Revo S owner a suction level its robot does not have in [#10](https://github.com/mathiashornbek/homebridge-roborock-matter/issues/10). Wash and dry are unconfirmed on this dock and stay unclaimed. A test now pins both halves: dock type 20 is in the set because an owner said so, and the codes nobody has reported stay out until one does.
+
 ## 3.17.1
 
 **Closing the plugin's settings page could print a Node crash dump into your Homebridge log.** Reported with the log to prove it by [@jcoz00](https://github.com/jcoz00) in [#6](https://github.com/mathiashornbek/homebridge-roborock-matter/issues/6). The Homebridge UI runs the settings-page server as a child process and closes its IPC channel the moment the page goes away; every reply that server sends is a `process.send()`, including the `ready()` handshake it fires before serving a single request. A send that loses the race against that close is reported asynchronously as an unhandled `'error'` event, which is fatal — so a closed settings page ended in `Error: write EPIPE`, a stack trace and a `Node.js v24.19.0` banner in the log. Nothing was broken and nothing in the log said so. A dead channel now ends that child process quietly; every other error stays exactly as loud as it was.

package/README.md

@@ -37,7 +37,7 @@ This is the most feature-packed, most thoroughly engineered Roborock plugin for
 - 📍 **See where it's cleaning — live.** Apple Home shows _"Cleaning — Kitchen"_ with the room the robot is actually inside, updating as it moves from room to room. Works even for cleans started from the robot's button or the Roborock app. No other Homebridge plugin does this.
 - 🧭 **One robot, one tile — and as many robots as you own.** Sign in once and your whole fleet comes along: every vacuum on your account appears as its own clean, native accessory in Apple Home. No clutter of fake fans and helper switches, and rooms appear with the names you gave them in the Roborock app.
 - ⚡ **Fast and reliable.** Commands go directly to the robot over your own network whenever possible, with the Roborock cloud as automatic backup — and built-in diagnostics in the settings if you ever want to look under the hood.
-- 🛡️ **Verified by Homebridge.** Reviewed and endorsed by the Homebridge team. 1419 automated tests, zero known vulnerabilities, no analytics, and a startup designed to never crash your Homebridge — even when your Wi-Fi or the Roborock cloud has a bad day.
+- 🛡️ **Verified by Homebridge.** Reviewed and endorsed by the Homebridge team. 1438 automated tests, zero known vulnerabilities, no analytics, and a startup designed to never crash your Homebridge — even when your Wi-Fi or the Roborock cloud has a bad day.
 
 ## Features
 
@@ -252,7 +252,7 @@ The complete path — robot → plugin → Homebridge → matter.js store — wa
 
 ## Contributing
 
-Model reports, diagnostics exports, and pull requests are very welcome. The codebase ships with 1419 tests (protocol fixtures verified against the [python-roborock](https://github.com/Python-roborock/python-roborock) reference), strict TypeScript checking, and CI across Node 22/24 × Homebridge 1.11/2.x — `npm test` before you push and you're set.
+Model reports, diagnostics exports, and pull requests are very welcome. The codebase ships with 1438 tests (protocol fixtures verified against the [python-roborock](https://github.com/Python-roborock/python-roborock) reference), strict TypeScript checking, and CI across Node 22/24 × Homebridge 1.11/2.x — `npm test` before you push and you're set.
 
 ## Support the project
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "homebridge-roborock-matter",
-  "version": "3.17.1",
+  "version": "3.17.2",
   "description": "The most complete Roborock plugin for Apple Home. Supports the entire Roborock lineup — from the classic S-series to the new 2025 Q7 series that no other plugin can control. Sign in with your Roborock account and get native start/stop, room cleaning, suction levels, battery, and live 'cleaning in the kitchen' room tracking. Verified by Homebridge.",
   "license": "MIT",
   "author": {

package/roborockLib/lib/deviceFeatures.js

@@ -68,6 +68,12 @@ const dockTypes = {
   7: "Empty Wash Fill Dry Dock (S8 Pro Ultra)",
   8: "Empty Wash Fill Dry Dock (Q Revo)",
   9: "Empty Wash Fill Dry Dock (Q Revo Pro)",
+  // Upstream python-roborock calls 20 `k1s_dock`. It reached this project as a
+  // diagnostics export from an a185 (Qrevo CurvX) owner in issue #6 — the
+  // first dock code ever seen here above 9 — and he confirmed the auto-empty
+  // by hand. Named for the capability he reported, not for the ones upstream's
+  // codename might imply: nobody has confirmed wash or dry on this dock.
+  20: "Auto-Empty Dock (K1S — Qrevo CurvX)",
 };
 
 const firmwareFeatures = {
@@ -1393,6 +1399,15 @@ class deviceFeatures {
         this.isWashThenChargeCmdSupported();
         this.isSupportedDrying();
         break;
+      // K1S: a185 Qrevo CurvX. Auto-empty only, and deliberately so — its
+      // owner confirmed the dock empties the robot's bin (issue #6, 23 Aug
+      // 2026), which is the whole of what was asked and the whole of what is
+      // granted. Wash and dry are unconfirmed on this dock, and the a104
+      // suction level in issue #10 is what a capability granted on a table
+      // alone costs. Add them here on an owner's word, not on a codename's.
+      case 20:
+        this.isDustCollectionSettingSupported();
+        break;
       default:
         break;
     }

package/roborockLib/roborockAPI.js

@@ -2456,7 +2456,13 @@ class Roborock {
 
   supportsDustCollection(duid) {
     const dockType = Number(this.getVacuumDeviceStatus(duid, "dock_type"));
-    const autoEmptyDockTypes = new Set([1, 3, 5, 6, 7, 8, 9]);
+    // 20 (upstream `k1s_dock`, the a185 Qrevo CurvX) is here because its owner
+    // confirmed the auto-empty in issue #6, not because upstream names the
+    // code. Upstream also names 10, 11, 13-19, 21-24 and 26; none of those has
+    // an owner report, so none of them is here. Keep this set and
+    // `processDockType()` in step — a code in one but not the other is a dock
+    // that either offers a switch it cannot drive or hides one it can.
+    const autoEmptyDockTypes = new Set([1, 3, 5, 6, 7, 8, 9, 20]);
 
     return (
       autoEmptyDockTypes.has(dockType) ||