# Colonnes du fichier CSV

L'outil d'entrepôt de données vous permet d'exporter un fichier de données brutes contenant tous les paquets reçus depuis votre appareil, sans aucun filtrage ni calcul effectué côté plateforme. Ces paramètres représentent des informations initialement décodées à partir du paquet de votre appareil dans un format lié au protocole, présentées de manière lisible par l'humain. Vous n'avez pas besoin de connaître le protocole pour lire et vérifier les informations contenues dans ces paquets.

{% hint style="info" %}
Pour apprendre comment télécharger ces informations, vous pouvez vous référer à notre [article précédent](https://www.navixy.com/docs/expert-center/fr/faq-and-troubleshooting/access-iot-data/save-iot-data-to-csv-file). Ici, nous visons à explorer plus en détail comment lire ce fichier et interpréter les différentes colonnes qui le composent.
{% endhint %}

## Ouverture d'un fichier

Le nom de fichier contient toujours les éléments suivants :

* ID de l'appareil : Le numéro d'identification de l'appareil, représentant souvent son IMEI.
* Étiquette de l'appareil sur la plateforme : Une étiquette pour faciliter la recherche du fichier.
* Heure de début et de fin : Représentant le début et la fin du fichier au format jour\_mois\_année\_heures\_minutes\_AM/PM.
* Fuseau horaire au format UTC.

Vous pouvez ouvrir le fichier de données brutes avec n'importe quel éditeur de texte, tel que WordPad, Notepad++ ou Sublime Text. Ce format est facilement compris par les programmes et les machines mais peut être moins clair pour les personnes. Pour simplifier la lecture du fichier, nous recommandons d'utiliser un éditeur de tableaux. Ouvrez simplement le fichier CSV avec Excel, Google Sheets ou tout autre éditeur de tableaux. Dans l'éditeur de tableaux, tous les paramètres seront dans leurs propres colonnes. De plus, vous pouvez figer la première ligne pour voir les noms des colonnes tout au long du fichier.

## Paramètres des données brutes

Le fichier inclura les paramètres sélectionnés dans des colonnes, ainsi qu'une entrée constante : msg\_time.

![](https://3233900410-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-2f5edca71dd9b788133c28403e6c7f4d95373331%2Fimage-20240209-073506.png?alt=media)

Ces paramètres peuvent être catégorisés comme simples ou complexes.

### Colonnes simples

Les paramètres simples fournissent des noms complets et représentent principalement des informations de suivi spécifiques.

* `msg_time` : Heure à laquelle le traceur a enregistré un point. Toujours inclus dans la sortie CSV. Indiqué selon le fuseau horaire choisi.
* `server_time` : Heure de réception du message par le serveur. Indiqué selon le fuseau horaire choisi.
* `gps_fix_type`
  * NO\_FIX : Le traceur GPS a marqué que la localisation n'est pas valide.
  * HAS\_FIX : Le traceur GPS a marqué que la localisation est valide.
  * LAST\_KNOWN\_POSITION : Dans le cas où le traceur fournit une entrée actuelle et d'autres états au sein de la dernière position connue.
  * UNKNOWN : Si un appareil ne peut pas fournir cette information ou n'a pas déterminé le type de fix GPS pour ce paquet.
* `lat` : Latitude de la localisation.
* `lng` : Longitude de la localisation.
* `speed` : Vitesse déterminée par le traceur en km/h. Dans la plupart des cas, il s'agit de la vitesse déterminée par le GPS de l'appareil.
* `alt` : Altitude de la localisation en mètres.
* `satellites` : Nombre de satellites connectés à ce moment ; `-1` signifie inconnu et, dans la plupart des cas, représente un point de localisation LBS.
* `heading` : Cap de l'objet en degrés où 0 représente le Nord.
* `precision` : Précision de la localisation en mètres.
* `hdop` : Dilution horizontale de la précision - représente la précision des estimations de la position horizontale du traceur GPS. Les valeurs vont de 1 (excellent) à plus de 20 (faible). Les valeurs entre 1 et 2 sont considérées comme bonnes pour la plupart des usages de navigation. `-1` signifie inconnu.
* `pdop` : Dilution de position (PDOP) - indique la précision de la position d'un traceur GPS en fonction de la géométrie des satellites par rapport au traceur. Des valeurs PDOP plus faibles signifient un meilleur positionnement par satellites, conduisant à des données de localisation plus précises, mais `-1` signifie inconnu.
* `mn_name` : Nom du réseau mobile. Déterminé par l'appareil.
* `mn_roaming` : État d'itinérance. Est déterminé par l'appareil.
  * `0` signifie pas d'itinérance,
  * `1` signifie que ce point a été généré par un appareil en itinérance,
  * Si l'appareil ne peut pas fournir de telles données ou ne l'a pas fait pour ce message particulier, ce sera `-1` (inconnu).
* `mn_code` : Code de l'opérateur du réseau mobile. Déterminé par l'appareil.
* `mn_csq` : Intensité du signal du réseau mobile, CSQ, valeurs de 0 à 31. Déterminé par l'appareil. Si l'appareil ne peut pas fournir de telles données ou ne l'a pas fait pour ce message particulier, ce sera `99` (inconnu).
* `mn_type` : Type de réseau mobile. Est déterminé par l'appareil.
  * Si l'appareil ne peut pas fournir de telles données ou ne l'a pas fait pour ce message particulier, ce sera `UNKNOWN`
  * `GSM` : Si l'appareil a déterminé le type GSM.
  * `CDMA` : Si l'appareil a déterminé le type CDMA.
  * `WCDMA` : Si l'appareil a déterminé le type WCDMA.
  * `LTE` : Si l'appareil a déterminé le type LTE.
  * `NR` : Si l'appareil a déterminé le type NR.
* `event_id` : ID d'événement de la plateforme. Trouvez la liste de tous les codes d'ID d'événement ci-dessous.

<details>

<summary>Codes d'événements de la plateforme et leurs définitions</summary>

Dans les paquets de l'appareil, divers codes d'événements peuvent être définis, chacun signifiant une occurrence spécifique.

| **ID d'événement** | **Définition**                                                               |
| ------------------ | ---------------------------------------------------------------------------- |
| 2                  | Suivi. Aucun événement spécifique, juste un point de suivi                   |
| 4                  | Numéro de contact d'urgence appelé                                           |
| 5                  | Événement de mouvement non autorisé déterminé par l'appareil                 |
| 11                 | Changement d'état de l'entrée 1                                              |
| 12                 | Changement d'état de l'entrée 2                                              |
| 13                 | Changement d'état de l'entrée 3                                              |
| 14                 | Changement d'état de l'entrée 4                                              |
| 15                 | Changement d'état de l'entrée 5                                              |
| 16                 | Changement d'état de l'entrée 6                                              |
| 17                 | Changement d'état de l'entrée 7                                              |
| 18                 | Changement d'état de l'entrée 8                                              |
| 34                 | L'appareil se réveille d'un mode veille                                      |
| 37                 | Début du mode veille                                                         |
| 40                 | Alimentation principale faible                                               |
| 41                 | Alimentation perdue ou coupure d'alimentation externe                        |
| 42                 | Bouton d'alimentation pressé                                                 |
| 43                 | Alimentation rétablie ou alimentation externe connectée                      |
| 44                 | OBD débranché du connecteur de la voiture                                    |
| 45                 | OBD branché                                                                  |
| 46                 | Batterie de secours de l'appareil faible                                     |
| 50                 | Fin de l'inactivité (liée au matériel)                                       |
| 51                 | Début de l'inactivité (liée au matériel)                                     |
| 71                 | Début du sommeil d'inactivité                                                |
| 72                 | Début du sommeil pour batterie de secours faible                             |
| 73                 | Réveil par minuterie                                                         |
| 74                 | Réveil par mouvement                                                         |
| 75                 | Réveil par alimentation externe                                              |
| 76                 | Alerte de sommeil par minuterie                                              |
| 81                 | Mode de sécurité activé                                                      |
| 82                 | Événement utilisateur                                                        |
| 83                 | Événement bouton SOS pressé                                                  |
| 84                 | Mode de sécurité désactivé                                                   |
| 90                 | Déconnexion d'antenne                                                        |
| 100                | Appareil détaché de l'objet                                                  |
| 111                | Changement d'état de la sortie 1                                             |
| 112                | Changement d'état de la sortie 2                                             |
| 113                | Changement d'état de la sortie 3                                             |
| 114                | Changement d'état de la sortie 4                                             |
| 115                | Changement d'état de la sortie 5                                             |
| 116                | Changement d'état de la sortie 6                                             |
| 117                | Changement d'état de la sortie 7                                             |
| 118                | Changement d'état de la sortie 8                                             |
| 797                | Check-in envoyé depuis l'application mobile                                  |
| 798                | Soumission de formulaire de tâche                                            |
| 799                | Changement d'état de travail                                                 |
| 800                | Point LBS GSM déterminé par un appareil                                      |
| 802                | Point de suivi par temps                                                     |
| 803                | Point de suivi par distance                                                  |
| 804                | Point de suivi par angle                                                     |
| 811                | Début du mouvement de suivi                                                  |
| 812                | Fin du mouvement de suivi                                                    |
| 813                | Fin du mouvement non autorisé                                                |
| 814                | Message non lié au suivi                                                     |
| 900                | Changement de voie brusque (conduite agressive)                              |
| 901                | Brouillage GPS                                                               |
| 928                | Déconnexion de l'objet suivi                                                 |
| 929                | Changement fréquent de voie                                                  |
| 930                | L'appareil ne peut pas détecter de visage humain                             |
| 931                | Ceinture de sécurité débouclée                                               |
| 932                | Boire                                                                        |
| 933                | Yeux fermés                                                                  |
| 934                | Attacher l'appareil à l'objet suivi                                          |
| 935                | MDSM 7 déconnecté                                                            |
| 936                | MDSM 7 connecté                                                              |
| 937                | Signaler un nouveau conducteur                                               |
| 938                | Le conducteur entre dans la cabine                                           |
| 939                | Début de l'absence du conducteur                                             |
| 940                | Le conducteur a arrêté de fumer (distraction du conducteur)                  |
| 941                | Bouton d'arrêt mis hors tension pressé                                       |
| 942                | Le conducteur a commencé à fumer (distraction du conducteur)                 |
| 943                | Le conducteur a cessé d'utiliser le téléphone (distraction du conducteur)    |
| 944                | Le conducteur a commencé à utiliser le téléphone (distraction du conducteur) |
| 945                | Bâillement (fatigue au volant)                                               |
| 946                | Le conducteur a arrêté la distraction (distraction du conducteur)            |
| 947                | Le conducteur a commencé la distraction (distraction du conducteur)          |
| 948                | Le conducteur a arrêté la somnolence (fatigue au volant)                     |
| 949                | Le conducteur a commencé la somnolence (fatigue au volant)                   |
| 950                | Excès de vitesse détecté par un événement matériel                           |
| 951                | Régulateur de vitesse activé                                                 |
| 952                | Régulateur de vitesse désactivé                                              |
| 953                | Début d'un mouvement inattendu                                               |
| 954                | Fin d'un mouvement inattendu                                                 |
| 955                | Alarme de voiture                                                            |
| 956                | Piétons dans la zone de danger (ADAS)                                        |
| 957                | Reconnaissance des panneaux de signalisation (ADAS)                          |
| 958                | Alerte de collision avec piéton (ADAS)                                       |
| 959                | Voyant de contrôle moteur                                                    |
| 960                | Conduite en état de fatigue                                                  |
| 961                | Alerte d'écart de distance (Headway) (ADAS)                                  |
| 962                | Départ de voie à droite (ADAS)                                               |
| 963                | Départ de voie à gauche (ADAS)                                               |
| 964                | Départ de voie (ADAS)                                                        |
| 965                | Alerte de collision avant (ADAS)                                             |
| 966                | Le traceur est entré dans une géofence automatique                           |
| 967                | Le traceur est sorti d'une géofence automatique                              |
| 968                | Forcer la réponse de localisation par SMS depuis l'interface utilisateur     |
| 969                | Alarme de porte                                                              |
| 970                | Allumage Off                                                                 |
| 971                | Allumage On                                                                  |
| 972                | Conducteur non identifié                                                     |
| 973                | Conducteur identifié                                                         |
| 974                | Verrou fermé                                                                 |
| 975                | Verrou ouvert                                                                |
| 976                | Appareil éteint                                                              |
| 977                | Appareil allumé                                                              |
| 978                | Boîtier fermé                                                                |
| 979                | Boîtier ouvert                                                               |
| 980                | Bouton d'appel pressé                                                        |
| 981                | Capteur de lumière a déterminé l'obscurité                                   |
| 982                | Capteur de lumière a déterminé la luminosité                                 |
| 983                | Fin de vibration                                                             |
| 984                | Début de vibration                                                           |
| 985                | Boulon de sangle inséré                                                      |
| 986                | Boulon de sangle coupé                                                       |
| 987                | Accélération et virage brusques (conduite agressive)                         |
| 988                | Freinage et virage brusques (conduite agressive)                             |
| 989                | Virage brusque (conduite agressive)                                          |
| 990                | Accélération brusque (conduite agressive)                                    |
| 991                | Freinage brusque (conduite agressive)                                        |
| 992                | Signal GPS récupéré                                                          |
| 993                | Signal GPS perdu                                                             |
| 994                | Alarme de collision                                                          |
| 995                | Alerte d'atténuation du signal GSM                                           |
| 996                | Conduite brutale                                                             |
| 997                | Bracelet ouvert                                                              |
| 998                | Bracelet fermé                                                               |
| 999                | Alerte capteur G                                                             |

</details>

### Paramètres complexes

Les paramètres complexes incluent à la fois le nom du groupe et le nom spécifique. Ils sont catégorisés comme suit :

* `flags` : Une carte de bits (bitmap) de drapeaux représentant la validité de la localisation et LBS :
  * Bit 0 (location\_valid) : Indique le statut de validité de la localisation. Il est `0` si la localisation est invalide, et `1` si la localisation est valide.
  * Bit 1 (lbs) : Indique l'état LBS du point. Si `0`, le point est reçu par GPS ; si `1`, le point est reçu par LBS.
  * Bit 2 (soft\_lbs) : Indique la source du point LBS. Si `0`, le point est déterminé par le LBS de l'appareil ; si `1`, par le LBS de la plateforme.
* `discrete_inputs` : Représente l'information de chaque entrée discrète. Chaque entrée discrète est présentée dans une colonne séparée, numérotée à partir de 1. Les valeurs possibles sont 1 et 0, où 0 signifie éteint, et 1 signifie allumé.
* `discrete_outputs`  : Montre la même chose que les entrées discrètes mais pour les sorties discrètes. Chaque sortie discrète est dans une colonne séparée, numérotée à partir de 1.
* `inputs` : Représente les données provenant de différents capteurs, tels que le carburant ou divers capteurs de mesure. Chaque entrée est dans une colonne séparée, et la liste des entrées dépend du modèle d'appareil.
* `states` : Affiche les valeurs des paramètres d'état. La plupart d'entre eux peuvent être 1 ou 0, mais certains ont des valeurs textuelles spécifiques comme des codes DTC.

Avec ces définitions, nous espérons que vous trouverez facile de lire les informations dans les fichiers de données brutes et de les utiliser pour le dépannage des appareils et dans des programmes pour vos clients.
