---
title: "Guide de configuration d’Alarme Mobotix"
source: /fr/gcxone/devices/mobotix
locale: fr
updated: 2026-09-02
---
## Introduction

Ce guide décrit comment configurer une caméra MOBOTIX M15 pour générer une notification d’alarme structurée et l’envoyer à un récepteur d’alarme NXGEN via Raw TCP/IP, en utilisant le moteur d’événements de la caméra et le profil IP Notify. Il couvre la configuration de l’interface web MOBOTIX, le profil IP Notify (Configuration Personnalisée via Raw TCP/IP), la charge utile d’alarme JSON, la validation du message au récepteur, et l’ajout de l’appareil MOBOTIX à GCXONE.

## Aperçu de l’intégration

La configuration recommandée utilise le moteur d’événements MOBOTIX pour déclencher une action IP Notify. Le profil IP Notify formate les données d’événement en JSON et les envoie à un récepteur externe via une connexion TCP initiée par la caméra.

- **Source d’événement :** un événement interne MOBOTIX — capteur, analytique, entrée, ou un autre déclencheur configuré.
- **Réaction d’événement :** un groupe d’actions exécute l’action IP Notify.
- **Transport de notification :** Raw TCP/IP.
- **Destination :** l’adresse IP et le port TCP du récepteur externe.
- **Format du message :** texte brut contenant un objet JSON rempli avec des expressions de variables MOBOTIX.
- **Responsabilité du récepteur :** accepter le message TCP, détecter le séparateur configuré, analyser le JSON, valider l’événement et le traiter selon l’intégration en aval.

**Flux :** Événement MOBOTIX → Groupe d’actions → Profil IP Notify → Raw TCP/IP → Récepteur d’Alarme → NXGEN / traitement d’alarme en aval.

## Ouvrir les menus de configuration MOBOTIX

Depuis l’interface web de la caméra, ouvrez le **Menu** de contrôle et accédez à la zone de configuration administrative. Les libellés exacts des menus peuvent varier selon le firmware de la caméra et la version de l’interface.

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

Naviguez vers la zone de configuration des événements et localisez le **Groupe d’actions** / **IP Notify** paramètres. Le Groupe d’actions détermine quand une notification est générée ; le profil IP Notify détermine où et comment la notification est transmise.

## Configurer le profil IP Notify

Créer ou modifier un profil IP Notify dédié au récepteur d’alarme externe.

| Champ | Valeur recommandée | Objectif / notes |
| --- | --- | --- |
| Profil IP Notify | Un nom dédié, p. ex. MultipleNotify | Utiliser un profil dédié à cette intégration. |
| Type IP Notify | Configuration Personnalisée | Permet de définir explicitement la charge utile d’alarme. |
| Adresse de destination | Adresse IPv4 du récepteur et port TCP | Confirmer le point de terminaison correct avec le Support client avant la mise en service — ne pas supposer une valeur par défaut. |
| Envoyer la commande | Envoi parallèle à tous | Utiliser lorsque plusieurs destinations sont configurées et que toutes doivent recevoir le message. |
| Protocole de données | TCP/IP brut | Envoie la notification sous forme de flux de données TCP plutôt que d’une requête HTTP. |
| Séparateur pour TCP/IP brut | Une chaîne unique, par ex. --next-image-- | Le récepteur utilise ce marqueur pour identifier les limites du message dans le flux TCP. Il ne doit pas apparaître dans le corps JSON. |
| Type de données | Texte brut | Requis pour la charge utile JSON utilisée dans ce guide. |
| Port d’envoi | 0 | Automatique. |

**Important :** Toujours confirmer l’adresse IP de destination et le port avec le Support client avant de configurer une intégration en direct.

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

## Configurer le groupe d’événements / d’actions MOBOTIX

Le profil IP Notify ne définit pas à lui seul le moment où une alarme est envoyée — un événement doit être relié à un groupe d’actions qui l’invoque.

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

**Étape 1 :** Activer le nouveau groupe d’actions (ou existant).

**Étape 2 :** Sélectionner les événements qui doivent déclencher une notification d’alarme TCP. Sélectionner tout déclenchera une notification pour chaque caméra et chaque événement du système configurés.

**Étape 3 :** Définir un temps mort d’environ 5 secondes entre les actions, et configurer les actions pour qu’elles se déclenchent simultanément.

**Étape 4 :** Sélectionner le profil IP Notify que vous avez configuré, et définir un délai d’attente d’environ 30 secondes.

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

