MeshCore FUOTAEinfach erklärtExplained simply
Ausführliche DokuFull documentation
Zweiter Alpha-Test im Großraum Hamburg

Ein Repeater bekommt das Update von Hand. Alle anderen holen es per Funk.

Repeater sind Funkstationen im MeshCore-Netz. Viele stehen auf Dächern und Masten. Für ein Update musste bisher jemand hinfahren und ein Kabel anstecken. FUOTA heißt Firmware Update Over The Air: Die Repeater geben neue Firmware per Funk weiter. Firmware ist das Programm im Gerät. Alpha heißt: frühe Testfassung. FUOTA ist ein Test und noch nicht Teil von MeshCore.

11 SekundenSo viel darf FUOTA für Update-Daten höchstens pro Stunde und Repeater senden. Gerechnet aus der Grenze von 0,3 %, die im Code fest eingebaut ist.
9 bis 13 StundenSo lange brauchte ein Repeater in den Testläufen, bis er das Update komplett hatte (gemessen). Dazu kommen ab Werk 7 Tage Wartezeit vor dem Einspielen.
3 ProbestartsBestätigt sich die neue Firmware nach 3 Probestarts nicht, läuft wieder die alte (gemessen).

Fünf Wörter, die du brauchst

Mehr Fachsprache gibt es nicht. Alles andere wird dort erklärt, wo es zum ersten Mal vorkommt.

Repeater

Eine Funkstation, oft auf einem Dach oder Mast. Sie gibt Nachrichten im Mesh weiter.

Mesh

Das Funknetz aus allen Repeatern, die sich hören.

Hop

Ein Sprung von einem Repeater zum nächsten. Zwei Hops sind zwei Sprünge.

Fluten

Jeder Repeater gibt die Nachricht an alle weiter, die er hört. So verteilt sie sich wie Wasser.

Seed

Englisch für Saatkorn. Der Repeater, der das neue Release von Hand bekommt. Ein Release ist eine fertige Firmware-Version.

So funktioniert es

Ein Repeater bekommt das neue Release von Hand. Von dort wandert das Update von Repeater zu Repeater.

Seed1. Hop2. Hopholt geradegibt schon weiter
hat die neue Firmware holt gerade hat noch die alte

Schema, nicht das echte Netz.

  1. 1
    Der Seed bekommt das ReleaseJemand spielt das neue Release von Hand auf einen Repeater, per Kabel oder per Bluetooth. Dieser Repeater heißt Seed. Er bietet das Update seinen Nachbarn an.
  2. 2
    Nachbarn holen nur den UnterschiedÜber Funk geht nur, was sich zwischen alter und neuer Version geändert hat. Bei einem Beispiel waren das 10.076 Byte, rund 10 KB (gemessen). Ein Nachbar holt Datenpaket für Datenpaket. Ein Datenpaket ist ein kleines Funkpaket. Hat er eine ganze Seite (4 KB) zusammen, prüft er sie.
  3. 3
    Jeder gibt es weiterEine geprüfte Seite darf ein Repeater sofort weitergeben, auch wenn ihm noch andere fehlen. So wandert das Update Hop für Hop durchs Mesh.
  4. 4
    Jeder installiert selbstIst alles da, wartet der Repeater ab Werk 7 Tage. In dieser Zeit kann das Update noch zurückgerufen werden. Danach baut er die neue Firmware und startet sie probeweise. Das heißt Probestart. Bestätigt sie sich, bleibt sie. Sonst läuft wieder die alte.

Auch normale Repeater helfen mit

Nicht jeder Repeater im Mesh hat FUOTA. Das Update kann trotzdem durch: Normale Repeater, also Repeater ohne FUOTA, geben Nachrichten und Pakete mit festem Weg weiter.

AnbieterNormaler RepeaterEmpfängerhat das Updateohne FUOTAwill das Update1Angebot an alle in Hörweite2Anfrage geht den Weg zurück3Datenpakete gehen den Weg entlang
  1. 1
    Das Angebot wird geflutetDer Anbieter ruft in die Runde: „Ich habe ein Update.“ Jeder Repeater, der es hört, gibt es weiter. Das tut der Anbieter in der ersten Woche höchstens einmal am Tag, danach einmal in der Woche (im Code geprüft).
  2. 2
    Die Anfrage geht den Weg zurückDas Angebot trägt den Weg, den es genommen hat. Darauf fragt der Empfänger zurück: „Schick mir Datenpakete.“ Nicht jeder Weg lässt sich in beide Richtungen nutzen. Bleibt die Anfrage zweimal ohne Antwort, schickt der Empfänger sie einmal als Flut. So lernt der Anbieter einen Weg, der von dort zu ihm führt, und meldet ihn zurück. Danach fragt der Empfänger entlang dieses Weges.
  3. 3
    Die Datenpakete gehen denselben WegNormale Repeater reichen Pakete mit festem Weg weiter wie jedes andere Paket. Dafür brauchen sie kein FUOTA.

