Configurer MeshCore en CLI
Pilotez vos noeuds MeshCore via l outil officiel meshcore-cli. Utile pour automatisation, depannage et gestion avancee (reseau en structuration en France).
Qu est-ce que la MeshCore CLI ?
La MeshCore command-line interface (meshcore-cli) est un outil (souvent base sur Python) pour communiquer avec un appareil MeshCore depuis un terminal. Selon votre setup, la connexion peut passer par Bluetooth Low Energy (BLE), TCP/IP ou USB/serial.
Les firmwares Repeater et Room Server ont aussi une CLI integree accessible via USB/serial (et parfois a distance). On y regle la frequence, la puissance, le nom, et les options reseau directement sur l appareil.
Ce guide couvre les deux approches: l outil meshcore-cli pour les companion radios, et la CLI serie pour repeater/room server. En France, le reseau est en structuration: commencez par un test simple a 2-5 noeuds + eventuel repeater.
Pourquoi utiliser la CLI ?
Rapide et efficace
Configurer en secondes avec quelques commandes (pratique quand on fait beaucoup de tests).
Automatisation scriptable
Bash/Python pour operations en lot sur plusieurs noeuds (inventaire, config, checks).
Controle fin
Acces aux reglages avances et a des infos utiles (radio, routage, stats).
Plusieurs liens possibles
BLE, TCP, USB/serial: vous choisissez ce qui colle a votre materiel et votre contexte.
Gestion a distance (selon firmware)
Certaines fonctions d admin distante existent pour des repeaters (a utiliser prudemment).
Mode interactif
Mode console avec historique, completion, et affichage temps reel (selon outil).
Installer MeshCore CLI
L outil meshcore-cli s installe comme package Python via pip/pipx. Il fonctionne sur Windows, macOS et Linux. Visez Python 3.10+ (selon version).
Etape 1: verifier Python
Assurez-vous d avoir Python 3.10+ :
python3 --version
Si Python n est pas installe, voir python.org
Etape 2: installer meshcore-cli
Installez via pipx (souvent plus propre) ou pip:
# Via pipx (aanbevolen)pipx install meshcore-cli# Of via pippip3 install meshcore-cliEtape 3: verifier
Ouvrez l aide pour confirmer:
meshcli -h
Commandes de base
La CLI supporte des parametres en ligne et parfois un mode interactif. Lancez sans arguments pour le mode interactif (si disponible).
Selectionner un appareil (BLE)
Scanner puis selectionner votre appareil MeshCore en Bluetooth. La CLI peut memoriser ce choix pour la suite.
meshcli -S
Se connecter en TCP/IP
Connexion a un noeud expose en TCP (si un serveur TCP est active sur le firmware).
meshcli -t 192.168.1.100
Se connecter en USB/serial
Connexion directe via un port serie (USB) pour debug/config.
meshcli -s /dev/ttyUSB0
Envoyer un message
Envoyer un message texte a un contact ou en diffusion (selon canal).
meshcli send "Hallo MeshCore netwerk!"
Lister contacts/noeuds
Voir les noeuds connus, leur statut, et parfois la qualite de lien.
meshcli contacts
Mode interactif
Lancer la CLI en mode console pour surveiller et envoyer des commandes.
meshcli
CLI Repeater & Room Server
Les firmwares repeater/room server ont une CLI integree accessible via USB/serial (terminal). Apres flash, vous reglez les bases ici.
Frequence (obligatoire)
Apres flash, reglez la frequence EU (868 MHz). Des frequences courantes en EU sont 869.4 MHz ou 869.525 MHz (selon preset/usage).
set freq 869.4rebootNom et position
Donnez un nom clair a votre repeater et, si utile, des coordonnees pour la carte.
set name MijnRepeaterset lat 52.3676set lon 4.9041Puissance d emission
Reglez la puissance en dBm. Restez dans le cadre 868 MHz (EU/France) et evitez les reglages agressifs.
set tx 22
Options repeater
Ajustez hop limit, intervals d annonces, et comportements de relai en fonction du trafic local.
set flood.max 3set advert.interval 30set flood.advert.interval 3Alternative: outils web
En plus de la CLI, vous pouvez configurer repeater/room server via des outils web, souvent plus simples.
MeshCore Flasher
Flasher et ouvrir une console via le navigateur sur flasher.meshcore.co.uk (selon firmware).
flasher.meshcore.co.uk →MeshCore Config Tool
Configurer via config.meshcore.dev: connexion USB, modifications dans le navigateur.
config.meshcore.dev →Config minimale apres flash
Apres flash, ces etapes sont souvent le strict minimum:
# 1. Frequence (obligatoire)
set freq 869.4
# 2. Redemarrer
reboot
# 3. Optionnel: nom
set name MonRepeater
# 4. Optionnel: position
set lat 48.8566
set lon 2.3522FAQ CLI
Difference entre meshcore-cli et la CLI serie ?
La meshcore-cli est un outil cote PC pour parler a une companion radio (BLE/TCP/USB). La CLI serie est integree dans les repeaters/room servers et s utilise via un terminal. Les commandes et usages ne sont pas identiques.
Comment se connecter en Bluetooth ?
Selon OS, il peut falloir pairer l appareil (ex: bluetoothctl sous Linux). Ensuite, utilisez les options de scan/selection de la CLI. Restez proche (quelques metres).
Peut-on administrer un repeater a distance ?
Souvent oui (selon firmware et fonctions d admin). En pratique, en France le reseau est en structuration: privilegiez d abord la stabilite locale et gardez une option d acces physique pour recuperation.
Quelle frequence en France ?
Utilisez la bande 868 MHz (EU). Evitez 915 MHz (US). Respectez les limites de puissance/duty-cycle.
Comment reset un repeater ?
Selon firmware, une commande efface la config (ex: erase/factory-reset). Attention: cela supprime les reglages, et vous devrez reconfigurer frequence/preset.
Ou trouver la liste des commandes ?
Pour meshcore-cli: l aide (ex: -h). Pour la CLI serie: tapez help dans la console. La reference la plus fiable reste la doc officielle / GitHub MeshCore.
Maitriser la CLI
La MeshCore CLI donne un controle propre pour debug, gestion et automatisation. Pour la France: commencez petit (2-5 noeuds), puis ajoutez un repeater bien place.