alexei.dolgolyov
9383f957b6
Sends customizable notifications for Dreame vacuum events (cleaning status, consumable alerts, warnings, errors, and informational messages). Requires the Dreame Vacuum integration. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
95 lines
2.8 KiB
Markdown
95 lines
2.8 KiB
Markdown
# Dreame Vacuum Notifications
|
|
|
|
Sends customizable notifications for Dreame vacuum events. Requires the [Dreame Vacuum](https://github.com/Tasshack/dreame-vacuum) integration.
|
|
|
|
## Features
|
|
|
|
- Notifications for cleaning started and completed
|
|
- Consumable end-of-life alerts (brush, filter, mop pad, sensor, etc.)
|
|
- Device warning and error notifications
|
|
- Informational alerts (e.g., action blocked by Do Not Disturb)
|
|
- Individual toggle for each event type
|
|
- Customizable message templates with variable substitution
|
|
- Multiple notification targets
|
|
|
|
## How It Works
|
|
|
|
The blueprint listens to events fired by the Dreame Vacuum integration:
|
|
|
|
| Event | Description |
|
|
| --- | --- |
|
|
| `dreame_vacuum_task_status` | Cleaning job started or completed |
|
|
| `dreame_vacuum_consumable` | Consumable reached end-of-life |
|
|
| `dreame_vacuum_warning` | Dismissible device warning |
|
|
| `dreame_vacuum_error` | Device fault |
|
|
| `dreame_vacuum_information` | Action blocked by user settings |
|
|
|
|
Events are filtered by the configured vacuum entity, so only the selected vacuum triggers notifications.
|
|
|
|
## Configuration
|
|
|
|
| Input | Description |
|
|
| --- | --- |
|
|
| **Vacuum Entity** | The Dreame vacuum entity to monitor |
|
|
| **Notification Targets** | One or more `notify` entities |
|
|
| **Event Toggles** | Enable/disable each event type independently |
|
|
| **Message Templates** | Customizable message for each event type |
|
|
|
|
## Message Template Variables
|
|
|
|
### Cleaning Started
|
|
|
|
| Variable | Description |
|
|
| --- | --- |
|
|
| `{vacuum_name}` | Friendly name of the vacuum |
|
|
| `{cleaning_mode}` | Cleaning mode (e.g., sweeping, mopping) |
|
|
| `{status}` | Current status |
|
|
|
|
### Cleaning Completed
|
|
|
|
| Variable | Description |
|
|
| --- | --- |
|
|
| `{vacuum_name}` | Friendly name of the vacuum |
|
|
| `{cleaning_mode}` | Cleaning mode used |
|
|
| `{status}` | Final status |
|
|
| `{cleaned_area}` | Area cleaned (m²) |
|
|
| `{cleaning_time}` | Cleaning duration (minutes) |
|
|
|
|
### Consumable Depleted
|
|
|
|
| Variable | Description |
|
|
| --- | --- |
|
|
| `{vacuum_name}` | Friendly name of the vacuum |
|
|
| `{consumable}` | Consumable name (e.g., Main Brush, Side Brush, Filter, Mop Pad) |
|
|
|
|
### Warning
|
|
|
|
| Variable | Description |
|
|
| --- | --- |
|
|
| `{vacuum_name}` | Friendly name of the vacuum |
|
|
| `{warning}` | Warning description |
|
|
| `{code}` | Warning code |
|
|
|
|
### Error
|
|
|
|
| Variable | Description |
|
|
| --- | --- |
|
|
| `{vacuum_name}` | Friendly name of the vacuum |
|
|
| `{error}` | Error description |
|
|
| `{code}` | Error code |
|
|
|
|
### Information
|
|
|
|
| Variable | Description |
|
|
| --- | --- |
|
|
| `{vacuum_name}` | Friendly name of the vacuum |
|
|
| `{information}` | Information message (e.g., Dust Collection, Cleaning Paused) |
|
|
|
|
## Debug Mode
|
|
|
|
Enable **Debug Notifications** in the Debug section to send persistent notifications with raw event data for troubleshooting.
|
|
|
|
## Author
|
|
|
|
Alexei Dolgolyov (<dolgolyov.alexei@gmail.com>)
|