> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/user/fr/guide/devices-and-settings/vehicle-sensors/virtual-sensors.md).

# Capteurs virtuels

Les Capteurs virtuels dans Navixy convertissent la télémétrie brute en libellés simples, déduisent le Contact à partir de la tension et associent des états d’appareil à valeurs multiples à des indicateurs lisibles.

Les capteurs virtuels vous permettent de traiter les données de télémétrie plus efficacement. En mappant la tension de bord, ils peuvent vous aider à calculer les heures moteur en fonction de conditions et de valeurs définies. De plus, ils vous permettent de convertir plusieurs points de données provenant de différents capteurs connectés à un appareil en indicateurs plus faciles à comprendre tels que « chaud », « froid », « ouvert » et « fermé », quel que soit le fabricant ou le modèle de l’appareil.

<figure><img src="https://www.navixy.com/wp-content/uploads/2024/03/browser_clvf66ikbi.png" alt="Virtual sensor interface"><figcaption><p>Interface du capteur virtuel</p></figcaption></figure>

## Disponibilité

Disponible lorsque l’appareil dispose d’entrées ou d’états à partir desquels dériver des valeurs. Chaque appareil prend en charge jusqu’à 100 capteurs virtuels.

## Comment créer un capteur virtuel

Les capteurs virtuels peuvent être créés via le **Boutons et capteurs** bloc situé dans le **Paramétrage des traceurs** module. Pour créer un capteur virtuel :

1. Accédez à la section Paramétrage des traceurs
2. Sélectionnez un appareil GPS
3. Cliquez sur le **+** bouton
4. Sélectionnez **Capteur virtuel**

Chaque appareil peut comporter jusqu’à 100 capteurs virtuels.

<figure><img src="https://www.navixy.com/wp-content/uploads/2024/03/browser_73sv6rayqh.png" alt="Virtual sensor adding in sensors and buttons block" width="375"><figcaption><p>Ajout d’un capteur virtuel dans Boutons et capteurs</p></figcaption></figure>

Les étapes suivantes dépendent du cas d’usage à résoudre à l’aide du capteur virtuel. Vous trouverez ci-dessous des exemples et des instructions pour différentes méthodes de calcul.

## Méthodes de calcul

Les capteurs virtuels ont trois types de calcul différents :

* Valeur dans l’intervalle
* Valeur source
* Indice de bit

Toutes les valeurs des capteurs virtuels doivent correspondre au format dans lequel elles sont reçues de l’appareil. Tous les états constituent vos définitions pour ces valeurs.

Cette section décrit le fonctionnement des différentes méthodes de calcul. Cliquez sur le nom de la méthode de calcul pour développer.

### **Valeur dans l’intervalle**

Ce type de capteur virtuel aide les clients à maintenir des paramètres importants, tels que le contact virtuel, la température, l’humidité et le niveau de carburant, dans une plage spécifiée.

Voici comment cela fonctionne :

* Si la valeur du capteur se situe à l’intérieur des limites spécifiées (la plage min/max que vous avez définie), Navixy la traite comme 1 (ce qui signifie que la condition est active) et affiche votre libellé A.
* Si la valeur du capteur est en dehors de cette plage, Navixy la traite comme 0 (la condition est inactive) et affiche votre libellé B.

### Exemple de contact virtuel

Si vous n’avez pas d’entrée d’allumage ou si votre appareil fonctionne déjà à pleine capacité, vous pouvez utiliser un outil de contact virtuel pour détecter l’état du contact. La tension de bord du véhicule augmente considérablement lorsque le moteur est mis en marche, ce qui permet d’utiliser le seuil de tension comme indicateur pour savoir si le moteur tourne ou non. En général, la tension de bord doit dépasser 13,2 V pour indiquer que le moteur fonctionne.

Pour créer ce capteur :

