MeshCore CLI configuratie
Beheer je MeshCore nodes via de officiële meshcore-cli tool. Perfecte controle voor gevorderde gebruikers en automatisering.
Wat is de MeshCore CLI?
De MeshCore command-line interface (meshcore-cli) is een Python-gebaseerde tool waarmee je via de terminal communiceert met je MeshCore companion radio. De CLI ondersteunt verbindingen via Bluetooth Low Energy (BLE), TCP/IP of serieel.
Daarnaast hebben repeaters en room servers hun eigen ingebouwde CLI die je via USB/serieel of remote kunt benaderen. Hiermee configureer je frequentie, zendvermogen, naam en andere instellingen rechtstreeks op het apparaat.
Deze gids behandelt beide methodes: de meshcore-cli Python tool voor companion radio's, en de seriële CLI voor repeaters en room servers. Perfect voor systeembeheerders, power users en iedereen die scripting of automatisering wil gebruiken.
Waarom de CLI gebruiken?
Snelheid en efficiëntie
Configureer nodes in seconden met enkele commando's, veel sneller dan via een grafische interface.
Scriptbare automatisering
Schrijf bash of Python scripts om batch-operaties uit te voeren op meerdere nodes tegelijk.
Volledige controle
Toegang tot alle instellingen inclusief geavanceerde radio parameters en repeater configuratie.
Meerdere verbindingen
Verbind via Bluetooth, WiFi/TCP of serieel - kies wat het beste past bij jouw setup.
Remote beheer
Beheer repeaters op afstand via de remote admin functie vanuit de CLI of mobiele app.
Interactieve chat modus
De CLI heeft een interactieve modus met tab-completion, geschiedenis en real-time berichten.
MeshCore CLI installeren
De meshcore-cli tool installeer je als Python package via pip of pipx. Het werkt op Windows, macOS, Linux en Raspberry Pi. Vereist Python 3.10 of nieuwer.
Stap 1: Controleer Python versie
Je hebt Python 3.10 of nieuwer nodig. Controleer je versie:
python3 --version
Als Python niet geïnstalleerd is, download het van python.org
Stap 2: Installeer meshcore-cli
Installeer de officiële MeshCore CLI tool via pipx (aanbevolen) of pip:
# Via pipx (aanbevolen)pipx install meshcore-cli# Of via pippip3 install meshcore-cliStap 3: Verifieer installatie
Controleer of de installatie succesvol was door de help te openen:
meshcli -h
Basis CLI commando's
De meshcore-cli ondersteunt zowel command-line parameters als een interactieve chat modus. Start zonder argumenten voor de interactieve modus.
Apparaat selecteren (BLE)
Scan en selecteer je MeshCore apparaat via Bluetooth. De CLI onthoudt je keuze voor volgende sessies.
meshcli -S
Verbinden via TCP/IP
Verbind met een MeshCore node via WiFi/netwerk als TCP server actief is.
meshcli -t 192.168.1.100
Verbinden via serieel
Verbind via USB/seriële poort voor directe communicatie met je node.
meshcli -s /dev/ttyUSB0
Bericht versturen
Stuur een tekstbericht naar een specifiek contact of broadcast naar iedereen.
meshcli send "Hallo MeshCore netwerk!"
Contacten bekijken
Bekijk alle bekende nodes in je netwerk met hun status en signaalsterkte.
meshcli contacts
Interactieve modus
Start zonder commando's voor de interactieve chat modus met tab-completion en geschiedenis.
meshcli
Repeater & Room Server CLI
Repeaters en room servers hebben een ingebouwde CLI die je via USB/serieel (terminal/PuTTY) of via de T-Deck CLI kunt gebruiken. Na flashen configureer je hier de basisinstellingen.
Frequentie instellen (verplicht)
Na flashen moet je eerst de frequentie instellen voor je regio. Voor Europa gebruik 869.4 MHz of 869.525 MHz.
set freq 869.4rebootNaam en locatie
Geef je repeater een herkenbare naam en optioneel GPS-coördinaten voor de kaart.
set name MijnRepeaterset lat 52.3676set lon 4.9041Zendvermogen configureren
Pas het zendvermogen aan in dBm. Gebruik max 22 dBm voor EU 868 MHz band.
set tx 22
Repeater instellingen
Configureer repeater-specifieke opties zoals hop limits en advertentie-intervallen.
set flood.max 3set advert.interval 30set flood.advert.interval 3Web-based configuratie
Naast de CLI kun je repeaters en room servers ook configureren via de web-based tools. Dit is vaak makkelijker voor beginners.
MeshCore Flasher
Flash firmware en configureer direct via de browser op flasher.meshcore.co.uk. Klik na flashen op "Console" voor CLI toegang.
flasher.meshcore.co.uk →MeshCore Config Tool
Configureer bestaande repeaters via config.meshcore.dev - verbind via USB en pas instellingen aan in de browser.
config.meshcore.dev →Minimale configuratie na flashen
Na het flashen van MeshCore firmware zijn minimaal deze stappen nodig:
# 1. Frequentie instellen (verplicht voor legaal gebruik)
set freq 869.4
# 2. Herstart om wijzigingen toe te passen
reboot
# 3. Optioneel: geef je repeater een naam
set name MijnRepeater
# 4. Optioneel: stel locatie in voor de kaart
set lat 52.3676
set lon 4.9041Veelgestelde vragen over CLI
Wat is het verschil tussen meshcore-cli en de seriële CLI?
De meshcore-cli (meshcli) is een Python tool waarmee je via BLE, TCP of serieel communiceert met je companion radio. De seriële CLI is ingebouwd in repeaters en room servers en benader je rechtstreeks via USB/terminal. Beide hebben andere commando's en toepassingen.
Hoe verbind ik via Bluetooth?
Op Linux moet je eerst je apparaat pairen via bluetoothctl. Daarna gebruik je meshcli -S om je apparaat te selecteren. De CLI onthoudt je keuze in ~/.config/meshcore.
Kan ik repeaters op afstand configureren?
Ja! Via de Remote Admin functie kun je repeaters en room servers beheren via LoRa. Dit werkt vanuit de meshcore-cli met repeater commando's, of via de mobiele app met Remote Management.
Welke frequentie moet ik gebruiken in Nederland/Europa?
Gebruik frequenties in de 868 MHz band. Gangbare keuzes zijn 869.4 MHz of 869.525 MHz. Gebruik nooit 915 MHz - dat is alleen toegestaan in de VS en niet legaal in Europa.
Hoe reset ik mijn repeater naar fabrieksinstellingen?
Via de seriële CLI kun je erase gebruiken om het bestandssysteem te wissen. Dit verwijdert alle instellingen. Je moet daarna opnieuw de frequentie instellen.
Waar vind ik alle beschikbare commando's?
Voor meshcore-cli: meshcli -h toont alle opties. Voor de repeater/room server CLI: help in de seriële console. De complete referentie staat op de MeshCore GitHub wiki.
Meester de command-line
Met de MeshCore CLI heb je professionele controle over je mesh-netwerk. Ideaal voor repeater beheer, scripting en geavanceerde configuratie.