v5.30.0

v5.30.0 (2026-07-13)

This release is published under the GPL-3.0-only License.

Bug Fixes

• Gate dock_error_status on has_dock rather than is_collectable (#875, 86acd87)

Documentation

• Document metadata keys in field_metadata and is_field_supported (#875, 86acd87)

Features

• Implement device capability metadata for status computed property fields (#875, 86acd87)

---

Detailed Changes: v5.29.0...v5.30.0

v5.29.0

v5.29.0 (2026-07-12)

This release is published under the GPL-3.0-only License.

Features

• Truncate large payloads in RoborockMessage repr (#873, 95460d7)

---

Detailed Changes: v5.28.1...v5.29.0

v5.28.1

v5.28.1 (2026-07-12)

This release is published under the GPL-3.0-only License.

Bug Fixes

• Correct some dock mapping (#872, 9e95992)

Refactoring

• Use stateful fakes and fixtures in integration tests (#868, 89c8074)

---

Detailed Changes: v5.28.0...v5.28.1

v5.28.0

v5.28.0 (2026-07-08)

This release is published under the GPL-3.0-only License.

Features

• Add better dock feature control (#867, 73ba2bf)

---

Detailed Changes: v5.27.0...v5.28.0

v5.27.0

v5.27.0 (2026-07-07)

This release is published under the GPL-3.0-only License.

Documentation

• Add comment explaining dss field in v1_simulator (#860, c963ad7)

Features

• Add roborock.testing module for stateful integration testing (#860, c963ad7)

• Expose dock_type configuration in V1VacuumSimulator (#860, c963ad7)

• Expose in_cleaning, in_returning, charge_status, and dss on V1VacuumSimulator (#860, c963ad7)

• Honor publish_side_effect in simulator and raise NotImplementedError in base _handle_publish (#860, c963ad7)

Refactoring

• Decouple default product id from device duid and share DEFAULT_PRODUCT_ID constant (#860, c963ad7)

• Delete redundant properties from V1VacuumSimulator and update trigger_push_update (#860, c963ad7)

• Export and define all simulator state default constants at package level (#860, c963ad7)

• Expose raw status and app_init dataclasses on simulator for direct test manipulation (#860, c963ad7)

• Inherit FakeChannel from Channel Protocol (#860, c963ad7)

• Rename self.servers to self.simulated_devices and restore hardcoded qiCNieZa in mock_data (#860, c963ad7)

• Replace FakeUserState with library UserData dataclass on FakeRoborockCloud (#860, c963ad7)

• Type simulator consumables state using Consumable dataclass (#860, c963ad7)

• Type simulator dnd, clean summary and record using real dataclasses (#860, c963ad7)

• Type simulator status, network info and init status using real dataclasses (#860, c963ad7)

• Update _handle_app_get_init_status to serialize self.app_init and dynamically resolve status_info fields from self.status (#860, c963ad7)

---

Detailed Changes: v5.26.0...v5.27.0

v5.26.0

v5.26.0 (2026-07-06)

This release is published under the GPL-3.0-only License.

Documentation

• Add 569 back to the docstring's Q7-divergence list (#863, 32f9747)

• Mark fault 12 hw-confirmed (fired at 14% battery, corpus recount) (#863, 32f9747)

• Mark fault 2 hw-confirmed (bumper held during commanded motion) (#863, 32f9747)

• Mark fault 407 hw-confirmed (deterministically reproduced: due schedule ignored mid-clean) (#863, 32f9747)

• Mark fault 46 hw-confirmed (docked with dust bag removed) (#863, 32f9747)

• Mark fault 5 hw-confirmed (physically ground-truthed brush jams) (#863, 32f9747)

• Note fault 501 fires per completed task (#863, 32f9747)

• Note the error state can carry no fault code (observed live) (#863, 32f9747)

• Refer to the ss07 fault spec, not the app (review feedback) (#863, 32f9747)

Features

• Decode Q10 (B01/ss07) dpFault codes into a YXFault map (#863, 32f9747)

• Decode Q10 (B01/ss07) dpFault codes with a YXFault enum (#863, 32f9747)

• Re-add fault 569 as too_frequent_emptying, hw-confirmed (dock refuses a too-soon empty) (#863, 32f9747)

Refactoring

• Decouple B01 (Q7/Q10) protocol layer from transport layer (#859, b00d60b)

• Type Q10Status.fault as YXFault, mirroring the Q7 fault field (#863, 32f9747)

---

Detailed Changes: v5.25.0...v5.26.0

v5.25.0

v5.25.0 (2026-07-03)

This release is published under the GPL-3.0-only License.

Chores

• Add dataclasses for Roborock mower (#862, 413d6e5)

• Add some comments that better explain 'get_mop_only_vacuum_mode' (#817, 9474bfa)

• Address comments (#817, 9474bfa)

• Address comments from copilot (#817, 9474bfa)

• Apply suggestions from code review (#862, 413d6e5)

• Drop int typing and improve comment (#817, 9474bfa)

Features

• Add better cleaning mode support (#817, 9474bfa)

---

Detailed Changes: v5.24.0...v5.25.0

v5.24.0

v5.24.0 (2026-07-03)

This release is published under the GPL-3.0-only License.

Features

• Implement dynamic map update listeners and filtering on HomeTrait (#861, a793c8e)

---

Detailed Changes: v5.23.1...v5.24.0

v5.23.1

v5.23.1 (2026-07-03)

This release is published under the GPL-3.0-only License.

Bug Fixes

• Verify MQTT connection requires successful subscription (#858, e3c97c6)

Documentation

• Clarify is_mqtt_connected docstring with motivation (#858, e3c97c6)

Refactoring

• Remove unused fixtures in tests (#858, e3c97c6)

---

Detailed Changes: v5.23.0...v5.23.1

v5.23.0

v5.23.0 (2026-07-03)

This release is published under the GPL-3.0-only License.

Features

• Add Q10 (B01/ss07) clean-record history trait (#857, 79a996d)

• Q10 (B01/ss07) clean-record history trait (#857, 79a996d)

Refactoring

• Call the static parse_record via the class, not self (#857, 79a996d)

• Widen parse_record's parameter type to Any | None (#857, 79a996d)

---

Detailed Changes: v5.22.0...v5.23.0