Was das kostet: Jeder Repeater auf dem Weg sendet jedes Datenpaket noch einmal. Der Anbieter rechnet das in seine Sendezeit ein (gerechnet: bei k Repeatern dazwischen k + 1 Sendungen je Datenpaket).
Aus dem ersten Test: Das Angebot kam über das Mesh bis zu 6 Hops weit. Datenpakete kamen über 2 normale Repeater hintereinander beim Empfänger an. Viele Anfragen gingen aber auf dem Rückweg verloren. Ein ganzes Update kam auf diesem Weg noch nicht an. Deshalb gibt es die Flut-Anfrage. Ob sie in den Paketen des zweiten Tests steckt, steht beim Release.

Was das Mesh davon merkt

Für Update-Daten darf jeder Repeater höchstens 0,3 % der Zeit senden. Das sind gerechnet rund 11 Sekunden je Stunde. Die Grenze ist im Code fest eingebaut (im Code geprüft).

015304560 min
Daten gehen nur an den, der fragt

Update-Daten werden nie an alle Repeater geschickt. Ein Repeater fragt, und die Daten kommen auf einem festen Weg zu ihm: direkt vom Nachbarn oder über normale Repeater dazwischen.

Normale Nachrichten zuerst

Wartet ein normales Mesh-Paket, geht es vor. FUOTA sendet erst danach.

Wenige Nachrichten gehen an viele

Das Angebot, der Rückruf und der Widerruf eines Schlüssels werden geflutet, dazu selten eine Anfrage, die zweimal ohne Antwort blieb. Das Angebot geht in der ersten Woche höchstens einmal am Tag raus, danach einmal in der Woche (im Code geprüft).

Wie lange dauert das?

Das Update darf langsam sein. FUOTA sendet so wenig, dass normale Nachrichten Vorrang behalten.

  1. 1 Du

    Aufspielen und einrichten

    einmal

    Aufspielen heißt: die Firmware auf das Gerät bringen, per USB-Kabel oder per Bluetooth. Danach holt sich der Repeater das Update selbst.

  2. 2 Warten

    Angebot hören

    bis zu rund 3 Tage

    Hat ein Nachbar das Update, bietet er es an. Wer später dazukommt, hört spätestens nach rund 3 Tagen ein Angebot (im Code geprüft).

  3. 3 Funk

    Update holen

    9 bis 13 Stunden

    Gemessen in 2 Testläufen. Ein kleines Update braucht bis zum ersten Nachbarn gerechnet rund 7 Stunden.

  4. 4 Einspielen

    Neue Firmware einspielen

    rund 1 Minute

    Das dauert rund 1 Minute (gemessen mit einer Testfirmware). Ab Werk wartet der Repeater davor 7 Tage. Mit fuota auto now passiert es sofort.

  5. 5 Prüfen

    Bestätigen

    Frist bis 6 Stunden

    Die neue Firmware muss 60 Sekunden gesund laufen, ein Funkpaket hören und eins senden. Je nach bisheriger Laufzeit hat sie dafür 15 Minuten bis 6 Stunden (im Code geprüft).

Zusammen: Holen dauert 9 bis 13 Stunden (gemessen). Dazu kommen ab Werk 7 Tage Wartezeit (im Code festgelegt) und die Bestätigung.

Weiter entfernte Repeater brauchen länger

Geprüfte Seiten wandern sofort weiter. Der nächste Repeater wartet also nicht auf das ganze Update. Gerechnet kommen je weiterem Repeater in der Kette rund 2,5 Stunden dazu, wenn alle FUOTA haben.

1. Hop, direkter Nachbar: 9 bis 13 Stunden (gemessen)
2. Hop: bis etwa 15 Stunden (gerechnet)
3. Hop: bis etwa 18 Stunden (gerechnet)
05101520 Stunden

so lange brauchten alle Testläufe mindestens Spanne der Testläufe gerechneter Zuschlag

