Brontekst bekijken van MeshCore/Geadvanceerd/OTA

Met '''OTA''' (Over-The-Air) updates kun je MeshCore-firmware bijwerken zonder USB-kabel. Je repeater of room server staat vaak al op hoogte — via je smartphone en een '''Companion''' bereik je hem over LoRa en zet je hem in update-modus.

Deze pagina behandelt:

* '''nRF52''' (RAK4631, Heltec T114, Seeed XIAO, T1000-E, …) — update via '''Bluetooth''' en de '''nRF Device Firmware Update'''-app
* '''ESP32''' (Heltec V3, …) — update via '''Wi-Fi-hotspot''' op het toestel zelf

<div class="mw-message-box mw-message-box-notice">
'''Community-handleiding''' — RRY22 (Lieven) beschreef de RAK4631-procedure stap voor stap op zijn blog — nuttig als aanvullende lezing met screenshots: [https://lieven.kks36.be/2026/01/31/upgrade-rak-meshcore-repeater-over-the-air/ Upgrade RAK MeshCore repeater over-the-air].
</div>

= Wat heb je nodig? =

* Een '''smartphone''' met de MeshCore-app en de '''nRF Device Firmware Update'''-app (alleen voor nRF52)
* Een '''Companion''' die via LoRa bereik heeft op de repeater/room server die je wilt updaten
* De '''ZIP'''-firmware (nRF52) of '''non-merged .bin''' (ESP32) van [https://flasher.meshcore.io flasher.meshcore.io]

Werk je op een plek '''zonder internet'''? Download firmware en apps van tevoren op je telefoon.

= nRF52 — update via Bluetooth =

Van toepassing op o.a. '''RAK4631''', '''Heltec T114''', '''Seeed XIAO nRF52840''', '''T1000-E''' en '''Wio Tracker L1'''. Companion-, repeater- én room-server-firmware kan op deze manier.

== Voorbereiding ==

# Installeer '''nRF Device Firmware Update''' (Nordic Semiconductor) uit de App Store of Play Store. Zoek op <code>nrf dfu</code>. Gebruik die app, '''niet''' nRF Connect for Mobile.
# Download op [https://flasher.meshcore.io flasher.meshcore.io] het '''ZIP'''-bestand voor jouw toestel en firmwaretype (Repeater, Room Server, …). Gebruik '''geen''' UF2 voor OTA.
# Optioneel maar aanbevolen: maak een '''back-up''' van je repeater-instellingen. Een firmware-upgrade behoudt instellingen meestal, maar veilig is veilig.

== Repeater in DFU-modus zetten ==

Ga binnen '''Bluetooth-bereik''' van de repeater (typisch enkele meters).

# Open de '''MeshCore-app''' en verbind met je Companion
# Selecteer de repeater in '''Contacts''' → '''Manage''' (log in met het admin-wachtwoord)
# Ga naar '''Command Line''' en stuur: <code>start ota</code>
# Je ontvangt '''OK'''. Het LED-lampje knippert meestal. Noteer eventueel het '''MAC-adres''' dat in de reactie staat — dat moet overeenkomen met het toestel in de DFU-app

Voor een '''companion node''' zelf updaten via OTA moet die companion-firmware '''v1.15 of nieuwer''' draaien.

== Firmware uploaden ==

# Open '''nRF Device Firmware Update'''
# Ga naar '''Settings''' (rechtsboven). Zet '''Packet receipt notification''' aan en '''Number of packets''' op '''10''' voor RAK4631 (8 werkt ook) of '''8''' voor Heltec T114.
# Terug op het hoofdscherm: kies bij '''File''' het gedownloade '''ZIP'''-bestand, bij '''Device''' je repeater (zelfde MAC als bij <code>start ota</code>), en tik '''Upload''' (of '''Start''').

[[File:MeshCore-ota-settings.jpeg|350px|OTA Settings]]
[[File:MeshCore-ota-flashing.jpeg|350px|OTA Firmware Upgrade]]

De update duurt enkele minuten. Je ziet o.a. ''Bootloader enabled'' → ''DFU initialized'' → ''Uploading firmware'' → ''Completed''. Houd het scherm aan en blijf op dezelfde pagina tot de upload klaar is.

[[File:MeshCore-ota-flashing-complete.jpeg|350px|OTA Voltooid]]

== Verificatie ==

# Open in de MeshCore-app opnieuw '''Repeater Admin''' voor je node
# Controleer de '''firmwareversie''' (bijv. v1.12.0)
# Voer '''Sync Clock''' uit — belangrijk na elke update

[[File:MeshCore-ota-flash-result.jpeg|350px|Repeater Admin – Firmwareversie]]

== Problemen oplossen (nRF52) ==

* Staat je toestel niet in de lijst? Stuur <code>start ota</code> opnieuw, of zet '''Force Scanning''' aan in de DFU-app
* Mislukt de upload bij ''Enabling Bootloader''? Zet Bluetooth op je telefoon uit/aan, of herstart de telefoon. Vergeet het board niet in de Bluetooth-instellingen van je telefoon en koppel opnieuw via de DFU-app
* Blijft het mislukken? Probeer '''Number of packets''' te verlagen (bijv. 5 of 8)
* Zie ook de [https://docs.meshcore.io/faq/?h=ota#71-q-how-to-update-nrf-rak-t114-seeed-xiao-companion-repeater-and-room-server-firmware-over-the-air-using-the-new-simpler-dfu-app officiële FAQ §7.1]

= ESP32 — update via Wi-Fi =

Van toepassing op o.a. '''Heltec V3''' en andere ESP32-toestellen.

# Download op [https://flasher.meshcore.io flasher.meshcore.io] de '''non-merged''' <code>.bin</code> (geen <code>merged</code> in de bestandsnaam), bijv. <code>Heltec_v3_repeater-v1.x.x-xxxxxxx.bin</code>
# Log via de MeshCore-app remote in op de repeater (Companion + admin-wachtwoord)
# '''Command Line''' → <code>start ota</code> → bevestiging '''OK'''
# Het toestel start een Wi-Fi-hotspot '''<code>MeshCore OTA</code>'''
# Verbind je telefoon of laptop met die hotspot
# Open in de browser: [http://192.168.4.1/update http://192.168.4.1/update] en upload het <code>.bin</code>-bestand

Zie [https://docs.meshcore.io/faq/?h=ota#72-q-how-to-update-esp32-based-devices-over-the-air officiële FAQ §7.2].

= OTAFIX-bootloader (nRF52, sterk aanbevolen) =

De standaard nRF-bootloader kan OTA-updates laten mislukken of een toestel moeilijk recoverbaar maken na een foute flash. De '''OTAFIX'''-bootloader (door che aporeps) maakt OTA betrouwbaarder: detecteert de app-firmware ongeldig, dan valt hij terug naar DFU-modus zodat je opnieuw kunt flashen.

<div class="mw-message-box mw-message-box-warning">
'''Eerste keer flashen?''' Heb je het toestel nog '''fysiek bereikbaar''' via USB? Installeer dan '''eerst''' de OTAFIX-bootloader vóór je de repeater op hoogte monteert. Daarna zijn OTA-updates veel betrouwbaarder.
</div>

Ondersteunde boards (o.a.): RAK4631, Heltec T114, Seeed XIAO nRF52840, T1000-E, Wio Tracker L1, RAK WisMesh Tag. Volledige lijst op GitHub: [https://github.com/oltaco/Adafruit''nRF52''Bootloader_OTAFIX Adafruit nRF52 Bootloader OTAFIX].

== Bootloader installeren via USB (RAK4631) ==

# Verbind de RAK4631 via USB met je pc
# Druk '''tweemaal''' op '''RESET''' → er verschijnt een USB-schijf (bijv. <code>RAK4631</code>)
# Download het juiste <code>.uf2</code>-bestand uit de [https://github.com/oltaco/Adafruit''nRF52''Bootloader_OTAFIX/releases OTAFIX-releases op GitHub]
# Sleep het <code>.uf2</code>-bestand naar de schijf; het board herstart
# Knipperen groen/blauw = OTA via Bluetooth is mogelijk
# Draait het toestel '''companion'''-firmware? Voer daarna een [https://flasher.meshcore.io MeshCore flash erase] uit om het ExtraFS-gedeelte te formatteren

Meer achtergrond: [https://blog.meshcore.io/2026/04/06/otafix-bootloader MeshCore-blog OTAFIX], [https://docs.meshcore.io/faq/?h=ota#73-q-is-there-a-way-to-lower-the-chance-of-a-failed-ota-device-firmware-update-dfu FAQ §7.3].

=== Wio Tracker L1 Pro ===

Na installatie van de OTAFIX-bootloader: houd de knop naast de D-Pad ingedrukt en druk op '''reset''' om OTA te starten — '''<code>start ota</code> is dan niet nodig'''. Volg daarna de DFU-app-stappen hierboven.

= Gerelateerd =

* [[MeshCore/FlashFirmware|Firmware Flashen]] — initiële installatie via USB
* [[MeshCore/ConfigureRepeater|Repeater Configureren]]
* [[MeshCore|MeshCore Introductie]]
* [https://lieven.kks36.be/2026/01/31/upgrade-rak-meshcore-repeater-over-the-air/ Upgrade RAK MeshCore repeater over-the-air] — blogpost RRY22 (RAK4631, met foto's)
* [https://docs.meshcore.io/faq/?h=ota MeshCore FAQ — OTA] — officiële upstream-documentatie
* [https://discord.gg/kvybAgqnhD Radio-Actief Discord]

[[Category:MeshCore]]