Guide Meshtastic - Paramètres de positionnement et de localisation

Les données de position provenant du GPS sont fournies soit par la radio, soit par votre téléphone apparié. Bien qu’il ne soit pas nécessaire d’utiliser Meshtastic, les calculs de temps nécessitent qu’au moins un appareil sur le maillage dispose soit d’un GPS, d’un RTC ou d’une connexion internet pour le NTP.

La configuration de position utilise un message administrateur pour envoyer un Config.Position protobuf. Les options de configuration de position incluent : Mode GPS, Intervalle de mise à jour GPS, Position fixe, Diffusion intelligente, Distance minimale de diffusion intelligente, Intervalle minimal de diffusion intelligente, Intervalle de diffusion, Drapeaux du paquet de position et Broches GPS RX/TX/EN.

Valeurs de configuration de position

Mode GPS : Configure si la fonctionnalité GPS est activée, désactivée ou absente sur le nœud. Valeurs acceptables : DISABLED, ENABLED et NOT_PRESENT. En général, cette valeur sera par défaut soit ENABLED soit NOT_PRESENT, selon l’appareil et sa configuration.
Intervalle de mise à jour GPS : Spécifie la fréquence à laquelle nous devons tenter d'obtenir la position GPS (en secondes), ou mettre à zéro pour la valeur par défaut d'une fois toutes les 2 minutes, ou une valeur très grande (maxint) pour mettre à jour une seule fois au démarrage.
Position fixe : Valeurs acceptables : true ou false (par défaut false). Si défini sur true, ce nœud est à une position fixe. L'appareil générera des mises à jour GPS à l'intervalle de mise à jour GPS régulier mais utilisera la dernière lat/lon/alt enregistrée pour le nœud. La lat/lon/alt peut être définie par un GPS interne ou avec l'assistance du GPS de l'appareil mobile.
Diffusion intelligente : Valeurs acceptables : true ou false (par défaut true). La diffusion intelligente enverra votre position à une fréquence accrue uniquement si votre emplacement a suffisamment changé pour qu'une mise à jour de position soit utile. Elle complète l'intervalle de diffusion (ne remplace pas ce réglage) et applique un algorithme pour mettre à jour plus fréquemment votre réseau maillé lorsque vous êtes en mouvement, puis réduit la fréquence lorsque vous êtes immobile. Si vous utilisez cette fonction, il est préférable de conserver l'intervalle de diffusion par défaut. La diffusion intelligente calculera un intervalle idéal de mise à jour de position basé sur le débit de données de la configuration de canal sélectionnée.
Distance minimum de diffusion intelligente : La valeur par défaut de 0 correspond à 100 mètres. Ce paramètre spécifie la distance minimale en mètres parcourue (depuis le dernier envoi) avant qu'une position puisse être envoyée au réseau maillé si la diffusion intelligente est activée.
Intervalle minimum de diffusion intelligente : La valeur par défaut de 0 correspond à 30 secondes. Ce paramètre définit le nombre minimum de secondes (depuis le dernier envoi) avant qu'une position puisse être envoyée au réseau maillé si la diffusion intelligente est activée.
Intervalle de diffusion : La valeur par défaut de 0 correspond à 15 minutes. Si la diffusion intelligente est désactivée, la position doit être envoyée aussi souvent. Les mises à jour GPS seront envoyées à chaque intervalle de diffusion, soit avec la position GPS réelle, soit avec une position vide si aucun fix GPS n'a été obtenu.
Drapeaux de position : Définit quelles options sont incluses dans les messages POSITION. Les valeurs sont stockées sous forme de champ de bits d'options de configuration booléennes (OU bit à bit OR de PositionFlags).

Valeur	Description
DÉSACTIVER	Requis pour la compilation
ALTITUDE	Inclure une valeur d'altitude (si disponible)
ALTITUDE_MSL	La valeur d'altitude est MSL
GEOIDAL_SEPARATION	Inclure la séparation géoïdale
DOP	Inclure la valeur DOP ; PDOP utilisé par défaut, voir ci-dessous
HVDOP	Si POS_DOP est défini, envoyer des valeurs HDOP / VDOP séparées au lieu de PDOP
SATEN_VUE	Inclure le nombre de "satellites en vue"
NUM_SEQ	Inclure un numéro de séquence incrémenté par paquet
HORODATAGE	Inclure l'horodatage positionnel (issu de la solution GPS)
TITRE	Inclure le cap positionnel (issu de la solution GPS)
VITESSE	Inclure la vitesse positionnelle (issue de la solution GPS)

