Instalación y Uso

Esta guía explica cómo poner en funcionamiento la Tarjeta Dreame Vacuum en el panel de Home Assistant. Cubre los requisitos previos para la integración, los pasos para agregar la tarjeta a los paneles existentes e instrucciones para configurar el Modo Panel recomendado. El Modo Panel ofrece la mejor experiencia posible al utilizar toda la pantalla, siendo especialmente potente en tablets y monitores de escritorio.

---

La Tarjeta Dreame Vacuum está integrada como una parte central del Integración de Dreame Vacuum con Home Assistant. No es una tarjeta independiente que se instala por separado.

Para usar esta tarjeta, debe estar instalada la dreame_vacuum versión de integración v2.0.0 o superior, que incluye la tarjeta integrada.

Requisito previo

Si la integración Dreame Vacuum ya está instalada, este paso se puede ignorar con seguridad.

Si aún no está instalado, la forma más fácil de conseguirlo es a través de HACS. La integración Dreame Vacuum se puede buscar en HACS > Integrations y descargar la versión v2.0.0 o superior. Home Assistant debe reiniciarse después de la descarga. Una vez configurada la integración, la tarjeta estará disponible automáticamente para los tableros.

Optimización de entidades

La tarjeta está diseñada para operar utilizando únicamente las entidades vacuum, sensor.cleaning_history, sensor.cruising_history y camera.map. Obtiene todo lo que necesita directamente de estas cuatro entidades principales. Como resultado, todas las demás entidades de la página del dispositivo, incluidas las entidades de mapa guardadas, se pueden desactivar de manera segura para mantener Home Assistant limpio.

Para reducir aún más la carga en la instancia de Home Assistant apagando la generación de imágenes del lado del servidor, se puede desactivar la entidad camera.map y en su lugar habilitar la entidad camera.map_data. La tarjeta detectará esto automáticamente y mostrará todos los mapas directamente en el navegador. Como mínimo, la tarjeta puede funcionar solo con la entidad vacuum habilitada. Aunque el mapa no se dibuje en este estado, todas las funciones que no están relacionadas con el mapa, como las configuraciones de limpieza, las acciones de la base y los controles básicos, seguirán siendo totalmente accesibles y utilizables.

Añadiendo la tarjeta a tu panel

Para añadir la Tarjeta de Aspiradora Dreame al panel de Home Assistant:

1. Se abre Home Assistant y se navega al panel deseado.
2. Se hace clic en el icono Editar panel () en la esquina superior derecha.
3. Se hace clic en el botón Añadir tarjeta () en la esquina inferior derecha.
4. En el selector de tarjetas, se busca y selecciona Personalizado: Tarjeta de Aspiradora Dreame.
5. En el editor de tarjetas, se selecciona la Entidad de la Aspiradora Dreame, tal como vacuum.l10s_gen2.
6. Se hace clic en Guardar para añadir la tarjeta al panel de control.

Uso del Modo Panel (Recomendado)

Para la mejor experiencia de usuario, especialmente dado el extenso editor de mapas y las funciones de la Tarjeta de la Aspiradora Dreame, se recomienda encarecidamente usar el Modo Panel de Home Assistant. El Modo Panel permite que una sola tarjeta ocupe toda la pantalla de una vista del panel de control.

La tarjeta detecta automáticamente cuando se coloca en una vista de panel y elimina su color de fondo y bordes externos para integrarse perfectamente con el tema del panel de control. Además, todos los elementos internos de la interfaz de usuario son completamente conscientes del panel y adaptarán sus diseños para utilizar el espacio de pantalla ampliado.

Configuración de Vista de Tarjeta Única en Panel

1. Se abre el panel deseado y se hace clic en el icono Editar panel () en la esquina superior derecha.
2. Se hace clic en el icono Agregar vista () junto a las pestañas de vista del panel en la parte superior.
3. En el cuadro de diálogo “Agregar vista”, Panel, se selecciona la opción de tarjeta única en el menú desplegable Diseño.
4. Se proporciona un Título opcional, como “Aspiradora”, y un Icono, como mdi:robot-vacuum.
5. Se hace clic en Guardar.
6. Se hace clic en el botón Añadir tarjeta () en la esquina inferior derecha.
7. En el selector de tarjetas, se busca y selecciona Personalizado: Tarjeta de Aspiradora Dreame.
8. En el editor de tarjetas, se selecciona la Entidad de la Aspiradora Dreame, tal como vacuum.l10s_gen2.
9. Se hace clic en Guardar para añadir la tarjeta al panel de control.

Navegación nativa del navegador

Cuando se usa en Modo Panel o cuando es la única tarjeta en una vista, la tarjeta maneja de forma nativa la navegación del navegador. Se puede usar el botón Atrás físico del dispositivo o los gestos de deslizamiento para cerrar cuadros de diálogo, descartar menús o regresar, actuando exactamente como el propio botón de retroceso de la tarjeta. Esto es especialmente útil en dispositivos móviles. Para mantener una experiencia de usuario estable, la tarjeta solo intercepta las acciones de "atrás" y no maneja la navegación hacia adelante.