jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-24 17:57:14 +00:00
Code Issues Packages Projects Releases Wiki Activity

Updates vacuum.xioami_miio docs (#11795)

Browse Source 
Also added an example on how to reset the counter for consumables
(filter, brushes and sensors).
This commit is contained in:
Aaron Godfrey 2020-01-18 04:08:18 -08:00 committed by Franck Nijhof
parent 90f2d0e19b
commit 67d8c8da27
1 changed files with 44 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

33
source/_integrations/vacuum.xiaomi_miio.markdown
View File

@ -189,23 +189,29 @@ In addition to [all of the attributes provided by the `vacuum` component](/integ
- `main_brush_left` - `main_brush_left`
- `side_brush_left` - `side_brush_left`
- `filter_left` - `filter_left`
- `sensor_dirty_left`
- `cleaning_count` - `cleaning_count`
- `total_cleaned_area` - `total_cleaned_area`
- `total_cleaning_time` - `total_cleaning_time`
- `clean_start`
- `clean_end`
The following table shows the units of measurement for each attribute: The following table shows the units of measurement for each attribute:
| Attribute | Unit of measurement | Description | | Attribute | Unit of measurement | Description |
|---------------------------|---------------------|-------------------------------------------------------| |---------------------------|---------------------|----------------------------------------------------------------|
| `do_not_disturb` | | DND mode on / off | | `do_not_disturb` | | DND mode on / off |
| `cleaning_time` | minutes | Last / actual cleaning time in minutes | | `cleaning_time` | minutes | Last / actual cleaning time in minutes |
| `cleaned_area` | square meter | Last / actual cleaned area in square meters | | `cleaned_area` | square meter | Last / actual cleaned area in square meters |
| `main_brush_left` | hours | Hours left until a change of the main brush is needed | | `main_brush_left` | hours | Hours left until a change of the main brush is needed |
| `side_brush_left` | hours | Hours left until a change of the side brush is needed | | `side_brush_left` | hours | Hours left until a change of the side brush is needed |
| `filter_left` | hours | Hours left until a change of the filter is needed | | `filter_left` | hours | Hours left until a change of the filter is needed |
| `sensor_dirty_left` | hours | Hours left until the wall and cliff sensors should be cleaned |
| `cleaning_count` | | Number of total cleaning cycles | | `cleaning_count` | | Number of total cleaning cycles |
| `total_cleaned_area` | square meter | Total cleaned area in square meters | | `total_cleaned_area` | square meter | Total cleaned area in square meters |
| `total_cleaning_time` | minutes | Total cleaning time in minutes | | `total_cleaning_time` | minutes | Total cleaning time in minutes |
| `clean_start` | datetime | The last date/time the vacuum started cleaning (offset naive) |
| `clean_end` | datetime | The last date/time the vacuum finished cleaning (offset naive) |
## Retrieving the Access Token ## Retrieving the Access Token
@ -339,6 +345,31 @@ Valid room numbers can be retrieved using miio command-line tool. It will only g
miio protocol call <ip of the vacuum> get_room_mapping miio protocol call <ip of the vacuum> get_room_mapping
``` ```
## Example on how to reset maintenance hours (brushes, filter, sensors)
The vacuum entity stores attribute values for when brushes, filters and sensors need to be
cleaned or replaced (`main_brush_left`, `side_brush_left`, `filter_left` and
`sensor_dirty_left`). The values are measured in hours. Once the parts are cleaned
or replaced you can then reset those values on the vacuum. Here is an example script using
[`vacuum.send_command`](/integrations/vacuum/) to reset the hours for the main brush:
```yaml
reset_main_brush_left:
alias: "Reset hours for main brush replacement"
sequence:
- service: vacuum.send_Command
data:
entity_id: vacuum.xiaomi_vacuum_cleaner
command: reset_consumable
params: ['main_brush_work_time']
```
Allowed `params` for the `reset_consumable` command:
* `['main_brush_work_time']`
* `['side_brush_work_time']`
* `['filter_work_time']`
* `['sensor_dirty_time']`
## Retrieving Zoned Cleaning Coordinates ## Retrieving Zoned Cleaning Coordinates
### Using FloleVac (Android) ### Using FloleVac (Android)