1. Commencez par lui donner un nom.
2. Définissez l’entrée sur **Tension de bord** ou sur tout autre capteur si nécessaire.
3. Activer **Considérer comme état du contact** dans les paramètres.
4. Choisissez « Valeur dans l’intervalle » comme méthode de calcul.
5. Spécifiez une valeur minimale de plage, par exemple 13,2 V. Une valeur maximale n’est pas nécessaire, car la tension de bord peut varier lorsque le contact est mis.
6. Enfin, définissez les valeurs d’état 0 et 1. En général, il s’agit de **en marche** et **à l’arrêt,** respectivement.

<figure><img src="https://www.navixy.com/wp-content/uploads/2024/03/browser_7qx9prhhxc.png" alt="Example configuration for virtual ignition" width="375"><figcaption><p>Exemple de configuration du contact virtuel</p></figcaption></figure>

Une fois que vous avez défini votre plage seuil de tension, si la valeur embarquée entrante se situe dans cette plage, la plateforme active l’état du contact. À l’inverse, si elle est en dehors de cette plage, elle le désactive. Le contact virtuel créé à l’aide de cette méthode est également pris en compte dans les rapports et les notifications en fonction de son état. Par exemple, vous pouvez l’utiliser pour générer des rapports sur les heures moteur ou des règles d’alertes pour fonctionnement au ralenti excessif.

De plus, ce contact est utilisé pour la détection des voyages et la détection de stationnement avec prise en compte du contact.

### Exemple avec un capteur analogique

Cet exemple est similaire au précédent, mais au lieu de surveiller le contact du véhicule, il surveille la température.

Supposez que vous disposiez d’un capteur analogique qui collecte des données de température. Disons qu’il renvoie 1 020 pour -10 °C et 1 900 pour 0 °C. Les données provenant des capteurs analogiques ne sont pas calibrées et doivent donc également être indiquées sous cette forme pour le capteur virtuel.

La plage peut être configurée : toute valeur comprise entre 1 020 et 1 900 sera classée comme « froid » (1), et toute valeur supérieure à 1 900 sera considérée comme « chaud » (0).

<figure><img src="https://www.navixy.com/wp-content/uploads/2024/03/browser_kgzvrsdzb1.png" alt="Example configuration for reading temperature from analog sensor" width="563"><figcaption><p>Exemple de configuration pour la lecture de la température depuis un capteur analogique</p></figcaption></figure>

### **Valeur source**

Avec les capteurs virtuels, vous pouvez attribuer votre définition à n’importe quelle valeur reçue. Cette méthode fonctionne avec des ensembles prédéfinis de valeurs et de chaînes, ce qui facilite le travail avec des valeurs statiques sans avoir à spécifier différentes plages. De plus, elle peut fonctionner avec toutes les données dont vous avez besoin. Par exemple :

* 0/1,
* vrai/faux,
* en marche/à l’arrêt,
* ouvert/fermé,
* armé/désarmé,
* état 1/état 2/état 3,
* clé 1/clé 2/clé 3, etc.

Le mode fonctionne ainsi :

* lorsque la valeur 1 arrive, il s’agit de votre valeur A.
* lorsque la valeur 2 arrive, il s’agit de votre valeur B.
* et lorsque la valeur 3 arrive, il s’agit de votre valeur C, et ainsi de suite.

Illustrons ce type de fonctionnalité avec un exemple précis.

### Exemple avec les relevés CAN d’un véhicule

Certains capteurs CAN peuvent fournir différentes valeurs numériques à la plateforme Navixy. Par exemple, un camion équipé d’un capteur d’état PTO CAN peut ne renvoyer que les valeurs suivantes :

* 0 : arrêt
* 1 : maintien
* 2 : maintien à distance
* 3 : veille
* 4 : veille à distance
* 5 : réglage
* 6 : décélérer
* 7 : reprendre
* 8 : accélérer

Pour configurer ce capteur :

1. Saisissez son nom.
2. Choisissez l’entrée.
3. **Considérer comme état du contact** doit être désactivé.
4. Sélectionnez **Valeur source** comme méthode de calcul.
5. Remplissez le tableau avec vos propres valeurs à gauche et les valeurs de capteur correspondantes à droite. Ajoutez des lignes en cliquant sur le **+** bouton et supprimez-les à l’aide du bouton de la corbeille.

