Saltar al contenido principal

Integración domótica GE Appliances (SmartHQ), gratuita y de código abierto

Integración GE Appliances (SmartHQ) para Gladys Assistant

GE, Café, Monogram, Haier, Hotpoint vía SmartHQ: ropa, vajilla, frigorífico, climatizadores.

Ver en GitHubTodas las integraciones

Presentación​

Esta integración trae a Gladys los electrodomésticos conectados de GE Appliances, a través de la nube SmartHQ: GE, GE Profile, Café, Monogram, Haier (Estados Unidos) y Hotpoint. Lavadoras, secadoras y lavavajillas muestran su estado, su programa y el tiempo restante; hornos y cocinas su temperatura y sus temporizadores; frigoríficos sus temperaturas, consignas, puertas y filtro de agua; los climatizadores de ventana y portátiles se controlan como cualquier climatizador de Gladys.

Los cambios llegan en unos segundos por la conexión en tiempo real de SmartHQ. Dos disparadores de escena («ciclo terminado», «alerta de un aparato»), una acción de escena (pausar o detener un lavavajillas) y un widget del panel (aparatos en marcha, tiempo restante) completan los aparatos.

La seguridad primero: nada que caliente se inicia nunca a distancia. Hornos, cocinas y calentadores de agua son de solo lectura; un lavavajillas puede pausarse o detenerse, nunca iniciarse; lavadoras y secadoras son de solo lectura.

Desarrollada sin el hardware: sus comentarios son bienvenidos. Esta integración no tiene relación con GE Appliances ni con Haier; GE, SmartHQ, Café, Monogram, Profile y Hotpoint son sus marcas.

Requisitos​

  • Gladys Assistant 5.1.0 o posterior.
  • Aparatos ya vinculados en la aplicación SmartHQ (la aplicación norteamericana de GE Appliances), con su módulo Wi-Fi conectado.
  • El correo electrónico y la contraseña de esa cuenta SmartHQ. Una cuenta protegida por un código de verificación (autenticación de dos factores) también funciona: consulte Configuración.
  • Acceso a Internet desde Gladys: los aparatos GE no tienen API local, todo pasa por la nube SmartHQ.

Configuración​

  1. En Gladys, abra Integraciones, instale GE Appliances (SmartHQ) y abra su pestaña Configuración.
  2. Indique el correo electrónico y la contraseña de su cuenta SmartHQ. Deje la región de la cuenta en «Estados Unidos», salvo si su cuenta se creó en Europa.
  3. Elija la unidad de temperatura (°C por defecto; los aparatos GE funcionan en °F y los valores se convierten) y el idioma de los nombres de las funciones. Elija ambos antes de añadir los aparatos: los nombres y las unidades de un aparato se fijan al añadirlo.
  4. Guarde. El estado pasa a «conectado» y los aparatos aparecen en la pestaña Descubrir: añada los que desee.
  5. Si SmartHQ pide un código de verificación, el estado lo indica. Ejecute la acción Enviar el código de verificación (SmartHQ lo envía por correo electrónico) y luego Introducir el código de verificación con el código recibido, en 15 minutos. La integración conserva después un token de actualización en su volumen privado: no se vuelve a pedir ningún código en el siguiente reinicio.

La acción Probar la conexión enumera los aparatos de la cuenta.

Una contraseña rechazada no se vuelve a intentar hasta que usted la cambie y guarde: los intentos repetidos podrían bloquear la cuenta. Si SmartHQ pide aceptar nuevas condiciones de uso, acéptelas en la aplicación SmartHQ y guarde de nuevo la configuración: la integración nunca acepta condiciones en su lugar.

Los aparatos​

