Le paramétrage des matériels Meshtastic peut se faire à travers diverses interfaces graphiques via une application iOS, Android, ou encore dans un navigateur via l'interface web. Une autre méthode, en ligne de commande, utilise le client Python développé par Meshtastic. Ce client Python est un outil qui permet non seulement de consulter l'état des caractéristiques et des paramètres de votre matériel, mais également de définir des paramètres et d'initier des actions.
Dans ce post, j'ai choisi le shell Bash comme interpréteur de ligne de commande et GNU/Linux comme système d'exploitation. Il est également possible d'utiliser le client Python sur Microsoft Windows, mais je ne l'aborde pas ici. Quelques notions de base sur les environnements en ligne de commande et Python sont essentielles.
Installation du Client Python
Téléchargez le client Python de Meshtastic depuis les Releases du client Python, en adaptant le lien selon la version souhaitée :
wget https://github.com/meshtastic/python/releases/download/2.3.7/meshtastic_ubuntu
Attribuez-lui des droits d'exécution :
chmod 755 meshtastic_ubuntu
Pour me rapprocher de la documentation, je renomme l'exécutable :
mv meshtastic_ubuntu meshtastic
Commandes de base du Client Python
Afficher les arguments disponibles avec la commande ./meshtastic
./meshtastic -h
Tester la connexion réseau. J'ai choisi la méthode réseau en TCP pour cette démonstration :
./meshtastic --host 169.254.0.1
Obtenir la version du firmware :
./meshtastic --host 169.254.0.1 --version
Obtenir la valeur d'un paramètre --get [config_section] :
./meshtastic --host 169.254.0.1 --get device.role
./meshtastic --host 169.254.0.1 --get mqtt.enabled
Modifier un paramètre --set [config_section].[option] [value] :
./meshtastic --host 169.254.0.1 --set device.role CLIENT
./meshtastic --host 169.254.0.1 --set mqtt.enabled true
Effectuer un redémarrage :
./meshtastic --host 169.254.0.1 --reboot
Diverses commandes utiles du Client Python
Exporter la configuration de votre nœud :
./meshtastic --host 169.254.0.1 --export-config > backup_config.yaml
Importer une configuration :
./meshtastic --host 169.254.0.1 --configure backup_config.yaml
Réinitialiser la liste des nœuds :
./meshtastic --host 169.254.0.1 --reset-nodedb
Définir une position GPS fixe :
./meshtastic --host 169.254.0.1 --set position.fixed_position true --setlat 0.0001 --setlon 0.0002
💡 Il est recommandé de regrouper les commandes qui modifient plusieurs paramètres au sein d'une même section pour éviter qu'elles ne soient écrasées lors du redémarrage. Vous pouvez également regrouper l'ensemble de vos commandes pour les exécuter en une seule ligne.
Où acheter ?
Voici trois radios abordables et prêtes à l'emploi parmi les plus populaires :
- Le T-Beam v1.2 de LILYGO : AliExpress
- Le Heltec LoRa 32 v3 de Heltec Automation : AliExpress
- Le WisBlock Meshtastic Starter Kit de RAK : AliExpress, RAK