CLI-kommandoer

← MeshCore Rogalandsnett

På denne siden

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

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.


« MeshView-kart · Oversikt · Lenker og endringer »