Logo Neyos

Données transmises

Structure complète des messages envoyés par la balise (points GPS, événements, configuration et informations contextuelles).

Comment fonctionne la balise OTRAC ?

Votre balise communique par messages structurés contenant des éléments horodatés. Chaque message regroupe :

  • Des informations contextuelles (batterie, température, réseau)
  • Des éléments spécialisés (points GPS, événements, configuration)

Tout est organisé chronologiquement pour optimiser la transmission réseau.

Où consulter vos messages ?

Les messages de votre balise sont accessibles depuis la Plateforme Neyos :

  • Ouvrez Plateforme Neyos → Balises → Votre balise
  • Accédez à l'onglet Messages
  • Consultez l'historique complet des transmissions
  • Chaque ligne représente un message. Cliquez dessus pour déplier son contenu et visualiser les éléments sur la carte interactive et dans le tableau de données détaillées.

    De quoi sont composés les messages ?

    Chaque message transmis par votre balise contient deux types d'informations :

    1. État de la balise

    Automatiquement présent dans tous les messages pour diagnostiquer le fonctionnement :

    InformationExempleDescription
    Batterie 85%Niveau de charge restant (0-100%)
    Température 48°CTempérature interne du module
    Réseau Orange Opérateur, type réseau (LTE-M/NB-IoT/SAT) et qualité signal
    Horodatage 23/09/2025 13:27Date et heure d'envoi du message (UTC)

    2. Données associées

    Données horodatées permettant de suivre l'activité et la position de votre balise. Il existe 3 types de données :

    Points GPS

    Positions géolocalisées avec données de mouvement

    Contenu :

    • Coordonnées (latitude, longitude, altitude)
    • Vitesse instantanée et cap
    • Qualité du fix GPS (2D/3D)
    • Horodatage précis

    Badge : Point

    Événements

    Changements d'état et actions détectées

    Contenu :

    • Type d'événement (bouton, choc, veille...)
    • Horodatage précis
    • Position GPS associée (si disponible)
    • Données complémentaires

    Badge : Événement

    Points GPS

    Un Point est une acquisition GPS horodatée contenant la position géographique, les données de mouvement et la qualité du signal satellite. Chaque acquisition GPS enregistre les données suivantes :

    ChampTypeDescriptionExemple
    LatitudeDécimal (WGS84)Coordonnée Nord-Sud48.8566 (Paris)
    LongitudeDécimal (WGS84)Coordonnée Est-Ouest2.3522 (Paris)
    AltitudeMètresHauteur au-dessus du niveau de la mer35m
    Vitessekm/hVitesse instantanée calculée par GNSS67 km/h
    CapDegrésDirection du déplacement (0-360°)245° (Sud-Ouest)
    Fix GPSEnumQualité du positionnement Pas de fixe / 2D / 3D
    PrécisionMètresEstimation de l'erreur de position (HDOP)5m (précision typique en 3D)
    TimestampISO 8601Horodatage UTC de l'acquisition2025-09-23T13:27:45Z

    Qualité du fix GPS

    La balise indique la qualité de chaque acquisition GPS selon trois niveaux :

    Pas de fixe

    Aucun satellite visible ou signal trop faible

    Comportement : Selon le paramètre Abscence de fixe GPS, la balise peut :

    • Skip : Ne pas enregistrer de point
    • Last_known : Répéter la dernière position valide

    Causes : Intérieur, parking souterrain, tunnel

    Fix 2D

    Positionnement horizontal uniquement (3 satellites)

    Précision : > 5 mètres (latitude/longitude uniquement)

    Causes : Signal GPS faible, environnement urbain dense, vue du ciel partielle

    Fix 3D

    Positionnement complet avec altitude (4+ satellites)

    Précision : 1-5 mètres (latitude, longitude, altitude)

    Recommandé : Toujours privilégier un fix 3D pour les mesures critiques

    Améliorer la qualité du fix : Pour la première acquisition ou après une longue période sans signal, placez la balise près d'une fenêtre ou en extérieur pendant quelques secondes. Le temps de premier fix peut atteindre 30-45 secondes en démarrage à froid.

    Événements

    Un Événement signale un changement d'état système ou une action détectée par la balise. Chaque événement est horodaté avec précision et peut être associé à une position GPS si le module GNSS était actif au moment du déclenchement.

    Liste complète des événements

    La balise OTRAC détecte et transmet 16 types d'événements organisés par catégorie :

    Événements système

    ÉvénementIcôneDescription
    Allumage de la balise Mise sous tension de la balise
    Extinction de la balise Arrêt de la balise
    Entrée en veille Passage en mode veille (active ou profonde)
    Sortie de veille Réveil après une période de veille

    Événements boutons

    ÉvénementIcôneDescription
    Appui bouton carré Appui validé sur le bouton carré
    Appui bouton croix Appui validé sur le bouton croix
    Appui bouton triangle Appui validé sur le bouton triangle

    Événements mouvement

    ÉvénementIcôneDescription
    Détection de mouvement Mouvement détecté après une période d'immobilité
    Détection de non mouvement Absence de mouvement détectée
    Détection de choc Impact ou choc violent détecté par l'accéléromètre

    Événements température

    ÉvénementIcôneDescription
    Seuil de température Température dépassant ou descendant sous un seuil défini

    Événements batterie

    ÉvénementIcôneDescription
    Détection de batterie faible Niveau de batterie descendu sous un seuil critique

    Événements alimentation

    ÉvénementIcôneDescription
    Détection de charge Connexion à une source d'alimentation
    Câble de recharge retiré Déconnexion du câble de recharge

    Événements connectique

    ÉvénementIcôneDescription
    Connexion port UART Connexion d'un accessoire sur le port UART
    Déconnexion port UART Déconnexion d'un accessoire sur le port UART

    Événements géographiques

    ÉvénementIcôneDescription
    Détection d'entrée de zone Entrée dans une zone géographique prédéfinie
    Détection de sortie de zone Sortie d'une zone géographique prédéfinie

    Caractéristiques des événements

    Chaque événement possède les propriétés suivantes :

    • Horodatage précis : Date et heure UTC du déclenchement (précision milliseconde)
    • Position GPS associée : Si le module GNSS était actif au moment de l'événement
    • Données complémentaires : Informations spécifiques selon le type d'événement (intensité choc, niveau batterie, etc.)
    • Visualisation : Pictogramme coloré dans l'interface plateforme avec badge Événement
    Déclencher une transmission immédiate : Les événements critiques (boutons, chocs, batterie faible) peuvent forcer le changement de réseau pour une transmission immédiate.

    Quand un message est-il envoyé ?

    Les messages sont transmis dans deux situations :

    Transmission périodique

    Selon l'intervalle configuré pour le réseau actif

    Paramètres :

    • Intervalle d'envoi cellulaire
    • Intervalle d'envoi satellite

    Usage : Mode normal, traçage continu

    Transmission à l'événement

    Déclenchée immédiatement par un événement critique

    Événements déclencheurs :

    • Appui sur bouton,
    • ...

    Usage : Alertes temps réel

    Questions fréquentes

    Causes possibles et solutions :

    1. Balise éteinte :
      • Vérifiez que la LED Power est allumée
      • Appuyez sur le bouton ON/OFF pendant 3 secondes
    2. Pas de couverture réseau :
      • Consultez la carte de couverture réseau
      • Essayez de déplacer la balise en extérieur ou près d'une fenêtre
      • Vérifiez les paramètres de bascule réseau (LTE-M ↔ Satellite)
    3. Intervalle de transmission trop long :
      • Vérifiez les paramètres Intervalle d'envoi dans l'onglet Configuration

    La balise dispose d'une mémoire tampon de 30 000 éléments maximum.

    Fonctionnement :

    • Les éléments (Points GPS, Événements, Config) sont stockés localement en mémoire flash
    • Dès que la connexion réseau est rétablie, les éléments sont retransmis automatiquement

    Au-delà de 30 000 éléments :

    • Les éléments les plus anciens sont écrasés (FIFO)
    • Un événement buffer_overflow est généré

    Raisons techniques :

    1. Signal GNSS insuffisant :
      • Balise en intérieur (bâtiment, parking souterrain, tunnel)
      • Environnement urbain dense (effet canyon)
    2. Démarrage à froid :
      • Temps de premier fix (TTFF) : 30-45 secondes après allumage
      • La balise peut acquérir avant d'avoir obtenu un fix complet
    3. Paramètre Abscence de fixe GPS :
      • Ignoré (recommandé) : Aucun point n'est enregistré si pas de fix
      • Dernière position connue : Répète la dernière position valide avec flag no_fix

    Et ensuite ?

    Vous maîtrisez maintenant la structure des données transmises par vos balises.
    Cette compréhension est essentielle pour exploiter efficacement les informations disponibles dans la plateforme et configurer des alertes pertinentes.

    Prochaines étapes recommandées :

    1. Configurer vos balises → Ajustez les Paramètres selon vos besoins (fréquence acquisition, transmission, réseaux)
    2. Mettre à jour le firmware → Assurez-vous d'avoir les dernières fonctionnalités
    3. Intégrer avec vos outils → Configurez des Webhooks ou utilisez l'API Neyos