Integración domótica Emporia Vue, gratuita y de código abierto
Monitores Emporia Vue, enchufes y cargadores Emporia: potencia y energía por circuito.
Publicado por guim31
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.1.0
- ★ 0
Presentación
Esta integración trae a Gladys los monitores de energía Emporia Vue (Vue 2, Vue 3 y sus sensores por circuito), los enchufes inteligentes Emporia y los cargadores de vehículos eléctricos Emporia, a través de la nube de Emporia — la misma cuenta que la app Emporia Energy.
- Potencia de toda la vivienda y de cada circuito (hasta 16 por Vue), actualizada cada minuto.
- Índices de energía acumulados (kWh), total y por circuito, que Gladys convierte en consumo y coste por media hora en su seguimiento de energía.
- Producción solar y exportación a la red cuando el Vue está configurado para solar.
- Enchufes: encendido/apagado, potencia, energía. Cargadores: estado del conector y de la carga, potencia, energía y — solo si usted lo autoriza — encendido/apagado y corriente objetivo.
- Un widget del panel, un disparador y una acción de escena.
Desarrollada sin el hardware: sus comentarios son bienvenidos. Sin relación con Emporia Energy.
Requisitos
- Gladys Assistant 5.1.0 o posterior (los contratos de energía y el cálculo del coste llegan con Gladys 5.2).
- Una cuenta Emporia con correo electrónico y contraseña, cuyos dispositivos estén configurados en la app Emporia Energy. Las cuentas con inicio de sesión de Google o Apple, y las cuentas con autenticación multifactor (MFA), no son compatibles.
- Acceso a Internet desde Gladys: todo pasa por la nube de Emporia, no hay API local.
Configuración
- En Gladys, abra Integraciones → Instalar desde GitHub e instale
https://github.com/guim31/gladys-emporia, o busque Emporia Vue en el catálogo. - Introduzca el correo y la contraseña de su cuenta Emporia y guarde. El estado pasa a conectado en cuanto Emporia los acepta.
- Idioma de los nombres de funciones: francés por defecto; los nombres se fijan al añadir un dispositivo.
- Permitir controlar los cargadores: desactivado por defecto (ver más abajo).
- Abra la pestaña Descubrimiento y añada los dispositivos que desee. No se lee nada de Emporia para un dispositivo que usted no ha añadido.
La contraseña permanece en la configuración de Gladys; los tokens de sesión se guardan en el
volumen /data de la integración, para que un reinicio no vuelva a iniciar sesión.
Dispositivos
Emporia Vue
Un dispositivo de Gladys por Vue, con el nombre de la app Emporia.
| Función | Tipo | Unidad |
|---|---|---|
| Potencia total | energy-sensor / power | W |
| Índice total | energy-sensor / index | kWh |
| Circuito – potencia (una por circuito) | energy-sensor / power | W |
| Circuito – índice (uno por circuito) | energy-sensor / index | kWh |
| Potencia no medida | energy-sensor / power (con signo) | W |
| Potencia de la red (Vue solar) | grid-sensor / power (con signo) | W |
| Índice de importación (Vue solar) | energy-sensor / index | kWh |
| Índice de exportación (Vue solar) | grid-sensor / output-index | kWh |
| Circuito – producción (solar) | energy-production-sensor / power | W |
| Circuito – índice de producción | energy-production-sensor / index | kWh |
Los circuitos llevan los nombres de la app Emporia; un circuito sin nombre se llama «Circuito n», y dos circuitos con el mismo nombre reciben su número. La potencia no medida es lo que los sensores de circuito no ven (acometida menos circuitos).
Enchufes
Encendido/apagado (controlable), potencia (W) e índice de energía (kWh).
Cargadores
| Función | Valores |
|---|---|
| Conector | disponible, ocupado (vehículo enchufado), no disponible, con fallo |
| Estado de carga | cargando, vehículo conectado, en pausa por el vehículo o el cargador |
| Cargador activado | encendido/apagado |
| Corriente objetivo | de 6 A al máximo del cargador |
| Potencia de carga | W |
| Índice | kWh |
El control de los cargadores está desactivado por defecto: Cargador activado y Corriente objetivo son de solo lectura, y se rechaza cualquier orden. Active Permitir controlar los cargadores en la configuración y luego use Actualizar en la pestaña Descubrimiento para hacerlos controlables. Una orden equivocada puede detener una carga que usted necesita por la mañana: piénselo antes de automatizarla.
Seguimiento de energía y signo de los valores
Emporia da la energía de un periodo, no un índice de contador. La integración construye el
índice: la suma de los días terminados, releídos en Emporia al final de cada día, más la energía
del día en curso. Así el índice coincide con la app Emporia, nunca retrocede y recupera los días
perdidos mientras Gladys estaba parado (31 días como máximo). Se actualiza cada 5 minutos y se
guarda en /data/energy.json.
Gladys deriva de cada índice el consumo por media hora y el coste (seguimiento de energía de Gladys 5.x). En los ajustes de energía, elija el Índice total (o el Índice de importación de un Vue solar) como contador principal; los índices de los circuitos, enchufes y cargadores pasan a ser subcontadores. Un enchufe o un cargador conectado a un circuito medido también se cuenta en ese circuito: organice la jerarquía para no contarlo dos veces.
Convenciones de signo:
- Emporia informa la generación en negativo. Un circuito de tipo Solar/Generation se publica como producción positiva (potencia e índice de producción).
- En un Vue solar, la acometida es el intercambio neto con la red: la Potencia de la red es positiva al importar y negativa al exportar. El índice de consumo viene entonces del canal de importación y la exportación del canal de exportación, cuando Emporia los proporciona.
- Un circuito bidireccional (una batería…) conserva su signo y no tiene índice, porque su total diario puede ser negativo. Lo mismo para la potencia no medida.
- Cualquier otro circuito se publica en positivo, como lo muestra la app Emporia.
Widget
Potencia Emporia muestra la potencia total de un Vue (en directo), su producción solar si la tiene, y los cinco circuitos que más consumen en este momento, con su parte del total (salvo en un Vue solar, cuya acometida es un intercambio neto). Elija el Vue en los ajustes del widget; vacío, muestra el primer Vue añadido a Gladys.
Disparador de escena
Dispositivo Emporia sin conexión o de vuelta: un Vue, un enchufe o un cargador perdió (o recuperó) su enlace con la nube de Emporia. Sin conexión, sus mediciones se detienen: nada más en Gladys se lo indica. Filtros: el dispositivo y el cambio (se desconecta / vuelve a conectarse). Variables: nombre del dispositivo, nuevo estado.
Acción de escena
Energía Emporia del día: para el dispositivo elegido, devuelve la energía tomada de la red hoy (kWh), la producción solar de hoy (kWh), el circuito que más consumió hoy y su energía, y la potencia actual (W). Los valores vienen de las últimas mediciones (5 minutos como máximo).
La configuración ofrece también un botón Listar mis dispositivos Emporia, que muestra lo que contiene la cuenta (Vue con su número de circuitos, enchufes, cargadores).
Ejemplos de escenas
- Resumen de la noche: cada día a las 21:00 → Energía Emporia del día en el Vue → enviar el mensaje «Hoy: {{energy_today_kwh}} kWh de la red, {{production_today_kwh}} kWh solares; primero: {{top_circuit}} ({{top_circuit_kwh}} kWh)».
- Aparato olvidado: cuando Oven – potencia se mantiene por encima de 1500 W y no hay nadie en casa → notificar.
- Medición a ciegas: cuando el Vue se desconecta → enviar «El Emporia Vue ya no informa, compruebe su Wi-Fi».
- Excedente solar: cuando la Potencia de la red baja de −1500 W (exportación) → encender el enchufe del calentador de agua.
Actualización y uso de la API de Emporia
La API de Emporia no es pública y no tiene cuota publicada; la integración se mantiene cerca de lo que hacen la app Emporia y la integración de Home Assistant:
- cada minuto, una petición para la potencia de todos los canales de todos los dispositivos
(
getDeviceListUsages, media de 1 minuto) y una para enchufes, cargadores y conexión; - cada 5 minutos, una petición para la energía del día (y una por cada día terminado que cerrar);
- cada hora, la lista de dispositivos (nombres, circuitos).
No se lee nada mientras no haya ningún dispositivo Emporia añadido a Gladys. Solo se envían a Gladys los valores que cambian, más un valor sin cambios cada 6 horas para que nunca parezca antiguo. Una contraseña rechazada nunca se vuelve a intentar sola, para no bloquear la cuenta.
Solución de problemas
- «Emporia rechaza este correo o esta contraseña»: compruébelos en la app Emporia y guarde de nuevo la configuración (es lo que lanza un nuevo intento).
- «Su cuenta Emporia pide un paso…»: MFA o cambio de contraseña obligatorio. Inicie sesión una vez en la app Emporia; una cuenta con MFA no se puede usar.
- «La nube de Emporia no responde»: la integración lo vuelve a intentar cada minuto e indica cuando funciona de nuevo; compruebe el acceso a Internet de Gladys y el estado de Emporia en su app.
- Un circuito no tiene valor: Emporia no envía mediciones de un sensor sin uso. Nombre y configure el circuito en la app Emporia.
- Nombres en el idioma equivocado: cambie el idioma, luego elimine y vuelva a añadir el dispositivo (los nombres se fijan al crearlo).
- Registros: la página de la integración los muestra;
LOG_LEVEL=debugdetalla cada ciclo.
Limitaciones
- Desarrollada sin el hardware ni una cuenta Emporia: probada contra el comportamiento publicado de la API (PyEmVue y su simulador), no contra dispositivos reales. Sus comentarios son bienvenidos.
- Solo nube: ninguna medición cuando Internet o la nube de Emporia fallan. La potencia por minuto es una media de 1 minuto, no un valor instantáneo.
- El índice se actualiza cada 5 minutos, no se lee durante los primeros 30 minutos después de medianoche (la API de Emporia puede responder todavía el día anterior), y una parada de más de 31 días pierde los días anteriores.
- En un Vue solar cuyo canal de importación no proporciona Emporia, no hay índice de consumo para toda la vivienda (los circuitos conservan el suyo).
- Las cuentas con inicio de sesión de Google, Apple o MFA no son compatibles. Las baterías, termostatos y vehículos de Emporia no son compatibles.
- Sin relación con Emporia Energy; «Emporia» y «Vue» son sus marcas.
Parámetros de configuración
Estos son los parámetros que Emporia Vue te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Su cuenta Emporia | section | No | Utilice el correo y la contraseña de la app Emporia Energy. La integración lee la nube de Emporia una vez por minuto. Las cuentas con inicio de sesión de Google o Apple, o protegidas por MFA, no son compatibles. Sin relación con Emporia Energy. |
| Correo electrónico | string | Sí | |
| Contraseña | secret | Sí | |
| Idioma de los nombres de funciones | select | No | Los nombres se fijan al añadir un dispositivo a Gladys. |
| Permitir controlar los cargadores | boolean | No | Desactivado: los cargadores son de solo lectura. Activado: Gladys puede apagarlos y ajustar la corriente objetivo (6 A mínimo). |
Cómo instalar Emporia Vue en Gladys
- En Gladys, abre Integraciones: Emporia Vue aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/guim31/gladys-emporia:1.0.1), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-emporia.
Emporia Vue requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
Emporia Vue es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene guim31, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación