Dieses Dokument bietet einen Überblick über die CLI-Befehle, die an MeshCore Repeater, Raumserver und Sensoren gesendet werden können.

Starten Sie den Knoten neu

Verwendung:

• reboot

Uhrzeit zurücksetzen und neu starten

Verwendung:

• clkreboot

Synchronisieren Sie die Uhr mit dem Remote-Gerät.

Verwendung:

• clock sync

Aktuelle Zeit in UTC anzeigen

Verwendung:

• clock

Stelle die Zeit auf einen bestimmten Zeitstempel ein.

Verwendung:

• time <epoch_seconds>

Parameter:

• epoc_seconds : Unix-Epochenzeit

Senden Sie eine flood advert

Verwendung:

• advert

Starten Sie ein Firmware-Update über Funk (OTA).

Verwendung:

• start ota

Löschen/Auf Werkseinstellungen zurücksetzen

Verwendung:

• erase

Nur seriell: Ja

Warnung: Dies ist zerstörerisch!

Listen Sie Nachbarn in der Nähe auf

Verwendung:

• neighbors

Hinweis: Die Ausgabe dieses Befehls ist auf die 8 neuesten Anzeigen beschränkt.

Hinweis: Jede Zeile ist wie folgt kodiert: {pubkey-prefix}:{timestamp}:{snr*4}

Entfernen Sie einen Nachbarn

Verwendung:

• neighbor.remove <pubkey_prefix>

pubkey_prefix: Der öffentliche Schlüssel des Knotens, der aus der Nachbarliste entfernt werden soll.

Statistiken löschen

Verwendung:

• clear stats

Systemstatistiken – Akku, Betriebszeit, Warteschlangenlänge und Debug-Flags

Verwendung:

• stats-core

Nur seriell: Ja

Funkstatistik – Rauschpegel, Letzter RSSI/SNR-Wert, Sendezeit, Empfangsfehler

Verwendung:

• stats-radio

Nur seriell: Ja

Paketstatistik – Paketzähler: Empfangen, Gesendet

Verwendung:

• stats-packets

Nur seriell: Ja

Beginne die Erfassung des RX-Protokolls im Knotenspeicher

Verwendung:

• log start

Ende der Erfassung des RX-Logs im Knotenspeicher

Verwendung:

• log stop

Erfasstes Protokoll löschen

Verwendung:

• log erase

Geben Sie das erfasste Protokoll im seriellen Terminal aus.

Verwendung:

• log

Nur seriell: Ja

Holen Sie sich die Version

Verwendung:

• ver

Zeigt den Hardwarenamen an

Verwendung:

• board

Funkparameter dieses Knotens anzeigen oder ändern

Verwendung:

• get radio
• set radio <freq>,<bw>,<sf>,<cr>

Parameter:

• freq : Frequenz in MHz
• bw : Bandbreite in kHz
• sf : Spreizfaktor (5-12)
• cr : Kodierungsrate (5-8)

Wird durch Build-Flag gesetzt: LORA_FREQ, LORA_BW, LORA_SF, LORA_CR Standard: 869.525,250,11,5 Hinweis: Ein Neustart ist erforderlich, um die Anwendung zu ermöglichen.

Sendeleistung dieses Knotens anzeigen oder ändern

Verwendung:

• get tx
• set tx <dbm>

Parameter:

• dbm : Leistungspegel in dBm (1-22)

Wird durch Build-Flag gesetzt: LORA_TX_POWER

Standard: Variiert je nach Board

Hinweis: Diese Einstellung steuert lediglich die Sendeleistung des LoRa-Chips. Einige Knoten verfügen über eine zusätzliche Leistungsverstärkerstufe, die die Gesamtausgangsleistung erhöht. Die korrekte Einstellung finden Sie im Handbuch des jeweiligen Knotens. Ein zu hoher Wert kann gegen geltendes Recht in Ihrem Land verstoßen.

Ändern Sie die Funkparameter für eine festgelegte Dauer

Verwendung:

• tempradio <freq>,<bw>,<sf>,<cr>,<timeout_mins>

Parameter:

• freq : Frequenz in MHz
• bw : Bandbreite in kHz
• sf : Spreizfaktor (5-12)
• cr : Kodierungsrate (5-8)
• timeout_mins : Dauer in Minuten (muss > 0 sein)

Hinweis: Diese Einstellung wird nicht gespeichert und geht beim Neustart verloren.

Frequenz dieses Knotens anzeigen oder ändern

Verwendung:

• get freq
• set freq <frequency>

Parameter:

• frequency : Frequenz in MHz

Standard: 869.525