GPIO RX/TX/EN pour Module GPS

Si votre appareil ne possède pas de puce GPS fixe, vous pouvez définir les broches GPIO pour les broches RX, TX et EN d'un module GPS.

Disponibilité du client de configuration de position

Android

Les options de configuration de position sont disponibles pour Android.

Pour y accéder, ouvrez l'application Meshtastic et naviguez vers : Ellipse verticale (3 points en haut à droite) > Configuration radio > Position.

Pomme

Toutes les valeurs de configuration de position sont disponibles sur iOS, iPadOS et macOS dans Réglages > Configuration de l'appareil > Position.

CLI

Toutes les commandes de configuration de position sont disponibles dans le CLI Python. Des exemples de commandes sont fournis ci-dessous :

Cadre	Valeurs acceptables	Par Défaut
position.gps_mode	ACTIVÉ, DÉSACTIVÉ, NON_PRÉSENT	ACTIVÉ ou NON_PRÉSENT
position.gps_update_interval	entier (secondes)	Par défaut 0 correspond à 2 minutes
position.fixed_position	vrai, faux	FAUX
position.position_broadcast_smart_enabled	vrai, faux	VRAI
position.broadcast_smart_minimum_distance	entier (mètres)	Par défaut 0 correspond à 100 mètres
position.broadcast_smart_minimum_interval_secs	entier (secondes)	Par défaut 0 correspond à 15 minutes
position.position_broadcast_secs	entier (secondes)	Par défaut 0 correspond à 15 minutes
position.flags	DÉSACTIVER, ALTITUDE, ALTITUDE_MSL, SÉPARATION_GÉOÏDALE, DOP, HVDOP, PDOP, SATINVIEW, NUM_SEQ, HORODATAGE, CAP, VITESSE	DÉSACTIVER
position.rx_gpio	entier (0-39)	DÉSACTIVER
position.tx_gpio	entier (0-34)	DÉSACTIVER

Définir l'intervalle de mise à jour GPS (Par défaut 0 correspond à 2 minutes)

meshtastic --set position.gps_update_interval 0
meshtastic --set position.gps_update_interval 45

Définir la position fixe - Position actuelle

meshtastic --set position.fixed_position true

NOTE1 : L’appareil continuera à acquérir les coordonnées GPS selon le gps_update_interval, mais utilisera les dernières coordonnées enregistrées comme son point fixe.

Définir et activer une position fixe - définie par l’utilisateur

meshtastic --setlat 37.8651 --setlon -119.5383

Supprimer et annuler la position fixe

meshtastic --remove-position

Activer / Désactiver la diffusion intelligente de la position (activée par défaut)

meshtastic --set position.position_broadcast_smart_enabled true
meshtastic --set position.position_broadcast_smart_enabled false

Définir l’intervalle de diffusion de la position (par défaut 0 correspond à 15 minutes)

meshtastic --set position.broadcast_secs 0
meshtastic --set position.broadcast_secs 60

NOTE2 : Il peut falloir un certain temps pour observer que le changement a pris effet. La localisation GPS est mise à jour selon la valeur spécifiée pour gps_update_interval, et le maillage sera informé de la nouvelle position en fonction de la valeur position_broadcast_secs.

Définir / Annuler les indicateurs de position

meshtastic --pos-fields ALTITUDE ALTITUDE_MSL
meshtastic --pos-fields UNSET

NOTE3 : Comme l’appareil redémarrera après chaque commande envoyée via le CLI, il est recommandé de chaîner les commandes en une seule lorsqu’on définit plusieurs valeurs dans une section de configuration. Ceci est particulièrement important pour les valeurs de position afin de s’assurer qu’elles sont définies en même temps et d’éviter qu’elles soient écrasées par des commandes ultérieures. Par exemple :

meshtastic --set position.fixed_position true --setlat 37.8651 --setlon -119.5383