# :white\_check\_mark: Ajouter l'aspirateur Roborock S50 de chez Xiaomi

**URL:** <https://forum.hacf.fr/t/ajouter-laspirateur-roborock-s50-de-chez-xiaomi/222>\
**Category:** Intégration\
**Tags:** aspirateur-vacuum, xiaomi, roborock\
**Created:** [Juillet 3, 2020, 1:38 UTC](https://forum.hacf.fr/t/ajouter-laspirateur-roborock-s50-de-chez-xiaomi/222 "2020-07-03T13:38:15Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![McFly](https://forum.hacf.fr/user_avatar/forum.hacf.fr/mcfly/32/1077_2.png) [@McFly](https://forum.hacf.fr/u/McFly)\
**Post date:** [Juillet 3, 2020, 1:38 UTC](https://forum.hacf.fr/t/ajouter-laspirateur-roborock-s50-de-chez-xiaomi/222/1 "2020-07-03T13:38:15Z")

</div>

![licence](https://forum.hacf.fr/uploads/default/original/2X/e/e1fead3f87ba19785badbf348ffefc0c7612c613.svg)

Les aspirateurs Xiaomi sont plutôt de bonne qualité. Je me suis laissé tenter il y a plus d’un an et ça change la vie.

Cela n’empêche pas de faire votre ménage, mais quel bonheur de rentrer dans une maison rangée (sinon l’aspirateur bloque partout) et propre (sans petites poussières).

Nous allons voir ici comment l’ajouter à votre installation Home Assistant.

## Niveau requis

- **Débutant** / _Intermédiaire_ / _Avancé_

## Matériels nécessaires / Matériels utilisés / Prérequis

- Avoir installé [HACS](https://hacf.fr/installer-ajouter-integrations-customisations-avec-hacs/),
- Avoir installé [File Editor](https://hacf.fr/file-editor-et-home-assistant-modifier-vos-fichiers/) ou tout autre méthode pour éditer les fichiers de configuration
- Avoir [récupéré son Token](https://forum.hacf.fr/t/integrer-les-capteurs-bluetooth-xiaomi-dans-home-assistant-via-passive-ble-monitor/211).
- Roborock compatible (S50, S5, S6).

## Installation / configuration.

### Configuration.yaml.

Pour ajouter votre robot aspirateur, il faut ajouter dans `configuration.yaml` le code suivant.

```auto
vacuum:
  - platform: xiaomi_miio
    name: Roborock S50 ## Nom que vous souhaitez
    host: 192.168.10.5 ## IP de votre Aspirateur
    token: !secret token_aspirateur

```

 ![Configuration.yaml Vacuum](https://forum.hacf.fr/uploads/default/original/2X/b/bfc16ff70da03f3e01732bf9bc73ee165540bf6a.png)

Il vous suffit maintenant d’aller ajouter votre `token` dans `secret.yaml` et c’est fini.

Vérifier votre fichier de configuration, puis redémarrer.

Dans `Configuration`, `Entités`, rechercher `vacuum` vous devriez voir votre aspirateur.

 ![](https://forum.hacf.fr/uploads/default/original/2X/4/4ebce61bc248a36b6448bbe193e7aa8ebc5c7097.png)

### Lovelace UI.

 ![](https://forum.hacf.fr/uploads/default/original/2X/3/363afa232af7226fb21228bec9408bb8b8391479.jpeg)

Pour ajouter cette carte dans votre interface, rendez vous dans `HACS` puis dans `plugins`.

Rechercher `xiaomi` puis installer `(xiaomi) Vacuum Card`.

 ![](https://forum.hacf.fr/uploads/default/original/2X/3/31781c776eafbfe7b13ba59c381cd1b41cc86b4a.jpeg)

Une fois installé, les ressources sont automatiquement ajoutées avec `HACS` (pour vérifier rendez vous dans `Configuration`, `Tableaux de bord Lovelace` puis `Ressources`.  
Vous devriez voir la ressource ajoutée.

 ![](https://forum.hacf.fr/uploads/default/original/2X/4/4360a04ac73c5a68e49775e30a822e7ee296bb36.jpeg)

 ![](https://forum.hacf.fr/uploads/default/original/2X/8/837dd9515a3449919f6e5d9f4cc8ce57c9d471c1.png)

Rendez vous maintenant dans `Aperçu`, `Configurer l'interface Utilisateur`, ajouter une carte type `Manuel` en bas.  
Copier le code suivant.

**NOTA :** c’est le code complet vous pouvez supprimer des boutons par exemple.

```auto
buttons:
  locate: true
  pause: true
  return: true
  spot: true
  start: true
  stop: true
entity: vacuum.roborock_s50
icons:
  start: 'mdi:play'
  stop: 'mdi:stop'
labels:
  battery: Batterie
  filter: Filtre
  hours: h
  main_brush: Brosse Principale
  mode: Puissance
  sensor: Capteurs
  side_brush: Brosse Latérale
  status: Etat
name: Aspirateur
type: 'custom:xiaomi-vacuum-card'
vendor: xiaomi

```

**N’oubliez** pas de changer votre `entity` par le votre (celui qui apparaît dans la recherche des entités).

## Partage de Royto.

### Carte Lovelace.

Personnellement, j’utilise la carte Lovelace vacuum-card : [https://github.com/denysdovhan/vacuum-card](https://github.com/denysdovhan/vacuum-card)

 ![](https://forum.hacf.fr/uploads/default/original/2X/8/844330fc2eedc0955fb622e3115df9fb9dc440da.jpeg)

Je la trouve plus jolie et plus adapté a lovelace

ci-joint une configuration de la carte

La partie actions permet d’appeler des services ce qui me permet de spécifier une pièce à nettoyer

```auto
actions:
  - icon: 'mdi:stove'
    name: Nettoyer Cuisine
    service: script.vacuum_dispatch
    service_data:
      room: Cuisine
  - icon: 'mdi:sofa'
    name: Nettoyer le salon
    service: script.vacuum_dispatch
    service_data:
      room: Salon
  - icon: 'mdi:television'
    name: Nettoyer le salon & salle a manger
    service: script.vacuum_dispatch
    service_data:
      room: Salon & Salle à manger
  - icon: 'mdi:bed-empty'
    name: Nettoyer la chambre des filles
    service: script.vacuum_dispatch
    service_data:
      room: Chambre filles
  - icon: 'mdi:water-pump'
    name: Nettoyer la salle de bain
    service: script.vacuum_dispatch
    service_data:
      room: Salle de bain
  - icon: 'mdi:bed-double'
    name: Nettoyer la chambre parentale
    service: script.vacuum_dispatch
    service_data:
      room: Chambre parents
  - icon: 'mdi:home'
    name: Nettoyer Maison
    service: script.vacuum_dispatch
    service_data:
      room: Maison
entity: vacuum.xiaomi_vacuum_cleaner
show_name: false
show_toolbar: true
stats:
  cleaning:
    - attribute: cleaned_area
      subtitle: Zone nettoyée
      unit: m2
    - attribute: cleaning_time
      subtitle: Temps de nettoyage
      unit: minutes
  default:
    - attribute: filter_left
      subtitle: Filtre
      unit: heures
    - attribute: side_brush_left
      subtitle: Brosse latérale
      unit: heures
    - attribute: main_brush_left
      subtitle: Brosse principale
      unit: heures
    - attribute: sensor_dirty_left
      subtitle: Capteurs
      unit: heures
type: 'custom:vacuum-card'

```

### Gestion des Pièces.

MiHome permet de définir des pièces dans l’application.

Il est possible via Home Assistant de spécifier le nettoyage dans une ou plusieurs pièces. Pour cela, il faut utiliser le service `vacuum.send_command`.

Ci joint un exemple de `scripts` pour lancer le nettoyage dans la cuisine qui correspond à la zone 19 dans notre cas.

```auto
vacuum_clean_cuisine:
  alias: "Nettoyer Cuisine"
  sequence:
    - service: vacuum.send_command
      data:
        entity_id: vacuum.xiaomi_vacuum_cleaner
        command: app_segment_clean
        params: [19]

```

Il est possible de nettoyer plusieurs pièces en spécifiant plusieurs id de pièces dans la valeur de `params: [19, 20, 21]`.

Afin de retrouver les `id` de pièces, le plus simple est de passer par les `outils de développement` et de lancer une commande en testant les `id` 1 par 1.  
Dans l’application MiHome, si l’`id` correspond à une pièce configurée, celle-ci sera affiché en couleur dans l’application. Si l’`id `ne correspond pas, le robot dira un message d’erreur et retournera sur la base.

Pour info, les `id` 1 à 15 sont réservés pour les pièces générées automatiquement par l’application. Les pièces créées manuellement sont numérotées à partir de 16.

## Trucs & astuces.

#### Ça ne marche pas !!!

Vérifiez bien que [votre token](https://forum.hacf.fr/t/recuperer-le-token-et-l-encryptor-de-ses-appareils-xiaomi-avec-mi-home-vevs/1366) est bon.

#### Donner une zone à nettoyer.

Il est possible de lui faire nettoyer une zone et de voir cette carte. Elle est dans `HACS` `Lovelace Xiaomi Vacuum Map Card` mais n’ayant pas vraiment besoin chez moi je regarderais plus tard et le rajouterais sur l’article.

Si vous l’avez fait, n’hésitez pas à le partager.

## Conclusion.

L’aspirateur est maintenant intégré à votre domotique, vous pourrez créer une multitude de scenarios comme par exemple, le faire tourner quand personne n’est à la maison ou que Mr et Mme sont au travail.

## Une question, un problème

[Besoin d'aide ? Cliquez ici !](https://forum.hacf.fr/new-topic?title=Titre+de+votre+probl%C3%A8me&body=%23%23+Mon+probl%C3%A8me%0D%0A%0D%0A%2ARenseigner+votre+probl%C3%A8me%2A%0D%0A%0D%0A%23%23+Le+tutoriel+d%27origine%0D%0A%0D%0Ahttps%3A%2F%2Fforum.hacf.fr%2Ft%2Fajouter-laspirateur-roborock-s50-de-chez-xiaomi%2F222%0D%0A%0D%0A%23%23+Ma+configuration%0D%0A ___%0D%0A%5Bcenter%5DTexte+%C3%A0+remplacer+par+votre+configuration%5B%2Fcenter%5D%0D%0AComment+r%C3%A9cup%C3%A9rer+ma+configuration+%3A%0D%0ADans+votre+HA%2C+Menu+lat%C3%A9ral+%60Configuration%60+%3E+%60Info%60+%3E+bouton+copier+%3E+%60Pour+Github%60%0D%0A+++%21%5Bimage%7C648x167%2C+75%25%5D%28upload%3A%2F%2F1ietIxFU6nXP1GFrJTzwc2mh0j2.png%29%0D%0A___ %26category%3Dentraide-home-assistant%26tags%3Daide)

## Annexes

### Sources

- [Home Assistant (Officiel) vacuum](https://www.home-assistant.io/integrations/vacuum/),
- [Vacuum Card](https://github.com/benct/lovelace-xiaomi-vacuum-card),

### To do :

- Ajouter la carte avec l’aspiration par pièce.
- [GitHub - PiotrMachowski/lovelace-xiaomi-vacuum-map-card: This card provides a user-friendly way to fully control map-based vacuums in Home Assistant. Supported brands include Xiaomi (Roborock/Viomi/Dreame/Roidmi/Valetudo/Valetudo RE), Neato, Wyze, Roomba, Ecovacs (and probably more). · GitHub](https://github.com/PiotrMachowski/lovelace-xiaomi-vacuum-map-card#hints)
- [GitHub - calas80/Xiaomi-Vacuum-Package: Pacchetto per l'integrazione dei vacuum Xiaomi in Home Assistant comprensivo di Card · GitHub](https://github.com/calas80/Xiaomi-Vacuum-Package/)
- [~~Root de l’aspirateur (pour ne plus utiliser l’application Xiaomi)~~](https://forum.hacf.fr/t/root-des-aspirateurs-xiaomi-pour-se-liberer-du-cloud-avec-valetudo/635)

## Suivi des modifications

- _04/02/2021_ : Passage en article officiel (:hacf_tuto: ) @Clemalex
- _10/07/2020_ : Ajout des scripts par pièces. merci Royto. (McFly)
- _05/07/2020_ : Ajout des Roborock compatibles et de sa config lovelace. merci Royto. (McFly)
- _12/05/2020_ : Création de l’article

---

<div class="post-metadata">

**Author:** ![oncleben31](https://forum.hacf.fr/user_avatar/forum.hacf.fr/oncleben31/32/107_2.png) [@oncleben31](https://forum.hacf.fr/u/oncleben31)\
**Post date:** [Juillet 5, 2020, 10:24 UTC](https://forum.hacf.fr/t/ajouter-laspirateur-roborock-s50-de-chez-xiaomi/222/2 "2020-07-05T22:24:19Z")

</div>

Merci à Royto pour la découverte de la carte Lovelace.

Pour info j’ai dans ma conf tout un système d’automatisation de la routin de quotidienne de nettoyage. [Les explication en anglais](https://github.com/oncleben31/home-assistant-config/wiki/Daily-cleaning-with-vacuum-robot), faudrait que je la traduise à moins qu’un volontaire se présente pour la traduction.

---

<div class="post-metadata">

**Author:** ![Clemalex](https://forum.hacf.fr/user_avatar/forum.hacf.fr/clemalex/32/3691_2.png) [@Clemalex](https://forum.hacf.fr/u/Clemalex)\
**Post date:** [Février 4, 2021, 8:16 UTC](https://forum.hacf.fr/t/ajouter-laspirateur-roborock-s50-de-chez-xiaomi/222/3 "2021-02-04T20:16:10Z")

</div>

A fermé ce sujet (le Février 4, 2021, 8:16 UTC)