Guía de Configuración de Alarma de Mobotix

Introducción

Esta guía describe cómo configurar una cámara MOBOTIX M15 para generar una notificación de alarma estructurada y enviarla a un receptor de alarmas NXGEN mediante Raw TCP/IP, utilizando el motor de eventos de la cámara y el perfil IP Notify. Cubre la configuración de la interfaz web de MOBOTIX, el perfil IP Notify (Configuración Personalizada sobre Raw TCP/IP), la carga útil de alarma JSON, la validación del mensaje en el receptor y la incorporación del Dispositivo MOBOTIX a GCXONE.

Resumen de Integración

La configuración recomendada utiliza el motor de eventos de MOBOTIX para activar una acción IP Notify. El perfil IP Notify formatea los datos del evento como JSON y los envía a un receptor externo mediante una conexión TCP iniciada por la cámara.

• Fuente del evento:un evento interno de MOBOTIX — sensor, analítica, entrada o otro disparador configurado.
• Reacción del evento: un Grupo de Acción ejecuta la acción IP Notify.
• Transporte de notificación: Raw TCP/IP.
• Destino: la dirección IP y el puerto TCP del receptor externo.
• Formato del mensaje: texto plano que contiene un objeto JSON poblado con expresiones de variables MOBOTIX.
• Responsabilidad del receptor: aceptar el mensaje TCP, detectar el separador configurado, analizar el JSON, validar el evento y procesarlo según la integración descendente.

Flujo: Evento MOBOTIX → Grupo de Acción → Perfil IP Notify → Raw TCP/IP → Receptor de Alarma → NXGEN / procesamiento de alarmas descendente.

Abra los Menús de Configuración de MOBOTIX

Desde la interfaz web de la cámara, abra el Menú control y acceda al área de configuración administrativa. Las etiquetas exactas del menú pueden variar según el firmware de la cámara y la versión de la interfaz.

Navegue al área de configuración de eventos y localice el Grupo de Acción / IP Notifyajustes. El Grupo de Acción determina cuándo se genera una notificación; el perfil IP Notify determina dónde y cómo se transmite la notificación.

Configure el Perfil IP Notify

Cree o edite un perfil IP Notify dedicado al receptor de alarma externo.

Importante:Confirme siempre la dirección IP de destino y el puerto con el Servicio de Atención al Cliente antes de configurar una integración en producción.

Configure el Grupo de Eventos / Acción de MOBOTIX

El perfil IP Notify no define por sí mismo cuándo se envía una Alarma — se debe conectar un evento a un Grupo de Acción que lo invoque.

Paso 1: Permita el nuevo (o existente) Grupo de Acción.

Paso 2: Seleccione los eventos que deben desencadenar una notificación de Alarma TCP. Seleccionar todos notificará en cada cámara y evento del sistema configurados.

Paso 3: Establezca un tiempo muerto de aproximadamente 5 segundos entre acciones, y configure las acciones para que se activen simultáneamente.

Paso 4: Seleccione el perfil IP Notify que configuró y establezca un tiempo de espera de aproximadamente 30 segundos.

Secuencia de configuración recomendada:

1. Configure o verifique la fuente del evento (movimiento, activación de entrada, un evento de analítica o otra condición de alarma).
2. Cree o edite un Grupo de Acción para ese evento.
3. Añada la acción IP Notify y seleccione el perfil IP Notify dedicado.
4. Configure cualquier comportamiento pre‑evento / post‑evento que requiera el flujo de trabajo de Alarma.
5. Permita el Grupo de Acción y confirme que el evento está armado y activo.
6. Active un evento de prueba controlado y verifique el lado del receptor.

Carga útil JSON de mensaje de Alarma

Utilice el siguiente cuerpo de mensaje en texto plano en el perfil IP Notify. Cada $(...) expresión es una variable de sustitución MOBOTIX, evaluada cuando se genera la notificación.