Im echten Mesh kann es länger dauern, etwa wenn ein Repeater erst spät ein Angebot hört oder normale Repeater dazwischen jedes Datenpaket noch einmal senden.

Was deinen Repeater schützt

Diese Vorkehrungen gibt es, und so weit sind sie getestet.

Signierte Firmware

Jedes Release trägt eine digitale Unterschrift. Der Schlüssel dafür liegt offline, getrennt vom Bau der Firmware. Im Code ist festgelegt: Ein Repeater installiert nur Firmware mit passender Unterschrift. Ein Test mit gefälschter Firmware steht noch aus.

Jede Seite wird geprüft

Jede 4-KB-Seite wird mit der unterschriebenen Liste verglichen, bevor ein Repeater sie weitergibt. Ist sie beschädigt, gibt er sie nicht weiter und fragt sie neu an.

Die alte Firmware bleibt als Reserve

Die neue Firmware entsteht neben der alten. Bestätigt sie sich nach 3 Probestarts nicht, läuft wieder die alte (gemessen). Bestätigen heißt: 60 Sekunden gesund laufen, ein Funkpaket hören und eins senden.

Was getestet wurde

Der Repeater wurde im Test 82 Mal mitten im Tausch neu gestartet (Watchdog-Reset, gemessen). Danach waren beide Speicherbereiche jedes Mal in Ordnung. Das Kabel mitten im Tausch wirklich zu ziehen, ist nur teilweise getestet. Am Rechner liefen bis 27. Oktober 2026 2,8 Milliarden zufällig veränderte Eingaben ohne Absturz (gemessen).

VorherSpeicher Aalt, läuftSpeicher Bneu, geprüftTauschNach dem TauschSpeicher Aneu, ProbestartSpeicher Balt, ReserveBestätigtläuft und funktneue bleibtZurück3 Versuche ohneBestätigung:Tausch zurück
  1. 1
    VorherSpeicher A läuft mit der alten Firmware. Speicher B hält die neue, geprüfte.
  2. 2
    Tausch und ProbestartDie neue Firmware startet probeweise aus A. Die alte bleibt als Reserve in B.
  3. 3
    Bestätigt oder zurückBestätigt sie sich, bleibt sie. Nach 3 Probestarts ohne Bestätigung wird zurückgetauscht.

Was die Firmware sonst noch kann

Neben dem Update steckt noch mehr in der FUOTA-Firmware. Welche dieser Funktionen in den Paketen des zweiten Tests sind, steht beim Release.

1 Ansage2 Kurz nebenan3 ZurückMesh-KanalAnsageFreie Spur danebenfreifreiwechselnzurückNormale Repeater bleiben auf dem Mesh-Kanal

Nebenslot: schnellere Updates

Das Mesh funkt auf einer Frequenz, wie auf einer Straße. Daneben liegen freie Spuren im selben Funkband. Für einen Schwung Daten sagt der Anbieter kurz an. Dann wechseln er und die Nachbarn, denen Daten fehlen, auf eine freie Spur, den Nebenslot. Danach sind alle wieder auf dem Mesh-Kanal. Normale Repeater wechseln nie.

Das Ziel (gerechnet): Ein mittleres Release braucht in Hamburg 1,6 bis 2,7 Stunden statt 27 Stunden. Mehr dazu

Paketfilter: weniger Hops

Ein geflutetes Paket darf nur wenige Hops machen. Normale MeshCore-Repeater erlauben bis zu 64. Die FUOTA-Firmware erlaubt ab Werk 10, für Adverts 2 und für Pakete ohne Region 1. Ein Advert ist der Rundruf, mit dem ein Repeater sagt: Ich bin hier. Das soll Sendezeit sparen.

Das sind nur Voreinstellungen. Jeder Repeater-Admin kann sie frei ändern, von 0 bis 64 Hops, zum Beispiel mit set flood.max 64.

Gilt nur für neu installierte Repeater.

Kanalfilter: Vielsender bremsen

Ein Kanal ist eine Gruppe, in der Nachrichten laufen. Der Repeater kann einzelne Kanäle auf eine Liste setzen und deren Pakete nicht mehr weitergeben. Er entschlüsselt dabei nichts, er erkennt den Kanal an einer Kennung im Paket.

Noch in Entwicklung. Im ersten Test war er nicht dabei.

Stromsparen

Der Befehl powersaving on lässt den Repeater schlafen, wenn nichts zu senden ist. Er kommt aus dem normalen MeshCore und ist ab Werk aus. FUOTA ändert daran nichts. Ein laufendes Update hält den Repeater nicht wach.

