Saltar al contenido principal

Integración domótica iCSee PTZ, gratuita y de código abierto

Integración iCSee PTZ para Gladys Assistant

Controle sus cámaras PTZ iCSee / XMEye en local: imagen, orientación, presets, movimiento.

Ver en GitHubTodas las integraciones

Esta integración controla las cámaras motorizadas iCSee (vendidas también con las marcas XMEye, Xiongmai, Jennov, Hiseeu, Floureon...) desde Gladys Assistant, en local: Gladys se comunica con las cámaras de su red con su protocolo nativo (DVRIP, puerto TCP 34567). Sin cuenta en la nube, sin necesidad de internet.

Qué obtiene​

  • La imagen de la cámara en Gladys: widget de cámara del panel, chat («muéstrame la cámara»), escenas («enviar una imagen de cámara»).
  • La orientación (y el zoom en los modelos que lo tienen) desde el panel, las filas de dispositivos y las escenas. Cada movimiento se detiene solo: un «stop» perdido nunca deja la cámara girando.
  • Los presets: un toque para orientar la cámara hacia una posición guardada.
  • La detección de movimiento y de personas: un sensor de movimiento, y un disparador de escena que distingue un movimiento de una persona.
  • Dos widgets: «Control PTZ iCSee» (imagen, estado, flechas) y «Presets iCSee».
  • Acciones de escena: mover una cámara, ir a / guardar un preset, actualizar la imagen, reiniciar una cámara.
  • Disparadores de escena: detección (movimiento / persona), cámara conectada / desconectada.

Antes de empezar​

  1. Vincule cada cámara con la app iCSee, en la misma red que Gladys.
  2. En su router, asigne a cada cámara una dirección IP fija (reserva DHCP). La integración también reconoce una cámara cuya dirección ha cambiado, pero una dirección fija evita cualquier corte.
  3. Anote la contraseña del dispositivo definida en la app iCSee (vacía si nunca la definió). El usuario es admin.
  4. Para recibir las detecciones, active la alarma de detección de movimiento / de personas de la cámara en la app iCSee.

Configuración​

Abra Integraciones → iCSee PTZ → Configuración:

CampoQué introducir
Direcciones de las cámarasLas direcciones IP, separadas por comas: 192.168.1.50, 192.168.1.51. Añada :puerto si no es 34567.
Usuarioadmin, salvo que haya creado otra cuenta.
ContraseñaLa contraseña del dispositivo en la app iCSee. Vacía si no hay. Común a todas las cámaras.
Actualización de la imagen (s)Segundos entre dos imágenes enviadas a Gladys (60 por defecto, mínimo 5). 0 = solo bajo demanda.
Captura de la imagenAutomático usa la captura de la cámara, o el flujo RTSP si el firmware no la tiene.
Paso de movimiento (s)Cuánto gira la cámara con una orden de movimiento aislada (1 s por defecto).
Velocidad del motor (1-8)Velocidad de los motores PTZ.
Zoom motorizadoMárquelo solo si su modelo tiene zoom óptico.
PresetsLas posiciones guardadas en las cámaras, como número:nombre: 1:Entrada, 2:Jardín.
Detección de movimientoRecibe las detecciones de las cámaras.
Cámaras de doble objetivoDivide la imagen de los modelos de doble objetivo (objetivo fijo arriba por defecto).

Guarde y use los botones:

  • Probar las cámaras se conecta a cada dirección e indica cuáles responden (modelo y número de serie), o por qué no (contraseña incorrecta, inaccesible...).
  • Buscar en la red enumera las cámaras iCSee de su red. Difunde la búsqueda iCSee y después prueba el puerto 34567 en cada dirección de la red: la que indique en «Red a analizar» (p. ej. 192.168.1.0/24) o, por defecto, la red de las cámaras ya configuradas. Para su primera cámara, indique su red. La dirección también aparece en la app iCSee (Ajustes del dispositivo → Red) y en la lista de dispositivos de su router.
  • Reiniciar una cámara reinicia la cámara elegida.

Después abra la pestaña Detección de la integración y añada sus cámaras.

Mover la cámara​

  • Panel: añada el widget «Control PTZ iCSee» (o el dispositivo en un widget de habitación). Cada flecha gira la cámara durante el «Paso de movimiento».
  • Escenas: la acción «Mover una cámara iCSee» recibe una dirección y una duración (5 s como máximo). La acción estándar «controlar un dispositivo» también funciona en la función PTZ (1 izquierda, 2 derecha, 3 arriba, 4 abajo, 5 acercar, 6 alejar, 0 stop).

Venga de donde venga, un movimiento siempre se detiene solo como mucho a los 5 segundos.

Cámaras de doble objetivo​

