--- title: "Mobotix Alarmkonfigurationshandbuch" source: /de/gcxone/devices/mobotix locale: de updated: 2026-09-02 --- ## Einleitung Dieses Handbuch beschreibt, wie Sie eine MOBOTIX M15 Kamera konfigurieren, um eine strukturierte Alarmbenachrichtigung zu erzeugen und über Raw TCP/IP an einen NXGEN Alarmempfänger zu senden, wobei das Ereignissystem der Kamera und das IP Notify‑Profil verwendet werden. Es behandelt die Konfiguration der MOBOTIX Weboberfläche, das IP Notify‑Profil (Custom Configuration über Raw TCP/IP), die JSON‑Alarm‑Nutzlast, die Validierung der Nachricht am Empfänger und das Hinzufügen des MOBOTIX Geräts zu GCXONE. ## Integrationsübersicht Die empfohlene Konfiguration verwendet die MOBOTIX Ereignis‑Engine, um eine IP Notify‑Aktion auszulösen. Das IP Notify‑Profil formatiert die Ereignisdaten als JSON und sendet sie über eine von der Kamera initiierte TCP‑Verbindung an einen externen Empfänger. - **Ereignisquelle:** ein internes MOBOTIX‑Ereignis — Sensor, Analytik, Eingang oder ein anderer konfigurierter Auslöser. - **Ereignisreaktion:** eine Action Group führt die IP Notify‑Aktion aus. - **Benachrichtigungstransport:** Raw TCP/IP. - **Ziel:** die IP‑Adresse und der TCP‑Port des externen Empfängers. - **Nachrichtenformat:** Klartext, der ein JSON‑Objekt enthält, das mit MOBOTIX‑Variablenausdrücken gefüllt ist. - **Verantwortung des Empfängers:** das TCP‑Nachricht akzeptieren, den konfigurierten Trenner erkennen, das JSON parsen, das Ereignis validieren und es gemäß der nachgelagerten Integration verarbeiten. **Ablauf:**MOBOTIX‑Ereignis → Action Group → IP Notify‑Profil → Raw TCP/IP → Alarmempfänger → NXGEN / nachgelagerte Alarmverarbeitung. ## Öffnen Sie die MOBOTIX Konfigurationsmenüs Öffnen Sie über die Weboberfläche der Kamera die **Menü** Steuerung und wechseln Sie in den administrativen Konfigurationsbereich. Exakte Menübezeichnungen können je nach Kamerafirmware und Interface‑Version variieren. ![1](/api/media/file/blob-edited-60df60a2.jpg?prefix=media) Navigieren Sie zum Ereigniskonfigurationsbereich und suchen Sie das **Action Group** / **IP Notify** Einstellungen. Die Action Group bestimmt, wann eine Benachrichtigung erzeugt wird; das IP Notify‑Profil bestimmt, wo und wie die Benachrichtigung übertragen wird. ## IP Notify‑Profil konfigurieren Erstellen oder bearbeiten Sie ein IP Notify‑Profil, das dem externen Alarmempfänger zugeordnet ist. | Feld | Empfohlener Wert | Zweck / Notizen | | --- | --- | --- | | IP Notify‑Profil | Ein eindeutiger Name, z. B. MultipleNotify | Verwenden Sie ein Profil, das dieser Integration gewidmet ist. | | IP Notify‑Typ | Custom Configuration | Ermöglicht die explizite Definition der Alarm‑Nutzlast. | | Zieladresse | Empfänger‑IPv4‑Adresse und TCP‑Port | Bestätigen Sie den korrekten Endpunkt mit dem Kundensupport, bevor Sie live gehen – gehen Sie nicht von einem Standard aus. | | Auftrag senden | Parallel an alle senden | Verwenden Sie dies, wenn mehrere Ziele konfiguriert sind und alle die Nachricht erhalten sollen. | | Datenprotokoll | Raw TCP/IP | Sendet die Benachrichtigung als TCP‑Datenstrom statt als HTTP‑Anfrage. | | Trennzeichen für Raw TCP/IP | Ein eindeutiger String, z. B. --next-image-- | Der Empfänger verwendet dieses Marker, um Nachrichten­grenzen im TCP‑Strom zu erkennen. Es darf nicht im JSON‑Body vorkommen. | | Datentyp | Klartext | Erforderlich für die in diesem Leitfaden verwendete JSON‑Nutzlast. | | Sendeport | 0 | Automatisch. | **Wichtig:** Bestätigen Sie stets die Ziel‑IP‑Adresse und den Port mit dem Kundensupport, bevor Sie eine Live‑Integration konfigurieren. ![14](/api/media/file/blob-26--edited-5ede41a8.png?prefix=media) ## MOBOTIX Ereignis‑/Aktionsgruppe konfigurieren Das IP‑Notify‑Profil legt nicht selbst fest, wann ein Alarm gesendet wird – ein Ereignis muss mit einer Aktionsgruppe verbunden werden, die es auslöst. ![14](/api/media/file/blob-1--edited-74645c45.jpg?prefix=media) **Schritt 1:** Aktivieren Sie die neue (oder bestehende) Aktionsgruppe. **Schritt 2:** Wählen Sie die Ereignisse aus, die eine TCP‑Alarmbenachrichtigung auslösen sollen. Die Auswahl von allen benachrichtigt bei jedem konfigurierten Kamera‑ und Systemereignis. **Schritt 3:** Legen Sie eine Sperrzeit von etwa 5 Sekunden zwischen Aktionen fest und konfigurieren Sie die Aktionen so, dass sie gleichzeitig ausgelöst werden. **Schritt 4:** Wählen Sie das von Ihnen konfigurierte IP‑Notify‑Profil aus und setzen Sie ein Timeout von etwa 30 Sekunden. ![45](/api/media/file/4E084C64-9D8C-425A-8319-BADCB67453D1-edited-2df1091c.png?prefix=media) Empfohlene Konfigurationsreihenfolge: 1. Konfigurieren oder überprüfen Sie die Ereignisquelle (Bewegung, Eingangsauslösung, ein Analytik‑Ereignis oder eine andere Alarmbedingung). 2. Erstellen oder bearbeiten Sie eine Aktionsgruppe für dieses Ereignis. 3. Fügen Sie die IP‑Notify‑Aktion hinzu und wählen Sie das dedizierte IP‑Notify‑Profil. 4. Legen Sie das erforderliche Vor‑/Nach‑Ereignis‑Verhalten des Alarm‑Workflows fest. 5. Aktivieren Sie die Aktionsgruppe und bestätigen Sie, dass das Ereignis scharf und aktiv ist. 6. Lösen Sie ein kontrolliertes Testereignis aus und prüfen Sie die Empfängerseite. ## Alarmnachricht JSON Payload Verwenden Sie den folgenden Klartext-Nachrichtentext im IP Notify‑Profil. Jeder `$(…)` Ausdruck ist eine MOBOTIX‑Ersetzungsvariable, die beim Erzeugen der Benachrichtigung ausgewertet wird. ```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)" } ``` ## Verarbeitung auf Empfängerseite Der Empfänger behandelt die MOBOTIX‑Verbindung als TCP‑Stream. TCP bewahrt keine anwendungsspezifischen Nachrichten­grenzen, daher muss der konfigurierte Trenner explizit verarbeitet werden: - Akzeptieren Sie die eingehende TCP‑Verbindung am konfigurierten Port. - Sammeln Sie Bytes, bis der konfigurierte Trenner (z. B. `--next-image--`) erkannt wird. - Extrahieren Sie die Nachrichtenbytes vor dem Trenner. - Entfernen Sie Transport‑Leerzeichen und parsen Sie den extrahierten Text als JSON. - Validieren Sie Pflichtfelder wie `eventTime`, `eventCode`, `ipaddress`, und `serial`, sowie alle ereignisbezogenen Werte, die das nachgelagerte System benötigt. - Ordnen Sie das normalisierte Ereignis dem Alarmmodell zu, das vom Ziel‑Alarmempfänger verwendet wird. - Speichern Sie das ursprüngliche MOBOTIX‑Payload für Fehlersuche und Audit, soweit praktikabel. **Beispiel für Nachrichtenrahmung:** ```text {JSON alarm object}--next-image--{next JSON alarm object}--next-image-- ``` ## Konfigurations‑Checkliste - IP Notify‑Profil erstellt und aktiviert. - Ziel‑IP und TCP‑Port mit dem Kundensupport verifiziert. - Roh‑TCP/IP als Datenprotokoll ausgewählt. - Ein eindeutiger Trenner wurde konfiguriert und dokumentiert. - Klartext als Datentyp ausgewählt. - JSON‑Payload eingefügt und validiert. - Duplizierte JSON‑Eigenschaftsnamen entfernt oder umbenannt. - Aktionsgruppe mit der vorgesehenen Ereignisquelle konfiguriert. - Aktionsgruppe ruft das korrekte IP Notify‑Profil auf. - Ein kontrolliertes Testereignis wurde erfolgreich empfangen und geparst. - Ein Mehrereignis‑/Burst‑Test wurde abgeschlossen. - Der Alarm wird zugeordnet und in der nachgelagerten Integration gespeichert. - MOBOTIX‑Gerät zu GCXONE hinzugefügt und erfolgreich entdeckt. ## Hinweise und Firmware‑Kompatibilität - MOBOTIX‑Variablennamen und welche Variablen verfügbar sind, können vom Kameramodell, der Firmware‑Version und dem Ereigniskontext abhängen. Validieren Sie die Variablen auf der tatsächlichen Kamerafirmware, bevor Sie das Payload standardisieren. - Konfigurationsmenüs und Bezeichnungen können zwischen Firmware‑Versionen variieren – die in diesem Leitfaden referenzierten Bildschirme können in zukünftiger MOBOTIX‑Firmware neu angeordnet sein. ## Mobotix Config Guide mit GCXONE **Schritt 1:** Navigieren Sie zum **Geräte** Reiter. **Schritt 2:** Klicken Sie die **Add New** Schaltfläche. ![14](/api/media/file/Screenshot-2026-09-02-135203-edited-289d4385.png?prefix=media) **Schritt 3:** Das **Gerät hinzufügen** Dialogfeld wird angezeigt. **Schritt 4:** Im Dialog öffnen Sie das **Gerät** Dropdown und wählen **Mobotix**. ![2112](/api/media/file/Screenshot-2026-09-02-135456-edited-051e9d7a.png?prefix=media) **Schritt 5:** Geben Sie alle erforderlichen Felder ein: **Name**, **IP Adresse oder Hostname**, **MAC Adresse**, **Nutzername**, **Passwort**, **Steuerport**, **RTSP‑Port**. ![12112](/api/media/file/Screenshot-2026-09-02-135600-edited-639c60da.png?prefix=media) **Schritt 6:** Unterhalb der Verbindungsfelder enthält der Dialog außerdem ein **Entitätsgruppe auswählen** Dropdown, ein **Audio Aktivieren** Umschalter (standardmäßig aktiviert), ein erforderlicher **Zeitzone**, ein **Gerät Konfiguration** Abschnitt (Site Pulse Configuration), ein **Erweiterte Einstellungen** Abschnitt (Ereignisabfrage, Heatmap-Maske konfigurieren, Periodische Statusprüfung, Ereignisaufbewahrungszeit — 30 Tage standardmäßig), und ein optionaler **Standort** Abschnitt (Latitude, Longitude, Plus Code, What3Words). ![121](/api/media/file/Screenshot-2026-09-02-135717-edited-bbf6a553.png?prefix=media) **Schritt 7:** Click **Suche**. **Schritt 8:** Sobald das Gerät erfolgreich entdeckt wurde, klicken Sie **Speichern**.