Wie viel Strom das spart, ist nicht gemessen.

Dein Test in 6 Schritten

Du brauchst einen Repeater mit nRF52-Chip und Zeit. Zum ersten Aufspielen hast du die Wahl: USB-Kabel oder Bluetooth.

So läuft der zweite Alpha-Test: Du installierst nur das Empfänger-Paket. Das Seed-Paket, mit dem das Update startet, bekommen 1 bis 2 ausgewählte Personen. So lässt sich der Test steuern und auswerten. Installiere das Seed-Paket nicht selbst.
  1. Repeater aussuchen

    Nimm einen Repeater, an den du gut rankommst und den du entbehren kannst. Er sollte andere Repeater hören. Welche Geräte (Boards) gehen, steht in der Tabelle auf der Alpha-Seite.

  2. Empfänger-Paket aufspielen noch nicht fertig

    Die Pakete für den zweiten Test sind noch nicht gebaut. Ein Datum gibt es noch nicht. Hier steht der Link zum Release, sobald sie fertig sind. Dann hast du die Wahl:

    Per USB-Kabel

    Lade die Datei mit deinem Board im Namen. Vergleiche ihre Prüfsumme mit SHA256SUMS aus dem Release. Die Prüfsumme zeigt, dass die Datei beim Laden nicht beschädigt wurde. Schließe das Board per USB an, drück zweimal Reset und zieh die Datei auf das Laufwerk, das dann erscheint.

    Kommst du an das Kabel, nimm diesen Weg.

    Per Bluetooth (OTA)

    OTA heißt: ohne Kabel, per Funk. Du nimmst die ZIP-Datei statt der UF2-Datei. Sie bringt dieselbe Firmware auf einen Repeater, der schon eingerichtet läuft. Mit dem Befehl start ota schaltet der Repeater auf Bluetooth-Update. Bis das Update fertig ist, arbeitet er nicht als Repeater.

    Bei Tests dauerte die Übertragung 135 bis 281 Sekunden. Hat dein Board den Bootloader OTAFIX 1.x, nimm USB. Ob die ZIP-Dateien im Paket liegen, steht beim Release. Mehr dazu

  3. Einrichten

    Per Bluetooth aufgespielt? Dann läuft dein Repeater schon eingerichtet. Funkwerte und Region blieben nach dem Update gleich (gemessen). Du änderst nur noch den Namen: set name FUOTA <Spitzname> <Release>. Schick den Befehl so an den Repeater, wie du es sonst auch tust. Die anderen Befehle in diesem Schritt brauchst du dann nicht.

    Hat dein Repeater noch keine Einstellungen (zum Beispiel direkt nach dem Aufspielen per USB), richte ihn so ein. Öffne die USB-Konsole. Das ist ein Textfenster, in dem du dem Repeater Befehle schickst. Wie du sie öffnest, steht auf der Alpha-Seite. Tippe diese Befehle. Ersetze die Teile in spitzen Klammern.

    password <neues Passwort> set name FUOTA <Spitzname> <Release> region default hansemesh set advert.interval 240 set flood.advert.interval 0 set lat <Breite> set lon <Länge>
    • Passwort: Dieses Passwort legst du neu fest. Höchstens 15 Zeichen. password und ein leeres Passwort gehen nicht.
    • Name: FUOTA, dein Spitzname und die Release-Kennung, zum Beispiel FUOTA verdi 1.17b2. So sieht man im Analyzer (einer Webseite, die das Mesh zeigt), wessen Repeater das ist und welche Version er hat. Die Release-Kennung nennen wir mit den Paketen, die zeitnah folgen. Höchstens 31 Zeichen, nicht erlaubt sind [ ] \ : , ? *. Nach einem Update ändert sich die Kennung im Namen nicht von selbst.
    • Advert: Alle 4 Stunden ruft dein Repeater „Ich bin hier“, mit Name und Standort, nur an seine direkten Nachbarn (zero-hop). Der Rundruf an alle (geflutet) ist aus.
    • Standort: Ein grober Standort reicht.
    • Funkwerte: Nimm dieselben wie bei deinen anderen Repeatern: set radio <MHz>,<Bandbreite>,<SF>,<CR>, danach neu starten.
    • Region: der Name des Gebiets, in dem dein Repeater Nachrichten weitergibt. Das Beispiel hansemesh gilt für HanseMesh. Nimm den Namen deines Netzes. Ohne Region meldet dein Repeater seinen Stand nicht, und der Analyzer zeigt ihn nicht in der Ausbreitung des Updates.
  4. Sofort einspielen lassen

    Ab Werk wartet ein Repeater 7 Tage, bevor er ein fertiges Update einspielt. Das kürzt du für den Test ab:

    fuota auto now

    Danach startet der Repeater von selbst neu und ist kurz nicht erreichbar.

  5. Zuschauen

    Mehr musst du nicht tun. Den Stand zeigt fuota info, in der USB-Konsole oder per Fernzugriff übers Mesh, wenn du als Admin angemeldet bist. fuota status zeigt per USB alle Einzelheiten, übers Mesh nur dieselbe Kurzantwort wie fuota info. Von außen siehst du das Update im Analyzer auf der Seite FUOTA-Kampagnen, im Tab Aktivität. Eine Kampagne ist ein Update, das gerade durchs Mesh wandert.

  6. Melden, was passiert ist

    Am liebsten als GitHub-Issue mit der Vorlage „Alpha-Bericht“. Dafür brauchst du ein GitHub-Konto. Telegram und Discord gehen auch. Wer schon auf dem Server ist, findet die Alpha-Meldungen direkt in diesem Kanal. Kopiere Ausgaben als Text, nicht als Screenshot.

    • Board und Version vorher und nachher (ver, fuota info)
    • wann das Update fertig war und wann die neue Firmware bestätigt war
    • alles Auffällige: Neustarts ohne dein Zutun, Rückfall auf die alte Version, Meldungen mit ERR

