Ce module vous permet de tester la portée de communication entre deux nœuds Meshtastic. Seuls les nœuds avec le module activé afficheront les messages de test de portée sur leurs clients connectés.
-
Émetteur : Un nœud fixe qui envoie des paquets séquentiels à un intervalle de 30-60 secondes (configuré comme « Intervalle de message de l’émetteur »).
-
Récepteur : Un nœud mobile (généralement vous) qui utilise éventuellement le GPS embarqué ou le GPS du téléphone. Les nœuds sont considérés comme étant à portée tant que les paquets séquentiels peuvent être reçus avec succès.
Le nœud récepteur a la capacité d'enregistrer les messages ainsi que les coordonnées GPS auxquelles ils ont été reçus dans un fichier .csv. Ce fichier .csv peut ensuite être intégré dans Google Earth, Google Maps - Mes cartes ou tout autre programme capable de traiter des fichiers .csv, vous permettant de visualiser votre maillage. Assurez-vous de régler la précision de position dans le canal par défaut sur élevée ; sinon, les données collectées n'enregistreront pas précisément votre position réelle.
REMARQUE : Assurez-vous de désactiver le module ou d'arrêter l'envoi lorsqu'il n'est pas utilisé, car cela consommera beaucoup de temps d'antenne, ralentira votre maillage et encombrera votre canal avec des messages inutiles. Le module s'éteindra automatiquement après 8 heures d'utilisation.
Les options de configuration du module de test de portée incluent : Activé, Émetteur et Enregistrer. La configuration du module de test de portée utilise un message administrateur pour envoyer un protobuf ModuleConfig.RangeTestConfig.
Valeurs de configuration du module de test de portée
-
Activé : Active le module de test de portée. Le Émetteur et le Récepteur doivent tous deux avoir le module activé. Pour que les applications Apple et Android reçoivent des messages de test de portée, le module doit également être activé sur ces appareils. Veuillez noter que l'écran de l'appareil peut toujours afficher des paquets de test de portée provenant d'anciennes versions du firmware même si le module est désactivé.
-
Intervalle de l'émetteur
Le temps d'attente entre l'envoi de paquets de test séquentiels est configurable, avec 0 comme valeur par défaut, ce qui désactive l'envoi de messages.
-
Paramètres recommandés pour l'émetteur
| Paramètre radio | range_test.sender |
| Long Lent | 60 |
| Long Rapide | 30 |
| Moyen | 15 |
| Court Rapide | 15 |
-
Enregistrer CSV Fichier
Si activé, tous les messages reçus sont enregistrés dans la mémoire flash de l'appareil dans un fichier nommé rangetest.csv.
Pour accéder à ce fichier, activez le WiFi sur votre appareil et connectez-vous à votre réseau. Une fois connecté, rendez-vous sur meshtastic.local/rangetest.csv (ou votre_ip_appareil/rangetest.csv), et le fichier sera téléchargé automatiquement. Ce fichier ne sera créé qu'après que l'appareil ait reçu les premiers messages.
Pour éviter de saturer le stockage, l'appareil arrêtera d'écrire s'il reste moins de 50Ko d'espace disponible sur le système de fichiers.
NOTE : Laissez cette fonctionnalité désactivée lors de l'utilisation des applications Android ou Apple. Elle enregistre les données directement dans la mémoire flash de l'appareil (sans nécessiter de smartphone) et n'est disponible que sur les appareils basés sur ESP32.
Client de configuration du module de test de portée
Android
Android exporte un fichier rangetest.csv à partir des paquets dans le journal de débogage. Pour effacer les anciennes données d'historique des paquets :
Panneau de débogage > Effacer
Note : Les options de configuration du test de portée sont disponibles sur Android. Ouvrez l'application Meshtastic et allez dans Paramètres > Test de portée.
Pomme
Les applications Apple vous permettent de télécharger les données de position enregistrées stockées sur votre iPhone, iPad ou Mac. Pour y accéder, ouvrez l’onglet Nœuds, choisissez un nœud, puis sélectionnez Journal de position et cliquez sur Enregistrer. Ce fichier peut être sauvegardé sans que le module Test de portée soit actif.
Note : Toutes les options de configuration du module de test de portée sont disponibles sur iOS, iPadOS et macOS dans Réglages > Configuration du module > Test de portée.
CLI
Les options de configuration du module de test de portée sont disponibles dans le CLI python. Exemples de commandes ci-dessous :
| Paramètre | Valeurs acceptables | Par défaut |
| range_test.enabled | vrai, faux | FAUX |
| range_test.save | vrai, faux | FAUX |
| range_test.sender | entier (Secondes) | 0 |
Comme l'appareil redémarrera après chaque commande envoyée via CLI, il est recommandé, lors de la configuration de plusieurs valeurs dans une section de configuration, de chaîner les commandes ensemble en une seule. Par exemple:
meshtastic --set range_test.enabled true --set range_test.save false
Activer / Désactiver le test de portée
meshtastic --set range_test.enabled true meshtastic --set range_test.enabled false
Activer / Désactiver la sauvegarde du test de portée
meshtastic --set range_test.save true meshtastic --set range_test.save false
Activer l'émetteur du test de portée (envoi toutes les 60 secondes)
meshtastic --set range_test.sender 60
Désactiver l'émetteur du test de portée
meshtastic --set range_test.sender 0
Web
Toutes les options de configuration du module de test de portée sont disponibles dans l'interface Web.
Exemples d'application
Intégration Google Earth
Étapes :
-
Téléchargez et ouvrez Google Earth.
-
Allez dans Fichier > Importer.
-
Choisissez CSV.
-
Sélectionnez Délimité, Virgule.
-
Assurez-vous que l’option « Ce jeu de données ne contient pas d’informations de latitude/longitude, mais des adresses postales » est décochez.
-
Assignez rx lat et rx long aux champs latitude/longitude.
-
Cliquez sur Terminer.
-
Lorsque vous êtes invité à créer un modèle de style, sélectionnez Oui.
-
Définissez le champ Nom sur n’importe quelle colonne que vous souhaitez afficher sur la carte (toutes les données apparaîtront toujours en cliquant sur une icône).
-
Choisissez une couleur, icône, etc., puis cliquez sur OK.
Votre jeu de données sera chargé sur la carte ; cochez la case à côté dans la barre latérale pour le rendre visible.
My Maps
Vous pouvez utiliser Google My Maps, qui prend en charge les fichiers CSV et offre une interface plus simple. Google fournit des instructions sur comment configurer cela. Vous pouvez aussi styliser les plages en fonction des valeurs — par exemple, faire apparaître les épingles plus foncées lorsque SNR ou RSSI est plus élevé.
OpenStreetMap - uMap
Pour une option open source, vous pouvez utiliser uMap, un service basé sur OpenStreetMap.
-
Visitez uMap dans la langue de votre choix.
-
Cliquez sur Créer une carte.
-
Sélectionnez l’icône Importer des données ou appuyez sur CTRL + I.
-
Choisissez votre fichier rangetest.csv et cliquez sur Importer.
-
Le format sera reconnu automatiquement, et les emplacements seront ajoutés à la carte.