Un aparato de Gladys por cada aparato GE, con el nombre que tiene en SmartHQ. Una función solo se crea si el aparato proporciona el valor que la alimenta.

  • Lavadoras, secadoras, lavadoras-secadoras: estado, programa (nombres de GE, en inglés), tiempo restante, fin previsto, inicio diferido, puerta, alertas (problema de desagüe, salida de la secadora obstruida). Solo lectura.
  • Lavavajillas: estado, programa, fase del ciclo (prelavado, lavado principal, secado…), tiempo restante, fin previsto, puerta, control remoto activado, alertas (abrillantador bajo, filtro por limpiar). Pausa o parada solo mediante la acción de escena.
  • Hornos y cocinas: para cada cavidad (superior e inferior en un horno doble), estado (precalentando, cocinando, mantener calor, limpieza…), temperatura alcanzada, temperatura de consigna, tiempo restante de una cocción programada, temporizador. Solo lectura: ningún ajuste, ningún inicio.
  • Frigoríficos y enfriadores de bebidas: temperaturas del frigorífico y del congelador, consignas del frigorífico y del congelador (modificables, dentro de los límites del aparato), puerta (abierta en cuanto una puerta lo está), estado y vida útil del filtro de agua, alertas (filtro, fuga, puerta abierta, demasiado caliente).
  • Climatizadores (ventana, portátil, split, empotrado): encendido/apagado, modo (frío, solo ventilador, deshumidificación, calor y auto según el aparato), consigna (en grados enteros), velocidad del ventilador (auto, baja, media, alta), temperatura ambiente, alerta de filtro.
  • Calentadores de agua GeoSpring: temperatura del agua, consigna y modo, de solo lectura.
  • Máquinas de hielo Opal: estado (haciendo hielo, depósito lleno, añadir agua…) y alertas, de solo lectura.

Las puertas siguen a Gladys: 0 significa abierta, 1 cerrada. Un aparato desconectado de SmartHQ conserva sus últimos valores, muestra «No conectado» como estado y su distintivo pasa a «inaccesible».

Widget​

El widget Aparatos GE enumera lo que está en marcha: lavadoras, secadoras, lavavajillas y hornos, el más ocupado primero, con su programa, su fase y el fin previsto, y un distintivo con el tiempo restante (o «En pausa», «Terminado», «Alarma»). Cuando nada está en marcha, una línea lo indica. Se actualiza cada minuto y en cuanto un aparato arranca o se detiene.

Disparadores y acción de escena​

  • Ciclo GE terminado: una lavadora, secadora o lavavajillas terminó su ciclo, o terminó la cocción programada de un horno. Filtro: el aparato. Variables: nombre del aparato, programa.
  • Alerta de un aparato GE: un aparato emite una nueva alerta (puerta abierta, fuga de agua, filtro de agua, abrillantador, salida de la secadora obstruida, filtro del climatizador, máquina de hielo…). Filtros: el aparato, las alertas. Variables: nombre del aparato, alerta (en el idioma configurado), código de la alerta.
  • Pausar o detener un lavavajillas GE (acción): pausa o detiene el ciclo de un lavavajillas cuyo control remoto está activado en el aparato. Nunca inicia ni reanuda un ciclo. Salida: orden enviada.

Un disparador se activa una vez por transición, nunca al arrancar.

Ejemplos de escenas​

  • Colada terminada: disparador «Ciclo GE terminado» en la lavadora → enviar el mensaje «La lavadora ha terminado ({{triggerEvent.data.cycle}})» a la familia.
  • Puerta del frigorífico abierta: disparador «Alerta de un aparato GE», alerta «Puerta del frigorífico abierta» → notificación, y hacer parpadear la luz de la cocina.
  • Horas de descanso: a las 22 h → «Pausar o detener un lavavajillas GE» con «Pausar» (rechazada sin consecuencias cuando nada está en marcha).
  • Refrescar el dormitorio antes de dormir: a las 21 h en verano → climatizador del dormitorio encendido, modo frío, consigna 22 °C.

Actualización y cuotas​

