Mobotix Alarmkonfigurationshandbuch

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.

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.

Wichtig: Bestätigen Sie stets die Ziel‑IP‑Adresse und den Port mit dem Kundensupport, bevor Sie eine Live‑Integration konfigurieren.

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.

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.

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.

{
  "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:

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

Schritt 3: Das Gerät hinzufügen Dialogfeld wird angezeigt.

Schritt 4: Im Dialog öffnen Sie das Gerät Dropdown und wählen Mobotix.

Schritt 5: Geben Sie alle erforderlichen Felder ein: Name, IP Adresse oder Hostname, MAC Adresse, Nutzername, Passwort, Steuerport, RTSP‑Port.

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

Schritt 7: Click Suche.

Schritt 8: Sobald das Gerät erfolgreich entdeckt wurde, klicken Sie Speichern.