Command-line Interface

MeshCore CLI configuratie

Beheer je MeshCore nodes via terminal voor snelle configuratie, scripting en geavanceerde controle.

Wat is de MeshCore CLI?

De MeshCore CLI is een terminaltool waarmee je nodes configureert en diagnostiek uitvoert via BLE, TCP of seriële verbindingen, afhankelijk van je hardware.

Voor repeaters bestaan ook seriële beheeropties waarmee je frequentie, naam en radio-instellingen direct kunt aanpassen.

CLI-beheer is vooral nuttig voor gevorderde gebruikers die meerdere toestellen willen beheren of automatiseren.

Waarom de CLI gebruiken?

Snelle configuratie

Meerdere instellingen aanpassen gaat vaak sneller via terminal dan via schermmenu's.

🤖

Automatisering

Scriptbare workflows maken batchbeheer van meerdere nodes mogelijk.

🔧

Diepere controle

CLI geeft toegang tot geavanceerde parameters die niet altijd in eenvoudige UI's zitten.

📡

Flexibele verbindingen

Je kiest de methode die past bij je setup: lokaal, serieel of netwerkgericht.

🖥️

Remote beheer

Met de juiste opstelling kun je repeaters op afstand beheren en opvolgen.

💬

Interactieve workflows

Interactieve modus helpt bij testen, debuggen en snelle iteratie.

MeshCore CLI installeren

CLI-tools draaien doorgaans op Python- of seriële workflows. Controleer eerst de documentatie van jouw versie en platform.

Stap 1: Controleer je runtime

Controleer of je systeem de vereiste runtime en dependencies heeft.

python3 --version

Gebruik bij voorkeur een schone omgeving voor CLI-tools.

Stap 2: Installeer de tool

Installeer volgens de officiële instructies voor jouw besturingssysteem.

# Via pipx (aanbevolen)
pipx install meshcore-cli
# Of via pip
pip3 install meshcore-cli

Stap 3: Verifieer de installatie

Controleer of help/versiecommando's correct antwoorden.

meshcli -h

Basis CLI-commando's

Deze acties gebruik je het meest tijdens dagelijkse configuratie en controle:

Toestel selecteren (BLE)

Scan en selecteer de juiste node voordat je instellingen aanpast.

meshcli -S

Verbinden via TCP/IP

Gebruik netwerkverbinding wanneer je node hiervoor geconfigureerd is.

meshcli -t 192.168.1.100

Verbinden via serieel

Serieel blijft de meest directe methode voor initiële setup of herstel.

meshcli -s /dev/ttyUSB0

Bericht versturen

Verifieer je verbinding met een eenvoudige testboodschap.

meshcli send "Hallo MeshCore netwerk!"

Contacten bekijken

Inspecteer zichtbare nodes, status en relevante metadata.

meshcli contacts

Interactieve modus

Gebruik interactieve shell voor snelle aanpassingen en troubleshooting.

meshcli

Repeater & Room Server CLI

Voor vaste infrastructuurnodes is seriële CLI vaak de veiligste manier om kerninstellingen te beheren.

Frequentie instellen (verplicht)

Controleer dat je node op de correcte 868 MHz-parameters staat voor legaal gebruik in België/EU.

set freq 869.4
reboot

Naam en locatie

Gebruik herkenbare namen en consistente locatielabels voor beheer op kaart en dashboards.

set name MijnRepeater
set lat 52.3676
set lon 4.9041

Zendvermogen configureren

Stem TX-vermogen af op regelgeving en je lokale dekkingsdoel.

set tx 22

Repeaterinstellingen

Beheer hop-limieten, intervallen en andere parameters volgens je netwerkontwerp.

set flood.max 3
set advert.interval 30
set flood.advert.interval 3

Webgebaseerde configuratie

Naast CLI bestaan er browsertools voor wie liever visueel werkt. CLI blijft nuttig voor precisie en scripting.

MeshCore Flasher

Gebruik webflasher voor firmware en basisstart; schakel nadien over naar CLI voor fijnere tuning.

flasher.meshcore.co.uk →

MeshCore Config Tool

Handig voor snelle parameterwijzigingen via USB zonder volledige terminalworkflow.

config.meshcore.dev →

Minimale configuratie na het flashen

Na firmwareflash stel je minstens frequentie en basisidentificatie in voordat je de node in productie zet:

# 1. Stel correcte frequentie in\nset freq 869.4\n\n# 2. Herstart node\nreboot\n\n# 3. Geef een duidelijke naam\nset name MijnRepeater\n\n# 4. Optioneel: locatie\nset lat 50.8503\nset lon 4.3517

Veelgestelde vragen over CLI

Wat is het verschil tussen meshcore-cli en de seriële CLI?

De externe CLI-tool draait op je computer; seriële CLI draait direct op het toestel. Beide vullen elkaar aan.

Hoe verbind ik via Bluetooth?

Koppel eerst op OS-niveau en gebruik daarna de scan/select-functie van je CLI-tool.

Kan ik repeaters op afstand instellen?

Ja, mits correcte remote beheerinstellingen en een stabiel netwerkpad.

Welke frequentie moet ik gebruiken in België/Europa?

Gebruik instellingen in de 868 MHz-band volgens lokale regelgeving. Vermijd 915 MHz in EU-context.

Hoe reset ik mijn repeater naar de fabrieksinstellingen?

Gebruik de officiële resetprocedure van jouw firmwareversie en maak vooraf back-ups van belangrijke instellingen.

Waar vind ik alle beschikbare commando's?

Gebruik help-commando's in de tool en controleer de officiële documentatie van je firmwareversie.

CLI geeft je maximale controle

Met een goede CLI-workflow beheer je nodes sneller, consistenter en schaalbaarder dan met losse manuele stappen.