Uh oh!
There was an error while loading. Please reload this page.
feat: add dust collection settings to the B01 Q7 api - #919
Open
akj wants to merge 2 commits into
Open
Conversation
Adds set_dust_collection (auto-empty on/off) and set_dust_collection_frequency (cleans per emptying) to Q7PropertiesApi, using prop.set like the other Q7 setters. Both verified against a real Q7 M5+ (roborock.vacuum.sc05, fw 03.01.80): dust_auto_state and dust_frequency round-trip correctly. Note that writing dust_action (empty now) is rejected by the device with code 1, so a manual-empty trigger is intentionally not included; it likely requires the dock-task DPS (203 start_dock_task) instead.
Author
Live-hardware follow-up from the same Q7 M5+: I monitored a full app-started clean (102 min, 59 m²) end-to-end over MQTT, polling
Happy to run more captures on this hardware if other codes or values need confirming. |
akj
marked this pull request as ready for review
August 16, 2026 16:09
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Adds two setters to
Q7PropertiesApifor the auto-empty dock, following the existingprop.setsetter conventions (set_child_lock,set_volume):set_dust_collection(enabled)— writesdust_auto_stateset_dust_collection_frequency(cleans)— writesdust_frequency(1 = empty after every clean); validates >= 1Plus parametrized tests in
tests/devices/traits/b01/q7/test_init.pymatching the existing setter tests.Verified on real hardware
Tested against a Roborock Q7 M5+ (
roborock.vacuum.sc05, fw 03.01.80, US region):dust_auto_stateround-trips 1 → 0 → 1 viaset_dust_collection, confirmed byGET_PROPread-back after each write.dust_frequencyround-trips 1 → 2 → 1 viaset_dust_collection_frequency, same method.Deliberately not included: manual "empty now"
Writing
dust_actionviaprop.setis rejected by the device with code 1 (B01 command failed with code 1), sodust_actionappears to be read-only state. The product schema for sc05 exposes write-only DPS201 start_clean_task,202 start_back_dock_task,203 start_dock_task— a manual empty trigger most likely goes through203 start_dock_task, which the Q7 channel doesn't support sending yet. Happy to test candidate encodings against my device in a follow-up if someone knows the expected payload shape.Side observation from the same session, can file separately: this healthy, docked device steadily reports
fault: "fault_2103"(unmapped placeholder inB01Fault, adjacent to 2102cleaning_complete) — the 2103 reading appeared right after a completed clean while charging, so it looks like another benign 2100-series notification rather than a real fault.