Was schiefgehen kann

  • Es ist ein Alpha-Test. Fällt etwas aus, flasht du den Repeater per USB-Kabel neu. Darum nimm einen Repeater, an den du gut rankommst.
  • Dein Repeater ist kurz weg. Beim Einspielen startet er ohne dein Zutun neu und ist kurz nicht erreichbar. Fällt er zurück, versucht er es frühestens nach 1 Tag erneut.
  • Boards mit dem Bootloader OTAFIX 1.x: Nimm USB statt Bluetooth. Halte das USB-Kabel bereit.
  • Ein Display bleibt dunkel. Die Alpha-Pakete haben keinen Display-Treiber, zum Beispiel am Heltec T114. Das ist so gewollt.
  • Ohne Funkkontakt keine Bestätigung. Hört dein Repeater nach dem Update niemanden, kann er die neue Firmware nicht bestätigen. Nach 3 Probestarts läuft wieder die alte. Stell ihn dahin, wo er andere Repeater hört.
  • Zurück zu MeshCore: Gib in der USB-Konsole fuota uf2 ein. Der Repeater startet neu und erscheint am Rechner als USB-Laufwerk. Zieh die normale MeshCore-Datei (UF2) für dein Board darauf. Antwortet der Repeater nicht mehr, drück zweimal kurz Reset, dann erscheint dasselbe Laufwerk. Ohne USB geht es per Bluetooth: Der Befehl start ota startet den Repeater in den Bluetooth-Update-Modus (auch per Fernzugriff als Admin), dann spielst du das normale MeshCore-Paket ein.

Stand 15. November 2026. Die Zahlen stammen aus der ausführlichen Doku (Stand 13. November 2026). Im Text steht bei jeder Zahl, ob sie gemessen, gerechnet oder im Code geprüft ist.

FUOTA ist ein Versuchsaufbau auf Basis von MeshCore 1.18.0. Nichts davon ist bei MeshCore eingereicht, eine allgemeine Freigabe gibt es nicht.

Text und Abbildungen: CC BY 4.0 (Namensnennung: „MeshCore FUOTA, github.com/marcelverdult/meshcore_fuota“). Ausgenommen ist das Logo.

Second alpha test in the Hamburg area

One repeater gets the update by hand. All the others fetch it over the air.

Repeaters are radio stations in the MeshCore network. Many stand on roofs and masts. Until now, an update meant someone had to go there and plug in a cable. FUOTA stands for Firmware Update Over The Air. Repeaters pass new firmware to each other by radio. Firmware is the program inside the device. Alpha means an early test version. FUOTA is a test and not yet part of MeshCore.

11 secondsThat is the most FUOTA may transmit for update data per hour and repeater. Calculated from the limit of 0.3 %, which is built into the code.
9 to 13 hoursThat is how long a repeater took in the test runs to receive the whole update (measured). On top of that, the factory setting waits 7 days before installing.
3 test bootsIf the new firmware does not confirm itself after 3 test boots, the old one runs again (measured).

