Chappe 05 · Commandes du firmware
Commandes du firmware
Toutes les commandes de la console série d'un relais, relevées dans le code du firmware. Cherchez par nom, mot-clé ou catégorie, filtrez par origine.
Premier niveau
47 commandes
| Commande | Description | Défaut | Origine |
|---|---|---|---|
reboot |
Redémarrage de la carte. | — | MeshCore amont |
shutdown |
Extinction de la carte. Alias : poweroff. | — | MeshCore amont |
clkreboot |
Redémarrage avec recalage de l'horloge. | — | MeshCore amont |
erasesérie seulement |
Formate le système de fichiers : configuration ET identité perdues. La carte recrée une identité au démarrage suivant. | — | MeshCore amont |
ver |
Version du firmware. | — | MeshCore amont |
board |
Nom de la carte. | — | MeshCore amont |
advert |
Émet une annonce (advert) portant l'identité du nœud. | — | MeshCore amont |
advert.zerohop |
Émet une annonce sans saut, en portée directe seulement. | — | MeshCore amont |
clock |
Lit l'horloge de la carte. | — | MeshCore amont |
clock sync |
Synchronise l'horloge. | — | MeshCore amont |
time <epoch> |
Fixe l'heure, en secondes epoch. | — | MeshCore amont |
neighbors |
Liste le voisinage radio direct. | — | MeshCore amont |
neighbor.remove <préfixe> |
Retire un voisin de la table. | — | MeshCore amont |
discover.neighbors |
Lance une découverte active du voisinage. | — | MeshCore amont |
password <mot de passe>admin |
Change le mot de passe administrateur. 15 caractères utiles, tronqué en silence au-delà. | — | MeshCore amont |
setperm <clé publique hex> <0-3>admin |
Autorise une clé publique à un niveau d'accès, de 0 invité à 3 administrateur. | — | MeshCore amont |
get aclsérie seulement |
Liste les clés publiques autorisées et leur niveau. | — | MeshCore amont |
block.add <préfixe> |
Ajoute un nœud à la liste de blocage, par préfixe de clé publique (1 à 4 octets). | — | Chappe 05 |
block.remove <préfixe> |
Retire un nœud de la liste de blocage. | — | Chappe 05 |
block.clear |
Vide la liste de blocage. | — | Chappe 05 |
block.list |
Affiche la liste de blocage. | — | Chappe 05 |
gps on |
Active le GPS. | — | MeshCore amont |
gps off |
Désactive le GPS. | — | MeshCore amont |
gps |
État du GPS. Renvoie une erreur si la carte n'en a pas. | — | MeshCore amont |
gps sync |
Synchronise l'horloge sur le GPS. | — | MeshCore amont |
gps setloc |
Fige la position du fix GPS courant. | — | MeshCore amont |
gps advert |
Lit la position diffusée dans les adverts. | — | MeshCore amont |
gps advert none|prefs|share |
Fixe la position diffusée : aucune, celle des préférences, ou celle du fix courant. | — | MeshCore amont |
powersaving on |
Active l'économie d'énergie. | — | MeshCore amont |
powersaving off |
Désactive l'économie d'énergie. | — | MeshCore amont |
powersaving |
État de l'économie d'énergie. | — | MeshCore amont |
log start |
Démarre le journal. | — | MeshCore amont |
log stop |
Arrête le journal. | — | MeshCore amont |
log erase |
Efface le journal. | — | MeshCore amont |
logsérie seulement |
État du journal. | — | MeshCore amont |
stats-packetssérie seulement |
Compteurs de paquets. | — | MeshCore amont |
stats-radiosérie seulement |
Compteurs radio. | — | MeshCore amont |
stats-coresérie seulement |
Compteurs du cœur mesh. | — | MeshCore amont |
stats-filtersérie seulement |
Compteurs de filtrage : rejets par motif (grp_data, typeblock, blocklist, hopcap, airtime, qfull), avec le détail par type block[t] et air[t]. | — | Chappe 05 |
clear stats |
Remet tous les compteurs à zéro. | — | MeshCore amont |
tempradio <freq,bw,sf,cr> |
Réglage radio temporaire, non enregistré. | — | MeshCore amont |
sensor list |
Liste les capteurs. | — | MeshCore amont |
sensor get <clé> |
Lit un réglage de capteur. | — | MeshCore amont |
sensor set <clé> <valeur> |
Écrit un réglage de capteur. | — | MeshCore amont |
start ota |
Passe la carte en mise à jour OTA. | — | MeshCore amont |
get <champ> |
Lit un réglage. Voir la catégorie Lecture. | — | MeshCore amont |
set <champ> <valeur> |
Écrit un réglage. Voir les catégories set. | — | MeshCore amont |
Radio
9 commandes
| Commande | Description | Défaut | Origine |
|---|---|---|---|
set radio <freq>,<bw>,<sf>,<cr> |
Preset radio complet. freq 150 à 2500 MHz, bw 7 à 500 kHz, sf 5 à 12, cr 5 à 8. Les quatre sont obligatoires. | — | MeshCore amont |
set freq <MHz> |
Fréquence seule. | — | MeshCore amont |
set tx <dBm> |
Puissance d'émission. | — | MeshCore amont |
set dutycycle <1-100> |
Rapport cyclique, en pourcentage. | 50 | MeshCore amont |
set af <facteur> |
Facteur d'airtime. | — | MeshCore amont |
set radio.rxgain <n> |
Gain de réception radio. | — | MeshCore amont |
set radio.fem.rxgain <n> |
Gain de réception de l'amplificateur (FEM), selon le matériel. | — | MeshCore amont |
set radio.fem.txgain <n> |
Gain d'émission de l'amplificateur (FEM), selon le matériel. | — | MeshCore amont |
set extra.sf <n> |
Facteur d'étalement additionnel. | — | MeshCore amont |
Identité et position
5 commandes
| Commande | Description | Défaut | Origine |
|---|---|---|---|
set name <nom> |
Nom du nœud. | — | MeshCore amont |
set owner.info <texte> |
Information de propriétaire. | — | MeshCore amont |
set lat <degrés> |
Latitude. | — | MeshCore amont |
set lon <degrés> |
Longitude. | — | MeshCore amont |
set prv.key <128 hex>admin |
Remplace l'identité du nœud. Les 64 octets sont la clé privée étendue Ed25519, le SHA-512 de la graine borné, et non la graine suivie de la clé publique : la carte recalcule la clé publique et la renvoie. Refusée si cette clé publique commence par 00 ou FF. Redémarrage nécessaire. | — | MeshCore amont |
Diffusion
2 commandes
| Commande | Description | Défaut | Origine |
|---|---|---|---|
set advert.interval <minutes> |
Cadence des annonces directes. | 2 minutes | MeshCore amont |
set flood.advert.interval <heures> |
Cadence des annonces inondées. 0, ou de 3 à 168. | 47 heures | MeshCore amont |
Filtrage et portée
13 commandes
| Commande | Description | Défaut | Origine |
|---|---|---|---|
set flood.max <0-64> |
Plafond de sauts global en flood. | 64 | MeshCore amont |
set flood.max.unscoped <0-64> |
Plafond de sauts pour le trafic sans région. | 64 | MeshCore amont |
set flood.max.advert <0-64> |
Plafond de sauts pour les adverts inondés. | 8 | MeshCore amont |
set flood.max.type <0-15> <0-64> |
Plafond de sauts par type de paquet. | — | Chappe 05 |
set grp.data.block <0|1> |
Rejet des GRP_DATA reçus en flood. Généralisé par block.type (block.type 6 en est l'alias). | 1 | Chappe 05 |
set grp.data.allow <00-FF> |
Exempte une empreinte de canal du rejet GRP_DATA. allow.type 6 en est l'alias. | — | Chappe 05 |
set grp.data.deny <00-FF> |
Retire une empreinte de la liste d'exemption. | — | Chappe 05 |
set grp.data.allow.clear |
Vide la liste d'exemption GRP_DATA. | — | Chappe 05 |
set block.lasthop <0|1> |
Liste de blocage : ne compare que le saut précédent immédiat. | 1 | Chappe 05 |
set block.alltypes <0|1> |
Liste de blocage : applique à tous les types (sinon l'administration passe toujours). | 0 | Chappe 05 |
set block.type <0-15> <0|1> |
Blocage total d'un type de paquet en flood, jeté dès le premier saut. Refuse les types structurants (ACK, ADVERT, PATH, CONTROL). Le type 6 (GRP_DATA) est l'alias de grp.data.block. | — | Chappe 05 |
set allow.type <5|6> <00-FF> |
Exempte une empreinte de canal du blocage, pour les types de canal seulement (GRP_TXT 5, GRP_DATA 6). allow.type 6 est l'alias de grp.data.allow. | — | Chappe 05 |
set allow.type.clear <5|6> |
Vide la liste d'exemption d'un type de canal (5 ou 6). | — | Chappe 05 |
Qualité de service
2 commandes
| Commande | Description | Défaut | Origine |
|---|---|---|---|
set prio.type <0-15> <0-64> |
Décalage de priorité par type. Plus la valeur est haute, plus le type cède sous charge. | 0 | Chappe 05 |
set airtime.budget.type <0-15> <0-100> |
Part d'airtime autorisée par type, en pourcentage du budget de duty cycle. | 0 | Chappe 05 |
Relais de groupe
4 commandes
| Commande | Description | Défaut | Origine |
|---|---|---|---|
set grp.relay.enable <0|1> |
Confirmation passive de relais de groupe. | 0 | Chappe 05 |
set grp.relay.timeout <1-30> |
Délai d'écoute, en secondes. | 2 | Chappe 05 |
set grp.relay.retries <0-10> |
Réémissions si aucune confirmation. | 2 | Chappe 05 |
set grp.relay.firsthop <0|1> |
Premier saut seulement. | 1 | Chappe 05 |
Comportement et temporisation
11 commandes
| Commande | Description | Défaut | Origine |
|---|---|---|---|
set repeat <0|1> |
Active la retransmission. | — | MeshCore amont |
set loop.detect <off|minimal|moderate|strict> |
Détection de boucle. Valeurs en toutes lettres, pas numériques. | off | MeshCore amont |
set path.hash.mode <0|1|2> |
Taille des empreintes de chemin à l'émission. | 0 | MeshCore amont |
set rxdelay <0-20> |
Délai de réception. | 0 | MeshCore amont |
set txdelay <0-2> |
Facteur de délai d'émission. | 0,5 | MeshCore amont |
set direct.txdelay <n> |
Facteur de délai pour le trafic direct. | 0,3 | MeshCore amont |
set cad <0|1> |
Détection d'activité canal avant émission. | 0 | MeshCore amont |
set multi.acks <n> |
Acquittements multiples. | 0 | MeshCore amont |
set int.thresh <n> |
Seuil d'interférence. | — | MeshCore amont |
set agc.reset.interval <n> |
Réinitialisation périodique de l'AGC. | — | MeshCore amont |
set adc.multiplier <n> |
Étalonnage de la mesure de tension. | — | MeshCore amont |
Accès
2 commandes
| Commande | Description | Défaut | Origine |
|---|---|---|---|
set guest.password <mot de passe> |
Mot de passe invité. 15 caractères utiles. | — | MeshCore amont |
set allow.read.only <0|1> |
Autorise l'accès en lecture seule sans mot de passe. | — | MeshCore amont |
Pont série
7 commandes
| Commande | Description | Défaut | Origine |
|---|---|---|---|
set bridge.enabled <0|1> |
Active le pont série. | — | MeshCore amont |
set bridge.type <n> |
Type de pont. | — | MeshCore amont |
set bridge.source <n> |
Source du pont. | — | MeshCore amont |
set bridge.baud <n> |
Débit du pont, en bauds. | — | MeshCore amont |
set bridge.channel <n> |
Canal du pont. | — | MeshCore amont |
set bridge.delay <n> |
Délai du pont. | — | MeshCore amont |
set bridge.secret <clé> |
Secret du pont. | — | MeshCore amont |
Lecture
12 commandes
| Commande | Description | Défaut | Origine |
|---|---|---|---|
get public.key |
Clé publique du nœud, 64 caractères hexadécimaux. | — | MeshCore amont |
get prv.keysérie seulement |
Clé privée, 128 caractères hexadécimaux. | — | MeshCore amont |
get role |
Rôle du nœud. | — | MeshCore amont |
get radio |
Preset radio courant, au format freq,bw,sf,cr. | — | MeshCore amont |
get bootloader.ver |
Version du bootloader. | — | MeshCore amont |
get pwrmgt.source |
Source de gestion d'énergie. | — | MeshCore amont |
get pwrmgt.support |
Prise en charge de la gestion d'énergie. | — | MeshCore amont |
get pwrmgt.bootmv |
Tension au démarrage, en millivolts. | — | MeshCore amont |
get pwrmgt.bootreason |
Raison du dernier démarrage. | — | MeshCore amont |
get bridge.type |
Type de pont configuré. | — | MeshCore amont |
get block.type |
Liste les types bloqués. Sans argument, tous les types actifs ; avec un numéro, l'état de ce type. | — | Chappe 05 |
get allow.type <5|6> |
Liste les empreintes de canal exemptées pour un type de canal. | — | Chappe 05 |
Régions
13 commandes
| Commande | Description | Défaut | Origine |
|---|---|---|---|
region |
Exporte la carte des régions. | — | MeshCore amont |
region def <définition> |
Définit tout l'arbre des régions en une commande, segments séparés, sauts nom|parent. | — | MeshCore amont |
region get <nom> |
Détail d'une région : nom, parent, F si le flood y est autorisé. | — | MeshCore amont |
region home |
Lit la région du nœud. | — | MeshCore amont |
region home <nom> |
Fixe la région du nœud. | — | MeshCore amont |
region default |
Lit le scope d'annonce par défaut. | — | MeshCore amont |
region default <nom> |
Fixe le scope par défaut, en créant la région au besoin. <null> pour aucun. | — | MeshCore amont |
region put <nom> [parent] |
Crée une région, éventuellement sous un parent. Flood autorisé par défaut. | — | MeshCore amont |
region remove <nom> |
Supprime une région. | — | MeshCore amont |
region allowf <nom> |
Autorise le flood dans une région. | — | MeshCore amont |
region denyf <nom> |
Refuse le flood dans une région. denyf * vise le joker. | — | MeshCore amont |
region save |
Écrit la table des régions. | — | MeshCore amont |
region load |
Recharge la table des régions. | — | MeshCore amont |
Aucune commande ne correspond à
Source. Chaque commande est relevée dans le code du firmware, fork und3rX1337/meshcore-chappe05, rôle repeater. Les bornes et valeurs par défaut viennent du source, pas d'une déduction. Certaines commandes ne répondent que depuis le port série, d'autres demandent un accès administrateur. Le préfixe des réponses sur le port est -> , une réponse de get ajoute encore > .