Firmware

Wat doet Meshcore firmware?

Meshcore firmware maakt van een radio-device een Meshcore companion, repeater of room server. De firmware zorgt dat het device het Meshcore protocol spreekt. Als je op hetzelfde device Meshtastic firmware zou zetten, dan zou het apparaat het Meshtastic protocol spreken; dat is niet compatible met Meshcore. Wil je van je apparaat een Meshcore companion maken, dan heb je companion firmware nodig; wil je een repeater, dan heb je repeater firmware nodig. Dus de firmware bepaalt wat het device doet.

De Meshcore firmware is open source; de broncode staat op Github. Dat betekent dat iedereen de broncode kan bekijken en eventueel de firmware zelf bouwen. Je zou de broncode ook kunnen kopiëren en aanpassen, en dat hebben sommigen dan ook gedaan. Op deze pagina laten we zien welke versies er zijn en waarin die verschillen.

Firmware is device-specifiek. Je kan bijvoorbeeld geen firmware voor Heltec V4 draaien op een Wio Tracker L1.

Het beste is om een recente firmware-versie te draaien: nieuwe versies komen met bug fixes en nieuwe features die Meshcore beter laten werken.

Welke firmware moet ik kiezen?

Er zijn diverse firmware-varianten. Heel in het kort is dit het advies:

• Wil je een eenvoudige, probleemloze ervaring: kies de originele firmware van meshcore.io.
• Wil je sites zoals MC-Radar helpen om meer inzicht te geven in de Nederlandse Mesh: kies dan DutchMeshCore zodat je device ook een observer wordt.

Zie voor meer opties en details de tabel hieronder.

Hoe installeer ik firmware?

Om je Meshcore device te kunnen gebruiken, zul je Meshcore firmware moeten installeren. Ook als die al geïnstalleerd is, zul je hem soms moeten updaten.

Het flashen (installeren of updaten) van de firmware is gelukkig niet moeilijk. Er zijn web-flashers die het meeste werk voor je doen. Hieronder gaan we uit van de originele firmware en web-flasher https://flasher.meshcore.io/.

Gebruik je Linux? Dan moet je eerst je gebruikersaccount toestemming geven om USB te gebruiken. Dat kan in de meeste gevallen met commando sudo usermod -a -G dialout $USER. Daarna even uitloggen en weer inloggen.

 Opmerking: We gaan er hier vanuit dat je je device via USB kan koppelen. Als je een device wilt updaten waar je moeilijk bij kan (bijvoorbeeld een repeater op het dak), dan kan dat Over The Air (OTA) via bluetooth en een app op je telefoon. Hoe dat moet staat hier beschreven: https://www.mesh-up.nl/voor-gevorderden/nrf52-otafix/. De beschrijving hieronder is voor een device dat je via USB kan koppelen.

Als je je device al gebruikt, is het heel verstandig om een backup te maken van je keys (identiteit) en settings.

1. Companion:
   1. Koppel je companion via bluetooth (of eventueel via USB) aan je Meshcore app.
   2. In de Meshcore app, ga naar ⚙️ (Settings).
   3. Kies Export config.
   4. Select all.
   5. Klik rechtsboven op ✓.
2. Repeater
   1. Koppel je repeater met USB aan je PC of laptop.
   2. Ga met Chrome naar https://config.meshcore.io/.
   3. Klik op Connect en kies je repeater uit de lijst.
   4. In het scherm "Repeater / Room server USB setup", klik op Export.

Dan nu het flashen van de firmware. Sommige stappen kunnen een beetje afwijken, afhankelijk van je device.

1. Koppel je Meshcore device met een USB kabel aan je PC of laptop.
2. Ga in je Chrome browser naar https://flasher.meshcore.io/. Waarom Chrome? Die ondersteunt communicatie over USB. Er zijn ook enkele andere browsers die dat kunnen, maar Chrome werkt zeker.
3. Kies op de flasher-pagina je device.
4. Kies de gewenste rol voor je device: een companion, een repeater of een room server. Voor een companion wil je meestal de bluetooth versie. Wil je dat je device daarnaast ook een observer wordt, kijk dan in de tabel hieronder welke firmware je kunt gebruiken.
5. Pas op! Als je op Erase Flash klikt of Erase device aanvinkt, worden de keys (identiteit) en settings van je device gewist! Dat is (meestal) niet wat je wilt.
6. Klik op Enter DFU mode (DFU = Device Firmware Upgrade). De browser wil dan verbinden met een seriële poort (met een USB apparaat dus). Is er geen knop met Enter DFU mode? Dan moet je even opzoeken hoe je je device in DFU mode zet. Soms doe je dat met knopjes op je device zelf.
7. Kies je device uit de lijst. Soms is de naam moeilijk te herkennen; zoek in dat geval naar usbmodem. Staat je device er echt niet bij, dan is misschien je USB kabel niet geschikt voor data. Probeer dan een andere kabel.
8. Als het goed is staat er nu ✓ DFU mode active.
9. Klik op ⚡️ Flash!
10. De firmware wordt nu geïnstalleerd.

Je device configureren

Wordt je device een companion? Dan kun je hem nu koppelen via bluetooth aan je Meshcore app.

Wordt je device een repeater? Dan kun je hem (via USB) instellen via https://config.meshcore.io/.

Kijk op https://settings.woodwar.com/nl/ voor de juiste instellingen voor Nederland. De provincie Limburg heeft zijn eigen instellingen.

Hoe installeer ik andere firmware?

Sommige firmware-aanbieders hebben hun eigen web-flasher. Maar je kunt ook altijd firmware downloaden, en dan met https://flasher.meshcore.io/ op je device zetten. Je kiest dan geen device uit de lijst, maar Custom firmware, helemaal onderaan. De stappen zijn verder hetzelfde als hierboven.

Firmware overzicht

Firmware	Omschrijving	Observer	Eigenschappen
meshcore.io	De originele firmware	Nee	De echte, originele software, gebouwd door de bedenkers van Meshcore. Stabiel. De standaard. Werkt op (bijna) elk MeshCore device. Kan soms achterlopen. Nieuwe features worden traag toegepast.
Zelf bouwen	Zelf firmware compileren (bouwen) van source	Ja (packet logging enablen)	Door zelf te compileren kun je nieuwe features eerder gebruiken (door de development branch te kiezen, of zelf patches toe te voegen). Niet voor beginners.
DutchMeshCore	Nederlandse fork	Ja (MQTT versie)	Repeater en room firmware, geen companion firmware. Niet alle devices worden ondersteund. De DutchMeshCore MQTT versie logt standaard naar DutchMeshCore MQTT servers, zodat analyse-websites als MC-Radar een beeld van de mesh kunnen geven. Kan 1-byte hashes blokkeren; dit kan helpen om spam te beperken.
Weebl	Webdienst om firmware te bouwen	Ja (packet logging aanvinken)	Selecteer je device, kies de rol (repeater/companion, bluetooth/USB) en deze website bouwt firmware voor je. Gebruikt broncode van de originele firmware, development branch (dus met nieuwste features)