Integración domótica Cync, gratuita y de código abierto
Controle bombillas, tiras LED, interruptores y enchufes Cync (GE Lighting) desde Gladys.
Publicado por prohand
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.1.0
- ★ 0
Esta integración conecta Gladys con su cuenta Cync (antes C by GE, GE Lighting): bombillas, tiras LED, focos empotrados, interruptores y reguladores de pared, enchufes inteligentes y el controlador de ventilador configurados en la aplicación Cync.
Antes de empezar
- Sus dispositivos se configuran en la aplicación móvil Cync, no en Gladys. Compruebe primero que funcionan allí.
- Cada hogar necesita al menos un dispositivo Cync con Wi-Fi siempre alimentado: una bombilla Wi-Fi, un enchufe, un interruptor. Las bombillas solo Bluetooth se alcanzan a través de él.
- Gladys necesita acceso a internet: los dispositivos Cync se controlan a través de la nube Cync (vea Solo nube).
Configuración
| Campo | Qué introducir |
|---|---|
| Correo de la cuenta Cync | El correo con el que inicia sesión en la aplicación Cync. |
| Contraseña de la cuenta Cync | Su contraseña. Gladys la guarda como secreto y nunca se escribe en los registros. |
| Añadir las estancias Cync como luces | Activado por defecto: cada estancia de la aplicación Cync se convierte también en una luz en Gladys (ver más abajo). |
| Lectura completa de estados (s) | 300 por defecto. Los cambios llegan al instante; esta lectura detecta los dispositivos desconectados. |
| Registros detallados | Desactivado por defecto. Actívelo solo para diagnosticar un dispositivo: se registra cada trama. |
Inicio de sesión: el código de verificación
Cync suele proteger la cuenta con un código enviado por correo. El inicio de sesión se hace en tres clics, una sola vez:
- Introduzca el correo y la contraseña y pulse Guardar. El estado indica que se necesita un código.
- Pulse Enviar un código de verificación. Cync envía un código a la dirección de la cuenta.
- Pulse Validar el código, escriba el código y confirme.
La respuesta indica cuántos dispositivos se han encontrado, y el estado pasa a conectado. Después, la integración guarda su sesión en su propio almacenamiento: reiniciar Gladys o la integración no pide un código nuevo.
Solo hace falta un código nuevo si cambia el correo, o si Cync cierra la sesión (tras un cambio de contraseña, por ejemplo). El estado lo indica.
Dispositivos
Tras iniciar sesión, abra la pestaña Descubrimiento de la integración y añada los dispositivos que quiera.
| Dispositivo Cync | En Gladys |
|---|---|
| Bombilla, tira, foco empotrado | Luz: encendido/apagado, brillo, blanco, color — según el modelo |
| Interruptor / regulador de pared | Luz: encendido/apagado (y brillo en un regulador) |
| Interruptor con detector de movimiento | Luz, más un sensor de movimiento |
| Enchufe, enchufe exterior doble | Interruptor (un dispositivo por toma) |
| Controlador de ventilador | Interruptor: encendido/apagado y velocidad (0–100 %) |
| Estancia o grupo de la aplicación Cync | Luz: controla todas sus luces a la vez |
La temperatura del blanco va de 2000 K (cálido) a 7000 K (frío).
Las cámaras, termostatos y otros productos Cync no son compatibles: se omiten, y los registros los nombran.
Las estancias
Una estancia controla todas sus luces con una sola orden: se encienden juntas, en lugar de una tras otra. Una estancia solo ofrece lo que todas sus luces pueden hacer: una estancia que mezcla bombillas de color y blancas no tiene ajuste de color. Aparece encendida en cuanto una de sus luces lo está.
Una estancia sin luces (solo enchufes) no se añade. Desactive Añadir las estancias Cync como luces si no quiere ninguna estancia.
La insignia de conexión
Cada dispositivo Cync muestra una insignia nube mientras la nube Cync lo alcanza, e inaccesible si no: el dispositivo no tiene alimentación, está fuera del alcance de los demás, o la integración ha perdido la nube.
Acciones
En la página de la integración:
- Enviar un código de verificación / Validar el código: el inicio de sesión descrito arriba.
- Probar la conexión: lee todos los estados al momento y responde con el número de dispositivos en línea y de hogares con un relé Wi-Fi.
- Recargar la lista de dispositivos: vuelve a leer los hogares desde la nube Cync, tras añadir, renombrar o mover un dispositivo en la aplicación Cync.
Escenas y panel (Gladys 5.1+)
Disparadores de escena
- Un sensor Cync detecta movimiento: se activa una vez por detección de un interruptor o sensor con detector de movimiento. Filtre por el sensor, o déjelo vacío para todos.
- Un dispositivo Cync se desconecta o se conecta: la malla Cync deja de oír
un dispositivo (corte de corriente, interruptor de pared apagado) o lo vuelve
a oír. Filtre por el dispositivo y por el cambio; las acciones siguientes
leen el cambio en la variable
status(onlineuoffline).
Acciones de escena
- Ajustar una luz Cync de una vez: encendido, brillo y temperatura del blanco en una sola orden. Una luz encendida así va directamente al ajuste deseado, sin destellar antes con su ajuste anterior. También funciona con estancias. Su salida Orden enviada es falsa cuando no se pudo alcanzar la luz: úsela como condición si el resto de la escena depende de ello.
- Leer los estados Cync ahora: pide a cada hogar el estado de sus dispositivos. Salidas: Dispositivos en línea y Dispositivos en total.
Widgets
- Estado Cync: la conexión a la nube, los dispositivos en línea, el relé Wi-Fi de cada hogar y dos botones: Leer estados y Recargar.
- Dispositivos Cync: una línea por dispositivo: encendido (con su brillo), apagado o sin conexión. El ajuste Mostrar la limita a los dispositivos encendidos, o a los desconectados — útil tras un corte de corriente.
Conviene saber
Solo nube
Los dispositivos Cync no tienen API local: la propia aplicación Cync los controla a través de la nube Cync. La integración hace lo mismo, con una conexión permanente:
- sus órdenes van a la nube, que las entrega a un dispositivo Wi-Fi de su hogar (el «relé»), que las transmite a los demás por Bluetooth;
- cada cambio — desde Gladys, la aplicación Cync, un interruptor de pared o un asistente de voz — vuelve por el mismo camino, en menos de un segundo.
Sin internet, o con la nube Cync caída, Gladys ya no puede controlar los dispositivos. La integración se reconecta sola en cuanto es posible.
El certificado del servidor Cync
El servidor Cync presenta un certificado caducado cuyo nombre no coincide. La integración intenta primero una verificación estricta; si falla, se conecta de todos modos, como la aplicación Cync, y escribe una advertencia en los registros. El tráfico sigue cifrado.
Qué se guarda
La integración guarda su sesión Cync (tokens, no la contraseña) en su propio almacenamiento, que solo ella puede leer. La contraseña se queda en la configuración de Gladys.
Solución de problemas
| Síntoma | Qué comprobar |
|---|---|
| «Código necesario» una y otra vez | Use Enviar un código de verificación y luego Validar el código con el último código: un código caduca pronto. |
| «La nube Cync ha rechazado este código» | Código erróneo o caducado, o contraseña incorrecta: compruebe la contraseña y pida un código nuevo. |
| Todos los dispositivos de un hogar están inaccesibles | Ningún dispositivo Cync Wi-Fi de ese hogar está en línea. Encienda uno; Probar la conexión muestra los hogares sin relé. |
| Un dispositivo está inaccesible | No tiene alimentación (¿interruptor de pared apagado?) o está demasiado lejos de los demás. La aplicación Cync muestra lo mismo. |
| Un dispositivo nuevo no aparece | Recargar la lista de dispositivos y luego la pestaña Descubrimiento. |
| Un dispositivo no responde, los demás sí | Active Registros detallados, vuelva a intentarlo y mire los registros de la integración (tramas enviadas y recibidas). |
Parámetros de configuración
Estos son los parámetros que Cync te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Primeros pasos | section | No | Inicie sesión con la cuenta de la aplicación Cync. Cync suele pedir un código enviado por correo: guarde el formulario, pulse «Enviar un código de verificación» y luego «Validar el código». Las luces se controlan a través de la nube Cync, por lo que al menos un dispositivo Cync Wi-Fi debe estar en línea en cada hogar. |
| Correo de la cuenta Cync | string | Sí | |
| Contraseña de la cuenta Cync | secret | Sí | |
| Añadir las estancias Cync como luces | boolean | No | Una estancia enciende todas sus luces con una sola orden, sin el efecto ola de una orden por bombilla. |
| Lectura completa de estados (s) | number | No | Los cambios llegan al instante; esta lectura solo detecta los dispositivos desconectados. |
| Registros detallados | boolean | No | Registra cada trama intercambiada con la nube Cync, para diagnosticar un dispositivo. Si no, déjelo desactivado. |
Cómo instalar Cync en Gladys
- En Gladys, abre Integraciones: Cync 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/prohand/gladys-cync: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/prohand/gladys-cync.
Cync 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
Cync 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 prohand, 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