Référence des commandes CLI
Toutes les commandes des répéteurs, room servers et capteurs MeshCore, par catégorie.
Mise à jour le 21 août 2026
Sur cette page
Référence des commandes acceptées par les répéteurs, room servers et capteurs MeshCore, d'après la documentation officielle.
Certaines commandes ne sont disponibles qu'en liaison série (et pas à distance) : elles sont signalées. D'autres n'existent que si le micrologiciel a été compilé avec l'option correspondante (GPS, capteurs, pont, Ethernet).
Le micrologiciel évolue rapidement. En cas d'écart avec ce tableau, référez-vous à la documentation officielle.
Fonctionnement
| Commande | Syntaxe | Description |
|---|---|---|
| Redémarrer | reboot | Aucune réponse n'est renvoyée. |
| Éteindre | poweroff ou shutdown | Aucune réponse n'est renvoyée. |
| Réinitialiser l'horloge et redémarrer | clkreboot | Aucune réponse n'est renvoyée. |
| Synchroniser l'horloge | clock sync | Se synchronise sur un appareil distant. |
| Afficher l'heure | clock | Heure courante en UTC. |
| Régler l'heure | time <horodatage_unix> | Horodatage Unix en secondes. |
| Annonce diffusée | advert | Annonce relayée par les répéteurs. |
| Annonce locale | advert.zerohop | Diffusion locale, non relayée. |
| Mise à jour OTA | start ota | Démarre une mise à jour par radio. |
| Réinitialisation d'usine | erase | Destructif. Série uniquement. |
Voisinage (répéteurs)
| Commande | Syntaxe | Description |
|---|---|---|
| Lister les voisins | neighbors | Limité aux 8 annonces les plus récentes. |
| Retirer un voisin | neighbor.remove <prefixe_cle> | Un espace en argument les retire tous. |
| Découvrir les voisins | discover.neighbors | Recherche les voisins à zéro saut. |
Statistiques
| Commande | Syntaxe | Description |
|---|---|---|
| Remettre à zéro | clear stats | Réinitialise tous les compteurs. |
| Statistiques système | stats-core | Batterie, temps de fonctionnement, file d'attente. Série uniquement. |
| Statistiques radio | stats-radio | Plancher de bruit, RSSI/SNR, temps d'antenne. Série uniquement. |
| Statistiques de paquets | stats-packets | Compteurs d'émission et de réception. Série uniquement. |
Journalisation
| Commande | Syntaxe | Description |
|---|---|---|
| Démarrer le journal | log start | Capture la réception dans le stockage du nœud. |
| Arrêter le journal | log stop | Termine la capture. |
| Effacer le journal | log erase | Efface le journal capturé. |
| Afficher le journal | log | Affiche le journal. Série uniquement. |
Informations
| Commande | Syntaxe | Description |
|---|---|---|
| Version | ver | Version du micrologiciel. |
| Matériel | board | Nom du matériel. |
| Clé publique | get public.key | Clé publique du nœud. |
| Rôle | get role | Rôle configuré. |
Configuration radio
| Commande | Syntaxe | Description |
|---|---|---|
| Paramètres radio | get radio / set radio <freq>,<bp>,<sf>,<cr> | Redémarrage requis. Valeurs d'usine : 869.525,250,11,5. |
| Puissance d'émission | get tx / set tx <dbm> | De 1 à 22 dBm. |
| Réglages temporaires | tempradio <freq>,<bp>,<sf>,<cr>,<duree_min> | Annulés au redémarrage. |
| Fréquence | get freq / set freq <mhz> | Redémarrage requis. |
| Gain de réception | get radio.rxgain / set radio.rxgain <on|off> | Mode boosté SX12xx / LR1110. |
| Gain FEM réception | get radio.fem.rxgain / set radio.fem.rxgain <on|off> | Pilotage d'un préampli externe. |
| Gain FEM émission | get radio.fem.txgain / set radio.fem.txgain <on|off> | Pilotage d'un ampli externe. |
Configuration du nœud
| Commande | Syntaxe | Description |
|---|---|---|
| Nom | get name / set name <nom> | 31 octets maximum, 23 si la position est diffusée. |
| Latitude | get lat / set lat <degres> | Degrés décimaux. |
| Longitude | get lon / set lon <degres> | Degrés décimaux. |
| Clé privée | get prv.key / set prv.key <cle> | 64 caractères hexadécimaux. Redémarrage requis. |
| Mot de passe admin | password <nouveau> | À changer impérativement. |
| Mot de passe invité | get guest.password / set guest.password <mdp> | Room server uniquement. |
| Informations propriétaire | get owner.info / set owner.info <texte> | Micrologiciel 1.12+. Le caractère | produit un saut de ligne. |
| Étalonnage batterie | get adc.multiplier / set adc.multiplier <valeur> | De 0,0 à 10,0. |
| Économie d'énergie | powersaving / powersaving on|off | Répéteur uniquement : sommeil entre les émissions. |
Routage
| Commande | Syntaxe | Description |
|---|---|---|
| Relayage | get repeat / set repeat <on|off> | Active ou désactive le relais des paquets. |
| Mode d'identifiant de chemin | get path.hash.mode / set path.hash.mode <0-2> | Identifiants de 1, 2 ou 3 octets. |
| Détection de boucle | get loop.detect / set loop.detect <mode> | off, minimal, moderate, strict. |
| Délai d'émission (diffusion) | get txdelay / set txdelay <valeur> | Facteur de 0 à 2 : limite les collisions. |
| Délai d'émission (direct) | get direct.txdelay / set direct.txdelay <valeur> | Facteur de 0 à 2 pour le trafic routé. |
| Délai de réception | get rxdelay / set rxdelay <valeur> | Base de 0 à 20 : privilégie les signaux forts. |
| Rapport cyclique | get dutycycle / set dutycycle <1-100> | En pourcentage. Micrologiciel 1.15.0+. 10 pour l'Europe. |
| Facteur de temps d'antenne | get af / set af <valeur> | Obsolète : utilisez dutycycle. |
| Seuil d'interférence | get int.thresh / set int.thresh <valeur> | Sensibilité de détection. |
| Détection d'activité canal | get cad / set cad <on|off> | Détection matérielle (CAD). |
| Réinitialisation AGC | get agc.reset.interval / set agc.reset.interval <valeur> | En secondes, arrondi à un multiple de 4. |
| Accusés multiples | get multi.acks / set multi.acks <0|1> | Prise en charge des accusés multiples. |
| Intervalle d'annonce diffusée | get flood.advert.interval / set flood.advert.interval <heures> | De 3 à 168 h. Défaut : 12 h. |
| Intervalle d'annonce locale | get advert.interval / set advert.interval <minutes> | De 60 à 240 min, arrondi à une valeur paire. |
| Sauts maximum (diffusion) | get flood.max / set flood.max <0-64> | Portée maximale d'une diffusion. |
| Sauts maximum (hors région) | get flood.max.unscoped / set flood.max.unscoped <0-64> | Limite les paquets sans région. |
| Sauts maximum (annonces) | get flood.max.advert / set flood.max.advert <0-64> | Défaut : 8 sauts. |
Contrôle d'accès
| Commande | Syntaxe | Description |
|---|---|---|
| Définir une permission | setperm <cle_publique> <0-3> | 0 = invité, 1 = lecture seule, 2 = lecture/écriture, 3 = administrateur. |
| Afficher la liste | get acl | Série uniquement. |
| Lecture seule | get allow.read.only / set allow.read.only <on|off> | Réglage room server. |
Régions (1.10+)
| Commande | Syntaxe | Description |
|---|---|---|
| Chargement groupé | region load / region load <nom> [F] | F autorise la diffusion. |
| Enregistrer | region save | Persiste les modifications. |
| Autoriser la diffusion | region allowf <nom> | * en joker. |
| Interdire la diffusion | region denyf <nom> | * bloque les paquets sans région. |
| Informations | region get <nom> | Détail d'une région. |
| Région d'origine | region home / region home <nom> | Consulte ou définit la région d'origine. |
| Région par défaut | region default / region default {nom|<null>} | Portée par défaut. |
| Créer | region put <nom> [parent] | Nouvelle région, avec parent facultatif. |
| Définir une hiérarchie | region def <jeton> [<jeton> …] | Hiérarchie sur une seule ligne. |
| Supprimer | region remove <nom> | Les régions filles doivent être retirées d'abord. |
| Lister | region list <filtre> | Filtre allowed ou denied. Série, 1.12+. |
| Tout afficher | region | Toutes les régions et leurs permissions. |
GPS (si compilé)
| Commande | Syntaxe | Description |
|---|---|---|
| État | gps / gps <on|off> | Active ou désactive le GPS. |
| Synchroniser l'horloge | gps sync | Cale l'horloge sur le temps GPS. |
| Définir la position | gps setloc | Renseigne la position depuis le GPS. |
| Politique d'annonce | gps advert / gps advert <politique> | none, share ou prefs. |
Capteurs (si compilé)
| Commande | Syntaxe | Description |
|---|---|---|
| Lister | sensor list [debut] | Liste des capteurs, index de départ facultatif. |
| Lire | sensor get <cle> | Valeur d'un capteur. |
| Écrire | sensor set <cle> <valeur> | Met à jour une valeur. |
Pont (si compilé)
| Commande | Syntaxe | Description |
|---|---|---|
| Type de pont | get bridge.type | Type de pont compilé. |
| Activation | get bridge.enabled / set bridge.enabled <on|off> | Active ou désactive le pont. |
| Délai | get bridge.delay / set bridge.delay <ms> | De 0 à 10000 ms, défaut 500. |
| Source | get bridge.source / set bridge.source <logRx|logTx> | Sens des paquets pontés. |
| Débit série | get bridge.baud / set bridge.baud <debit> | RS-232, de 9600 à 115200. |
| Canal | get bridge.channel / set bridge.channel <canal> | ESP-NOW, de 1 à 14. |
| Secret | get bridge.secret / set bridge.secret <secret> | 15 caractères maximum. |
Alimentation et démarrage
| Commande | Syntaxe | Description |
|---|---|---|
| Version du bootloader | get bootloader.ver | nRF52 uniquement. |
| Gestion d'énergie | get pwrmgt.support | Prise en charge de la gestion d'énergie. |
| Source d'alimentation | get pwrmgt.source | Alimentation courante. |
| Cause du démarrage | get pwrmgt.bootreason | Motifs de redémarrage et d'extinction. |
| Tension au démarrage | get pwrmgt.bootmv | Tension relevée au démarrage. |
Ethernet (si compilé)
| Commande | Syntaxe | Description |
|---|---|---|
| État de la connexion | eth.status | Serveur TCP sur le port 23, adresse par DHCP. |
Séquences utiles
Mise en service d'un répéteur français
password un-mot-de-passe-long-et-unique
set name FR84-MonPseudo-MonSite
set radio 869.618,62.5,8,8
set tx 20
set repeat on
set dutycycle 10
set advert.interval 240
set flood.advert.interval 24
set agc.reset.interval 4
set multi.acks 1
set path.hash.mode 1
set loop.detect minimal
reboot
Diagnostic
ver
board
get radio
get repeat
neighbors
stats-radio
stats-packets
Essai temporaire d'autres paramètres radio — revient tout seul aux réglages précédents au bout du délai indiqué, ce qui évite de perdre l'accès à un nœud distant après une mauvaise manipulation :
tempradio 869.525,250,11,5,10