Saltar al contenido principal

Integración domótica Sector Alarm, gratuita y de código abierto

Integración Sector Alarm para Gladys Assistant

Arme y desarme su alarma Sector Alarm, controle cerraduras y enchufes, siga sus sensores.

Esta integración conecta Gladys con su sistema de alarma Sector Alarm: armar y desarmar la central, cerrar y abrir las cerraduras inteligentes, encender y apagar los enchufes inteligentes, y seguir los sensores (puertas y ventanas, humo, fugas de agua, temperatura, humedad).

Antes de empezar​

  • Se necesita Gladys 5.3 o posterior.
  • Una cuenta Sector Alarm: el correo y la contraseña de la app móvil Sector Alarm.
  • Gladys necesita acceso a Internet. Sector Alarm no tiene API local: todo pasa por la nube de Sector Alarm (mypagesapi.sectoralarm.net). Por eso la integración lleva la etiqueta cloud.

Configuración​

CampoQué poner
Correo electrónicoEl correo de su cuenta Sector Alarm.
ContraseñaSu contraseña. Guardada como secreto, nunca escrita en los registros.
Código de la centralEl código que teclea en el teclado. Opcional, vea más abajo.
Identificador de la centralVacío para seguir todas las centrales de la cuenta. Si no, un identificador, o varios separados por comas.
Intervalo de actualización (s)Frecuencia de lectura de Sector Alarm. 60 s por defecto, 30 s como mínimo. Sector Alarm limita las peticiones: bajar de un minuto aporta poco.

Guarde y pulse Probar la conexión: la respuesta lista las centrales encontradas, su modo, si están en línea y cuántos accesorios tienen. Después abra la pestaña Descubrimiento de la integración y cree los dispositivos que desee.

El código de la central​

El código solo se necesita para:

  • desarmar la alarma desde Gladys (una escena, la tarjeta del dispositivo);
  • cerrar o abrir una cerradura inteligente;
  • armar una central cuyo armado rápido está desactivado.

Sin código, Gladys puede leerlo todo y armar una central con el armado rápido activado. Déjelo vacío si no quiere que Gladys pueda desarmar.

Dispositivos​

Dispositivo en GladysFuncionesValores
Central (una por central)Modo de la alarma (una lista: Desarmada, Parcial, Armada)disarmed, partial, armed
Cerradura inteligenteCerradura (controlable), Batería baja1 = cerrada, 0 = abierta
Enchufe inteligenteAlimentación (controlable)1 = encendido, 0 = apagado
Sensor de puerta / ventanaApertura, Batería baja1 = cerrada, 0 = abierta
Detector de humoHumo, a menudo Temperatura1 = humo detectado
Detector de fugasFuga de agua1 = fuga detectada
Temperatura / humedadTemperatura (°C), Humedad (%)

El modo «parcial» solo aparece en una central que lo permite. Cada dispositivo muestra una insignia cloud; pasa a inaccesible cuando la central está sin conexión o Sector Alarm no responde.

Gladys no consulta los dispositivos uno por uno: la integración lee cada central entera, al intervalo elegido, y solo envía a Gladys los valores que han cambiado. Tras una orden, la central se vuelve a leer unos segundos después para confirmarla.

Widget del panel​

Añada el widget Sector Alarm a un panel. Muestra:

  • el modo de la alarma (rojo armada, naranja parcial, verde desarmada);
  • la conexión de la central;
  • las puertas y ventanas abiertas, las cerraduras abiertas;
  • una alerta de humo o de agua.

Sus botones: Armar y Parcial (con confirmación), Desarmar, Actualizar.

Seguridad. Un panel puede estar colgado en la pared y cualquiera puede pulsarlo. Por eso el botón Desarmar nunca usa el código de la configuración: abre un pequeño formulario donde hay que teclear el código cada vez.

Con varias centrales, elija la que se muestra en los ajustes del widget.

Escenas​

Disparadores​

DisparadorClaveFiltrosVariables
Cambia el modo de la alarmaalarm_mode_changedCentral, Nuevo modomode, previous_mode, panel_name, user, channel
Una central se desconecta o vuelvepanel_connection_changedCentral, Conexiónstate (offline / online), panel_name
Se acciona una cerradura inteligentelock_operatedCerradura, Qué ha pasadoaction (lock / unlock / lock_failed), lock_name, user, channel

user y channel vienen del registro de eventos de Sector Alarm (quién, y con qué: teclado, app, llavero…); están vacíos cuando el registro no lo indica.

