---
title: "Guía de Configuración de Alarma de Mobotix"
source: /es/gcxone/devices/mobotix
locale: es
updated: 2026-09-02
---
## 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.

![1](/api/media/file/blob-edited-60df60a2.jpg?prefix=media)

Navegue al área de configuración de eventos y localice el **Grupo de Acción** / **IP Notify**ajustes. 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.

| Campo | Valor recomendado | Propósito / notas |
| --- | --- | --- |
| Perfil IP Notify | Un nombre dedicado, p. ej. MultipleNotify | Utilice un perfil dedicado a esta integración. |
| Tipo IP Notify | Configuración Personalizada | Permite que la carga útil de alarma se defina explícitamente. |
| Dirección de destino | Dirección IPv4 del receptor y Port TCP | Confirme el punto final correcto con el Servicio de Atención al Cliente antes de pasar a producción — no asuma un valor predeterminado. |
| Enviar orden | Envío paralelo a todos | Utilícelo cuando se configuren varios destinos y todos deban recibir el mensaje. |
| Protocolo de datos | Raw TCP/IP | Envía la notificación como un flujo de datos TCP en lugar de una solicitud HTTP. |
| Separador para Raw TCP/IP | Una cadena única, p. ej. --next-image-- | El receptor utiliza este marcador para identificar los límites del mensaje en el flujo TCP. No debe aparecer dentro del cuerpo JSON. |
| Tipo de datos | Texto plano | Requerido para la Carga útil JSON utilizada en esta guía. |
| Puerto de envío | 0 | Automático. |

**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.

![14](/api/media/file/blob-26--edited-5ede41a8.png?prefix=media)

## 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.

![14](/api/media/file/blob-1--edited-74645c45.jpg?prefix=media)

**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.

![45](/api/media/file/4E084C64-9D8C-425A-8319-BADCB67453D1-edited-2df1091c.png?prefix=media)

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.

```json
{
  "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:**

```text
{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.

![14](/api/media/file/Screenshot-2026-09-02-135203-edited-289d4385.png?prefix=media)

**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**.

![2112](/api/media/file/Screenshot-2026-09-02-135456-edited-051e9d7a.png?prefix=media)

**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**.

![12112](/api/media/file/Screenshot-2026-09-02-135600-edited-639c60da.png?prefix=media)

**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).

![121](/api/media/file/Screenshot-2026-09-02-135717-edited-bbf6a553.png?prefix=media)

**Paso 7:** Haga clic **Descubrir**.

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