Five words you need

That is all the jargon. Everything else is explained where it first appears.

Repeater

A radio station, often on a roof or mast. It passes messages on in the mesh.

Mesh

The radio network of all repeaters that can hear each other.

Hop

One jump from one repeater to the next. Two hops are two jumps.

Flooding

Every repeater passes the message on to everyone it hears. It spreads like water.

Seed

The repeater that gets the new release by hand. A release is a finished firmware version.

How it works

One repeater gets the new release by hand. From there the update travels from repeater to repeater.

Seed1st hop2nd hopfetchingalready passes on
has the new firmware is fetching still has the old one

A diagram, not the real network.

  1. 1
    The seed gets the releaseSomeone puts the new release onto a repeater by hand. That works by cable or over Bluetooth. This repeater is called the seed. It offers the update to its neighbors.
  2. 2
    Neighbors fetch only the differenceOnly what changed between both versions goes over the air. In one example that was 10,076 bytes, about 10 KB (measured). A neighbor fetches it data packet by data packet. A data packet is a small radio packet. Once it has a whole page (4 KB), it checks it.
  3. 3
    Everyone passes it onA repeater may pass on a checked page right away. It may do this while other pages are still missing. This way the update travels hop by hop through the mesh.
  4. 4
    Everyone installs on their ownOnce everything has arrived, the repeater waits 7 days by default. In that time the update can still be recalled. Then it builds the new firmware and starts it on trial. That is called a test boot. If the firmware confirms itself, it stays. Otherwise the old one runs again.

Normal repeaters help too

Not every repeater in the mesh has FUOTA. The update can still get through. Normal repeaters, those without FUOTA, pass on messages and packets with a fixed path.

ProviderNormal repeaterReceiverhas the updatewithout FUOTAwants the update1Offer to everyone in range2Request goes back along the path3Data packets travel along the path
  1. 1
    The offer is floodedThe provider calls out “I have an update”. Every repeater that hears it passes it on. In the first week the provider does this at most once a day. After that it does so once a week. Both are checked in the code.
  2. 2
    The request goes back along the pathThe offer carries the path it took. The receiver asks back along it: “Send me data packets”. Not every path works in both directions. If the request gets no answer twice, the receiver sends it once as a flood. That way the provider learns a path that leads from there to it. It reports this path back. After that the receiver asks along this path.
  3. 3
    The data packets take the same pathNormal repeaters pass on packets with a fixed path. They treat these like any other packet and do not need FUOTA for that.

What it costs: Every repeater on the path transmits every data packet once more. The provider counts that in its transmit time. With k repeaters in between, a data packet takes k + 1 transmissions (calculated).
From the first test: The offer travelled up to 6 hops through the mesh. Data packets reached a receiver over 2 normal repeaters in a row. Many requests were lost on the way back, though. No complete update has arrived this way yet. That is why the flooded request exists. The release states whether it is in the second test packages.

What the mesh notices

For update data, each repeater may transmit at most 0.3 % of the time. That is about 11 seconds per hour (calculated). The limit is built into the code (checked in the code).

015304560 min
Data goes only to the one who asks

Update data is never sent to all repeaters. A repeater asks, and the data reaches it along a fixed path. The data comes directly from the neighbor or through normal repeaters in between.

Normal messages first

If a normal mesh packet is waiting, it goes first. FUOTA transmits afterwards.

A few messages go to many

The offer, the recall and the revocation of a key are flooded. Rarely, a request that went unanswered twice is flooded too. In the first week the offer goes out at most once a day. After that it goes out once a week. Both are checked in the code.

How long does it take?

The update is allowed to be slow. FUOTA transmits so little that normal messages keep priority.

  1. 1 You

    Install and set up

    once

    Installing means putting the firmware onto the device, by USB cable or over Bluetooth. After that the repeater fetches the update by itself.

  2. 2 Waiting

    Hear an offer

    up to about 3 days

    A neighbor that has the update offers it. Anyone who joins later hears an offer within about 3 days (checked in the code).

  3. 3 Radio

    Fetch the update

    9 to 13 hours

    Measured in 2 test runs. A small update takes about 7 hours to the first neighbor (calculated).

  4. 4 Install

    Apply the new firmware

    about 1 minute

    This takes about 1 minute (measured with a test firmware). By default the repeater waits 7 days before that. With fuota auto now it happens right away.

  5. 5 Check

    Confirm

    deadline up to 6 hours

    The new firmware has to run healthy for 60 seconds. It also has to hear one radio packet and send one. For this it has 15 minutes to 6 hours (checked in the code). The time depends on how long the repeater ran before.

