---
title: "Mobotix Alarm Configuration Guide"
source: /gcxone/devices/mobotix
locale: en
updated: 2026-09-02
---
## Introduction

This guide describes how to configure a MOBOTIX M15 camera to generate a structured alarm notification and send it to an NXGEN alarm receiver over Raw TCP/IP, using the camera's event system and IP Notify profile. It covers the MOBOTIX web interface configuration, the IP Notify profile (Custom Configuration over Raw TCP/IP), the JSON alarm payload, validating the message at the receiver, and adding the MOBOTIX device to GCXONE.

## Integration Overview

The recommended configuration uses the MOBOTIX event engine to trigger an IP Notify action. The IP Notify profile formats the event data as JSON and sends it to an external receiver over a TCP connection initiated by the camera.

- **Event source:** a MOBOTIX internal event — sensor, analytics, input, or another configured trigger.
- **Event reaction:** an Action Group executes the IP Notify action.
- **Notification transport:** Raw TCP/IP.
- **Destination:** the external receiver's IP address and TCP port.
- **Message format:** plain text containing a JSON object populated with MOBOTIX variable expressions.
- **Receiver responsibility:** accept the TCP message, detect the configured separator, parse the JSON, validate the event, and process it according to the downstream integration.

**Flow:** MOBOTIX Event → Action Group → IP Notify Profile → Raw TCP/IP → Alarm Receiver → NXGEN / downstream alarm processing.

## Open the MOBOTIX Configuration Menus

From the camera's web interface, open the **Menu** control and enter the administrative configuration area. Exact menu labels can vary with camera firmware and interface version.

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

Navigate to the event configuration area and locate the **Action Group** / **IP Notify** settings. The Action Group determines when a notification is generated; the IP Notify profile determines where and how the notification is transmitted.

## Configure the IP Notify Profile

Create or edit an IP Notify profile dedicated to the external alarm receiver.

| Field | Recommended value | Purpose / notes |
| --- | --- | --- |
| IP Notify Profile | A dedicated name, e.g. MultipleNotify | Use a profile dedicated to this integration. |
| IP Notify Type | Custom Configuration | Allows the alarm payload to be explicitly defined. |
| Destination Address | Receiver IPv4 address and TCP port | Confirm the correct endpoint with Customer Support before going live — do not assume a default. |
| Send Order | Parallel send to all | Use when multiple destinations are configured and all should receive the message. |
| Data Protocol | Raw TCP/IP | Sends the notification as a TCP data stream rather than an HTTP request. |
| Separator for Raw TCP/IP | A unique string, e.g. --next-image-- | The receiver uses this marker to identify message boundaries in the TCP stream. It must not occur inside the JSON body. |
| Data Type | Plain text | Required for the JSON payload used in this guide. |
| Send Port | 0 | Automatic. |

**Important:** Always confirm the destination IP address and port with Customer Support before configuring a live integration.

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

## Configure the MOBOTIX Event / Action Group

The IP Notify profile does not by itself define when an alarm is sent — an event must be connected to an Action Group that invokes it.

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

**Step 1:** Enable the new (or existing) Action Group.

**Step 2:** Select the events that should trigger a TCP alarm notification. Selecting all will notify on every configured camera and system event.

**Step 3:** Set a deadtime of about 5 seconds between actions, and set actions to trigger simultaneously.

**Step 4:** Select the IP Notify profile you configured, and set a timeout of about 30 seconds.

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

Recommended configuration sequence:

1. Configure or verify the event source (motion, input activation, an analytics event, or another alarm condition).
2. Create or edit an Action Group for that event.
3. Add the IP Notify action and select the dedicated IP Notify profile.
4. Set any pre-event / post-event behavior the alarm workflow requires.
5. Enable the Action Group and confirm the event is armed and active.
6. Trigger a controlled test event and check the receiver side.

## Alarm Message JSON Payload

Use the following plain-text message body in the IP Notify profile. Each `$(...)` expression is a MOBOTIX substitution variable, evaluated when the notification is generated.

```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)"
}
```

## Receiver-Side Processing

The receiver treats the MOBOTIX connection as a TCP stream. TCP does not preserve application-level message boundaries, so the configured separator must be handled explicitly:

- Accept the incoming TCP connection on the configured port.
- Accumulate bytes until the configured separator (for example, `--next-image--`) is detected.
- Extract the message bytes preceding the separator.
- Trim transport whitespace and parse the extracted text as JSON.
- Validate mandatory fields such as `eventTime`, `eventCode`, `ipaddress`, and `serial`, plus any event-related values the downstream system requires.
- Map the normalized event into the alarm model used by the target alarm receiver.
- Persist the original MOBOTIX payload for troubleshooting and audit where practical.

**Message framing example:**

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

## Configuration Checklist

- IP Notify profile created and enabled.
- Destination IP and TCP port verified with Customer Support.
- Raw TCP/IP selected as the data protocol.
- A unique separator configured and documented.
- Plain text selected as the data type.
- JSON payload inserted and validated.
- Duplicate JSON property names removed or renamed.
- Action Group configured with the intended event source.
- Action Group invokes the correct IP Notify profile.
- A controlled test event was successfully received and parsed.
- A multiple-event / burst test was completed.
- The alarm is mapped and persisted in the downstream integration.
- MOBOTIX device added to GCXONE and discovered successfully.

## Notes and Firmware Compatibility

- MOBOTIX variable names, and which variables are available, can depend on camera model, firmware version, and event context. Validate the variables on the actual camera firmware before standardizing the payload.
- Configuration menus and labels can vary between firmware versions — the screens referenced in this guide may be reorganized in future MOBOTIX firmware.

## Mobotix Config Guide with GCXONE

**Step 1:** Navigate to the **Devices** tab.

**Step 2:** Click the **Add New** button.

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

**Step 3:** The **Add Device** dialog will be displayed.

**Step 4:** In the dialog, open the **Device** dropdown and select **Mobotix**.

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

**Step 5:** Enter all required fields: **Name**, **IP Address or Host Name**, **MAC Address**, **User Name**, **Password**, **Control Port**, **RTSP Port**.

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

**Step 6:** Below the connection fields, the dialog also has a **Select Entity Group** dropdown, an **Enable Audio** toggle (on by default), a required **Timezone**, a **Device Configuration** section (Site Pulse Configuration), an **Advanced Settings** section (Event Polling, Configure Heatmap Mask, Periodic Health Check, Event Retention Time — 30 days by default), and an optional **Location** section (Latitude, Longitude, Plus Code, What3Words).

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

**Step 7:** Click **Discover**.

**Step 8:** Once the device is successfully discovered, click **Save**.