Hinweis: Ein Neustart ist erforderlich, um die Anwendung zu ermöglichen.

Diesen Knotennamen anzeigen oder ändern

Verwendung:

• get name
• set name <name>

Parameter:

• name : Knotenname

Wird durch Build-Flag gesetzt: ADVERT_NAME

Standard: Variiert je nach Board

Hinweis: Die maximale Länge variiert. Bei Angabe eines Speicherorts beträgt die maximale Länge 24 Byte, andernfalls 32 Byte. Emoji- und Unicode-Zeichen können mehr als ein Byte belegen.

Breitengrad dieses Knotens anzeigen oder ändern

Verwendung:

• get lat
• set lat <degrees>

Parameter:

• degrees : Breitengrad in Grad

Wird durch Build-Flag gesetzt: ADVERT_LAT

Standard: 0

Längengrad dieses Knotens anzeigen oder ändern

Verwendung:

• get lon
• set lon <degrees>

Parameter:

• degrees : Längengrad in Grad

Wird durch Build-Flag gesetzt: ADVERT_LON

Standard: 0

Die Identität dieses Knotens (Privater Schlüssel) anzeigen oder ändern

Verwendung:

• get prv.key
• set prv.key <private_key>

Parameter:

• private_key : Privater Schlüssel im Hexadezimalformat (64 Hexadezimalzeichen)

Serial Only:

• get prv.key : Ja
• set prv.key : Nein

Hinweis: Ein Neustart ist erforderlich, damit die Einstellung wirksam wird.

Ändern Sie das Administratorpasswort dieses Knotens.

Verwendung:

• password <password>

Parameter:

• password : Administratorpasswort

Wird durch Build-Flag gesetzt: ADMIN_PASSWORD

Standard: password

Hinweis: Zur Bestätigung zurückgesendet.

Hinweis: Jeder Knoten, der dieses Passwort verwendet, wird der Admin-ACL-Liste hinzugefügt.

Gastpasswort für diesen Knoten anzeigen oder ändern.

Verwendung:

• get guest.password
• set guest.password <password>

Parameter:

• password : Gastpasswort

Wird durch Build-Flag gesetzt: ROOM_PASSWORD (Nur für den Raumserver)

Standard: <blank> also leer

Eigentümerinformationen dieses Knotens anzeigen oder ändern

Verwendung:

• get owner.info
• set owner.info <text>

Parameter:

• text : Eigentümerinformationstext

Standard: <blank> also leer

Hinweis: | Zeichen werden in Zeilenumbrüche umgewandelt.

Hinweis: Erfordert Firmware 1.12 oder höher.

Feinabstimmung der Batterieanzeige

Verwendung:

• get adc.multiplier
• set adc.multiplier <value>

Parameter:

• value : ADC-Multiplikator (0,0-10,0)

Standard: 0.0 (vom Board festgelegter Wert)

Hinweis: Gibt die Fehlermeldung „Fehler: Von diesem Board nicht unterstützt“ zurück, wenn die Hardware dies nicht unterstützt.

Energiesparstatus dieses Knotens anzeigen oder ändern (nur Repeater)

Verwendung:

• powersaving <state>
• powersaving

Parameter:

• state : on | off

Standard: on

Hinweis: Wenn diese Option aktiviert ist, wechselt das Gerät zwischen den Funkübertragungen in den Schlafmodus.

Wiederholungsflag dieses Knotens anzeigen oder ändern.

Verwendung:

• get repeat
• set repeat <state>

Parameter:

• state : on | off

Standard: on

Den Wiederholungsverzögerungsfaktor anzeigen oder ändern für flood Datenverkehr

Verwendung:

• get txdelay
• set txdelay <value>

Parameter:

• value : Übertragungsverzögerungsfaktor (0-2)

Standard: 0.5

Anzeigen oder Ändern des Wiederholungsverzögerungsfaktors für direkten Datenverkehr

Verwendung:

• get direct.txdelay
• set direct.txdelay <value>

Parameter:

• value : Direkte Übertragungsverzögerungsfaktor (0-2)

Standard: 0.2

[Experimentell] Anzeigen oder Ändern der Verarbeitungsverzögerung für empfangenen Datenverkehr

Verwendung:

• get rxdelay
• set rxdelay <value>

Parameter:

• value : Empfangsverzögerungsbasis (0-20)

Standard: 0.0

Anzeigen oder Ändern des Sendezeitfaktor (Arbeitszyklusgrenze)

Verwendung:

• get af
• set af <value>

Parameter:

• value : Sendezeitfaktor (0-9)