In total: fetching takes 9 to 13 hours (measured). On top come the default 7-day wait (set in the code) and the confirmation.

Repeaters further away take longer

Checked pages travel on right away. The next repeater therefore does not wait for the whole update. Each further repeater in the chain adds about 2.5 hours (calculated). This holds if all of them run FUOTA.

1st hop, direct neighbor: 9 to 13 hours (measured)
2nd hop: up to about 15 hours (calculated)
3rd hop: up to about 18 hours (calculated)
05101520 hours

every test run took at least this long range of test runs calculated extra time

In the real mesh it can take longer. One example is when a repeater hears an offer late. Another is when normal repeaters in between send every data packet once more.

What protects your repeater

These safeguards exist, and this is how far they are tested.

Signed firmware

Every release carries a digital signature. The key for it is kept offline, separate from building the firmware. The code says: a repeater installs only firmware with the matching signature. A test with forged firmware is still to come.

Every page is checked

Every 4 KB page is compared with the signed list before it goes on. A damaged page is not passed on. The repeater asks for it again.

The old firmware stays as a reserve

The new firmware is built next to the old one. After 3 test boots without confirmation, the old one runs again (measured). Confirming means: run healthy for 60 seconds, hear one radio packet and send one.

What was tested

In the test the repeater was restarted 82 times during the swap (watchdog reset, measured). Both memory areas were intact every time. Really pulling the cable in the middle of the swap is only partly tested. On a computer, 2.8 billion randomly altered inputs ran without a crash (measured). The count goes up to 27 October 2026.

BeforeMemory Aold, runningMemory Bnew, checkedswapAfter the swapMemory Anew, trial startMemory Bold, reserveConfirmedruns and transmitsnew one staysBack3 attempts withoutconfirmation:swap back
  1. 1
    BeforeMemory A runs the old firmware. Memory B holds the new, checked one.
  2. 2
    Swap and test bootThe new firmware starts on trial from A. The old one stays in B as a reserve.
  3. 3
    Confirmed or backIf it confirms itself, it stays. After 3 test boots without confirmation, the repeater swaps back.

What else the firmware can do

The FUOTA firmware holds more than the update. The release states which of these features are in the second test packages.

1 Announce2 Briefly aside3 BackMesh channelAnnounceFree lane next to itfreefreeswitchbackNormal repeaters stay on the mesh channel

Side slot: faster updates

The mesh transmits on one frequency, like on a road. Next to it lie free lanes in the same radio band. For a burst of data the provider announces it briefly. Then it and the neighbors that lack data switch to a free lane. That is the side slot. Afterwards everyone is back on the mesh channel. Normal repeaters never switch.

The goal (calculated): a medium-sized release takes 1.6 to 2.7 hours in Hamburg. Without the side slot it takes 27 hours (calculated). More

Packet filter: fewer hops

A flooded packet may make only a few hops. Normal MeshCore repeaters allow up to 64. The FUOTA firmware allows 10 by default. The limit is 2 for adverts and 1 for packets without a region. An advert is the broadcast with which a repeater says: I am here. That is meant to save airtime.

These are only presets. Every repeater admin can change them freely, from 0 to 64 hops. An example is set flood.max 64.

Applies only to newly installed repeaters.

Channel filter: slow down chatterboxes

A channel is a group in which messages travel. The repeater can put single channels on a list and stop passing on their packets. It decrypts nothing, it recognizes the channel by a tag in the packet.

Still in development. It was not part of the first test.

Power saving

The command powersaving on lets the repeater sleep when there is nothing to send. It comes from regular MeshCore and is off by default. FUOTA does not change it. A running update does not keep the repeater awake.

How much power this saves is not measured.

Your test in 6 steps

You need a repeater with an nRF52 chip and time. For the first install you can choose: USB cable or Bluetooth.

