Webseiten-Werkzeuge


meshcore:allgemeines:repeater‐_und_room‐server‐cli‐referenz

Repeater‐ und Room‐Server‐CLI‐Referenz

Du kannst sowohl Repeater- als auch Room-Server-Geräte entweder seriell (und über die Terminal-App/Putty/Serial Monitor) oder über den T-Deck-CLI-Bildschirm konfigurieren.

Nur serielle Befehle:

set freq {frequency}

Beispiel: set freq 869,618

time {epoch-secs}

Beispiel: time 1743400059

erase

Löscht das lokale Dateisystem des Gerätes vollständig.

log

Vollständigen Paketprotokollinhalt anzeigen.

get acl

Liste der autorisierten Knoten in der Zugriffssteuerungsliste anzeigen.

region

Liste/Hierarchie der definierten Regionen und der aktuellen Berechtigungen anzeigen.

Befehle über die serielle Schnittstelle, T-Deck-Benutzeroberfläche bzw App

HINWEIS: Zu den verschiedenen „set …“-Befehlen gibt es jeweils auch einen „get …“-Befehl.

advert

Sendet ein Node-Info Paket (Bekanntmachung)

reboot

Startet das Gerät neu. (Beachte, dass du wahrscheinlich eine „Zeitüberschreitung“ Meldung bekommst, was normal ist.)

clkreboot

Setzt die interne Uhr zurück und startet das Gerät neu. (Hinweis: Wahrscheinlich erhalten Sie die Meldung „Timeout“, was normal ist.)

clock

Zeigt die aktuelle Uhrzeit gemäß der Geräteuhr an.

password {new-password}

Legt ein neues Administratorkennwort für das Gerät fest.

set af {air-time-factor}

Legt den Air-Time-Faktor fest.

set tx {tx-power-dbm}

Legt die LoRa-Sendeleistung in dBm fest. (Neustart zum Anwenden)

set repeat {on|off}

Aktiviert oder deaktiviert die Repeater-Rolle für diesen Knoten.

set allow.read.only {on|off}

Raumserver (room server) Wenn „on“, dann ist die Anmeldung mit leerem Passwort erlaubt, aber es können keine Posts im Raum erstellt werden. (nur lesbar)

set flood.max {max-hops}

Legt die maximale Anzahl von Hops für eingehende Flood-Pakete fest (wenn >= max, wird das Paket nicht weitergeleitet)

set int.thresh {db}

Legt den Interferenzschwellenwert (in dB) fest. Standardwert ist 14. Auf 0 setzen, um die Kanalinterferenzerkennung zu deaktivieren.

set agc.reset.interval {seconds}

Legt das Intervall für das Zurücksetzen des automatischen Verstärkungsreglers fest. Auf 0 setzen, um ihn zu deaktivieren.

set multi.acks {0|1}

Aktiviert oder deaktiviert die Funktion „Doppelte Bestätigungen“.

set advert.interval {minutes}

Legt das Timerintervall in Minuten fest, um ein lokales (Zero-Hop-)Advertisement-Paket zu senden. Zum Deaktivieren auf 0 setzen.

set flood.advert.interval {hours}

Legt das Timerintervall in Stunden für das Senden eines Flood-Advertisement-Pakets fest. Zum Deaktivieren auf 0 setzen.

set guest.password {guess-password}

Legt das Gastkennwort fest/aktualisiert es. (Bei Repeatern können Gastanmeldungen die Anfrage „Statistiken abrufen“ senden.)

set name {name}

Legt den Anzeigennamen fest.

set owner.info {info}

(Ab Version 1.12.+) Legt die Besitzerinformationen fest. (Hinweis: Das Zeichen '|' wird bei der Anzeige in Zeilenumbruchzeichen umgewandelt.)

set lat {latitude}

Legt den Breitengrad auf der Karte fest. (Dezimalgrad)

set lon {longitude}

Legt den Längengrad der Karte fest. (Dezimalgrad)

set radio {freq},{bw},{sf},{cr}

Legt komplett neue Radioparameter fest und speichert sie in den Einstellungen. Zur Anwendung ist ein Neustart erforderlich.

Beispiel: 869,618,62,5,8,8

set rxdelay {base}

Legt den (experimentellen) Basiswert (muss > 1 sein, um wirksam zu sein) für die Anwendung einer leichten Verzögerung auf empfangene Pakete basierend auf der Signalstärke/dem Signal-Score fest. Auf 0 setzen, um die Funktion zu deaktivieren.

set txdelay {factor}

Legt einen Faktor fest, der mit der Sendezeit eines Flood-Mode-Pakets und einem randomisierten Slot-System multipliziert wird, um dessen Weiterleitung zu verzögern (um die Wahrscheinlichkeit von Kollisionen zu verringern).

set direct.txdelay {factor}

Dasselbe wie txdelay, jedoch zum Anwenden einer zufälligen Verzögerung auf die Weiterleitung von Direktmodus-Paketen.

set bridge.enabled {on|off}

Brücke aktivieren/deaktivieren.

set bridge.delay {0-10000}

Verzögerung vor dem erneuten Senden von Paketen einstellen.

set bridge.source {rx|tx}

Wählen Sie aus, ob die Bridge empfangene oder gesendete Pakete erneut senden soll.

set bridge.baud {speed}

Serielle Verbindungsbaudrate für RS232-Brücken einstellen.

set bridge.secret {shared-secret}

Setze das Brückengeheimnis für espnow-Brücken.

set adc.multiplier {factor}

Legt einen benutzerdefinierten Faktor fest, um die gemeldete Batteriespannung anzupassen (wird nur auf ausgewählten Boards unterstützt).