Los disparadores saltan con los cambios vistos entre dos lecturas, vengan de donde vengan (teclado, app, llavero o Gladys). Nada salta en la primera lectura tras un arranque: el historial no es una novedad. Un cambio que va y viene entre dos lecturas puede perderse: baje el intervalo si es importante.

Ejemplos:

  • Cuando se desarme la alarma, si no hay nadie en casa, enviarme una notificación con {{triggerEvent.data.user}}.
  • Cuando la central se desconecte, enviar un mensaje.
  • Cuando se abra la cerradura de la entrada, encender la luz del recibidor.

Acciones​

AcciónClaveCamposSalidas
Cambiar el modo de la alarmaset_alarm_modeCentral, Modoapplied (sí/no), mode, error
Leer Sector Alarm ahorarefresh_nowCentral (opcional)mode, online

set_alarm_mode usa el código de la central de la configuración. Una orden rechazada no detiene la escena: compruebe applied en una condición y use error en una notificación. Ejemplo: a las 23 h, armar la alarma en parcial; si applied es no, enviarme error.

Las acciones estándar de Gladys también controlan los dispositivos: el modo de la alarma, las cerraduras y los enchufes se ajustan con Controlar un dispositivo.

Botones de la pantalla de configuración​

  • Probar la conexión: vuelve a iniciar sesión y lee cada central.
  • Actualizar ahora: lee Sector Alarm sin esperar.

Solución de problemas​

Lo que veQué hacer
«Sector Alarm rechaza el correo o la contraseña»Compruébelos en la app Sector Alarm y vuelva a guardar.
«Sector Alarm pide reducir el ritmo»Sector Alarm limita las peticiones. La integración espacia sus lecturas y luego vuelve a la normalidad. Aumente el intervalo.
«No se puede contactar con Sector Alarm»Compruebe el acceso a Internet de Gladys.
«Esta orden necesita el código de la central»Indique el código, o arme solo con el armado rápido.
Falta un sensorPulse Actualizar ahora y mire la pestaña Descubrimiento: allí aparece el nuevo accesorio.
El modo no cambia durante un corteEs a propósito: una central sin conexión dice estar «armada» pase lo que pase, así que Gladys conserva el último modo conocido.

Privacidad​

Su correo, su contraseña y su código se quedan en Gladys, como secretos, y solo se envían a Sector Alarm (mypagesapi.sectoralarm.net). La integración no usa ningún otro servicio.

Esta integración no está hecha ni respaldada por Sector Alarm. Usa la misma API que la app Sector Alarm, que puede cambiar sin previo aviso.

Parámetros de configuración​

Estos son los parámetros que Sector Alarm te pide en su pantalla de configuración en Gladys.

ParámetroTipoObligatorioDescripción
Primeros pasossectionNoSector Alarm no tiene API local: la integración pasa por la nube de Sector Alarm con la cuenta de la app Sector Alarm. Indique su correo y su contraseña; las centrales, cerraduras, enchufes y sensores de la cuenta aparecen después en Descubrimiento. El código de la central solo sirve para desarmar, controlar las cerraduras y armar una central cuyo armado rápido está desactivado.
Correo electrónicostringSíEl correo con el que inicia sesión en la app Sector Alarm.
ContraseñasecretSíLa contraseña de esa cuenta Sector Alarm. Nunca se escribe en los registros.
Código de la centralsecretNoEl código que teclea en el teclado. Necesario para desarmar desde Gladys, cerrar o abrir una puerta y armar una central cuyo armado rápido está desactivado. Si lo deja vacío, Gladys solo puede armar (con el armado rápido). El widget del panel nunca lo usa para desarmar: pide el código cada vez.
Identificador de la centralstringNoDéjelo vacío para seguir todas las centrales de la cuenta. Para seguir solo algunas, escriba sus identificadores separados por comas: «Probar la conexión» los lista.
Intervalo de actualización (s)numberNoFrecuencia de lectura de la nube de Sector Alarm, en segundos (30 como mínimo). Sector Alarm limita el número de peticiones: bajar de un minuto aporta poco y arriesga una ralentización.

Cómo instalar Sector Alarm en Gladys​

  1. En Gladys, abre Integraciones: Sector Alarm 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/prohand/gladys-sectoralarm: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/prohand/gladys-sectoralarm.

Sector Alarm requiere Gladys >=5.3.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​

Sector Alarm 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.

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 🙂