<figure><img src="https://www.navixy.com/wp-content/uploads/2024/03/browser_xlxdl1ak9e.png" alt="Configuration example for source value calculation method" width="563"><figcaption><p>Exemple de configuration pour la méthode de calcul de la valeur source</p></figcaption></figure>

### Lectures de clé matérielle pour conducteurs, équipements et remorques

Certains appareils peuvent lire les conducteurs et leurs iButtons, clés RFID ou équipements connectés à l’appareil via des capteurs Bluetooth. La plateforme peut détecter l’équipement ou le conducteur le plus proche de l’appareil, et le capteur virtuel peut afficher de tels noms.

La manière la plus simple de les identifier consiste à utiliser des mots clés : chaque unité connectée à un engin lourd possède son propre capteur avec un mot clé apposé, qui est reconnu par la plateforme comme une clé matérielle. Une fois connecté à la machine, ce mot clé est envoyé à la plateforme et son nom associé peut être affiché de manière compréhensible, comme les valeurs du PTO ont été nommées.

<figure><img src="https://www.navixy.com/wp-content/uploads/2024/03/browser_vw7hkgdl0n.png" alt="Configuration example for source value calculation method for hardware key or state field sensor reading" width="563"><figcaption><p>Exemple de configuration pour la méthode de calcul de la valeur source pour une lecture de capteur de clé matérielle ou de champ d’état</p></figcaption></figure>

### **Indice de bit**

Certains appareils peuvent fournir des données avancées dans leurs paquets, en fusionnant parfois plusieurs paramètres [en une seule valeur](https://www.navixy.com/blog/sensor-parameters-avl/). L’outil Capteurs virtuels vous permet de travailler avec des bits individuels au sein de ces valeurs combinées, en décodant ce que chaque position signifie selon le protocole de l’appareil.

Par exemple, la valeur transmise est 011. Les appareils de ce type encodent plusieurs états dans un seul nombre à l’aide d’une disposition bit par bit lue de droite à gauche (ordre little-endian, tel que défini dans le protocole de l’appareil) :

* Bit 0 (chiffre de droite) : la valeur 1 signifie que la ceinture du conducteur n’est pas bouclée (0 = bouclée, 1 = non bouclée).
* Bit 1 (chiffre du milieu) : la valeur 1 signifie que la portière du conducteur est ouverte (0 = fermée, 1 = ouverte).
* Bit 2 (chiffre de gauche) : la valeur 0 signifie que le capot est fermé (0 = fermé, 1 = ouvert).

Chaque position de bit encode un état différent du système du véhicule. Pour les configurer et les afficher, créez un capteur virtuel pour chaque paramètre que vous souhaitez suivre.

Pour un capteur qui affiche l’état du capot du véhicule dans cet exemple :

1. Définissez le nom du capteur
2. Choisissez l’entrée conformément à la documentation de l’appareil
3. Sélectionnez **Indice de bit** comme méthode de calcul (cela indique à Navixy de lire une seule position de bit dans la valeur combinée)
4. Choisissez le bit 2 pour ce champ (la position qui encode l’état du capot)

Voici un exemple de capteur qui affiche l’état du capot du véhicule.

<figure><img src="https://www.navixy.com/wp-content/uploads/2024/03/browser_2qcam8zclk.png" alt="Configuration example for Bit index calculation sensor" width="563"><figcaption><p>Exemple de configuration pour un capteur utilisant la méthode de calcul Indice de bit</p></figcaption></figure>

Une fois qu’un capteur virtuel est configuré et que le capteur de l’appareil qui lui est associé a fourni des données, il peut être consulté dans le **widget Lectures du capteur** dans la **section Information** onglet.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://navixy.com/docs/user/fr/guide/devices-and-settings/vehicle-sensors/virtual-sensors.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