get bridge.type

Gibt den Brückentyp zurück: none, rs232, espnow

log start

Startet die Paketprotokollierung im Dateisystem.

log stop

Stoppt die Paketprotokollierung im Dateisystem.

log erase

Löscht die Paketprotokolle aus dem Dateisystem.

ver

Zeigt die Geräteversion und das Firmware-Erstellungsdatum an.

neighbors

(Nur für Repeater) Zeigt eine Liste anderer Repeater-Knoten an, die über Zero-Hop-Advertisements empfangen wurden. Jede Zeile hat die Form {id-prefix-hex}:{timestamp}:{snr-times-4}.

neighbor.remove {pubkey-prefix}

(Nur für Repeater) Entfernt den ersten übereinstimmenden Eintrag (nach öffentlichem Schlüsselpräfix (hex)) aus der Nachbarliste.

clear stats

Setzt diverse Statistikzähler auf Null zurück.

tempradio {freq},{bw},{sf},{cr},{minutes}

Legt temporäre Funkparameter für die angegebene Anzahl von {Minuten} fest und stellt anschließend die ursprünglichen Funkparameter wieder her. (Speichert NICHT in den Einstellungen).

setperm {pubkey-hex} {permissions}

Ändert die ACL. Entfernt den entsprechenden Eintrag (anhand des öffentlichen Schlüsselpräfixes), falls „permissions“ den Wert Null hat. Fügt einen neuen Eintrag hinzu, falls der öffentliche Schlüssel (Hexadezimalwert) die volle Länge aufweist und noch nicht in der ACL vorhanden ist. Aktualisiert den Eintrag anhand des übereinstimmenden öffentlichen Schlüsselpräfixes. Die Berechtigungsbits variieren je nach Firmware-Rolle, die beiden niedrigsten Bits sind jedoch: 0 (Gast), 1 (Nur Lesen), 2 (Lesen/Schreiben), 3 (Administrator).

Regionsverwaltung (nur für Repeater)

region Befehle wurden eingeführt um Regionsdefinitionen und Berechtigungen zu verwalten.

region

(Nur Serienversion) Listet alle definierten Regionen und die aktuellen Flood-Berechtigungen auf.

region load

HINWEIS: Dies ist ein spezieller Mehrfachbefehlsaufruf. Jeder nachfolgende Befehl ist ein Regionsname (eingerückt mit Leerzeichen zur Kennzeichnung der übergeordneten Hierarchie, mindestens ein Leerzeichen). Der Aufruf wird durch Senden einer leeren Zeile/eines leeren Befehls beendet.

region get {* | name-prefix}

Sucht nach Regionen mit dem angegebenen Namenspräfix (oder '*' für den globalen Bereich). Die Antwort lautet: „→ {region-name} ({parent-name}) {'F'}“

region put {name} {* | parent-name-prefix}

Fügt eine Regionsdefinition mit dem angegebenen Namen hinzu oder aktualisiert diese.

region remove {name}

Entfernt eine Regionsdefinition mit dem angegebenen Namen. (Muss exakt übereinstimmen und darf keine untergeordneten Regionen enthalten.)

region allowf {* | name-prefix}

Legt die 'F'lood'-Berechtigung für die angegebene Region fest. ('*' für den globalen/Legacy-Bereich)

region denyf {* | name-prefix}

Entfernt die 'F'lood'-Berechtigung für die angegebene Region. (HINWEIS: Derzeit wird von der Verwendung im globalen/Legacy-Bereich abgeraten!)

region home

Antworten mit der aktuellen Heimatregion. (Hinweis: Wird noch nicht überall angewendet, ist für die Zukunft reserviert.)

region home {* | name-prefix}

Legt die „Heimatregion“ fest.

region list {allowed|denied}

(ab Version 1.12.+) Listet die Namen der konfigurierten Regionen auf und filtert entweder nur diejenigen mit Flood-Berechtigung oder diejenigen, die keine Flood-Berechtigung haben.

region save

Speichert die Regionsliste/Regionskarte.

GPS-Verwaltung

gps Befehl wurde eingeführt, um standortbezogene Themen zu verwalten.

gps

Gibt den GPS-Status an. Wenn GPS deaktiviert ist, wird nur off angezeigt; wenn GPS aktiviert ist, werden on, {status}, {fix}, {sat count} angezeigt.

gps {on|off}

Schaltet den GPS-Energiestatus um.

gps sync

Synchronisiert die Knotenzeit mit der GPS-Uhr.

gps setloc

Legt die Position des Knotens auf GPS-Koordinaten fest und speichert die Einstellungen.

gps advert

Gibt die Standortanzeigenkonfiguration des Knotens an:

  • none: Standortangaben in Anzeigen vermeiden
  • share: GPS-Standort teilen (von SensorManager)
  • prefs: Den in den Einstellungen gespeicherten Standort bewerben

gps advert {none|share|prefs}

Legt die Konfiguration für Standortanzeigen fest.

Energiemanagement (nur Repeater)

powersaving Befehl wurden eingeführt (ab Version 1.12.0).

powersaving {on|off}

Ändert den aktuellen Energiesparmodus. (Wird in den Einstellungen gespeichert)

powersaving

Gibt den aktuellen Energiesparmodus zurück (ein oder aus).

Befehle ausschließlich über das T-Deck

clock sync

Synchronisiert die Uhr des Geräts mit der Uhr des T-Decks.

Quelle

meshcore/allgemeines/repeater‐_und_room‐server‐cli‐referenz.txt · Zuletzt geändert: von blue