MeshCore CLI Konfiguration
Verwalten Sie Ihre MeshCore Nodes über das offizielle meshcore-cli Tool. Perfekte Kontrolle für fortgeschrittene Benutzer und Automatisierung.
Was ist die MeshCore CLI?
Das MeshCore Command-Line Interface (meshcore-cli) ist ein Python-basiertes Tool, mit dem Sie über das Terminal mit Ihrer MeshCore Companion Radio kommunizieren. Die CLI unterstützt Verbindungen über Bluetooth Low Energy (BLE), TCP/IP oder Seriell.
Darüber hinaus haben Repeater und Room Server ihre eigene integrierte CLI, die Sie über USB/Seriell oder remote erreichen können. Damit konfigurieren Sie Frequenz, Sendeleistung, Name und andere Einstellungen direkt auf dem Gerät.
Diese Anleitung behandelt beide Methoden: das meshcore-cli Python-Tool für Companion Radios und die serielle CLI für Repeater und Room Server. Perfekt für Systemadministratoren, Power User und jeden, der Scripting oder Automatisierung nutzen möchte.
Warum die CLI verwenden?
Geschwindigkeit und Effizienz
Konfigurieren Sie Nodes in Sekunden mit wenigen Befehlen, viel schneller als über eine grafische Oberfläche.
Skriptbare Automatisierung
Schreiben Sie Bash- oder Python-Skripte, um Batch-Operationen auf mehreren Nodes gleichzeitig auszuführen.
Vollständige Kontrolle
Zugang zu allen Einstellungen einschließlich erweiterter Radio-Parameter und Repeater-Konfiguration.
Mehrere Verbindungen
Verbinden Sie über Bluetooth, WiFi/TCP oder seriell – wählen Sie, was am besten zu Ihrem Setup passt.
Remote-Verwaltung
Verwalten Sie Repeater aus der Ferne über die Remote-Admin-Funktion aus der CLI oder mobilen App.
Interaktiver Chat-Modus
Die CLI hat einen interaktiven Modus mit Tab-Vervollständigung, Verlauf und Echtzeit-Nachrichten.
MeshCore CLI installieren
Das meshcore-cli Tool installieren Sie als Python-Paket über pip oder pipx. Es funktioniert auf Windows, macOS, Linux und Raspberry Pi. Erfordert Python 3.10 oder neuer.
Schritt 1: Python-Version prüfen
Sie benötigen Python 3.10 oder neuer. Prüfen Sie Ihre Version:
python3 --version
Falls Python nicht installiert ist, laden Sie es von python.org herunter
Schritt 2: meshcore-cli installieren
Installieren Sie das offizielle MeshCore CLI Tool über pipx (empfohlen) oder pip:
# Via pipx (aanbevolen)pipx install meshcore-cli# Of via pippip3 install meshcore-cliSchritt 3: Installation verifizieren
Prüfen Sie, ob die Installation erfolgreich war, indem Sie die Hilfe öffnen:
meshcli -h
Basis CLI-Befehle
Das meshcore-cli unterstützt sowohl Command-Line-Parameter als auch einen interaktiven Chat-Modus. Starten Sie ohne Argumente für den interaktiven Modus.
Gerät auswählen (BLE)
Scannen und wählen Sie Ihr MeshCore-Gerät über Bluetooth. Die CLI merkt sich Ihre Auswahl für folgende Sitzungen.
meshcli -S
Verbinden über TCP/IP
Verbinden Sie mit einem MeshCore Node über WiFi/Netzwerk, wenn TCP-Server aktiv ist.
meshcli -t 192.168.1.100
Verbinden über Seriell
Verbinden Sie über USB/seriellen Port für direkte Kommunikation mit Ihrem Node.
meshcli -s /dev/ttyUSB0
Nachricht senden
Senden Sie eine Textnachricht an einen bestimmten Kontakt oder als Broadcast an alle.
meshcli send "Hallo MeshCore netwerk!"
Kontakte ansehen
Sehen Sie alle bekannten Nodes in Ihrem Netzwerk mit Status und Signalstärke.
meshcli contacts
Interaktiver Modus
Starten Sie ohne Befehle für den interaktiven Chat-Modus mit Tab-Vervollständigung und Verlauf.
meshcli
Repeater & Room Server CLI
Repeater und Room Server haben eine integrierte CLI, die Sie über USB/Seriell (Terminal/PuTTY) oder über die T-Deck CLI erreichen können. Nach dem Flashen konfigurieren Sie hier die Basiseinstellungen.
Frequenz einstellen (erforderlich)
Nach dem Flashen müssen Sie zuerst die Frequenz für Ihre Region einstellen. Für Europa verwenden Sie 869.4 MHz oder 869.525 MHz. Weitere Kanaloptionen finden Sie unter Kanal-Konfiguration.
set freq 869.4rebootName und Standort
Geben Sie Ihrem Repeater einen erkennbaren Namen und optional GPS-Koordinaten für die Karte.
set name MijnRepeaterset lat 52.3676set lon 4.9041Sendeleistung konfigurieren
Passen Sie die Sendeleistung in dBm an. Verwenden Sie max 22 dBm für EU 868 MHz Band.
set tx 22
Repeater-Einstellungen
Konfigurieren Sie Repeater-spezifische Optionen wie Hop-Limits und Werbe-Intervalle.
set flood.max 3set advert.interval 30set flood.advert.interval 3Web-basierte Konfiguration
Neben der CLI können Sie Repeater und Room Server auch über die web-basierten Tools konfigurieren. Das ist oft einfacher für Anfänger.
MeshCore-Webflasher
Flashen Sie Firmware und konfigurieren Sie direkt über den Browser auf meshcore.io/flasher. Klicken Sie nach dem Flashen auf "Console" für CLI-Zugang.
meshcore.io/flasher →MeshCore Config Tool
Konfigurieren Sie bestehende Repeater über config.meshcore.dev – verbinden Sie über USB und passen Sie Einstellungen im Browser an.
config.meshcore.dev →Minimale Konfiguration nach dem Flashen
Nach dem Flashen der MeshCore-Firmware sind mindestens diese Schritte erforderlich:
# 1. Frequenz einstellen (erforderlich für legalen Betrieb)
set freq 869.4
# 2. Neustart um Änderungen anzuwenden
reboot
# 3. Optional: Geben Sie Ihrem Repeater einen Namen
set name MeinRepeater
# 4. Optional: Standort für die Karte einstellen
set lat 52.5200
set lon 13.4050Häufig gestellte Fragen zur CLI
Was ist der Unterschied zwischen meshcore-cli und der seriellen CLI?
Das meshcore-cli (meshcli) ist ein Python-Tool, mit dem Sie über BLE, TCP oder seriell mit Ihrer Companion Radio kommunizieren. Die serielle CLI ist in Repeatern und Room Servern integriert und wird direkt über USB/Terminal erreicht. Beide haben unterschiedliche Befehle und Anwendungen.
Wie verbinde ich mich über Bluetooth?
Unter Linux müssen Sie Ihr Gerät zuerst über bluetoothctl koppeln. Dann verwenden Sie meshcli -S, um Ihr Gerät auszuwählen. Die CLI merkt sich Ihre Auswahl in ~/.config/meshcore.
Kann ich Repeater aus der Ferne konfigurieren?
Ja! Über die Remote-Admin-Funktion können Sie Repeater und Room Server über LoRa verwalten. Das funktioniert über meshcore-cli mit repeater-Befehlen oder über die mobile App mit Remote Management.
Welche Frequenz sollte ich in Deutschland/Europa verwenden?
Verwenden Sie Frequenzen im 868 MHz Band. Gängige Wahlen sind 869.4 MHz oder 869.525 MHz. Verwenden Sie niemals 915 MHz – das ist nur in den USA erlaubt und in Europa nicht legal.
Wie setze ich meinen Repeater auf Werkseinstellungen zurück?
Über die serielle CLI können Sie erase verwenden, um das Dateisystem zu löschen. Dies entfernt alle Einstellungen. Sie müssen danach erneut die Frequenz einstellen.
Wo finde ich alle verfügbaren Befehle?
Für meshcore-cli: meshcli -h zeigt alle Optionen. Für die Repeater/Room Server CLI: help in der seriellen Konsole. Die vollständige Referenz finden Sie im MeshCore GitHub Wiki.
Meistern Sie die Command-Line
Mit der MeshCore CLI haben Sie professionelle Kontrolle über Ihr Mesh-Netzwerk. Ideal für Repeater-Verwaltung, Scripting und erweiterte Konfiguration.