{
  "lasteventTimestamp": "$(LEV.DATE)",
  "manufacturer": "$(FPR.PRD)",
  "imageNumber": "$(FPR.FRM)",
  "eventNumber": "$(FPR.ENO)",
  "eventActiveGroups": "$(EVT.AST)",
  "eventsEnabled": "$(EVT.EST.SELECTED)",
  "eventCode": "$(EVT.EST.ACTIVATED)",
  "eventPreList": "$(EVT.SYA)",
  "eventPostList": "$(EVT.SYP)",
  "eventPreInterval": "$(EVT.SIA)",
  "eventPostInterval": "$(EVT.SIP)",
  "eventImageType": "$(FPR.IMT)",
  "eventTime": "$(FPR.TIMESTAMP)",
  "timezone": "$(FPR.TZN)",
  "eventTimeUTC": "$(TMS.RFC822)",
  "cameraModel": "$(IMG.CTY)",
  "videoCodec": "$(IMG.ICC)",
  "frameRate": "$(IMG.FRJ)",
  "bayerFrameRate": "$(IMG.FRB)",
  "imageSizeX": "$(IMG.XTO)",
  "imageSizeY": "$(IMG.YTO)",
  "imageQuality": "$(IMG.QLT)",
  "cameraImageType": "$(IMG.CAM)",
  "imageZoomLevel": "$(IMG.ZOM)",
  "imageMirrored": "$(IMG.MIR)",
  "imageRotated": "$(IMG.ROT)",
  "mac": "$(ID.MAC)",
  "serial": "$(ID.FIP)",
  "hostname": "$(ID.NAM)",
  "ipaddress": "$(ID.ET0)",
  "cameraSoftwareVersion": "$(ID.SWV)",
  "uptime": "$(ID.UPT)",
  "timeserverIP": "$(ID.TSI)",
  "timeServerConfig": "$(ID.TSP)",
  "timeserverOffset": "$(ID.TSO)",
  "inputState": "$(SEN.INA)",
  "rightCamButton": "$(SEN.BTR)",
  "leftCamButton": "$(SEN.BTL)",
  "pirValue": "$(SEN.PIR)",
  "microphoneValue": "$(SEN.MIC)",
  "rightLensBrightness": "$(SEN.ILR)",
  "leftLensBrightness": "$(SEN.ILL)",
  "triggeredMotionWindows": "$(SEN.VM1)",
  "cameraInternalTemp": "$(SEN.TIN.CELSIUS)",
  "cameraExternalTemp": "$(SEN.TOU.CELSIUS)",
  "externalIOTemp": "$(SEN.TEX.CELSIUS)",
  "GPSBoxTemp": "$(SEN.TGP.CELSIUS)",
  "rightSensorThermalCenterTemp": "$(SEN.TSR.CELSIUS)",
  "leftSensorThermalCenterTemp": "$(SEN.TSL.CELSIUS)",
  "thermalRadiometryTemp": "$(SEN.TTR.CELSIUS)",
  "thermalCoordinates": "$(SEN.TCO)",
  "ftpDir": "$(TEXT.FTPDIR)",
  "ftpEventFile": "$(TEXT.EVENTFILE)",
  "storageUtilization": "$(STORAGE.BUFFERFILL.CCURRENT)"
}

Procesamiento del lado del receptor

El receptor trata la Conexión MOBOTIX como una secuencia TCP. TCP no conserva los límites de mensaje a nivel de aplicación, por lo que el separador configurado debe gestionarse explícitamente:

• Aceptar la Conexión TCP entrante en el Port TCP configurado.
• Acumular bytes hasta que se detecte el separador configurado (por ejemplo, --next-image--) se detecta.
• Extraer los bytes del mensaje que preceden al separador.
• Eliminar los espacios en blanco de transporte y analizar el texto extraído como JSON.
• Validar los campos obligatorios como eventTime, eventCode, ipaddress, y serial, más cualquier valor relacionado con el evento que requiera el sistema downstream.
• Mapear el evento normalizado al modelo de Alarma utilizado por el receptor de Alarma de destino.
• Persistir la carga útil original de MOBOTIX para resolución de problemas y auditoría cuando sea práctico.

Ejemplo de encuadre de mensaje:

{JSON alarm object}--next-image--{next JSON alarm object}--next-image--

Lista de verificación de Configuración

• Perfil IP Notify creado y Activado.
• IP de destino y Port TCP verificados con el Cliente.
• TCP/IP sin procesar seleccionado como el protocolo de datos.
• Separador único configurado y documentado.
• Texto plano seleccionado como el tipo de datos.
• Carga útil JSON insertada y validada.
• Nombres de propiedades JSON duplicados eliminados o renombrados.
• Grupo de Acción configurado con la fuente de evento prevista.
• Grupo de Acción invoca el perfil IP Notify correcto.
• Se recibió y analizó correctamente un evento de prueba controlado.
• Se completó una prueba de múltiples eventos / ráfaga.
• La Alarma se mapea y persiste en la integración downstream.
• Dispositivo MOBOTIX añadido a GCXONE y descubierto con éxito.

Notas y compatibilidad de firmware

• Los nombres de variables MOBOTIX, y qué variables están disponibles, pueden depender del modelo de cámara, la versión de firmware y el contexto del evento. Valide las variables en el firmware real de la cámara antes de estandarizar la carga útil.
• Los menús y etiquetas de Configuración pueden variar entre versiones de firmware — las pantallas referenciadas en esta guía pueden reorganizarse en futuros firmware de MOBOTIX.

Guía de Configuración Mobotix con GCXONE

Paso 1: Navegue a la Dispositivos pestaña.

Paso 2: Haga clic en el Añadir Nuevo botón.

Paso 3: El Añadir Dispositivo cuadro de diálogo se mostrará.

Paso 4: En el cuadro de diálogo, abra el Dispositivo desplegable y seleccione Mobotix.

Paso 5: Introduzca todos los campos obligatorios: Nombre, Dirección IP o Nombre de Host, Dirección Mac, Nombre de Usuario, Contraseña, Puerto de Control, Puerto RTSP.

Paso 6: Debajo de los campos de Conexión, el cuadro de diálogo también tiene un Seleccionar grupo de entidad lista desplegable, un Habilitar audio conmutador (activado por defecto), un obligatorio Zona horaria, un Configuración de Dispositivo sección (Configuración de Site Pulse), un Configuración avanzada sección (Sondeo de eventos, Configurar Máscara de mapa de calor, control de salud periódico, Tiempo de retención de eventos — 30 días por defecto), y una opcional Ubicación sección (Latitud, Longitud, Código Plus, What3Words).

Paso 7: Haga clic Descubrir.

Paso 8: Una vez que el dispositivo se haya descubierto correctamente, haga clic Guardar.