Cómo integrar el Levoit Eleva 300X en Home Assistant antes de que llegue el soporte oficial
Si tienes un Levoit Eleva 300X y has intentado integrarlo en Home Assistant, probablemente te hayas encontrado con que la integración oficial de VeSync todavía no reconoce correctamente este modelo. Es precisamente el problema que me encontré cuando empecé a probar este purificador. Después de investigar cómo se comunicaba con la plataforma VeSync, conseguí añadirle soporte a la biblioteca Python que utiliza Home Assistant y preparar los sensores necesarios para mostrar su información. Los cambios ya están propuestos para su incorporación oficial, pero mientras los mantenedores los revisan, he preparado una versión experimental que puedes instalar manualmente en Home Assistant. Y lo mejor es que el procedimiento es bastante sencillo.
En YouTube comparto más tutoriales, pruebas y domótica real. Suscribirme

Vídeo relacionado en YouTube
Video¿Qué podemos hacer con esta integración?
Esta versión añade compatibilidad con el Levoit Eleva 300X europeo, modelo LAP-C341S-WEU, aprovechando la integración VeSync que ya existe en Home Assistant.
El objetivo es que el purificador pueda reconocerse y utilizarse desde Home Assistant, incluyendo sus funciones de control compatibles.
Además, he incorporado cuatro sensores para consultar información del dispositivo:
- Índice de calidad del aire (AQI): permite consultar el valor de calidad del aire comunicado por el purificador.
- Vida útil del filtro de carbón: muestra el porcentaje de vida útil restante.
- Vida útil del prefiltro: permite consultar el estado de mantenimiento del prefiltro.
- Días restantes del filtro: informa de los días de uso estimados que quedan antes de sustituirlo.
Estos sensores se han desarrollado de forma genérica para la integración VeSync. Esto significa que no están limitados exclusivamente al Eleva 300X: otros dispositivos compatibles también pueden utilizarlos cuando proporcionen los datos correspondientes.
Es importante tener en cuenta que VeSync utiliza la nube para comunicarse con el dispositivo. Esta solución no convierte el purificador en un dispositivo de control local ni utiliza Matter.
¿Por qué todavía no está disponible oficialmente?
Para integrar correctamente este modelo hay que modificar dos componentes diferentes.
El primero es pyvesync, la biblioteca Python que se encarga de comunicarse con los dispositivos Levoit y VeSync. Es aquí donde he añadido el reconocimiento y el soporte del Eleva 300X.
El segundo es la integración VeSync de Home Assistant Core, que utiliza esa biblioteca para crear las entidades correspondientes.
He enviado ambos desarrollos a sus respectivos proyectos de código abierto:
Soporte del Eleva 300X en pyvesync:
https://github.com/webdjoe/pyvesync/pull/570
Nuevos sensores de VeSync en Home Assistant Core:
https://github.com/home-assistant/core/pull/189317
Hasta que se acepten y publiquen los cambios necesarios, podemos utilizar una versión provisional preparada a partir de esos desarrollos.
Descargar la integración experimental
He publicado una versión basada en Home Assistant Core 2026.11.2, junto con una versión modificada de pyvesync 3.5.1 que incluye el soporte del Eleva 300X.
Puedes descargarla gratuitamente desde mi GitHub:
DESCARGAR LEVOIT ELEVA 300X PARA HOME ASSISTANT
Dentro de la página encontrarás el archivo:
vesync-eleva-preview-2026.11.2.zip
Esta es una versión experimental preparada específicamente sobre Home Assistant 2026.11.2. No se ha comprobado todavía su compatibilidad con todas las versiones posteriores.
La biblioteca pyvesync modificada ha superado 838 pruebas automatizadas, aunque eso no garantiza que no aparezcan problemas en instalaciones reales.
Antes de instalarla, te recomiendo realizar una copia de seguridad de Home Assistant.
Cómo instalar el Levoit Eleva 300X en Home Assistant
La instalación no requiere HACS, acceso por SSH ni modificar el contenedor Docker de Home Assistant OS.
Únicamente necesitamos acceder a los archivos de configuración de Home Assistant, por ejemplo, mediante Samba o un editor de archivos.
Paso 1. Descargar y descomprimir el archivo
Descarga el ZIP desde el enlace anterior y descomprímelo en tu ordenador.
En su interior encontrarás la carpeta custom_components, que contiene otra carpeta llamada vesync.
Esta última contiene los archivos de la integración.
Paso 2. Copiar la integración a Home Assistant
Accede al directorio de configuración de Home Assistant.
En una instalación de Home Assistant OS, normalmente corresponde a /config.
Dentro de ese directorio debe existir una carpeta llamada custom_components. Si no existe, puedes crearla.
Copia la carpeta vesync que has descargado dentro de custom_components.
La estructura final debe quedar de esta manera:
/config/
└── custom_components/
└── vesync/
├── __init__.py
├── manifest.json
├── sensor.py
├── fan.py
├── config_flow.py
├── translations/
└── ...otros archivosImportante: comprueba que el archivo manifest.json esté directamente dentro de /config/custom_components/vesync/.
No debe quedar una carpeta custom_components adicional dentro de vesync.
Si ya tienes una integración VeSync personalizada en esa ubicación, guarda primero una copia fuera de custom_components y sustituye la carpeta completa, sin mezclar archivos de distintas versiones.
Paso 3. Reiniciar Home Assistant
Una vez copiados los archivos, reinicia Home Assistant.
Al arrancar, Home Assistant detectará que existe una integración personalizada llamada vesync y tratará de cargarla en lugar de la versión incluida oficialmente en Core.
El paquete está preparado para que Home Assistant descargue automáticamente la biblioteca pyvesync modificada desde mi GitHub.
Por tanto, no necesitas instalar manualmente ninguna biblioteca Python.
Eso sí, Home Assistant deberá disponer de acceso a GitHub para poder descargar esa dependencia.
Paso 4. Configurar la integración VeSync
Si todavía no tienes VeSync configurada, entra en:
Ajustes → Dispositivos y servicios → Añadir integración
Busca VeSync y sigue el procedimiento de configuración con tu cuenta.
El Eleva 300X debe estar previamente vinculado a la aplicación VeSync y conectado a Internet.
Si ya tenías configurada la integración VeSync, normalmente podrás conservar la configuración existente y simplemente reiniciar Home Assistant después de copiar los archivos.
Una vez cargada la integración, comprueba si aparece tu purificador y qué entidades están disponibles.
Paso 5. Comprobar los sensores
Entra en el dispositivo correspondiente al Levoit Eleva 300X dentro de Home Assistant.
Además de las entidades de control compatibles, deberías poder consultar los nuevos sensores de calidad del aire y mantenimiento de filtros cuando el dispositivo proporcione sus valores.
Si alguna entidad no aparece, comprueba primero si está deshabilitada.
Ten en cuenta que los sensores solo se crean cuando los atributos correspondientes están disponibles.
¿Qué ocurre si ya tengo otros dispositivos VeSync?
Esta es una cuestión importante.
La carpeta personalizada vesync sustituye temporalmente toda la integración oficial VeSync, no únicamente el soporte del Eleva 300X.
Eso significa que también se encargará de los demás dispositivos que tengas configurados mediante VeSync.
He preparado esta versión utilizando como base la integración incluida en Home Assistant 2026.11.2 e incorporando nuestras modificaciones, pero no puedo garantizar que funcione correctamente con todos los modelos.
Por ese motivo, recomiendo utilizarla únicamente si necesitas probar el Eleva 300X y aceptas los posibles inconvenientes de una versión experimental.
Además, mientras tengas instalada esta carpeta personalizada, las actualizaciones de Home Assistant no actualizarán automáticamente ese código de VeSync.
Cómo volver a la integración oficial
Una de las ventajas de este método es que resulta fácil revertirlo.
Cuando Home Assistant incorpore oficialmente el soporte del Eleva 300X, o si prefieres dejar de utilizar la versión experimental, sigue estos pasos:
- Accede al directorio
/config/custom_components/. - Elimina la carpeta
vesyncque hemos añadido. - Reinicia Home Assistant.
Al retirar esa carpeta, Home Assistant volverá a utilizar la integración VeSync incluida en Core.
Si encuentras algún problema durante el proceso, puedes recurrir a la copia de seguridad realizada antes de instalar la versión experimental.
No es necesario modificar manualmente los archivos internos de Home Assistant OS.
¿Es una integración oficial?
Todavía no.
Esta versión es un desarrollo experimental basado en dos contribuciones que he enviado a los proyectos oficiales de pyvesync y Home Assistant.
El objetivo es que el soporte del Eleva 300X termine formando parte de Home Assistant y no sea necesario instalar ningún parche.
La biblioteca modificada ha pasado las pruebas automatizadas, pero el proceso completo de instalación de este paquete todavía necesita validarse en más sistemas reales.
También hay que recordar que esta integración depende de la nube de VeSync, por lo que su funcionamiento puede verse afectado por cambios en los servicios del fabricante.
¿Dónde comprarlo?
Si te interesa el Levoit Eleva 300X, aquí tienes las opciones de compra disponibles:
Conclusión
El Levoit Eleva 300X es un purificador que podemos aprovechar mucho mejor si conseguimos integrarlo en nuestras automatizaciones de Home Assistant.
Por eso he querido compartir esta versión provisional mientras esperamos que el soporte llegue oficialmente.
Con unos pocos pasos puedes probar la integración, sin tener que modificar Docker, sustituir archivos internos de Home Assistant o instalar dependencias manualmente.
DESCARGAR INTEGRACIÓN EXPERIMENTAL DEL LEVOIT ELEVA 300X
Si decides probarla, cuéntame en los comentarios qué versión de Home Assistant utilizas, si ha reconocido correctamente tu Eleva 300X y si funcionan los controles y sensores.
Así podremos detectar posibles problemas y seguir mejorando el soporte hasta que llegue su integración oficial.
¡Un saludo!
HectorziNo | Domótica y Home Assistant


