Add Dreame Vacuum Notifications blueprint
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>
This commit is contained in:
94
Common/Dreame Vacuum/README.md
Normal file
94
Common/Dreame Vacuum/README.md
Normal file
@@ -0,0 +1,94 @@
|
||||
# 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>)
|
||||
Reference in New Issue
Block a user