MeshCore CLI configuratie
Beheer je MeshCore nodes via de krachtige command-line interface. Perfecte controle voor gevorderde gebruikers en automatisering.
Wat is de MeshCore CLI?
De MeshCore command-line interface (CLI) is een krachtige Python-gebaseerde tool waarmee je volledige controle hebt over je mesh-netwerk nodes. In plaats van een grafische interface gebruik je tekstcommando's om instellingen te wijzigen, berichten te versturen, en netwerk statistieken op te vragen.
De CLI is vooral populair bij systeembeheerders, developers en power users die meerdere nodes moeten configureren, scripts willen schrijven voor automatisering, of die preferentie hebben voor keyboard-driven workflows. Het is ook essentieel voor remote server configuratie en headless repeater setups.
Deze gids laat je zien hoe je de MeshCore CLI installeert, basis en geavanceerde commando's gebruikt, configuraties exporteert en importeert, en volledige node setups automatiseert met scripts.
Waarom de CLI gebruiken?
Snelheid en efficiëntie
Configureer nodes in seconden met enkele commando's, veel sneller dan via een grafische interface klikken.
Scriptbare automatisering
Schrijf bash of Python scripts om dezelfde configuratie op tientallen nodes toe te passen zonder handmatig werk.
Volledige controle
Toegang tot alle instellingen, ook advanced features die niet in de mobiele app zichtbaar zijn.
Backup en restore
Exporteer complete configuraties naar YAML bestanden en herstel ze later of op andere apparaten.
Remote beheer
Configureer nodes op remote servers via SSH zonder grafische interface nodig te hebben.
Monitoring en logging
Real-time network monitoring, packet analysis en gedetailleerde logging voor troubleshooting.
MeshCore CLI installeren
De CLI wordt geïnstalleerd als een Python package via pip. Het werkt op Windows, macOS, Linux en Raspberry Pi.
Stap 1: Controleer Python versie
Je hebt Python 3.7 of nieuwer nodig. Controleer je versie:
python3 --version
Als Python niet geïnstalleerd is, download het van python.org
Stap 2: Installeer meshtastic package
Installeer de officiële meshtastic CLI tool via pip:
pip3 install --upgrade meshtastic
Stap 3: Verifieer installatie
Controleer of de installatie succesvol was:
meshtastic --version
Basis CLI commando's
Deze commando's gebruik je het meest frequent voor dagelijks beheer van je nodes.
Node informatie opvragen
Bekijk alle details van je aangesloten node: firmware versie, hardware type, node ID, regio instellingen en meer.
meshtastic --info
Node naam instellen
Geef je node een herkenbare naam die andere gebruikers in het netwerk zien.
meshtastic --set-owner "Mijn Node"
Regio configureren (868 MHz)
Stel de juiste frequentie in voor Europa. Dit is verplicht voor legaal gebruik.
meshtastic --set lora.region EU_868
Kanaal encryptie instellen
Configureer een gedeelde encryptie sleutel (PSK) voor private communicatie.
meshtastic --ch-set psk base64:jgACAYdwH3VSvEIhqST7Q==
Bericht versturen
Stuur een tekstbericht naar alle nodes in het netwerk (broadcast).
meshtastic --sendtext "Hallo MeshCore netwerk!"
Netwerk monitoren
Luister naar alle binnenkomende berichten en node activiteit in real-time.
meshtastic --listen
Geavanceerde configuratie
Voor power users: toegang tot alle technische instellingen van je node.
LoRa radio instellingen
Pas zendvermogen, hop limit en andere radio parameters aan voor optimaal bereik.
meshtastic --set lora.region EU_868meshtastic --set lora.tx_power 22meshtastic --set lora.hop_limit 3GPS en locatie instellingen
Configureer hoe vaak je node zijn positie deelt en GPS instellingen.
meshtastic --set position.gps_enabled truemeshtastic --set position.position_broadcast_secs 900Apparaat rol configureren
Stel je node in als router/repeater voor optimale netwerk performance.
meshtastic --set device.role ROUTERmeshtastic --set device.node_info_broadcast_secs 10800WiFi en netwerk
Verbind je node met WiFi voor remote beheer en MQTT bridging.
meshtastic --set network.wifi_ssid "MijnWiFi"meshtastic --set network.wifi_psk "wachtwoord"Configuratie backup en restore
Exporteer je complete node configuratie naar een bestand en herstel het later of gebruik het als template voor andere nodes.
Configuratie exporteren
Sla alle instellingen op in een YAML bestand.
meshtastic --export-config > config.yaml
Configuratie importeren
Herstel een eerder opgeslagen configuratie op een node.
meshtastic --configure config.yaml
Bulk configuratie met scripts
Voor het configureren van meerdere nodes kun je een configuratie YAML bestand maken en dit op alle apparaten toepassen:
owner:
long_name: "Amsterdam Repeater"
short_name: "AMS1"
lora:
region: EU_868
tx_power: 22
hop_limit: 3
device:
role: ROUTER
node_info_broadcast_secs: 10800Veelgestelde vragen over CLI
Kan ik meerdere nodes tegelijk beheren met de CLI?
Ja, maar je moet ze één voor één aanpakken of scripts schrijven. Gebruik meshtastic --port /dev/ttyUSB0 om een specifieke USB poort te selecteren als je meerdere nodes aangesloten hebt. Voor bulk configuratie exporteer je een config YAML en pas je die toe op elk apparaat.
Werkt de CLI ook via WiFi of Bluetooth?
Ja! Standaard zoekt de CLI naar een USB verbinding, maar je kan ook verbinding maken via: meshtastic --host 192.168.1.100 (WiFi) of meshtastic --ble "Node Name" (Bluetooth). Dit is handy voor remote configuratie.
Hoe reset ik mijn node naar factory defaults via CLI?
Gebruik het commando meshtastic --factory-reset. Let op: dit wist ALLE instellingen inclusief encryptie sleutels. Maak eerst een backup als je die wilt behouden.
Kan ik Python scripts schrijven die de CLI gebruiken?
Absoluut! De meshtastic package biedt een volledige Python API. In plaats van command-line commando's kun je import meshtastic gebruiken en programmatisch interacteren met je nodes. Perfect voor custom monitoring tools, bots en automatisering.
Waar vind ik een complete lijst van alle CLI commando's?
Gebruik meshtastic --help voor een overzicht. Voor gedetailleerde uitleg: meshtastic --help-all. De officiële documentatie op GitHub heeft ook een volledige command reference met voorbeelden.
Gaan mijn CLI configuraties verloren bij een firmware update?
Nee, configuratie staat opgeslagen in het NVS geheugen dat behouden blijft. Alleen bij een --factory-reset of volledige flash erase gaat de configuratie verloren. Firmware updates laten je instellingen intact.
Meester de command-line
Met de MeshCore CLI heb je professionele controle over je mesh-netwerk. Ideaal voor repeaternet beheer, scripting en bulk configuratie.