Standard: 1.0 (WICHTIG: Für Deutschland bitte Air‐Time und Duty Cycle schauen.)

Lokale Interferenzschwelle anzeigen oder ändern

Verwendung:

• get int.thresh
• set int.thresh <value>

Parameter:

• value : Interferenzschwellenwert

Standard: 0.0

AGC-Rücksetzintervall anzeigen oder ändern

Verwendung:

• get agc.reset.interval
• set agc.reset.interval <value>

Parameter:

• value : Intervall in Sekunden, abgerundet auf ein Vielfaches von 4 (17 wird zu 16)

Standard: 0.0

Multi-Acks-Unterstützung aktivieren oder deaktivieren

Verwendung:

• get multi.acks
• set multi.acks <state>

Parameter:

• state : 0 (deaktivieren) oder 1 (aktivieren)

Standard: 0

flood advert intervall anzeigen oder ändern

Verwendung:

• get flood.advert.interval
• set flood.advert.interval <hours>

Parameter:

• hours : Intervall in Stunden (3–168)

Standard: 12 (Repeater) - 0 (Sensor)

zero-hop advert intervall anzeigen oder ändern

Verwendung:

• get advert.interval
• set advert.interval <minutes>

Parameter:

• minutes : Intervall in Minuten, abgerundet auf das nächste Vielfache von 2 (61 wird zu 60) (60–240)

Standard: 0

Begrenzen Sie die Anzahl der Hops für eine Flood-Nachricht.

Verwendung:

• get flood.max
• set flood.max <value>

Parameter:

• value : Maximale Flood-Hop-Anzahl (0-64)

Standard: 64

Berechtigungen für einen companion hinzufügen, aktualisieren oder entfernen

Verwendung:

• setperm <pubkey> <permissions>

Parameter:

• pubkey : Companion öffentlicher Schlüssel
• permissions :
  • 0 : Gast
  • 1 : Nur-Lesen
  • 2 : Lesen/Schreiben
  • 3 : Admin

Hinweis: Entfernt den Eintrag, wenn die permissions weggelassen werden.

Aktuelle ACL anzeigen

Verwendung:

• get acl

Nur seriell: Ja

Die „Nur-Lesen“-Kennzeichnung dieses Raumservers anzeigen oder ändern

Verwendung:

• get allow.read.only
• set allow.read.only <state>

Parameter:

• state : on (aktivieren) oder off (deaktivieren)

Standard: off

Regionslisten in großen Mengen laden

Verwendung:

• region load
• region load <name> [flood_flag]

Parameter:

• name : Der Name einer Region. * stellt die Wildcard-Region dar

Hinweis: flood_flag : Optionales F, um flooding zuzulassen.

Hinweis: Einrückungen schaffen Eltern-Kind-Beziehungen (max. 8 Ebenen).

Hinweis: region load mit einem leeren Namen funktioniert nicht aus der Ferne (es ist interaktiv)

Speichern Sie alle seit dem Neustart vorgenommenen Änderungen an Regionen.

Verwendung:

• region save

Allow a region

Verwendung:

• region allowf <name>

Parameter:

• name : Der Name einer Region (oder * für Wildcard)

Hinweis: Hinweis: Die Einstellung mit dem Wildcard * lässt Pakete ohne Regions-Transportcodes zu.

Eine Region blockieren

Verwendung:

• region denyf <name>

Parameter:

• name : Der Name einer Region (oder * für Wildcard)

Hinweis: Die Einstellung auf Wildcard * verwirft Pakete ohne Regions-Transportcodes.

Informationen für eine Region anzeigen

Verwendung:

• region get <name>

Parameter:

• name : Der Name einer Region (oder * für Wildcard)

Die Heimatregion für diesen Knoten anzeigen oder ändern

Verwendung:

• region home
• region home <name>

Parameter:

• name : Der Name einer Region.

Neue Region erstellen

Verwendung:

• region put <name> [parent_name]

Parameter:

• name : Der Name einer Region.
• parent_name : Name der übergeordneten Region (optional, Standardwert ist Platzhalter)

Region entfernen

Verwendung:

• region remove <name>

Parameter:

• name : Der Name einer Region (oder * für Wildcard)

Hinweis: Alle untergeordneten Regionen müssen entfernt werden, bevor die Region entfernt werden kann.

Alle Regionen anzeigen

Verwendung:

• region remove <name>

Nur seriell: Ja

Parameter:

• filter : allowed | denied

Hinweis: Erfordert Firmware 1.12.+

Alle definierten Regionen und flood Berechtigungen löschen

Verwendung:

• region

Nur seriell: Für Firmware älter als 1.12.0