CLI-kommandoer
På denne siden
- 1. Drift og grunnfunksjoner
- 2. Naboer og statistikk
- 3. Logging og informasjon
- 4. Radio
- 5. System og identitet
- 6. Ruting og airtime
- 7. ACL og tillatelser
- 8. Regioner og scope
- 9. GPS, sensorer, bridge og Ethernet
- 10. meshcore-cli / meshcli på PC
- 11. Eksempler for Rogalandsnett
- 12. Kilder og vedlikehold
Praktisk kommandoreferanse for repeatere, room servere, sensorer og companion-noder. Oppdatert 19. november 2026. Kommandoene avhenger av firmware.
Viktig: Ikke alle kommandoer finnes i alle firmwarebygg eller på alle kort. Kommandoer merket «Serial only» krever lokal USB/seriell tilgang. Ta sikkerhetskopi av innstillinger og bruk erase, private key, radioeffekt og OTA med forsiktighet.
Omfang: Dokumentet skiller mellom den innebygde enhets-CLI-en og PC-verktøyet meshcore-cli/meshcli. Den innebygde CLI-en brukes direkte mot repeater, room server og sensor, lokalt eller som autorisert fjernkommando. meshcore-cli brukes fra Windows, macOS, Linux eller Raspberry Pi mot en companion via BLE, TCP eller serial.
Tilkobling: Den innebygde USB-konsollen bruker normalt 115200 baud. meshcore-cli installeres med pipx install meshcore-cli. Bruk meshcli -h, get help og spørsmålstegnet i interaktiv modus for den mest presise listen for installert versjon.
1. Drift og grunnfunksjoner
| Kommando / syntaks | Formål | Merknad / støtte |
|---|---|---|
reboot |
Start noden på nytt | Ingen svar sendes. |
poweroff / shutdown |
Slå av noden | Ingen svar sendes. |
clkreboot |
Nullstill klokke og start på nytt | Ingen svar sendes. |
clock |
Vis UTC-tid | |
clock sync |
Synkroniser klokke med fjernenhet/vert | |
time <epoch_seconds> |
Sett Unix-tid | |
advert |
Send flood advert | |
advert.zerohop |
Send zero-hop advert | |
start ota |
Start OTA-oppdatering | Firmware-/plattformavhengig. |
erase |
Fabrikktilbakestilling | Serial only. Destruktiv. |
2. Naboer og statistikk
| Kommando / syntaks | Formål | Merknad / støtte |
|---|---|---|
neighbors |
Vis inntil 8 nylige naboannonser | Repeater. |
neighbor.remove <pubkey_prefix> |
Fjern nabo(er) som matcher nøkkelprefix | Tomt prefix/blank kan matche alle. |
discover.neighbors |
Oppdag zero-hop-naboer | Repeater. |
clear stats |
Nullstill statistikk | |
stats-core |
Batteri, oppetid, kø og debug-flagg | Serial only. |
stats-radio |
Støygulv, RSSI/SNR, airtime og RX-feil | Serial only. |
stats-packets |
Mottatte og sendte pakker | Serial only. |
3. Logging og informasjon
| Kommando / syntaks | Formål | Merknad / støtte |
|---|---|---|
log start |
Start RX-logg til lagring | |
log stop |
Stopp loggføring | |
log erase |
Slett lagret logg | |
log |
Skriv lagret logg til terminal | Serial only. |
ver |
Vis firmwareversjon | |
board |
Vis maskinvarenavn | |
get public.key |
Vis nodens offentlige nøkkel | |
get role |
Vis konfigurert rolle | |
get bootloader.ver |
Vis bootloader-versjon | nRF52. |
4. Radio
| Kommando / syntaks | Formål | Merknad / støtte |
|---|---|---|
get radio |
Vis frekvens, båndbredde, SF og CR | |
set radio <freq>,<bw>,<sf>,<cr> |
Sett radioprofil | Krever reboot. Eksempel: 869.618,62.5,8,5. |
get tx / set tx <dBm> |
Vis/sett LoRa-chipens TX-effekt | Typisk 1–22 dBm; kort/PA kan endre total effekt. |
tempradio <freq>,<bw>,<sf>,<cr>,<min> |
Midlertidig radioprofil | Lagrer ikke; forsvinner ved reboot. |
get freq / set freq <MHz> |
Vis/sett frekvens | set freq er Serial only; reboot kreves. |
get radio.rxgain / set radio.rxgain on|off |
SX12xx/LR1110 boosted RX gain | Fra v1.14.1. |
get radio.fem.rxgain / set radio.fem.rxgain on|off |
Styr ekstern FEM-mottaker-LNA | Kun støttede kort. |
get radio.fem.txgain / set radio.fem.txgain on|off |
Styr ekstern FEM-sendegevinst | Kun støttede kort. |
5. System og identitet
| Kommando / syntaks | Formål | Merknad / støtte |
|---|---|---|
get name / set name <navn> |
Vis/sett nodenavn | Annonsert navn begrenses av advert-plass. |
get lat / set lat <grader> |
Vis/sett breddegrad | |
get lon / set lon <grader> |
Vis/sett lengdegrad | |
get prv.key / set prv.key <64 hex> |
Vis/sett privat nøkkel | Lesing Serial only; reboot etter setting. |
password <nytt_passord> |
Endre administratorpassord | Svaret kan gjengi passordet. |
get owner.info / set owner.info <tekst> |
Vis/sett eierinformasjon | | oversettes til linjeskift; v1.12+. |
get adc.multiplier / set adc.multiplier <0.0-10.0> |
Kalibrer batterimåling | Kortavhengig. |
powersaving \[on|off\] |
Vis/sett strømsparing | Repeater. |
6. Ruting og airtime
| Kommando / syntaks | Formål | Merknad / støtte |
|---|---|---|
get repeat / set repeat on|off |
Slå videresending av/på | |
get path.hash.mode / set path.hash.mode 0|1|2 |
Velg 1-, 2- eller 3-byte sti-hash | Rogalandsnett bruker 1 (2 byte), som MeshNO. |
get loop.detect / set loop.detect off|minimal|moderate|strict |
Loop-deteksjon | Fra firmware 1.14. |
get txdelay / set txdelay <0-2> |
Tilfeldig forsinkelse for flood-trafikk | Standard ca. 0.5. |
get direct.txdelay / set direct.txdelay <0-2> |
Forsinkelse for direkte/rutet trafikk | Standard rolleavhengig. |
get rxdelay / set rxdelay <0-20> |
Eksperimentell RX-prosesseringsforsinkelse | |
get dutycycle / set dutycycle <1-100> |
Sett duty cycle i prosent | Fra v1.15.0. |
get af / set af <0-9> |
Eldre airtime factor | Utfaset fra v1.15.0; bruk dutycycle. |
get int.thresh / set int.thresh <verdi> |
Lokal interferensterskel | |
get cad / set cad on|off |
Maskinvarebasert Channel Activity Detection | |
get agc.reset.interval / set agc.reset.interval <0-1020> |
AGC-resetintervall i sekunder | 0 deaktiverer. |
get multi.acks / set multi.acks 0|1 |
Multi-ACK-støtte | |
get flood.advert.interval / set flood.advert.interval <timer> |
Intervall for flood advert | 3–168 timer. |
get advert.interval / set advert.interval <minutter> |
Intervall for zero-hop advert | 60–240 min; 0 deaktivert. |
get flood.max / set flood.max <0-64> |
Maks flood-hopp | |
get flood.max.unscoped / set flood.max.unscoped <0-64> |
Maks hopp uten regionscope | |
get flood.max.advert / set flood.max.advert <0-64> |
Maks hopp for advert-flood | Standard 8. |
7. ACL og tillatelser
| Kommando / syntaks | Formål | Merknad / støtte |
|---|---|---|
setperm <pubkey> \[0|1|2|3\] |
Sett companion-tilgang | 0 gjest, 1 les, 2 les/skriv, 3 admin; uten nivå fjernes. |
get acl |
Vis ACL | Serial only. |
get allow.read.only / set allow.read.only on|off |
Room Server read-only |
8. Regioner og scope
| Kommando / syntaks | Formål | Merknad / støtte |
|---|---|---|
region load \[navn\] \[F\] |
Last regiontre interaktivt | F tillater flooding; innrykk lager hierarki. |
region save |
Lagre regionendringer | |
region allowf <navn|\*> |
Tillat flooding for region | * gjelder uten transportkode. |
region denyf <navn|\*> |
Blokker flooding for region | |
region get <navn|\*> |
Vis regioninformasjon | |
region home \[navn\] |
Vis/sett hjemmeregion | |
region default \[navn|tom\] |
Vis/sett standard scope | Tom verdi nullstiller. |
region put <navn> \[forelder\] |
Opprett region | Standard forelder er *. |
region def <tokens...> |
Definer hierarki på én linje | Bruk navn|jump for å flytte markøren. |
region remove <navn> |
Fjern region | Barn må fjernes først. |
region list \[allowed|denied\] |
List regioner | Serial only; v1.12+. |
region |
Dump hele regiontreet og flood-flagg | Serial only før v1.12. |
9. GPS, sensorer, bridge og Ethernet
| Kommando / syntaks | Formål | Merknad / støtte |
|---|---|---|
gps \[on|off\] |
Vis/sett GPS-status | Kun bygg med GPS. |
gps sync |
Synkroniser klokke fra GPS | |
gps setloc |
Sett nodeposisjon fra GPS | |
gps advert \[none|share|prefs\] |
Velg GPS-policy i adverts | |
sensor list \[start\] |
List sensorer | Kun sensorbygg. |
sensor get <key> |
Les sensorinnstilling | |
sensor set <key> <value> |
Sett sensorverdi | |
get bridge.type |
Vis kompilert brotype | |
get bridge.enabled / set bridge.enabled on|off |
Aktiver/deaktiver bridge | |
get bridge.delay / set bridge.delay <0-10000> |
Bridge-forsinkelse i ms | Standard 500. |
get bridge.source / set bridge.source logRx|logTx |
Velg pakkekilde | |
get bridge.baud / set bridge.baud <rate> |
RS-232 baudrate | 9600–115200. |
get bridge.channel / set bridge.channel <1-14> |
ESP-NOW-kanal | |
get bridge.secret / set bridge.secret <tekst> |
ESP-NOW-hemmelighet | Maks 15 tegn. |
get pwrmgt.support |
Vis power-management-støtte | Kortavhengig. |
get pwrmgt.source |
Vis aktiv strømkilde | Kortavhengig. |
get pwrmgt.bootreason |
Vis reset-/shutdown-årsak | Kortavhengig. |
get pwrmgt.bootmv |
Vis spenning ved oppstart | Kortavhengig. |
eth.status |
Vis Ethernet-status/IP/port | RAK4631 + RAK13800, repeater/room server. |
10. meshcore-cli / meshcli på PC
Dette er kommandoer i klientprogrammet som kobler til en companion via BLE, TCP eller serial. De er ikke identiske med den innebygde repeater-CLI-en.
Klientkommandoer
| Kommando / syntaks | Formål | Merknad / støtte |
|---|---|---|
meshcli -h |
Vis hjelp | |
meshcli -v |
Vis klientversjon | |
meshcli -S |
Skann og velg BLE-enhet | |
meshcli -l |
List BLE-/serial-enheter | |
meshcli -a <adresse/navn> |
Velg bestemt BLE-enhet | |
meshcli -t <host> -p <port> |
Koble via TCP; standard port 5000 | |
meshcli -s <port> -b <baud> |
Koble via serial | |
infos / i |
Vis nodeinformasjon | |
self_telemetry / t |
Vis egen telemetri | |
card / e |
Eksporter nodens MeshCore-URI | |
reboot |
Start companion på nytt | |
msg <navn> <tekst> / m |
Send privat melding | |
chan <nr> <tekst> / ch |
Send til kanal | |
public <tekst> / dch |
Send til offentlig kanal 0 | |
recv / r |
Les neste melding | |
wait_msg / wm |
Vent på melding | |
sync_msgs / sm |
Hent uleste meldinger | |
msgs_subscribe / ms |
Vis meldinger fortløpende | |
get_channels |
List kanaler | |
get_channel <nr|navn> |
Vis kanal | |
set_channel <nr> <navn> <key> |
Opprett/endre kanal | |
remove_channel <nr|navn> |
Fjern kanal | |
advert / a |
Send advert | |
floodadv |
Send flood advert | |
get <parameter> |
Les parameter; get help for liste | |
set <parameter> <verdi> |
Sett parameter; set help for liste | |
time <epoch> |
Sett tid | |
clock / clock sync |
Vis/synkroniser tid | |
node_discover / nd |
Oppdag noder etter type | |
cli <kommando> |
Kjør lokal CLI-kommando | |
send_raw <hex> |
Send rå pakke | |
contacts / list / lc |
List kontakter | |
contact_info <kontakt> / ci |
Vis kontaktinfo | |
share_contact <kontakt> / sc |
Del kontakt | |
export_contact <kontakt> / ec |
Eksporter kontakt-URI | |
import_contact <URI> / ic |
Importer kontakt | |
remove_contact <kontakt> |
Fjern kontakt | |
path <kontakt> |
Vis sti | |
disc_path <kontakt> / dp |
Oppdag ny sti | |
reset_path <kontakt> / rp |
Tilbakestill til flood | |
change_path <kontakt> <sti> / cp |
Sett rute manuelt | |
req_telemetry <kontakt> / rt |
Be om telemetri | |
req_mma <kontakt> / rm |
Min/maks/gjennomsnitt sensor | |
req_acl <kontakt> |
Be om sensor-ACL | |
login <node> <pwd> / l |
Logg inn på repeater/room | |
logout |
Logg ut | |
cmd <node> <kommando> / c |
Send CLI-kommando til infrastruktur-node | |
req_status <node> / rs |
Be om status | |
req_neighbours <node> / rn |
Be om naboer | |
trace <node> \[sti\] |
Kjør rutetrace | |
scope <region|\*> |
Sett midlertidig flood-scope | |
apply_to <filter> <kommando> |
Kjør batch på matchende kontakter | |
alias / aliases / aliases_load |
Administrer klientaliaser | |
script <fil> |
Kjør kommandofil | |
sleep <sek> / s |
Vent | |
wait_ack / wa |
Vent på ACK | |
wait_key / wk |
Vent på tastetrykk |
11. Eksempler for Rogalandsnett
Verdiene under følger standarden i Rogalandsnett. Hele oppsettet står på Sette opp repeater.
| Oppgave | Kommando |
|---|---|
| Kontroller radio | get radio |
| Sett radioprofil for repeater (CR 5) | set radio 869.618,62.5,8,5 og deretter reboot |
| Sett nodenavn etter navnestandarden | set name NO-<postnr> <sted>, for eksempel set name NO-4130 Fjellet |
| Sett posisjon (desimalgrader) | set lat <breddegrad> og set lon <lengdegrad> |
| Sett path hash 2 byte | set path.hash.mode 1 |
| Sett flood advert-intervall | set flood.advert.interval 24 |
| Send advert | advert |
| Kontroller naboer | neighbors |
| Vis regionene | region |
| Lagre regionendringer | region save |
Regionene i nettet heter for eksempel no-11 og no-1133, uten #. Hvilke regioner en repeater bruker, ser du i detaljene på Repeatere i nettet.
12. Kilder og vedlikehold
-
MeshCore Docs, «CLI Commands»: https://docs.meshcore.io/cli_commands/
-
meshcore-dev/meshcore-cli på GitHub: https://github.com/meshcore-dev/meshcore-cli
-
MeshCore webkonsoll: https://flasher.meshcore.io/console
Denne referansen er et øyeblikksbilde. MeshCore utvikles raskt, og kommandoer kan bli lagt til, endret eller fjernet. Sjekk alltid ver, board, get help, set help og den offisielle dokumentasjonen mot firmwareversjonen på noden.