La integración no depende del sondeo de Gladys, poco fiable para las integraciones externas (GladysAssistant/Gladys#3198): mantiene abierta una conexión en tiempo real con SmartHQ, recibe cada cambio en unos segundos y vuelve a leer por sí misma todos los aparatos cada 10 minutos (la red de seguridad, y el latido de los valores que nunca cambian). Gladys solo recibe los valores que cambian, y un valor sin cambios de nuevo cada 6 horas.

GE no publica condiciones de uso de la API ni cuotas para SmartHQ. La integración sigue el ritmo de gehomesdk, la biblioteca de la integración de Home Assistant: una conexión, un mantenimiento cada 30 segundos, la lista de aparatos cada 10 minutos, órdenes solo cuando usted actúa. Una conexión perdida se vuelve a abrir tras 10 segundos, luego 20, 40… hasta 15 minutos.

Solución de problemas​

  • «SmartHQ rechazó el correo electrónico o la contraseña»: compruébelos en la aplicación SmartHQ, corríjalos y guarde.
  • «SmartHQ pide un código de verificación»: ejecute «Enviar el código de verificación» y luego «Introducir el código de verificación» en 15 minutos.
  • «Nuevas condiciones de uso»: abra la aplicación SmartHQ, acéptelas y guarde de nuevo la configuración.
  • Falta un aparato: debe aparecer en la aplicación SmartHQ de la misma cuenta. Los tipos no compatibles (microondas, placas, campanas, hornos tostadores…) no se publican; los registros lo indican una vez.
  • Temperaturas en la unidad equivocada: cambie la unidad, guarde y luego use Actualizar en el aparato de la pestaña Descubrir (o elimínelo y añádalo de nuevo).
  • Más detalles: ajuste LOG_LEVEL=debug en la integración. Los registros nunca contienen la contraseña, los tokens ni la dirección de conexión.

Límites​

  • Desarrollada y probada sin aparatos GE ni cuenta SmartHQ, con valores construidos a partir de gehomesdk: sus comentarios son bienvenidos, sobre todo sobre los valores que dan sus aparatos.
  • Solo nube: sin Internet, nada se actualiza.
  • Las puertas de los hornos, los dispensadores de los frigoríficos y las máquinas de hielo integradas en los frigoríficos no figuran en los datos que lee la integración.
  • Lavadoras y secadoras no se pueden pausar ni detener a distancia (GE no ofrece esa orden); un lavavajillas solo si su control remoto está activado en el aparato.
  • Microondas, Advantium, placas de cocción, campanas, deshumidificadores, cafeteras, filtros y descalcificadores de agua aún no son compatibles.
  • Los nombres de los programas de lavado y secado quedan en inglés, tal como los nombra GE.

Parámetros de configuración​

Estos son los parámetros que GE Appliances (SmartHQ) te pide en su pantalla de configuración en Gladys.

ParámetroTipoObligatorioDescripción
Antes de empezarsectionNoLos aparatos GE no tienen API local: todo pasa por la nube SmartHQ, con la cuenta de la aplicación SmartHQ (GE, GE Profile, Café, Monogram, Haier, Hotpoint). Indique su correo electrónico y su contraseña y guarde. Si la cuenta pide un código de verificación, ejecute la acción «Enviar el código de verificación» y luego «Introducir el código de verificación» con el código recibido. Nada que caliente se inicia nunca a distancia. Sin relación con GE Appliances ni Haier.
Correo electrónicostringSíEl correo electrónico de su cuenta SmartHQ.
ContraseñasecretSíLa contraseña de su cuenta SmartHQ. Una contraseña rechazada no se vuelve a intentar hasta que usted la cambie.
Región de la cuentaselectNoEstados Unidos para casi todas las cuentas (la aplicación SmartHQ de Norteamérica).
Unidad de temperaturaselectNoUnidad de las temperaturas y consignas de los aparatos. Los aparatos GE funcionan en °F: los valores se convierten. Elíjala antes de añadir los aparatos.
IdiomaselectNoNombres de las funciones de los nuevos aparatos, estados y widget. Los programas de lavado conservan los nombres GE, en inglés.

Cómo instalar GE Appliances (SmartHQ) en Gladys​

  1. En Gladys, abre Integraciones: GE Appliances (SmartHQ) aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
  2. Haz clic en Instalar. Gladys descarga la imagen Docker (ghcr.io/guim31/gladys-smarthq: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).
  3. Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
  4. También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-smarthq.

GE Appliances (SmartHQ) 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​

GE Appliances (SmartHQ) 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.

Suscríbete a la newsletter de Gladys Assistant

Unos pocos correos al mes sobre nuevas versiones y novedades del proyecto. Enviados por Pierre-Gilles Leymarie, fundador del proyecto. Puedes darte de baja cuando quieras 🙂
Última actualización en