Introduction à la carte Lovelace Xiaomi Vacuum Map

La carte Lovelace Xiaomi Vacuum Map est un composant essentiel pour Home Assistant, offrant une interface de contrôle graphique et intuitive pour de nombreux aspirateurs robots cartographiques. Conçue pour simplifier la gestion des robots nettoyeurs, cette carte permet aux utilisateurs de piloter des appareils de marques telles que Xiaomi, Roborock, Viomi, Dreame, Roidmi, Valetudo (et RE), Neato, Wyze, Roomba, et Ecovacs, en proposant des fonctionnalités avancées comme le nettoyage de zone, la navigation ponctuelle ou la définition de chemins spécifiques.

Prérequis

Avant de procéder à l'installation et à la configruation, assurez-vous que les prérequis suivants sont satisfaits :

• Une instance de Home Assistant version 2021.12 ou ultérieure est opérationnelle.
• L'intégration de votre aspirateur robot (Xiaomi, Roborock, Viomi, Dreame, etc.) est déjà configurée dans Home Assistant.
• Une compréhension élémentaire de la syntaxe YAML est recommandée.

Installation du Composant

Pour intégrer la carte Xiaomi Vacuum Map à votre interface Lovelace, suivez ces étapes :

1. Téléchargement du fichier de la carte

Commencez par récupérer les fichiers du projet. Vous pouvez cloner le dépôt Git officiel et placer le fichier xiaomi-vacuum-map-card.js dans votre dossier /config/www/lovelace-xiaomi-vacuum-map-card/ (créez les dossiers si nécessaire) :

git clone https://gitcode.com/gh_mirrors/lo/lovelace-xiaomi-vacuum-map-card
# Copiez ensuite le fichier xiaomi-vacuum-map-card.js depuis le répertoire cloné
# vers votre dossier Home Assistant /config/www/lovelace-xiaomi-vacuum-map-card/

Alternativement, vous pouvez télécharger le fichier xiaomi-vacuum-map-card.js directement depuis le dépôt et le placer manuellement dans le chemin indiqué.

2. Déclaration de la ressource Lovelace

Une fois le fichier en place, vous devez déclarer cette nouvelle ressource dans votre configuration Lovelace. Ajoutez la section suivante à votre fichier configuration.yaml ou directement via l'interface utilisateur de Home Assistant (Paramètres > Tbaleaux de bord > Ressources) :

lovelace:
  resources:
    - url: /local/lovelace-xiaomi-vacuum-map-card/xiaomi-vacuum-map-card.js
      type: module

3. Ajout de la carte à un tableau de bord

Ouvrez votre tableau de bord Lovelace, passez en mode édition et ajoutez une nouvelle carte. Sélectionnez l'option 'Manuel' (ou 'Manuelle') et insérez la configuration de base suivante :

type: custom:xiaomi-vacuum-map-card
entity: vacuum.votre_aspirateur_robot # Remplacez par l'ID de votre entité aspirateur
map_source:
  camera: camera.extracteur_carte_xiaomi # Remplacez par l'ID de votre entité caméra de carte

L'entité camera.extracteur_carte_xiaomi est généralement fournie par l'intégration Xiaomi Cloud Map Extractor, essentielle pour visualiser les cartes.

Fonctionnalités et utilisation de l'interface

Une fois la carte correctement intégrée, votre tableau de bord affcihera une interface de contrôle enrichie pour votre aspirateur robot. Les éléments clés de cette interface comprennent :

• Carte en temps réel : Visualisation dynamique de la position de votre robot et de son progression de nettoyage.
• Sélection des modes de nettoyage : Accès rapide à différentes stratégies de nettoyage (par zone, par pièce, ponctuel, etc.).
• Surveillance de l'état : Affichage des informations vitales telles que le niveau de batterie, la vitesse du ventilateur et l'autonomie restante des consommables.

Modes de nettoyage avancés

La carte Lovelace Xiaomi Vacuum Map offre plusieurs modes de nettoyage, accessibles via un sélecteur intuitif. Voici les principaux :

• Nettoyage de zone (Zone cleanup) : Permet de définir une ou plusieurs zones rectangulaires sur la carte que le robot devra nettoyer spécifiquement.
• Nettoyage par pièce (Rooms) : Idéal pour nettoyer des pièces prédéfinies ou détectées par le robot.
• Aller à un point (Pin & Go) : Envoie le robot à un emplacement précis sur la carte pour un nettoyage localisé ou pour qu'il s'y rende simplement.
• Définition de chemin (Path) : Offre la possibilité de tracer un chemin personnalisé que le robot suivra pour le nettoyage.

Configuration avancée : Définition de zones et chemins

Pour exploiter pleinement les fonctionnalités de nettoyage par zone ou par chemin, vous aurez besoin de récupérer les coordonnées spécifiques de votre carte. Voici comment procéder :

1. Activez le mode édition de votre tableau de bord Home Assistant.
2. Ouvrez l'éditeur de la carte Xiaomi Vacuum Map.
3. Dans les options de la carte, choisissez la plateforme de configuration correspondant à votre marque d'aspirateur (celle qui gère l'extraction des coordonnées, souvent en format entier ou décimal).
4. Utilisez l'interface graphique pour marquer et sélectionner les zones ou points souhaités sur la carte.
5. Cliquez sur le bouton "Copier" ou "Obtenir les coordonnées" pour récupérer la chaîne de caractères JSON ou YAML contenant ces données.

Exemple de configuration complète

Voici un exemple de configuration YAML avancée, intégrant la définition de pièces, des points de calibration et des actions de nettoyage rapide :

type: custom:xiaomi-vacuum-map-card
entity: vacuum.mon_roborock_s7 # Assurez-vous que l'entité corresponde à votre robot
map_source:
  camera: camera.extracteur_carte_roborock # L'entité caméra pour la carte
calibration_points:
  - vacuum: [25000, 25000]
    map: [500, 500]
  - vacuum: [25000, 30000]
    map: [500, 1000]
  - vacuum: [30000, 25000]
    map: [1000, 500]
rooms:
  - id: 16
    name: Salon Principal
    icon: mdi:chair-rolling
    label_x: 26000 # Coordonnée X du label de la pièce
    label_y: 26500 # Coordonnée Y du label de la pièce
  - id: 17
    name: Cuisine Équipée
    icon: mdi:food-fork-drink
    label_x: 27000
    label_y: 27500
actions: # Personnalisation des actions et préréglages
  - name: Nettoyage Express Salon
    icon: mdi:speedometer
    service_call:
      service: vacuum.send_command
      service_data:
        entity_id: vacuum.mon_roborock_s7
        command: app_zoned_clean
        params: [[25000, 25000, 27000, 27000, 1]] # Coordonnées de la zone et nombre de passages
  - name: Vider la poubelle
    icon: mdi:trash-can-outline
    service_call:
      service: vacuum.send_command
      service_data:
        entity_id: vacuum.mon_roborock_s7
        command: app_goto_target
        params: [28000, 28000] # Coordonnées pour se rendre à un point précis

Ressources complémentaires

Pour une exploration plus approfondie et pour personnaliser davantage votre carte, n'hésitez pas à consulter les ressources suivantes :

• Documentation des modèles officiels
• Fichiers de localisation linguistique
• Générateurs de configuration de plateforme

Ces liens vous dirigeront vers le dépôt GitHub officiel du projet, où vous trouverez les informations les plus à jour.