Séquence de configuration recommandée :

1. Configurer ou vérifier la source de l’événement (mouvement, activation d’entrée, événement d’analytique ou autre condition d’alarme).
2. Créer ou modifier un groupe d’actions pour cet événement.
3. Ajouter l’action IP Notify et sélectionner le profil IP Notify dédié.
4. Définir tout comportement pré‑événement / post‑événement requis par le flux de travail de l’alarme.
5. Activer le groupe d’actions et confirmer que l’événement est actif et armé.
6. Déclencher un événement de test contrôlé et vérifier le côté récepteur.

## Charge utile JSON du message d’Alarme

Utiliser le corps du message en texte brut suivant dans le profil IP Notify. Chaque `$(…)` expression est une variable de substitution MOBOTIX, évaluée lors de la génération de la notification.

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

## Traitement côté récepteur

Le récepteur traite la connexion MOBOTIX comme un flux TCP. TCP ne préserve pas les limites de messages au niveau de l’application, le séparateur configuré doit donc être géré explicitement :

- Accepter la connexion TCP entrante sur le port configuré.
- Accumuler les octets jusqu’à ce que le séparateur configuré (par exemple, `--next-image--`) soit détecté.
- Extraire les octets du message précédant le séparateur.
- Supprimer les espaces blancs de transport et analyser le texte extrait comme JSON.
- Valider les champs obligatoires tels que `eventTime`, `eventCode`, `ipaddress`, et `serial`, ainsi que toute valeur liée à l’événement requise par le système en aval.
- Mapper l’événement normalisé dans le modèle d’alarme utilisé par le récepteur d’alarme cible.
- Conserver la charge utile MOBOTIX originale pour le dépannage et l’audit lorsque cela est possible.

**Exemple d’encadrement du message :**

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

## Liste de contrôle de configuration

- Profil IP Notify créé et activé.
- IP de destination et port TCP vérifiés avec le support Client.
- TCP/IP brut sélectionné comme protocole de données.
- Séparateur unique configuré et documenté.
- Texte brut sélectionné comme type de données.
- Charge utile JSON insérée et validée.
- Noms de propriétés JSON en double supprimés ou renommés.
- Groupe d’actions configuré avec la source d’événement prévue.
- Groupe d’actions invoque le profil IP Notify correct.
- Un événement de test contrôlé a été reçu et analysé avec succès.
- Un test d’événement multiple / rafale a été complété.
- L’alarme est mappée et conservée dans l’intégration en aval.
- Appareil MOBOTIX ajouté à GCXONE et découvert avec succès.

## Notes et compatibilité du firmware

- Les noms de variables MOBOTIX, et les variables disponibles, peuvent dépendre du modèle de caméra, de la version du firmware et du contexte de l’événement. Valider les variables sur le firmware réel de la caméra avant de standardiser la charge utile.
- Les menus de configuration et les libellés peuvent varier selon les versions du firmware — les écrans référencés dans ce guide peuvent être réorganisés dans les futurs firmware MOBOTIX.

## Guide de configuration Mobotix avec GCXONE

**Étape 1 :** Naviguer vers le **Appareils** onglet.

**Étape 2 :** Cliquer sur le **Ajouter nouveau** bouton.

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

**Étape 3 :** La **Ajouter un appareil** boîte de dialogue s’affichera.

**Étape 4 :** Dans la boîte de dialogue, ouvrir le **Appareil** menu déroulant et sélectionner **Mobotix**.

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

**Étape 5 :** Saisir tous les champs obligatoires : **Nom**, **Adresse IP ou nom d’hôte**, **Adresse MAC**, **Nom d’utilisateur**, **Mot de passe**, **Port de contrôle**, **Port RTSP**.

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

**Étape 6 :** En dessous des champs de connexion, la boîte de dialogue possède également un **Sélectionner le groupe d'entités** déroulant, un **Activer l'audio** bascule (activé par défaut), un **Fuseau horaire**, un **Appareil Configuration** section (Configuration Site Pulse), un **Paramètres avancés** section (Event Polling, Configure Heatmap Mask, Periodic Health Check, Event Retention Time — 30 days by default), et un **Emplacement** section (Latitude, Longitude, Plus Code, What3Words).

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

**Étape 7 :** Cliquez **Découvrir**.

**Étape 8 :** Une fois l'appareil découvert avec succès, cliquez **Enregistrer**.