Events

The integration tracks certain device properties and triggers events in Home Assistant. These events are always fired regardless of whether notifications are enabled in the integration options.

Event Tools

If the My Home Assistant integration is enabled, you can access the event debugging tools directly by clicking the badge below.

Event tools of

Otherwise, navigate to Developer Tools from the Home Assistant sidebar and select the Events tab.

This page is used for debugging events. By subscribing to a specific event (e.g., dreame_vacuum_task_status), you can monitor when it is triggered and inspect the data payload it contains. This information is highly useful when creating custom automations.

Task Status

dreame_vacuum_task_status

TIP

This event can be used to trigger an automation when a task finishes, or to chain multiple tasks together.

Triggered when a cleanup job is completed, ended, or canceled.

Show Properties

Property	Description	Notes
entity_id	Vacuum entity.
cleaning_mode	Selected cleaning mode.
status	Current status of the device.
water_tank	Indicates if the water tank is installed.
mop_pad	Indicates if the mop pads are installed.
completed	Indicates if the task is completed or started.
cleaned_area	Total cleaned area.	Only present when the task is completed.
cleaning_time	Total cleaning time.	Only present when the task is completed.
active_segments	Selected rooms for the segment cleaning task.	Only present if the map feature is enabled.
active_areas	Selected areas for the zone cleaning task.	Only present if the map feature is enabled.
active_points	Selected points for the spot cleaning task.	Only present if the map feature is enabled.

Consumable Depleted

dreame_vacuum_consumable

TIP

This event can be used to send a custom notification to your phone or to automatically reset the consumable via an automation (see Services).

Triggered when a consumable's lifespan has ended and it requires replacement or maintenance.

Show Properties

Property	Description	Notes
entity_id	Vacuum entity.
consumable	Type of the depleted consumable.	Possible values are main_brush, side_brush, filter, tank_filter, sensor, mop_pad, silver_ion, detergent, squeege, dirty_water_tank, onboard_dirty_water_tank, deodorizer, wheel, and scale_inhibitor.

Information

dreame_vacuum_information

Triggered when a specific job cannot be executed due to user settings or device state.

Show Properties

Property	Description	Notes
entity_id	Vacuum entity.
information	Type of information reported.	Possible values are dust_collection (dust collection not performed due to Do Not Disturb settings) and cleaning_paused (cleaning paused due to low battery).

Warning

dreame_vacuum_warning

TIP

This event can be used to send a custom notification to your phone or to automatically clear the warning via an automation (see Entities).

Triggered when the device reports a dismissible warning code.

Show Properties

Property	Description	Notes
entity_id	Vacuum entity.
warning	Warning description.
code	Fault code associated with the warning.

Error

dreame_vacuum_error

Triggered when the device reports a critical fault code.

TIP

This event can be used to send a custom notification to your phone to stay informed about fault information during a job.

Show Properties

Property	Description	Notes
entity_id	Vacuum entity.
error	Error description.
code	Fault code associated with the error.

Low Water

dreame_vacuum_low_water

TIP

This event can be used to send a custom notification to your phone to stay informed about low water situations.

Triggered when the device issues a low water warning.

Show Properties

Property	Description	Notes
entity_id	Vacuum entity.
low_water	Low water warning description.
code	Fault code associated with the low water warning.

Drainage Status

dreame_vacuum_drainage_status

TIP

This event can be used to trigger an automation or another task based on the result after drainage is triggered.

Triggered when a water tank drainage operation is completed or fails.

Show Properties

Property	Description	Notes
entity_id	Vacuum entity.
drainage_status	Indicates whether the drainage operation was successful or not.