How the second alpha test runs: You install only the receiver package. The seed package, which starts the update, goes to 1 or 2 selected people. That way the test can be steered and evaluated. Do not install the seed package yourself.
  1. Pick a repeater

    Take a repeater you can reach easily and can spare. It should hear other repeaters. Which devices (boards) work is listed in the table on the alpha page.

  2. Install the receiver package not ready yet

    The packages for the second test are not built yet. There is no date yet. The link to the release will appear here once they are ready. Then you can choose:

    By USB cable

    Download the file with your board in its name. Compare its checksum with SHA256SUMS from the release. The checksum shows that the file was not damaged while downloading. Connect the board by USB and press reset twice. Drag the file onto the drive that appears.

    If you can reach the cable, use this one.

    Over Bluetooth (OTA)

    OTA means: without a cable, by radio. You use the ZIP file instead of the UF2 file. It carries the same firmware onto a repeater that is already set up and running. With the command start ota the repeater switches to Bluetooth update. Until the update is done, it does not work as a repeater.

    In tests the transfer took 135 to 281 seconds. If your board has the OTAFIX 1.x bootloader, use USB. Whether the ZIP files are in the package is stated with the release. More

  3. Set it up

    Installed over Bluetooth? Then your repeater is already set up and running. Radio settings and region stayed the same after the update (measured). You only change the name: set name FUOTA <nickname> <release>. Send the command to the repeater the way you usually do. You do not need the other commands in this step.

    If your repeater has no settings yet, set it up like this. This is the case right after installing by USB, for example. Open the USB console. That is a text window in which you send commands to the repeater. How to open it is explained on the alpha page. Type these commands. Replace the parts in angle brackets.

    password <new password> set name FUOTA <nickname> <release> region default hansemesh set advert.interval 240 set flood.advert.interval 0 set lat <latitude> set lon <longitude>
    • Password: you choose a new password here. At most 15 characters. password and an empty password do not work.
    • Name: FUOTA, your nickname and the release tag, for example FUOTA verdi 1.17b2. The analyzer is a web page that shows the mesh. That way it shows whose repeater it is and which version it runs. We will name the release tag with the packages that follow soon. At most 31 characters; [ ] \ : , ? * are not allowed. After an update the tag in the name does not change by itself.
    • Advert: every 4 hours your repeater calls “I am here”, with name and location. This call goes only to its direct neighbors (zero-hop). The call to everyone (flooded) is off.
    • Location: a rough location is enough.
    • Radio settings: use the same as on your other repeaters: set radio <MHz>,<bandwidth>,<SF>,<CR>, then restart.
    • Region: the name of the area in which your repeater passes on messages. The example hansemesh is for HanseMesh. Use the name of your own network. Without a region your repeater does not report its state. So the analyzer does not show it in the spread of the update.
  4. Install right away

    By default a repeater waits 7 days before it installs a finished update. You shorten that for the test:

    fuota auto now

    After that the repeater restarts on its own and is briefly out of reach.

  5. Watch

    That is all you need to do. fuota info shows the state in the USB console. Over the mesh it works by remote access when you are logged in as admin. fuota status shows all details over USB. Over the mesh it gives only the same short answer as fuota info. From the outside you can see the update in the analyzer. Look in the Activity tab on the FUOTA campaigns page. A campaign is an update that is currently travelling through the mesh.

  6. Report what happened

    Preferably as a GitHub issue with the template “Alpha-Bericht” (a German template name). You need a GitHub account for that. Telegram and Discord work too. If you are already on the server, you find the alpha reports in this channel. Copy output as text, not as screenshots.

    • board and version before and after (ver, fuota info)
    • when the update was complete and when the new firmware was confirmed
    • anything unusual: restarts you did not trigger, fallback to the old version, messages with ERR

What can go wrong

  • It is an alpha test. If something fails, you reflash the repeater by USB cable. So pick a repeater you can reach easily.
  • Your repeater is briefly gone. While the update is installed, it restarts on its own. It is briefly out of reach. If it falls back, it tries again after 1 day at the earliest.
  • Boards with the OTAFIX 1.x bootloader: Use USB instead of Bluetooth. Keep a USB cable ready.
  • A display stays dark. The alpha packages have no display driver, for example on the Heltec T114. This is intended.
  • No radio contact, no confirmation. If your repeater hears nobody after the update, it cannot confirm the new firmware. After 3 test boots the old one runs again. Place it where it hears other repeaters.
  • Back to MeshCore: Enter fuota uf2 in the USB console. The repeater restarts and shows up on your computer as a USB drive. Drag the regular MeshCore file (UF2) for your board onto it. If the repeater no longer answers, press reset twice in quick succession. Then the same drive appears. Without USB it works over Bluetooth. The command start ota restarts the repeater into the Bluetooth update mode. This also works by remote access as admin. Then you load the regular MeshCore package.