From 5c307536bf957f372a200178a14da32e97ca0243 Mon Sep 17 00:00:00 2001 From: Daniel Date: Thu, 9 Jan 2020 11:25:23 +0100 Subject: [PATCH] =?UTF-8?q?Add=20docs=20in=20vaccum.xiaomi=5Fmiio.markdown?= =?UTF-8?q?=20with=20how=20to=20clean=20a=20sp=E2=80=A6=20(#11676)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Add documentation in vaccum.xiaomi_miio.markdown with instructions how to clean a specific room It specifies how the command send_command can be used for Xiaomi vacuums. * Update Xiaomi vacuum docs on how to clean a room An example is specified under a new section. The service vacuum.send_command is not documented here anymore. * :pencil2: Tweaks Co-authored-by: Franck Nijhof --- .../_integrations/vacuum.xiaomi_miio.markdown | 24 +++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/source/_integrations/vacuum.xiaomi_miio.markdown b/source/_integrations/vacuum.xiaomi_miio.markdown index cce32980088..8a4f3ecc9d9 100644 --- a/source/_integrations/vacuum.xiaomi_miio.markdown +++ b/source/_integrations/vacuum.xiaomi_miio.markdown @@ -315,6 +315,30 @@ The information output is: - `Address` - The IP that the device has on the network. - `Token` - The token of the device or `???` if it could not be automatically determined. + +## Example on how to clean a specific room + +Example script using [`vacuum.send_command`](/integrations/vacuum/) to clean a specific room: + +```yaml +vacuum_kitchen: + alias: "Clean the kitchen" + sequence: + - service: vacuum.send_command + data: + entity_id: vacuum.xiaomi_vacuum_cleaner + command: app_segment_clean + params: [18] +``` + +Where params specify room numbers, for multiple rooms, params can be specified like `[17,18]`. + +Valid room numbers can be retrieved using miio command-line tool. It will only give room numbers and not the room names. To get the room names, one can just test the app_segment_clean command and see which room it cleans. + +```bash +miio protocol call get_room_mapping +``` + ## Retrieving Zoned Cleaning Coordinates ### Using FloleVac (Android)