Skip to content

Opcions de configuració ​

A Home Assistant, cada aspiradora robot configurada correctament es desa com una entrada d'integració independent. Automàticament, es crea un dispositiu corresponent i s'associa a aquesta entrada, exposant les entitats, serveis i dades del mapa de l'aspiradora. Les opcions de configuració permeten l'accés a la configuració per dispositiu, cosa que permet personalitzar el comportament de cada entrada d'integració de manera independent.

Opcions de configuracióOpcions de configuració

Aquestes configuracions es poden accedir immediatament durant el procés de configuració inicial com a pas final després de completar la configuració per al tipus de connexió seleccionat (just abans d'afegir el dispositiu a Home Assistant). També es poden modificar en qualsevol moment posterior des de la pàgina Integrations de Home Assistant fent clic al botó Configure situat a la part superior dreta de la targeta del dispositiu.

Clau de Dreame Vacuum Card ​

Un camp opcional per a una clau de llicència Targeta Aspiradora Dreame. Quan s'introdueix una clau vàlida, la integració activa automàticament la targeta personalitzada incrustada i la posa a disposició entre les targetes personalitzades del tauler. Si s'introdueix una clau no vàlida, la targeta romandrà en mode de vista prèvia al tauler.

Activació d'un sol dispositiu

Cada clau de llicència està estrictament limitada a un únic dispositiu. Un cop una clau ha estat activada, queda permanentment vinculada a aquest dispositiu específic i no es pot utilitzar per activar la targeta en cap altre dispositiu.

Nota

Aquest camp és completament opcional. Si es deixa buit, la targeta personalitzada incrustada encara es pot afegir a un tauler, però funcionarà en mode de vista prèvia. Sempre es pot obtenir una clau vàlida més endavant directament a través de la interfície de la targeta en mode de vista prèvia.

Notificacions ​

Seleccioneu quines categories de notificacions persistents la integració pot crear per a aquest dispositiu. Desmarcar una categoria la desactiva completament, fins i tot si l'esdeveniment subjacent del dispositiu encara es produeix.

  • Neteja Completa (cleanup_completed): Generat cada vegada que una tasca de neteja s'acaba amb èxit.
  • Consumible (consumable): Generat quan la vida útil d'un consumible està baixa o quan un component requereix manteniment.
  • Informació (information): Generat per a esdeveniments informatius generals i actualitzacions d'estat.
  • Advertència (warning): Generat quan el dispositiu troba errors que es poden resoldre o problemes menors.
  • Error (error): Generat quan el dispositiu experimenta un error crític o un error de maquinari.

Més informació sobre la funció de notificacions

Aplicació Companion

Per defecte, les notificacions persistents només es mostren dins del tauler de Home Assistant. No es poden enviar directament a l'aplicació Home Assistant Companion en un dispositiu mòbil perquè es requereix un ID específic del dispositiu de notificació. Per rebre notificacions push en un dispositiu mòbil, cal crear un automació personalitzada que escolti els esdeveniments de la integració o segueixi les notificacions persistents generades, i després les reenviï al dispositiu mòbil específic.

Opcions de visualització del mapa Suport de Mapes ​

La configuració següent només està disponible per a dispositius configurats amb un compte al núvol (DreameHome, MovaHome, TROUVER o Xiaomi Home), ja que tots depenen de les dades del mapa:

Targeta Aspiradora Dreame

Les configuracions següents només s'apliquen a l'entitat de càmera de mapa generada. El Targeta Aspiradora Dreame mostra de manera nativa el seu propi mapa i pot anul·lar de manera independent l'Esquema de Colors i el Conjunt d'Icònes a través del seu configuració avançada. Les opcions Imatge de Mapa Quadrada i Imatge de Mapa de Baixa Resolució no tenen cap efecte en la targeta personalitzada, així que és molt recomanable habilitar Imatge de Mapa de Baixa Resolució per estalviar memòria.

Esquema colors ​

Selecciona la paleta de colors utilitzada a l'hora de generar la imatge del mapa.

  • Dreame Light (dreame_light): Tema oficial de l'aplicació Dreame.
  • Dreame Dark (dreame_dark): Tema fosc exclusiu de la integració dreame_vacuum.
  • Mijia Light (mijia_light): Tema clar oficial de l'aplicació Xiaomi Mi Home.
  • Mijia Dark (mijia_dark): Tema fosc oficial de l'aplicació Xiaomi Mi Home.
  • Escala de Grisos (grayscale): Un tema de mapa monocromàtic sense colors.
  • Transparente (transparent): Genera el sòl, les parets i el farciment de les habitacions completament transparent, útil per superposar el mapa sobre un fons personalitzat.

Veure els esquemes de colors disponibles a Suport de Mapes

Conjunt d'icones ​

Selecciona l'estil d'icona utilitzat per als marcadors del mapa, com el robot, el carregador i els mobles, coincidint amb els conjunts d'icones de les aplicacions oficials.

  • Dreame (dreame): Conjunt d'icones de l'aplicació Dreame oficial.
  • Dreame Old (dreame_old): Conjunt d'icones de l'antiga aplicació Dreame.
  • Mijia (mijia): Conjunt d'icones de l'aplicació Xiaomi Mi Home oficial.
  • Material (material): Icones de Material Design incorporats a Home Assistant.

Objectes del mapa ocults ​

Selecciona quins elements del mapa s'exclouen de la imatge del mapa generada. Això és útil per simplificar el mapa o amagar informació que no es necessiti per a un tauler específic.

Objectes disponibles
  • Room Colors (color): El color de farciment distintiu per a cada habitació.
  • Room Icons (icon): La icona de l'habitació basada en el seu tipus.
  • Room Names (name): Les etiquetes de text per als noms de les habitacions.
  • Room Name Background (name_background): El fons en forma de píndola darrere dels noms de les habitacions amb el seu color associat.
  • Ordre de la Habitació (order): Les insígnies numerades que indiquen la seqüència de neteja.
  • Nivell d'Aspror de l'Habitació (suction_level): La icona que indica el nivell d'aspror configurat de l'habitació.
  • Volum d'Aigua de l'Habitació (water_volume): La icona que indica el volum d'aigua configurat de l'habitació.
  • Vegades de Neteja de l'Habitació (cleaning_times): La insígnia que indica quantes vegades es netejarà l'habitació.
  • Mode de Neteja de l'Habitació (cleaning_mode): La icona que indica el mode de neteja configurat de l'habitació (escombrat, fregat o ambdós). (Només en dispositius compatibles)
  • Mode de Fregatge de l'Habitació (mopping_mode): La icona que indica el tipus de mopa configurat de l'habitació. (Només en dispositius compatibles)
  • Camí (path): El camí que mostra on ha netejat el robot.
  • Zones Prohibides (no_go): Zones restringides.
  • Zones de No Fregat (no_mop): Zones de fregat restringides.
  • Paret Virtual (virtual_wall): Una paret virtual afegida per evitar que el robot creui.
  • Llindars Virtuals (pathway): Llindars definits que el robot ha de creuar amb cura. (Només en dispositius compatibles)
  • Àrees Actives (active_area): La caixa delimitadora dibuixada durant la neteja per zones.
  • Punts Actius (active_point): Punts de neteja puntuals que mostren una àrea de 1,5 m².
  • Icona del Carregador (charger): La icona de l'estació base.
  • Icona del Robot (robot): La icona que representa el robot mateix.
  • Direcció de Neteja (cleaning_direction): La fletxa que indica la direcció en què el robot està netejant actualment.
  • Obstacle AI (obstacle): Icones d'obstacles detectats per IA com sabates i cables. (Només en dispositius compatibles)
  • Mascota (pet): Obstacles detectats com a mascota. (Només en dispositius compatibles)
  • Àrea de Catifa (carpet): Texture de catifa. (Només en dispositius compatibles)
  • Material del Sòl (material): La textura del material del sòl de l'habitació, com fusta o rajola. (Només en dispositius compatibles)
  • Zones Baixes (low_lying_area): Zones baixes on el robot entra abaixant el seu escàner LiDAR. (Només en dispositius compatibles)
  • Mobles (furniture): Mobles 3D o 2D. (Només en dispositius compatibles)
  • Rampa (ramp): Rampes situades a l'entorn. (Només en dispositius compatibles)
  • Cortina (curtain): Cortines. (Només en dispositius compatibles)
  • Punts de Creuer (cruise_point): Anar a punts d'operació. (Només en dispositius compatibles)

Imatge de Mapa Quadrada ​

Força la imatge de la càmera del mapa generada a tenir una proporció quadrada 1:1 en lloc del quadre delimitador natural del mapa, el que pot ser útil per a dissenys de taulers que esperen una imatge quadrada.

Imatge de Mapa de Baixa Resolució ​

Genera la imatge de la càmera del mapa amb una resolució reduïda per disminuir l'ús de memòria i accelerar les actualitzacions.

Limitacions de Memòria

La generació de mapes grans pot requerir una quantitat significativa de memòria. Si Home Assistant falla i es reinicia en navegar a la pàgina del dispositiu o en accedir a l'entitat de la càmera del mapa, és molt probable que sigui per falta de memòria. Habilitar aquesta opció normalment resol el problema.

Nota

Habilitar aquesta opció també desactiva l'entitat de càmera Mapes WiFi Guarda, ja que no està disponible en baixa resolució.

Preferir el núvol ​

Només disponible per a dispositius configurats amb un compte Xiaomi Home. Aquesta configuració permet actualitzar la preferència seleccionada originalment durant el pas de configuració inicial.

  • Quan està activat: Obliga tota la comunicació a través del núvol. Això és necessari per a dispositius més nous on Xiaomi ha desactivat les capacitats d'accés local, o quan el dispositiu i Home Assistant es troben en subxarxes diferents.
  • Quan està desactivat (recomanat per a configuracions compatibles): La integració estableix una connexió local directa amb el dispositiu (mentre encara gestiona automàticament la renovació del token i de la IP des del núvol). Això manté totes les comunicacions (excepte les dades del mapa) completament locals.

Provar la disponibilitat de l’API local

Aquesta opció proporciona una manera molt útil de provar la connectivitat local. Per assegurar que la configuració inicial del dispositiu tingui èxit sense errors, Preferir el núvol pot quedar activada durant el flux de configuració. Un cop el dispositiu s’afegeix correctament a Home Assistant, es pot desactivar aquesta opció aquí per comprovar si el dispositiu realment admet l’API local. Si el dispositiu es torna inaccessiblement després de desactivar-lo, simplement torneu-lo a activar per tornar a la connexió al núvol.

YAML Per Referència ​

yaml
dreame_vacuum:
  # Local connection
  host: 192.168.1.100
  token: b2a1c3d4e5f6a7b8c9d0e1f2a3b4c5d6

  # Cloud connection
  username: your@email.com
  password: your_password
  country: de
  prefer_cloud: true # Only available on Xiaomi Home

  # Options available regardless of connection type
  dvc_key: 123e4567-e89b-42d3-a456-426614174000
  notify:
    - information
    - warning
    - error

  # Options available only with map support (Cloud)
  color_scheme: dreame_dark
  icon_set: dreame_old
  hidden_map_objects:
    - name_background
    - name
    - order
  square: true
  low_resolution: true