Algunos modelos (X6E-WEQ...) tienen un objetivo fijo y un objetivo PTZ, pero envían ambos en una sola imagen, uno encima del otro: la app iCSee la divide en el teléfono. La integración hace lo mismo, automáticamente: una imagen más alta que ancha es una imagen de doble objetivo.

  • El dispositivo de cámara que ya tiene pasa a ser el objetivo PTZ (imagen, flechas, presets, movimiento): sus escenas y paneles siguen funcionando.
  • Un segundo dispositivo, «fixed lens» (objetivo fijo), aparece en la pestaña Detección con la imagen del objetivo fijo: añádalo como el primero.
  • Una sola captura alimenta las dos imágenes: dividirla no cuesta más que hoy.

El ajuste Cámaras de doble objetivo indica dónde está el objetivo fijo (arriba por defecto, o abajo) o desactiva la división.

El vídeo en directo no está disponible con esta integración (las integraciones externas de Gladys intercambian imágenes fijas, 12 por minuto como máximo). Para el directo, añada también la cámara a la integración Cámara RTSP de Gladys, con rtsp://<dirección>:554/user=admin&password=<contraseña>&channel=1&stream=0.sdp?real_stream (ambos objetivos en una sola imagen).

Presets​

Un preset es una posición guardada en la cámara. Para crear uno:

  1. oriente la cámara hacia la posición deseada (widget, app iCSee);
  2. lance una escena con la acción Guardar un preset iCSee y un número (1 a 255), o guárdelo desde la app iCSee;
  3. añada número:nombre al campo Presets de la configuración, por ejemplo 1:Entrada.

Los presets aparecen entonces en la función PTZ del dispositivo, en el widget «Presets iCSee», y la acción de escena Ir a un preset iCSee orienta la cámara hacia ellos.

Ideas de escenas​

  • Cuando se active la alarma, orientar todas las cámaras hacia la puerta (ir a un preset).
  • Cuando una cámara detecte a una persona, enviar su imagen por Telegram («Actualizar una imagen iCSee», y después la acción «Enviar una imagen de cámara» de Gladys).
  • Cuando una cámara se desconecte por la noche, reiniciarla.

Solución de problemas​

  • «wrong password»: compruebe la contraseña del dispositivo en la app iCSee; el usuario es admin.
  • Cámara inaccesible: compruebe la dirección, que la cámara esté alimentada y en la misma red, y que nada bloquee el puerto TCP 34567.
  • Sin imagen: algunos firmwares no tienen orden de captura; la integración usa entonces el flujo RTSP (puerto 554). Fuerce «Flujo RTSP» en «Captura de la imagen» si hace falta.
  • Sin detección: active la alarma de detección en la app iCSee y deje marcada «Detección de movimiento».
  • Los registros de la integración están en Ajustes → Sistema → Contenedores (o docker logs).

El código fuente, el seguimiento de incidencias y el registro de cambios están en GitHub.

Parámetros de configuración​

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

ParámetroTipoObligatorioDescripción
Primeros pasossectionNoVincule primero sus cámaras con la app iCSee y asígneles una dirección fija en su router. La integración se comunica con ellas directamente en su red local (protocolo DVRIP, puerto TCP 34567): no hace falta ninguna cuenta en la nube. Use «Buscar en la red» más abajo para encontrar sus direcciones.
Direcciones de las cámarasstringSíDirecciones IP de las cámaras, separadas por comas. Añada «:puerto» si no es 34567.
UsuariostringSíCuenta local de las cámaras, «admin» salvo que la haya cambiado.
ContraseñasecretNoContraseña del dispositivo definida en la app iCSee. Déjela vacía si nunca la definió.
Actualización de la imagen (s)numberNoSegundos entre dos imágenes enviadas a Gladys (mínimo 5). 0: solo bajo demanda.
Captura de la imagenselectNoAutomático usa la captura de la cámara, y el flujo RTSP si el firmware no la tiene.
Paso de movimiento (s)numberNoCuánto gira la cámara con una orden de movimiento aislada (0,2 a 5 s). Mantener pulsado mueve hasta 5 s.
Velocidad del motor (1-8)numberNo
Zoom motorizadobooleanNoOfrece los controles de zoom (solo modelos con zoom óptico).
PresetsstringNoPosiciones guardadas en las cámaras, como número:nombre. Guarde nuevas con la acción de escena «Guardar un preset».
Cámaras de doble objetivoselectNoLos modelos de doble objetivo envían ambos objetivos en una sola imagen, uno encima del otro (detectado automáticamente: la imagen es más alta que ancha). La integración la divide en dos dispositivos: el objetivo PTZ y el objetivo fijo.
Detección de movimientobooleanNoRecibe las detecciones de movimiento y de personas de las cámaras (actívelas en la app iCSee).

Cómo instalar iCSee PTZ en Gladys​

  1. En Gladys, abre Integraciones: iCSee PTZ 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/gboulvin/gladys-icseeptz:1.2.0), 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/gboulvin/Gladys-ICSeePTZ.

iCSee PTZ 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​

iCSee PTZ 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 gboulvin, 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