Configuration CLI MeshCore
Gérez vos nœuds MeshCore avec l'outil officiel meshcore-cli. Contrôle maximal pour les utilisateurs avancés et l'automatisation.
Qu'est-ce que le CLI MeshCore ?
L'interface ligne de commande MeshCore (meshcore-cli) est un outil basé sur Python qui permet de communiquer avec votre companion radio MeshCore via le terminal. Le CLI supporte les connexions via Bluetooth Low Energy (BLE), TCP/IP ou série.
De plus, les répéteurs et room servers disposent de leur propre CLI intégré accessible via USB/série ou à distance. Vous y configurez directement la fréquence, la puissance d'émission, le nom et d'autres paramètres.
Ce guide couvre les deux méthodes : l'outil Python meshcore-cli pour les companion radios, et le CLI série pour les répéteurs et room servers. Idéal pour les administrateurs système, les power users et tous ceux qui veulent faire du scripting ou de l'automatisation.
Pourquoi utiliser le CLI ?
Rapidité et efficacité
Configurez les nœuds en un rien de temps avec quelques commandes, bien plus rapide qu'via une interface graphique.
Automatisation scriptable
Écrivez des scripts bash ou Python pour effectuer des opérations en lot sur plusieurs nœuds simultanément.
Contrôle total
Accès à tous les paramètres, y compris les paramètres radio avancés et la configuration des répéteurs.
Diverses méthodes de connexion
Connectez via Bluetooth, WiFi/TCP ou série – choisissez ce qui convient le mieux à votre configuration.
Gestion à distance
Gérez les répéteurs à distance via la fonction remote admin, depuis le CLI ou l'application mobile.
Mode chat interactif
Le CLI dispose d'un mode interactif avec auto-complétion, historique des commandes et messages en temps réel.
Installer le CLI MeshCore
L'outil meshcore-cli s'installe comme package Python via pip ou pipx. Fonctionne sur Windows, macOS, Linux et Raspberry Pi. Nécessite Python 3.10 ou plus récent.
Étape 1 : Vérifiez la version Python
Vous avez besoin de Python 3.10 ou plus récent. Vérifiez votre version :
python3 --version
Si Python n'est pas encore installé, téléchargez-le via python.org
Étape 2 : Installez meshcore-cli
Installez l'outil CLI MeshCore officiel via pipx (recommandé) ou pip :
# Via pipx (aanbevolen)pipx install meshcore-cli# Of via pippip3 install meshcore-cliÉtape 3 : Vérifiez l'installation
Vérifiez que l'installation a réussi en ouvrant l'aide :
meshcli -h
Commandes CLI de base
meshcore-cli supporte aussi bien les paramètres en ligne de commande qu'un mode chat interactif. Démarrez sans arguments pour ouvrir le mode interactif.
Sélectionner l'appareil (BLE)
Scannez et sélectionnez votre appareil MeshCore via Bluetooth. Le CLI mémorise votre choix pour les sessions suivantes.
meshcli -S
Connexion via TCP/IP
Connectez-vous à un nœud MeshCore via WiFi/réseau quand le serveur TCP est actif.
meshcli -t 192.168.1.100
Connexion via série
Connectez via USB/port série pour une communication directe avec votre nœud.
meshcli -s /dev/ttyUSB0
Envoyer un message
Envoyez un message texte à un contact spécifique ou diffusez à tous les nœuds.
meshcli send "Hallo MeshCore netwerk!"
Voir les contacts
Affichez tous les nœuds connus dans votre réseau avec leur statut et puissance du signal.
meshcli contacts
Mode interactif
Démarrez sans commandes pour le mode chat interactif avec auto-complétion et historique des commandes.
meshcli
CLI Répéteur & Room Server
Les répéteurs et room servers disposent d'un CLI intégré accessible via USB/série (terminal/PuTTY) ou via le T-Deck CLI. Après le flash, vous configurez ici les paramètres de base.
Configurer la fréquence (obligatoire)
Après le flash, vous devez d'abord configurer la fréquence pour votre région. Pour l'Europe, utilisez 869.4 MHz ou 869.525 MHz.
set freq 869.4rebootNom et localisation
Donnez un nom reconnaissable à votre répéteur et éventuellement des coordonnées GPS pour l'affichage sur la carte.
set name MijnRepeaterset lat 52.3676set lon 4.9041Configurer la puissance d'émission
Ajustez la puissance d'émission en dBm. Utilisez maximum 22 dBm pour la bande EU 868 MHz.
set tx 22
Paramètres du répéteur
Configurez les options spécifiques au répéteur comme les hop limits et les intervalles d'annonce.
set flood.max 3set advert.interval 30set flood.advert.interval 3Configuration web
En plus du CLI, vous pouvez aussi configurer les répéteurs et room servers via les outils web. C'est souvent plus simple pour les débutants.
MeshCore Flasher
Flashez le firmware et configurez directement via le navigateur sur flasher.meshcore.co.uk. Après le flash, cliquez sur "Console" pour accéder au CLI.
flasher.meshcore.co.uk →MeshCore Config Tool
Configurez les répéteurs existants via config.meshcore.dev – connectez via USB et modifiez les paramètres dans le navigateur.
config.meshcore.dev →Configuration minimale après le flash
Après le flash du firmware MeshCore, ces étapes sont au minimum nécessaires :
# 1. Configurer la fréquence (obligatoire pour usage légal)
set freq 869.4
# 2. Redémarrer pour appliquer les modifications
reboot
# 3. Optionnel : donner un nom à votre répéteur
set name MonRepeteur
# 4. Optionnel : configurer la localisation pour la carte
set lat 50.8503
set lon 4.3517Questions fréquentes sur le CLI
Quelle est la différence entre meshcore-cli et le CLI série ?
Le meshcore-cli (meshcli) est un outil Python pour communiquer via BLE, TCP ou série avec votre companion radio. Le CLI série est intégré aux répéteurs et room servers et s'accède directement via USB/terminal. Les deux ont des commandes et domaines d'application différents.
Comment me connecter via Bluetooth ?
Sur Linux, vous devez d'abord appairer votre appareil via bluetoothctl. Ensuite, utilisez meshcli -S pour sélectionner votre appareil. Le CLI sauvegarde votre choix dans ~/.config/meshcore.
Puis-je configurer les répéteurs à distance ?
Absolument ! Via la fonction Remote Admin, vous gérez les répéteurs et room servers via LoRa. Cela fonctionne depuis meshcore-cli avec les commandes repeater, ou via l'application mobile avec Remote Management.
Quelle fréquence utiliser en Belgique/Europe ?
Utilisez des fréquences dans la bande 868 MHz. Les choix courants sont 869.4 MHz ou 869.525 MHz. N'utilisez jamais 915 MHz – c'est uniquement autorisé aux États-Unis et illégal en Europe.
Comment réinitialiser mon répéteur aux paramètres d'usine ?
Via le CLI série, vous pouvez utiliser erase pour effacer le système de fichiers. Cela supprime tous les paramètres. Ensuite, vous devez reconfigurer la fréquence.
Où trouver toutes les commandes disponibles ?
Pour meshcore-cli : meshcli -h affiche toutes les options. Pour le CLI répéteur/room server : tapez help dans la console série. La référence complète se trouve sur le wiki GitHub de MeshCore.
Maîtrisez la ligne de commande
Avec le CLI MeshCore, vous disposez d'un contrôle professionnel sur votre réseau mesh. Idéal pour la gestion des répéteurs, le scripting et la configuration avancée.