Die Nachrichten auf Funk
FUOTA sendet 4 Nachrichten: Angebot, Anfrage, Daten und Retract. Dazu kommen der Schlüssel-Widerruf und die Ansage des Nebenslots. Alle sind MeshCore-Pakete vom eigenen Typ 0x0E, zwischen direkten Nachbarn oder auf einem festen Pfad. Angebot, Retract und Schlüssel-Widerruf gehen zusätzlich als Flut raus. Die Statusmeldung eines Knotens geht nur als Flut. Hier stehen der Aufbau der Nachrichten, wer was weitergibt und welche Zeitgeber laufen.
The messages on air
FUOTA sends 4 messages: offer, request, data and retract. Two more are the key revocation and the announcement of the side slot. All are MeshCore packets of their own type 0x0E. They travel between direct neighbours or along a fixed path. Offer, retract and key revocation also go out as a flood. The status message of a node goes out only as a flood. This page shows the layout of the messages. It also shows who passes on what and which timers run.
Aufbau der Nachrichten
Jede Nachricht ist ein MeshCore-Paket vom Typ 0x0E mit Route Direct. Zwischen direkten Nachbarn läuft sie ohne Pfad (Zero-Hop). Hinter Repeatern ohne FUOTA läuft sie mit Pfad, siehe Wer was weitergibt. Angebot, Retract und Schlüssel-Widerruf gehen zusätzlich als Flut raus. Die Statusmeldung geht nur als Flut, siehe Statusmeldungen. Die Flut ist ein anderes Paket: eine Gruppen-Nachricht vom MeshCore-Typ 0x06.
Byte 1 und 2 jeder Nachricht sind die Kennung des Absenders. Das sind die ersten 2 Byte seines öffentlichen Schlüssels. Die Kennung ist nicht signiert. Knoten wählen damit den Anbieter und erkennen einen beschäftigten Anbieter. Logs und der Testfilter nutzen sie auch.
Das Angebot trägt ein Ticket. Es hängt am Manifest, der signierten Liste dessen, was zu einem Update gehört. Der Release-Schlüssel signiert das Ticket beim Release. Ein gefälschtes Angebot verwirft ein Knoten, bevor er etwas anfragt.
FUOTA-Pakete haben in der Sendewarteschlange von MeshCore die niedrigste Priorität. Höchstens eins wartet gleichzeitig. Fällige Mesh-Pakete gehen vor: Nur ein schon gesendetes FUOTA-Paket hält eines auf. FUOTA-Pakete zählen auch im Sendebudget von MeshCore.
Layout of the messages
Every message is a MeshCore packet of type 0x0E with route direct. Between direct neighbours it travels without a path (zero hop). Behind repeaters without FUOTA it travels with a path, see Who passes on what. The offer, the retract and the key revocation also go out as a flood. The status message goes out only as a flood, see Status messages. A flood is a different packet: a group message of MeshCore type 0x06.
Bytes 1 and 2 of every message are the sender ID. They are the first 2 bytes of its public key. The ID is unsigned. Nodes use it to pick a provider and to spot a busy provider. Logs and the test filter use it too.
The offer carries a ticket. It hangs on the manifest, the signed list of what belongs to an update. The release key signs the ticket at release time. A node drops a forged offer before it asks for anything.
FUOTA packets have the lowest priority in the MeshCore transmit queue. At most one waits at a time. Due mesh packets go first: only a FUOTA packet already on air holds one back. FUOTA packets also count against the MeshCore transmit budget.
| Nachricht | Aufbau | Bytes | Wer sendet | Wer reagiert |
|---|---|---|---|---|
| Angebot | [1][snd 2][Seiten][nonce][Ticket 108] | 113 | Jeder Knoten mit geprüftem Manifest, im Trickle-Takt (siehe Zeiten und Zeitgeber) | Nachbarn, für die es passt. Nachbarn mit derselben Kampagne zählen es als Bestätigung. |
| Anfrage | [2][snd 2][id 4][Block 2][Maske 2][Ziel 2][nonce] | 14 | Der Knoten, der den Patch holt | Nur der genannte Anbieter (Ziel = seine Kennung). Bei 0xFFFF jeder, der die Fragmente geprüft hat. |
| Daten | [3][snd 2][id, erste 3 B][Fragment 2][bis 176 B] | 184 | Wer die Seite geprüft hat und angefragt wurde | Alle Nachbarn, die dieselbe Kampagne holen. Ein Paket bedient alle. |
| Retract (signierter Rückruf) | [4][snd 2][signierter Retract 80 B] | 83 | Wer ihn geprüft hat, sendet ihn bis zu 3-mal an Nachbarn. Einmal geht er als Flut raus, dazu als Antwort auf ein Angebot dieses Builds | Alle Nachbarn mit FUOTA. Die Flut hat 84 B, weil ein nonce hinter der Kennung steht im Code geprüft. |
| Message | Layout | Bytes | Sender | Reacts |
|---|---|---|---|---|
| Offer | [1][snd 2][pages][nonce][ticket 108] | 113 | Every node with a checked manifest, on a Trickle schedule (see Times and timers) | Neighbours it fits. Neighbours with the same campaign count it as a confirmation. |
| Request | [2][snd 2][id 4][block 2][mask 2][target 2][nonce] | 14 | The node that pulls the patch | Only the named provider (target = its ID). With 0xFFFF everyone who has checked the fragments. |
| Data | [3][snd 2][id, first 3 B][fragment 2][up to 176 B] | 184 | Whoever has checked the page and was asked | All neighbours pulling the same campaign. One packet serves all. |
| Retract (signed recall) | [4][snd 2][signed retract 80 B] | 83 | Whoever verified it sends it up to 3 times to neighbours. It goes out once as a flood, and in reply to an offer of that build | All neighbours with FUOTA. The flood has 84 B, because a nonce follows the ID checked in the code. |
- Zahlen im Aufbau sind Bytes im Code geprüft. Die erste Klammer ist der Typ der Nachricht. Eine Klammer ohne Zahl ist 1 Byte.
- snd ist die Kennung des Absenders. Seiten ist die Zahl der geprüften 4-KB-Seiten des Patches.
- nonce ist ein Zähler des Absenders. Er steigt mit jedem Angebot und jeder Anfrage um 1, der Empfänger wertet ihn nicht aus im Code geprüft.
- Ein Block sind 16 Fragmente. Jedes Bit der Maske steht für ein Fragment des Blocks, gesetzt heißt „fehlt“.
- Ziel ist die Kennung des Anbieters, 0xFFFF heißt „wer es hat“. MeshCore erzeugt keinen Schlüssel, der mit 0xFF beginnt. 0xFFFF ist darum keine echte Kennung im Code geprüft.
- Numbers in the layout are bytes checked in the code. The first bracket is the message type. A bracket without a number is 1 byte.
- snd is the sender ID. Pages is the number of checked 4 KB pages of the patch.
- nonce is a counter of the sender. It rises by 1 with every offer and every request, and the receiver does not evaluate it checked in the code.
- A block is 16 fragments. Each mask bit stands for one fragment of the block. A set bit means “missing”.
- Target is the ID of the provider, and 0xFFFF means “whoever has it”. MeshCore never generates a key that starts with 0xFF. So 0xFFFF is never a real ID checked in the code.
Das Angebots-Ticket
Das Ticket hat 108 B im Code geprüft. Es muss zum Manifest passen, an dem es hängt.
The offer ticket
The ticket is 108 B checked in the code. It has to match the manifest it hangs on.
| Feld | Bytes | Inhalt |
|---|---|---|
| Magic | 4 | „FUO1“ |
| Ziel | 4 | Ziel-ID des Modells |
| Build | 4 | Build des Updates |
| Patch-Größe | 4 | Größe des Patches in Byte |
| Quelle | 8 | SHA-256 des Quell-Images, erste 8 B |
| Manifest-Hash | 16 | SHA-256 des Manifest-Kerns, erste 16 B |
| Signatur | 64 | Ed25519 über die 40 Byte davor |
| Field | Bytes | Content |
|---|---|---|
| Magic | 4 | “FUO1” |
| Target | 4 | Target ID of the model |
| Build | 4 | Build of the update |
| Patch size | 4 | Size of the patch in bytes |
| Source | 8 | SHA-256 of the source image, first 8 B |
| Manifest hash | 16 | SHA-256 of the manifest core, first 16 B |
| Signature | 64 | Ed25519 over the 40 bytes before it |
Anfrage und Daten über einen Pfad
Hinter Repeatern ohne FUOTA tragen Anfrage und Daten einen Pfad. Der Sender setzt dafür das Flag 0x40 im Typ-Byte im Code geprüft. Bei den Daten steckt der Sendezähler seq in den Bits 4 und 5 des Typ-Bytes. Seine übrigen 5 Bit stehen oben im Fragment-Feld.
Request and data along a path
Behind repeaters without FUOTA, request and data carry a path. The sender sets the flag 0x40 in the type byte for it checked in the code. In data packets, the counter seq sits in bits 4 and 5 of the type byte. Its other 5 bits sit at the top of the fragment field.
| Nachricht | Aufbau | Bytes |
|---|---|---|
| Anfrage über Pfad | [0x42][snd 2][id 4][Block 2][Maske 2][Ziel 2][nonce][Pfadlänge][Pfad vom Anbieter] | 15 + Pfad |
| Daten über Pfad | [0x43 + (seq & 3) · 0x10][snd 2][id, erste 3 B][Fragment + (seq >> 2) · 2048, 2][bis 176 B] | 184 |
| Message | Layout | Bytes |
|---|---|---|
| Request along a path | [0x42][snd 2][id 4][block 2][mask 2][target 2][nonce][path length][path from the provider] | 15 + path |
| Data along a path | [0x43 + (seq & 3) · 0x10][snd 2][id, first 3 B][fragment + (seq >> 2) · 2048, 2][up to 176 B] | 184 |
Airtime
Die Airtime zählt 2 Byte mehr als die Nachricht selbst im Code geprüft. Das sind das Header-Byte und die Pfadlänge. Alle Werte folgen aus der LoRa-Formel.
Airtime
The airtime counts 2 bytes more than the message itself checked in the code. They are the header byte and the path length. All values follow from the LoRa formula.
| Nachricht | MeshCore EU narrow, SF8, CR 4/8 | Hamburg, SF8, CR 4/5 | Testaufbau, SF7, CR 4/5 |
|---|---|---|---|
| Angebot | 1.164 ms | 796 ms | 439 ms |
| Anfrage | 345 ms | 284 ms | 152 ms |
| Daten | 1.721 ms | 1.144 ms | 643 ms |
| Retract | 902 ms | 632 ms | 347 ms |
| Message | MeshCore EU narrow, SF8, CR 4/8 | Hamburg, SF8, CR 4/5 | Bench, SF7, CR 4/5 |
|---|---|---|---|
| Offer | 1,164 ms | 796 ms | 439 ms |
| Request | 345 ms | 284 ms | 152 ms |
| Data | 1,721 ms | 1,144 ms | 643 ms |
| Retract | 902 ms | 632 ms | 347 ms |
- MeshCore EU narrow: 869,618 MHz, BW 62,5 kHz, SF8, CR 4/8 (App-Preset „EU/UK (Narrow)“). Das ist der langsamere Fall berechnet.
- Die großen Repeater in Hamburg laufen laut ihren Betreibern mit CR 4/5. Das Datenpaket braucht dort nur das 0,66-fache der Zeit berechnet.
- Alle gerechneten Zeiten dieser Website nehmen CR 4/5 an. Das ist die Einstellung in Hamburg laut Betreibern, an keinem Hamburger Repeater gemessen. Mit CR 4/8 dauert ein Datenpaket das 1,5-fache. Kürzere Pakete verlieren weniger: ein Retract das 1,43-fache, eine Anfrage das 1,22-fache berechnet.
- Der Testaufbau läuft mit SF7 und CR 4/5 gemessen.
- Alle gerechneten Sendezeiten nehmen 32 Preamble-Symbole an, dazu expliziten Header und CRC. Die Firmware setzt bei SF8 und darunter 32 Symbole, darüber 16 (
src/helpers/radiolib/RadioLibWrappers.h, preambleLengthForSF()) im Code geprüft. - Die Firmware rechnet ihr Airtime-Budget mit der Airtime ihrer aktuellen Einstellungen.
- MeshCore EU narrow: 869.618 MHz, BW 62.5 kHz, SF8, CR 4/8 (app preset “EU/UK (Narrow)”). This is the slower case calculated.
- According to their operators, the large repeaters in Hamburg run CR 4/5. A data packet takes only 0.66 times as long there calculated.
- All calculated times on this website assume CR 4/5. That is the Hamburg setting according to the operators, not measured at any Hamburg repeater. At CR 4/8 a data packet takes 1.5 times as long. Shorter packets lose less: a retract 1.43 times, a request 1.22 times calculated.
- The bench runs SF7 and CR 4/5 measured.
- All calculated airtimes assume 32 preamble symbols, plus explicit header and CRC. The firmware sets 32 symbols at SF8 and below, 16 above (
src/helpers/radiolib/RadioLibWrappers.h, preambleLengthForSF()) checked in the code. - The firmware computes its airtime budget from the airtime of its current settings.
Doppelte Pakete
MeshCore führt eine Duplikat-Tabelle mit 160 Einträgen aus Typ und Inhalt. Beim Empfang von Typ 0x0E umgeht FUOTA diese Tabelle. FUOTA erkennt doppelte Fragmente selbst, an Kampagne und Fragmentnummer. Normale Repeater auf einem Pfad nutzen die Tabelle aber. Darum trägt jedes Datenpaket über einen Pfad einen 7-Bit-Sendezähler. Eine Wiederholung ist so nie byte-gleich mit der ersten Sendung. Erst nach 128 Sendungen desselben Fragments wiederholt sich der Zähler im Code geprüft.
Duplicate packets
MeshCore keeps a duplicate table of 160 entries made of type and payload. When it receives type 0x0E, FUOTA bypasses that table. FUOTA detects duplicate fragments itself, by campaign and fragment number. Normal repeaters on a path do use the table. So every data packet along a path carries a 7-bit send counter. A repeat is never byte-identical to the first send. The counter repeats after 128 sends of the same fragment checked in the code.
Zeitlicher Ablauf über vier Knoten
A ist der Seed. Er hat das Release per USB oder BLE installiert und gibt es weiter. B hört A, C hört nur B. S ist ein Repeater ohne FUOTA. MeshCore verwirft unbekannte Typen, also auch das Angebot (Typ 0x0E). Jede Zeile ist eine Sendung, die Zeit läuft nach unten.
Timeline across four nodes
A is the seed. It installed the release by USB or BLE and passes it on. B hears A, and C hears only B. S is a repeater without FUOTA. MeshCore drops unknown types, so it drops the offer too (type 0x0E). Each line is one transmission, and time runs downwards.
Ein gemessener Lauf zum Abspielen
Der Lauf spielt die Logs aller 3 Knoten aus dem Kettentest ab. Jede Farbe ist ein Nachrichtentyp. Unter jedem Knoten stehen das Manifest (2 Fragmente) und die 4 Patch-Seiten. Sie füllen sich beim Empfang und bekommen einen Haken, sobald ihr Hash stimmt.
- Der Testaufbau hatte 10 % Budget und SF7. Im Mesh (0,3 %, SF8) dauert jeder Schritt rund 59-mal so lange berechnet.
- Im echten Netz hört C den Seed A nicht. Im Testaufbau sorgt ein Filter dafür.
- Wir haben den Lauf aufgezeichnet, bevor eine Anfrage genau einen Anbieter nannte. In dieser Kette hat jeder Knoten ohnehin nur einen.
A measured run to replay
The replay plays back the logs of all 3 nodes from the chain test. Each colour is a message type. Below each node are the manifest (2 fragments) and the 4 patch pages. They fill as fragments arrive and get a tick once their hash checks out.
- The bench had a 10 % budget and SF7. In the mesh (0.3 %, SF8) every step takes about 59 times as long calculated.
- In a real network C cannot hear the seed A. On the bench a filter enforces that.
- We recorded the run before a request named exactly one provider. In this chain every node has only one anyway.
Statusmeldungen der Knoten
Ein Knoten meldet sieben Ereignisse seines Updates. Die Statusmeldung ist ein signiertes Paket von 96 B im Code geprüft. Sie geht nur als Flut raus, als Gruppen-Nachricht im FUOTA-Kanal der Standard-Region. Ohne Standard-Region sendet der Knoten keine im Code geprüft. Höchstens 8 Meldungen gehen je 24 Stunden Laufzeit raus im Code geprüft.
| Meldung | Ereignis |
|---|---|
| E1 | Kampagne vollständig empfangen |
| E2 | Update wird angewendet, danach folgt ein Neustart |
| E3 | Probestart bestätigt |
| E4 | Rückfall ohne Funk-Lebenszeichen, später ein neuer Versuch |
| E5 | Rückfall nach einem Fehlstart, der Build ist gebannt |
| E6 | Absturz nach der Bestätigung, zurück auf den alten Build |
| E7 | Retract übernommen |
Am Brett wurden alle sieben Meldungen gesendet gemessen. Laut Status liefen sie im echten Ablauf, nicht per Testbefehl. Am 10. November 2026 waren es E1 und E3 bis E6. Am 11. November 2026 folgten E2 und E7.
Am 12. November 2026 flutete ein Knoten am Brett die Meldung E3. Die Standard-Region war gesetzt. Die Flut dauerte 754 ms, laut Bericht.
Wo der Analyzer sie zeigt, steht im Abschnitt zum Analyzer.
Status messages of the nodes
A node reports seven events of its update. The status message is a signed packet of 96 B checked in the code. It goes out only as a flood. This is a group message in the FUOTA channel of the default region. Without a default region the node sends none checked in the code. At most 8 messages go out per 24 hours of running time checked in the code.
| Message | Event |
|---|---|
| E1 | Campaign completely received |
| E2 | Update is applied, a restart follows |
| E3 | Test boot confirmed |
| E4 | Revert without a radio sign of life, a new try later |
| E5 | Revert after a failed start, the build is banned |
| E6 | Crash after the confirmation, back to the old build |
| E7 | Retract taken over |
On the bench all seven messages were sent measured. According to the status they ran in the real flow, not by test command. On 10 November 2026 these were E1 and E3 to E6. On 11 November 2026 E2 and E7 followed.
On 12 November 2026 a node on the bench flooded the message E3. The default region was set. The flood took 754 ms, according to the report.
Where the analyzer shows them is in the analyzer section.
Was im echten Netz davon zu sehen ist
Der FUOTA-Bericht im MeshCore-Analyzer wertet aus, was Beobachter im echten Netz von FUOTA hören: Kampagnen mit ihrer Kennung, beteiligte Knoten, Pakete je Art (Angebot, Anfrage, Daten), Bytes und Airtime, dazu jeder Beobachter mit seinem Signalabstand.
Viel kann dort nicht stehen. FUOTA sendet Zero-Hop, also hört ein Beobachter nur, was in seiner eigenen Reichweite liegt; alles hinter einem Repeater bleibt unsichtbar. Und senden tun nur Knoten mit FUOTA-Firmware, das sind die Testfirmware und die Alpha-Pakete.
Am 10. November 2026 stand dort im Zeitraum 30 Tage (die längste Auswahl im Bericht) eine einzige Kampagne:
4c0180ac, gehört am 7. November 2026 um 23:02 UTC von einem Beobachter mit dem Flughafenkürzel VNO
(Vilnius), ein Datenpaket mit 142 B und 1,4 s Airtime, ein beteiligter Knoten mit der Kennung 8f,
kein Angebot, Signalabstand 12,0 dB gemessen.
Der Bericht zeigt die Zeit in der Ortszeit des Betrachters: In Hamburg steht dort der 8. November, 00:02, in Vilnius wäre es 01:02. Eine Abfrage über 90 Tage, so weit reicht die Schnittstelle, liefert dieselbe eine Kampagne gemessen. Von unserem Testaufbau stammt das nicht: Der läuft in Hamburg mit 1 dBm über rund 50 cm, und unsere Knoten tragen andere Kennungen.
Ob es überhaupt ein FUOTA-Paket war, wissen wir nicht offen. Der Decoder des Analyzers prüfte Datenpakete damals nur locker. Er rechnete mit dem Paketlayout vom 18. Oktober 2026. Laut Status ist er seit dem 10. November 2026 umgebaut. Ob er dasselbe Paket heute als FUOTA-Paket anzeigt, ist nicht geprüft offen.
Im Alpha-Feld läuft seit dem 12. November 2026 die Kampagne dc7b7cb0 (Build 3). Sie hat zwei Tester-Knoten im Feld beobachtet. Der Analyzer hört sie nur direkt (Zero-Hop) über einen Beobachter im Feld beobachtet. Sie steht im Tab Aktivität. Der Tab Rollout zeigt nur Repeater mit Statusmeldung, also mit Standard-Region im Feld beobachtet. Ohne Standard-Region kommt keine Statusmeldung. Die Tester senden ihre Angebote dann nur Zero-Hop im Feld beobachtet. Der Lauf ist nicht vollständig offen.
What of this is visible in the real network
The FUOTA report in the MeshCore analyzer evaluates what observers in the real network hear of FUOTA: campaigns with their id, participating nodes, packets by type (offer, request, data), bytes and airtime, plus every observer with its signal margin.
There cannot be much in it. FUOTA sends zero hop, so an observer hears only what is in its own range, and anything behind a repeater stays invisible. Only nodes with FUOTA firmware send at all: the test firmware and the alpha packages.
On 10 November 2026 the report held a single campaign for the 30-day window (the longest choice in the report):
4c0180ac, heard on 7 November 2026 at 23:02 UTC by an observer with the airport code VNO
(Vilnius), one data packet of 142 B and 1.4 s of airtime, one participating node with the id 8f,
no offer, signal margin 12.0 dB measured.
The report shows time in the viewer's local time: in Hamburg it reads 8 November, 00:02; in Vilnius it would be 01:02. A query over 90 days, as far back as the interface goes, returns the same single campaign measured. It does not come from our bench: that one runs in Hamburg at 1 dBm over about 50 cm, and our nodes carry different ids.
Whether it was a FUOTA packet at all, we do not know open. Back then the decoder of the analyzer checked data packets only loosely. It assumed the packet layout of 18 October 2026. According to the status it was rebuilt on 10 November 2026. Whether it shows the same packet as a FUOTA packet today has not been checked open.
Since 12 November 2026 the alpha campaign dc7b7cb0 (build 3) has been running in the field. It has two tester nodes observed in the field. The analyzer hears it only directly (zero hop) through one observer observed in the field. It is in the Activity tab. The Rollout tab shows only repeaters with a status message, so with a default region observed in the field. Without a default region there is no status message. The testers then send their offers zero hop only observed in the field. The run is not complete open.
Wer was weitergibt und was nie
FUOTA selbst leitet kein Paket weiter. „Weitergeben“ heißt bei FUOTA: Ein Knoten empfängt, prüft, speichert im eigenen Flash und sendet später neu. Das Senden zahlt das eigene Airtime-Budget. Ein Knoten sendet nur Geprüftes erneut.
Weiter leitet nur der normale MeshCore-Code: Pakete mit Pfad sowie geflutete Angebote, Retracts und Schlüssel-Widerrufe.
Lücken entstehen hinter Repeatern ohne FUOTA. Dort flutet ein Anbieter sein Angebot, sobald er die ganze Kampagne hat. Die Wochen zählen seine Laufzeit, nicht den Kalender. In der ersten Woche flutet er höchstens einmal am Tag. Dasselbe gilt eine Woche nach jeder Anfrage, die er hört. Sonst flutet er höchstens einmal je Woche, auch ohne Anfrage im Code geprüft.
Hört ein Anbieter eine Flut derselben Kampagne, flutet er einen Tag lang nicht selbst. In der ersten Woche und nach einer Anfrage ist das auf 3 Tage begrenzt. Die 3 Tage zählen ab seiner letzten Flut oder der letzten zurückgehaltenen Wochenperiode. Hat er noch nie geflutet, zählen sie seine Laufzeit mit der Kampagne. Danach flutet er trotz gehörter Flut, sobald sein nächster Termin kommt im Code geprüft.
Der Start der Periode zählt in vollen Stunden. Die Grenze endet daher bis zu 1 h früher im Code geprüft. Läuft seine Laufzeit mit der Kampagne nicht, hält ihn keine gehörte Flut zurück im Code geprüft.
Nur eine Flut aus seiner Region mit höchstens 5 Hops hält ihn zurück im Code geprüft. Das gilt auch für eine Flut, die er hörte, während er die Kampagne holte. Eine Kopie von weiter her erreicht nicht die Knoten, die seine Flut erreichen würde. Gegen einen Angreifer in Funkreichweite hilft das nicht. Er wiederholt eine mitgeschnittene Flut mit Hop-Zahl 0. Der Transport-Code deckt Typ und Nutzlast, nicht den Pfad im Code geprüft.
Die Wochenphase beginnt nach der ersten Woche ohne Anfrage der letzten 7 Tage. Dort hält sich ein Anbieter höchstens 2-mal hintereinander zurück. Er flutet spätestens 3 Wochen nach seiner letzten Flut wieder im Code geprüft.
Eine Flut reist auf einer Region. Region heißt in MeshCore der Flood-Scope. Der Knoten flutet in seiner Standard-Region. Hat er keine, flutet er nicht im Code geprüft. Wer das Angebot nur über die Flut hört, fragt über den Pfad der Flut an. Anfrage und Daten leitet MeshCore entlang des Pfads weiter wie jedes Direct-Paket.
Auch ein Retract geht einmal als Flut raus. Der Knoten wartet vorher 2 bis 30 min im Code geprüft. Auf ein geflutetes Angebot eines zurückgezogenen Builds antwortet er mit einer Flut. Vorher wartet er bis zu 30 min. Das tut er höchstens einmal am Tag je Retract im Code geprüft. Auch ein Schlüssel-Widerruf geht als Flut raus, siehe Warum es funktioniert.
Am 10. November 2026 lief am Testaufbau die Flut von Retract. Ein Anbieter sendete sie. Ein zweiter empfing und prüfte sie und unterdrückte darauf seine eigene gemessen. Die Flut ohne Anfrage, die von Widerruf und die als Antwort sind dort nicht getestet offen. Die Grenze von 3 Tagen lief mit der heutigen Firmware nicht am Testaufbau offen. Ob normale Repeater jede Flut weitergeben, ist nicht geprüft offen.
Der Anbieter rechnet jede Kopie entlang des Pfads in sein Budget. Bei k Repeatern sind das k + 1 Sendungen je Fragment. Wartet ein Nachbar auf ein Datenpaket, gibt der Anbieter einem Pfad höchstens die Hälfte seiner Airtime im Code geprüft. Was ein Angreifer über fremde Repeater schickt, zählt in kein Budget, siehe Angriffe im Detail.
In der Tabelle steht „Modell“ für die Ziel-ID im Ticket.
Who passes on what, and what never
FUOTA itself forwards no packet. In FUOTA, “passing on” means: a node receives, checks, stores in its own flash and resends later. The resend costs its own airtime budget. A node resends only checked data.
Only the normal MeshCore code forwards: packets with a path, and flooded offers, retracts and key revocations.
Gaps arise behind repeaters without FUOTA. There, a provider floods its offer once it has the whole campaign. The weeks count its running time, not the calendar. In the first week it floods at most once a day. The same holds for a week after each request it hears. Otherwise it floods at most once a week, even without a request checked in the code.
A provider that hears a flood of its campaign does not flood for a day. In the first week and after a request, that is limited to 3 days. The 3 days count from its last flood or the last weekly period it held back. If it never flooded, they count its running time with the campaign. After that it floods despite a heard flood, at its next planned time checked in the code.
The start of the period counts in whole hours. The limit therefore ends up to 1 h early checked in the code. Without a running time for the campaign, no heard flood holds the provider back checked in the code.
Only a flood from its region with at most 5 hops holds it back checked in the code. This also holds for a flood it heard while it fetched the campaign. A copy from farther away misses nodes that its own flood would reach. That does not help against an attacker in radio range. The attacker repeats a recorded flood with hop count 0. The transport code covers type and payload, not the path checked in the code.
The weekly phase starts after the first week without a request in the last 7 days. There a provider holds back at most 2 times in a row. It floods again 3 weeks after its last flood at the latest checked in the code.
A flood travels on a region. In MeshCore, a region is the flood scope. The node floods in its default region. If it has none, it does not flood checked in the code. A node that hears the offer only via the flood asks along that flood's path. MeshCore forwards request and data along the path like any direct packet.
A retract also goes out once as a flood. The node waits 2 to 30 min first checked in the code. It answers a flooded offer of a retracted build with a flood. It waits up to 30 min first. It does so at most once a day per retract checked in the code. A key revocation also goes out as a flood, see Why it works.
The flood of the retract ran on the bench on 10 November 2026. One provider sent it. A second received and checked it, then held back its own measured. The flood without a request, the one of the revocation and the one as an answer are not tested there open. The limit of 3 days has not run on the bench with today's firmware open. It is not checked if normal repeaters pass on every flood open.
The provider counts every copy along the path in its budget. With k repeaters, that is k + 1 transmissions per fragment. While a neighbour waits for a data packet, the provider gives a path at most half of its airtime checked in the code. What an attacker sends through foreign repeaters counts in no budget, see Attacks in detail.
In the table, “model” stands for the target ID in the ticket.
| Was kommt an | Repeater mit FUOTA, gleiches Modell | Repeater mit FUOTA, anderes Modell | Repeater ohne FUOTA, Companion (Knoten mit App-Anbindung) |
|---|---|---|---|
| Angebot | Prüft, ob es passt. Holt dann den Patch oder zählt es als Bestätigung. | Ignoriert (Vorschlag: hält ein Fenster, siehe unten) | Verwirft. Ein geflutetes leitet er weiter wie jede Gruppen-Nachricht. |
| Angebot eines höheren Builds, während er eine Kampagne hält | Holt nur dessen Manifest in den RAM und wechselt erst, wenn es geprüft ist. Bis dahin bedient er die alte Kampagne weiter gemessen. | Ignoriert | Wie Angebot |
| Anfrage | Bedient aus eigenen geprüften Seiten, wenn die Anfrage ihn nennt (oder 0xFFFF). Er sendet reihum ab dem zuletzt gesendeten Fragment gemessen. | Ignoriert | Verwirft. Mit Pfad leitet er sie weiter wie jedes Direct-Paket. |
| Daten | Speichert, was fehlt, nur nach geprüftem Manifest. Er streicht aus der eigenen Sendeliste, was ein anderer gerade gesendet hat. | Ignoriert | Verwirft. Mit Pfad leitet er sie weiter wie jedes Direct-Paket. |
| Retract, gültig | Stoppt, speichert, sendet ihn bis zu 3-mal, flutet ihn einmal und antwortet damit. | Verwirft (andere Ziel-ID) | Verwirft. Einen gefluteten leitet er weiter wie jede Gruppen-Nachricht. |
| Angebot mit gefälschtem Ticket | Verwirft es, bevor er etwas anfragt gemessen. Er gibt nichts davon weiter im Code geprüft. | Ignoriert | Verwirft. Ein geflutetes leitet er weiter wie jede Gruppen-Nachricht. |
| Seite mit falschem Hash | Löscht sie, holt sie neu und gibt sie nie weiter. | Holt gar nicht | Verwirft |
| Angebot eines zurückgezogenen Builds | Holt nicht. Er antwortet höchstens alle 30 s mit dem Retract. Kam das Angebot als Flut, antwortet er nach bis zu 30 min mit einer Flut. Das tut er höchstens einmal am Tag je Retract im Code geprüft. | Ignoriert | Verwirft. Ein geflutetes leitet er weiter wie jede Gruppen-Nachricht. |
| Normale MeshCore-Pakete | Unverändert: FUOTA ändert die Weiterleitung von MeshCore nicht. Es kommt nur ein Fall dazu: Typ 0x0E ohne Pfad. FUOTA-Pakete stehen in der Sendewarteschlange hinter allen fälligen Mesh-Paketen. | ||
| What arrives | Repeater with FUOTA, same model | Repeater with FUOTA, other model | Repeater without FUOTA, companion (node connected to an app) |
|---|---|---|---|
| Offer | Checks whether it fits. Then pulls the patch or counts it as a confirmation. | Ignores (proposal: holds a window, see below) | Drops. A flooded one it forwards like any group message. |
| Offer of a higher build while it holds a campaign | Pulls only its manifest into RAM and switches once that is checked. Until then it keeps serving the old campaign measured. | Ignores | As offer |
| Request | Serves from its own checked pages if the request names this node (or 0xFFFF). It sends in turn, from the fragment sent last measured. | Ignores | Drops. With a path it forwards it like any direct packet. |
| Data | Stores what is missing, only after a checked manifest. It strikes from its own send list what another node has just sent. | Ignores | Drops. With a path it forwards it like any direct packet. |
| Retract, valid | Stops, stores, sends it up to 3 times, floods it once and replies with it. | Drops (other target ID) | Drops. A flooded one it forwards like any group message. |
| Offer with a forged ticket | Drops it before asking for anything measured. It passes nothing of it on checked in the code. | Ignores | Drops. A flooded one it forwards like any group message. |
| Page with wrong hash | Erases it, pulls it again and never passes it on. | Does not pull at all | Drops |
| Offer of a retracted build | Does not pull. It answers with the retract at most every 30 s. If the offer came as a flood, it answers with a flood after up to 30 min. It does so at most once a day per retract checked in the code. | Ignores | Drops. A flooded one it forwards like any group message. |
| Normal MeshCore packets | Unchanged: FUOTA does not change MeshCore forwarding. It adds one case: type 0x0E without a path. FUOTA packets wait in the transmit queue behind every due mesh packet. | ||
B leitet Pakete mit Pfad und geflutete Angebote weiter, wie jeder Repeater. C erfährt über ein geflutetes Angebot von A vom Update. C holt es über B per Pfad. Das sind 2 Sendungen je Fragment, beide im Airtime-Budget von A.
Am Testaufbau war B ein Repeater ohne FUOTA. Das lief auch mit einem Nachbarn, den C hört, der C aber nicht hört gemessen. Ein Repeater mit FUOTA anderen Modells leitet mit demselben MeshCore-Code weiter. Das haben wir nicht eigens gemessen.
Vorschlag für weniger Airtime: B hält Kampagnen fremder Modelle. Er prüft Signatur und Seiten-Hashes und wendet sie nie an. Er hält nur das Manifest und 2 geprüfte Seiten und gibt sie weiter. Noch nicht gebaut offen.
B forwards packets with a path and flooded offers, like any repeater. C learns about the update from a flooded offer of A. C pulls it via B along the path. That is 2 transmissions per fragment, both in A's airtime budget.
On the bench, B was a repeater without FUOTA. That also worked with a neighbour that C hears but that does not hear C measured. A repeater with FUOTA of another model forwards with the same MeshCore code. We have not measured that separately.
Proposal for less airtime: B holds campaigns of foreign models. It verifies signature and page hashes and never applies them. It holds only the manifest and 2 checked pages, and passes them on. Not built yet open.
Werkseinstellungen und Paketfilter
Die FUOTA-Firmware der Linie 1.18.0 startet mit engeren Werten als Stock-MeshCore. Sie gelten nur für eine Neuinstallation, also einen Knoten ohne Prefs-Datei. Ein Knoten im Feld behält alle seine Werte. Ein Schlüssel, der in einer alten Datei fehlt, bekommt den Stock-Wert im Code geprüft.
Factory settings and packet filter
The FUOTA firmware of the 1.18.0 line starts with tighter values than stock MeshCore. They apply to a new install only, meaning a node without a prefs file. A node in the field keeps all its values. A key that is missing from an old file gets the stock value checked in the code.
| Befehl | Werk | Erlaubt | Stock 1.18.0 |
|---|---|---|---|
advert.interval | 360 min | 0 oder 60 bis 510 min | 2 min bis zum ersten set, dann 0. Erlaubt 0 oder 60 bis 240 min. |
flood.advert.interval | 0 (aus) | 0 oder 24 bis 255 h | 47 h. Erlaubt 3 bis 168 h. |
dutycycle | 10 % | 10 bis 100 % | 50 %. Erlaubt 1 bis 100 %. |
cad | an | an, aus | aus |
flood.max | 10 Hops | 0 bis 64 | 64 |
flood.max.unscoped | 1 Hop | 0 bis 64 | 64 |
flood.max.advert | 2 Hops | 0 bis 64 | 8 |
flood.max.type | 0:5,1:5,7:5 | je Typ 0 bis 64 oder off, nicht für FUOTA | keine Einträge |
path.hash.mode | 2 (3 Byte je Hop) | 0 bis 2 | 0 (1 Byte je Hop) |
| Command | Factory | Allowed | Stock 1.18.0 |
|---|---|---|---|
advert.interval | 360 min | 0 or 60 to 510 min | 2 min until the first set, then 0. Allowed 0 or 60 to 240 min. |
flood.advert.interval | 0 (off) | 0 or 24 to 255 h | 47 h. Allowed 3 to 168 h. |
dutycycle | 10 % | 10 to 100 % | 50 %. Allowed 1 to 100 %. |
cad | on | on, off | off |
flood.max | 10 hops | 0 to 64 | 64 |
flood.max.unscoped | 1 hop | 0 to 64 | 64 |
flood.max.advert | 2 hops | 0 to 64 | 8 |
flood.max.type | 0:5,1:5,7:5 | per type 0 to 64 or off, not for FUOTA | no entries |
path.hash.mode | 2 (3 bytes per hop) | 0 to 2 | 0 (1 byte per hop) |
Alle Werte stehen im Code im Code geprüft. Eine neue Installation zeigte sie am Brett
mit get, ein Knoten mit Prefs behielt seine Werte, und die Grenzen der Setter griffen an den Rändern
gemessen. Die Typen 0, 1 und 7 sind REQ, RESPONSE und ANON_REQ.
Die Setter lesen eine Eingabe ganz. Ist sie keine Zahl im erlaubten Bereich oder nicht das ganze Wort on
oder off, antwortet der Knoten mit einem Fehler und ändert nichts. ON in Großbuchstaben gilt
nicht als on.
- Zahlen:
flood.max,flood.max.unscopedundflood.max.advert(0 bis 64),path.hash.mode(0 bis 2),agc.reset.interval(0 bis 1020),int.thresh(0 bis 255),multi.acks(0 oder 1),tx(-9 bis 30 dBm, FehlertextError, tx -9..30),advert.interval(0 oder 60 bis 510 Minuten) undflood.advert.interval(0 oder 24 bis 255 Stunden). Die beiden Advert-Setter behalten ihren bisherigen Fehlertext.set advert.interval abcschaltete vorher still das Advert aus, undset flood.advert.interval 24xwurde als 24 gelesen. Jetzt antwortet der Knoten mit dem Bereichsfehler und speichert nichts. - Koordinaten:
lat(-90 bis 90) undlon(-180 bis 180) als Dezimalzahl mit Punkt.52,01mit Komma wird abgelehnt. FehlertexteError, lat -90..90undError, lon -180..180. - Wörter:
cad,repeat,powersaving,allow.read.only,radio.rxgain,fuota autoundfuota relay.
Stock antwortet auf alles davon mit OK. set flood.max abc setzt 0, der Knoten gibt dann nichts
mehr weiter. set flood.max 320 setzt 64. set cad ON schaltet die Kanalprüfung aus und
set repeat offxyz das Weitergeben im Code geprüft. Der Host-Test prüft die
Entscheidung mit diesen Fehlfällen im Code geprüft. Die Antworten am Brett sind
offen.
So wählt der Knoten, was er weitergibt
Ein Repeater prüft jedes fremde Flood-Paket. Er gibt es nicht weiter, wenn es schon so viele Hops hinter sich hat wie eine der Grenzen erlaubt. Die strengste Grenze gewinnt im Code geprüft.
flood.maxgilt für jedes Flood-Paket.flood.max.unscopedgilt für Floods ohne Region.flood.max.advertgilt für Adverts.flood.max.type <Typ> <Hops>gilt für einen Pakettyp. Der Typ steht als Name oder Zahl von 0 bis 15 da, zum Beispielgrpdataoder6.
Mit den Werkswerten gibt ein Repeater ein Flood-Paket ohne Region einmal weiter. Adverts reichen bis 2 Hops, REQ, RESPONSE und ANON_REQ bis 5, alles andere bis 10. Die Grenzen betreffen nur das Weitergeben fremder Floods. Eigene Sendungen, Pakete mit Pfad und Zero-Hop-Pakete laufen nicht durch sie im Code geprüft.
Die Angebots-Flut von FUOTA läuft als Gruppen-Datenpaket in der Standard-Region des Knotens. Für sie gilt allein
flood.max. Ein Eintrag für grpdata trifft sie nicht: Der Repeater erkennt das Paket am
FUOTA-Kanal und lässt die Typliste weg. flood.max.unscoped trifft sie ebenfalls nicht, denn sie hat
eine Region im Code geprüft.
Der Typ fuota selbst wird nie geflutet. Darum lehnt set flood.max.type fuota 3 mit
Error, fuota packets cannot be limited ab im Code geprüft.
Der Kanalschlüssel ist öffentlich. Wer ihn kennt, kann ein Paket bauen, das als FUOTA-Flut durchgeht. Auch dieses Paket
hält flood.max. Nicht ausgenommen sind repeat off, fuota relay off, eine fehlende
Region und loop.detect.
Am Brett ist nur der Fall mit 0 Hops gemessen. Ab 1 Hop sind die Grenzen nur im Host-Test belegt. In einem echten Mesh mit mehreren Repeater-Hops hat sie niemand gemessen offen.
Was offen ist
- Im Bench-Build von 1.18.0-b3 sendet eine Neuinstallation die erste Zero-Hop-Advert nach 360 min, weil dort die Advert beim Start ausgeschaltet ist im Code geprüft. Bei Stock sind es 2 min. Ein Release-Build sendet sie etwa 16 s nach dem Start im Code geprüft. Am Release-Gerät ist das nicht gemessen offen. Mit
advert.zerohopsendet der Knoten sofort offen. - 1.17.1-b2 erlaubt für
advert.intervalnur 0 und 60 bis 240 min im Code geprüft. Es setzt ein Intervall unter 60 min beim Speichern auf 0. Darum sendet ein Knoten mit 1.17.1-b2 nach der ersten gespeicherten Einstellung keine Zero-Hop-Adverts mehr im Code geprüft. - Floods ohne Region laufen nur 1 Hop weit, auch Antworten auf Fernwartung. Ob das Betreiber ohne Standard-Region stört, ist ungeprüft offen.
- Mit
flood.max.advert2 und ausgeschalteter Flut-Advert sehen Beobachter einen Knoten nur aus etwa 2 Hops Umkreis. Das ist hergeleitet, nicht gemessen offen. - Wie 10 % Duty Cycle unter echter Last im Mesh wirken, ist nicht gemessen offen. Am Brett änderte er den Abstand der Fragmente nicht: 6,430 s gegen 6,434 s gemessen.
- CAD an: Die erste Slot-Anfrage ging in 2 von 4 Läufen verloren. In einer Folgeserie mit 6 Läufen mit CAD an wurden alle 12 ersten Slot-Anfragen beantwortet. Die 3 verzögerten Fälle der Serie traten alle mit CAD aus auf. Eine seltene Wirkung ist nicht ausgeschlossen gemessen.
All values are in the code checked in the code. On the bench, a new install showed
them with get, a node with prefs kept its values, and the setter limits held at their edges
measured. Types 0, 1 and 7 are REQ, RESPONSE and ANON_REQ.
The setters read an input completely. If it is not a number in the allowed range, or not the whole word on
or off, the node answers an error and changes nothing. ON in capitals is not on.
- Numbers:
flood.max,flood.max.unscopedandflood.max.advert(0 to 64),path.hash.mode(0 to 2),agc.reset.interval(0 to 1020),int.thresh(0 to 255),multi.acks(0 or 1),tx(-9 to 30 dBm, error textError, tx -9..30),advert.interval(0 or 60 to 510 minutes) andflood.advert.interval(0 or 24 to 255 hours). The two advert setters keep their earlier error text.set advert.interval abcused to turn the advert off without a word, andset flood.advert.interval 24xwas read as 24. Now the node answers the range error and stores nothing. - Coordinates:
lat(-90 to 90) andlon(-180 to 180) as a decimal number with a point.52,01with a comma is refused. Error textsError, lat -90..90andError, lon -180..180. - Words:
cad,repeat,powersaving,allow.read.only,radio.rxgain,fuota autoandfuota relay.
Stock answers OK to all of them. set flood.max abc sets 0, so the node forwards nothing any
more. set flood.max 320 sets 64. set cad ON turns the channel check off and
set repeat offxyz turns forwarding off checked in the code. The host test
checks the decision with those failing inputs checked in the code. The answers on the bench
are open.
How the node picks what it forwards
A repeater checks every foreign flood packet. It does not forward the packet once it has travelled as many hops as one of the limits allows. The strictest limit wins checked in the code.
flood.maxapplies to every flood packet.flood.max.unscopedapplies to floods without a region.flood.max.advertapplies to adverts.flood.max.type <type> <hops>applies to one packet type. The type is a name or a number from 0 to 15, for examplegrpdataor6.
With the factory values, a repeater forwards a flood packet without a region once. Adverts reach 2 hops, REQ, RESPONSE and ANON_REQ reach 5, everything else reaches 10. The limits only affect forwarding of foreign floods. Own sends, packets with a path and zero-hop packets do not pass through them checked in the code.
The offer flood of FUOTA travels as a group data packet in the default region of the node. For it, only
flood.max applies. An entry for grpdata does not affect it: the repeater recognises the packet by
the FUOTA channel and leaves the type list out. flood.max.unscoped does not affect it either, because it
carries a region checked in the code.
The type fuota itself is never flooded. So set flood.max.type fuota 3 answers
Error, fuota packets cannot be limited checked in the code.
The channel key is public. Whoever knows it can build a packet that passes as a FUOTA flood. flood.max holds that
packet as well. Not exempt are repeat off, fuota relay off, a missing region and
loop.detect.
On the bench, only the case with 0 hops is measured. From 1 hop on, the limits are proven in host tests only. Nobody has measured them in a real mesh with several repeater hops open.
What is open
- In the bench build of 1.18.0-b3 a new install sends its first zero-hop advert after 360 min, because the advert at start is switched off there checked in the code. In stock it is 2 min. A release build sends it about 16 s after start checked in the code. On a release device this is not measured open. With
advert.zerohopthe node sends at once open. - 1.17.1-b2 allows only 0 and 60 to 240 min for
advert.intervalchecked in the code. It sets an interval below 60 min to 0 when saving. So a node with 1.17.1-b2 sends no more zero-hop adverts after the first saved setting checked in the code. - Floods without a region travel 1 hop only, remote-admin replies included. Whether that bothers operators without a default region is unchecked open.
- With
flood.max.advert2 and the flood advert off, observers see a node only from about 2 hops around. This is derived, not measured open. - How 10 % duty cycle behaves under real load in a mesh is not measured open. On the bench it did not change the fragment gap: 6.430 s against 6.434 s measured.
- CAD on: the first slot request was lost in 2 of 4 runs. In a follow-up series of 6 runs with CAD on, all 12 first slot requests were answered. The 3 delayed cases of the series all occurred with CAD off. A rare effect is not ruled out measured.
Stromsparen (powersaving)
Der Befehl powersaving on|off stammt aus dem Upstream-MeshCore und steckt in der Basis 1.18.0.
Ab Werk ist er aus. FUOTA ändert die Schlaflogik nicht.
Die Auto-Sleep-Funktion des Boards RAK13302 aus dem Upstream fehlt in FUOTA im Code geprüft.
Wann der Knoten schläft
Der Repeater schläft, wenn der Befehl an ist und die Sendewarteschlange leer ist. Der nRF52 schläft dann bei jedem Schleifendurchlauf bis zum nächsten Interrupt. Danach arbeitet er weiter. Das ist die einzige Bedingung: ein laufender Pull oder ein Update hält den Knoten nicht wach im Code geprüft.
Was mit den FUOTA-Zeitgebern passiert
Die FUOTA-Zeitgeber sind Zeitmarken, die die Hauptschleife abfragt. Dazu gehören Angebot, Anfrage, Slot-Burst, Holen und Probestart. Einen eigenen Hardware-Timer oder Interrupt gibt es dafür nicht im Code geprüft.
Das System taktet mit 1024 Hz über einen RTC-Interrupt. Der Schlaf endet damit nach dieser Herleitung spätestens nach rund 1 ms. Ob der Tick im Schlaf wirklich durchläuft, ist ungeprüft offen. Ein Funkpaket weckt den Knoten über den DIO1-Interrupt des Funkchips. Die Zeitgeber laufen darum mit etwa 1 ms Auflösung weiter, aber der Prozessor wacht auch 1024-mal je Sekunde auf. Wie viel Strom das spart, ist nicht gemessen offen. Der Watchdog läuft im Schlaf weiter und wird in jedem Durchlauf gefüttert im Code geprüft.
Was gemessen ist
Ein Pull mit powersaving on auf beiden beteiligten Knoten lief am Brett durch. Er hatte 2 Bursts
und brauchte 187 s bis complete. Es gab keinen slot-stall. Der Fragmentabstand lag bei 673 bis 675 ms
und damit wie ohne Stromsparen gemessen. Danach schalteten wir den Befehl wieder aus.
Was fehlt
- Die Stromaufnahme mit und ohne
powersavingoffen. - Die Empfangsverluste fremder Pakete mit
powersaving onoffen. - Angebote und Anfragen über viele Stunden, Anwenden, Probestart und Rückfall mit dem Befehl an offen.
- BLE-OTA und das SoftDevice im Schlaf offen.
- Andere Boards als die zwei Testknoten und ein Anbieter mit dem Befehl an offen.
Power saving (powersaving)
The command powersaving on|off comes from upstream MeshCore and is part of the 1.18.0 base.
It is off from the factory. FUOTA does not change the sleep logic.
The auto-sleep function of the RAK13302 board from upstream is missing in FUOTA checked in the code.
When the node sleeps
The repeater sleeps when the command is on and the send queue is empty. The nRF52 then sleeps on every loop pass until the next interrupt. After that it carries on. This is the only condition: a running pull or an update does not keep the node awake checked in the code.
What happens to the FUOTA timers
The FUOTA timers are timestamps that the main loop polls. They include offer, request, slot burst, pull and test boot. There is no hardware timer or interrupt of its own for them checked in the code.
The system ticks at 1024 Hz from an RTC interrupt. By this derivation, the sleep ends after about 1 ms at the latest. Whether the tick really keeps running during sleep is unchecked open. A radio packet wakes the node through the DIO1 interrupt of the radio chip. The timers therefore keep running with about 1 ms resolution, but the processor also wakes 1024 times a second. How much power this saves is not measured open. The watchdog keeps running during sleep and is fed on every pass checked in the code.
What is measured
A pull with powersaving on on both nodes involved ran through on the bench. It had 2 bursts
and took 187 s to complete. There was no slot-stall. The fragment gap was 673 to 675 ms,
the same as without power saving measured. Afterwards we switched the command off again.
What is missing
- The power draw with and without
powersavingopen. - The receive losses of foreign packets with
powersaving onopen. - Offers and requests over many hours, apply, test boot and fallback with the command on open.
- BLE-OTA and the SoftDevice during sleep open.
- Boards other than the two test nodes, and a provider with the command on open.
Zeiten und Zeitgeber
Der Abstand ist die Pause, die das Airtime-Budget nach jeder eigenen Sendung erzwingt. Er beträgt Airtime × 1000 / Budget-Promille. Bei 0,3 % (Standard) und SF8 folgt ein Datenpaket alle 381 s. Bei 1 % sind es alle 114 s. Im Testaufbau (10 %, SF7) sind es 6,43 s berechnet.
Die Werte der Tabelle sind Konstanten der Firmware im Code geprüft. Nur die Zeit zum Anwenden ist gemessen.
Times and timers
The gap is the pause the airtime budget enforces after each own transmission. It equals airtime × 1000 / budget in permille. At 0.3 % (default) and SF8, one data packet follows every 381 s. At 1 %, it is every 114 s. On the bench (10 %, SF7) it is every 6.43 s calculated.
The values in the table are firmware constants checked in the code. Only the time to apply is measured.
| Wann | Wert | Erklärung |
|---|---|---|
| Angebot | 10 s, verdoppelt bis 2 Tage | Trickle (RFC 6206): selten ansagen. Der Zeitpunkt ist zufällig in der zweiten Hälfte des Intervalls, vorher hört der Knoten zu. |
| Angebot unterdrücken | 1 gleiches Angebot gehört | Der Knoten unterdrückt sein Angebot nur bei einem Intervall unter 1 h. Last je Nachbarschaft statt je Knoten. In langen Intervallen bietet jeder an, damit niemand ohne Angebot bleibt. |
| Intervall zurück auf 10 s | Eigenes Manifest geprüft, Patch vollständig, Pull fortgesetzt oder Anbieten gestartet (etwa nach einem Neustart) | Nachbarn erfahren den eigenen Fortschritt sofort. Ein Angebot eines Nachbarn mit weniger Seiten setzt das Intervall nicht mehr zurück. Er holt schon. |
| Sofort-Angebot | 0,2 bis 1 s | Der Knoten hat eine neue Seite geprüft, und jemand wartete darauf. Das ist Pipelining: Seiten gehen weiter, während der Rest noch kommt. |
| Erste Anfrage, nächster Block | 0,5 s bis 1 Abstand | Die Wartezeit ist zufällig und höchstens 30 s lang. So fragen Nachbarn, die sich nicht hören, nicht im Gleichschritt. |
| Warten auf das erste Fragment | 2 Abstände + 5 s | Dazu wartet der Knoten zufällig bis zu 1 Abstand. Jedes Fragment verlängert die Wartezeit auf den Rest des Blocks. Ohne Antwort fragt der Knoten den nächsten Anbieter oder 0xFFFF. Nach 12 Anfragen ohne Daten pausiert er. |
| Genannter Anbieter sendet Daten an andere | Wartezeit verlängert | Er ist beschäftigt, nicht verloren: kein Fehlversuch. |
| Nachbar fragt denselben Block | 3 s still | Die Antwort an ihn kommt hier auch an. |
| Nachfrage, wenn niemand Daten anbietet | max(30 s, 4 Abstände) | Meldet den Bedarf, solange noch niemand mehr hat. Der Nachbar bietet nach der nächsten geprüften Seite sofort an. |
| Bedienen starten | 50 bis 1000 ms | Bei einer Anfrage an alle (0xFFFF) beginnt einer zuerst. |
| Kanal belegt | 20 ms, dann erneut | Erst hören, was der Nachbar sendet, dann ein eigenes Fragment wählen. |
| Pull pausiert | 100 Abstände, mindestens 20 min | Der Knoten pausiert, wenn so lange weder Angebot noch Daten kamen. Bei 0,3 % sind das 10,6 h berechnet. Niemand hat die Kampagne mehr. Beim nächsten Angebot setzt der Knoten den Pull fort. |
| Manifest 3× beschädigt | 10 min übergehen | Keine Dauersperre wegen einer schlechten Verbindung. |
| Angebots-Flut | höchstens 1 am Tag, dann 1 je Woche | Ein Anbieter flutet sein Angebot, sobald er die ganze Kampagne hat. Die Tagesgrenze gilt in der ersten Woche und 1 Woche nach gehörter Anfrage. Danach gilt die Wochengrenze: höchstens einmal je Woche. Die Wochen zählen seine Laufzeit. In der Wochenphase hält ihn eine gehörte Flut derselben Kampagne höchstens 2-mal hintereinander zurück. Dann flutet er spätestens 3 Wochen nach seiner letzten Flut wieder. Die Regeln stehen unter Wer was weitergibt und was nie. |
| Zurückhalten der Angebots-Flut | höchstens 3 Tage | In der ersten Woche und 1 Woche nach gehörter Anfrage hält ihn eine gehörte Flut derselben Kampagne höchstens 3 Tage zurück. Die 3 Tage zählen ab seiner letzten Flut oder der letzten zurückgehaltenen Wochenperiode. Danach flutet er trotz gehörter Flut, sobald sein nächster Termin kommt. Nur eine Flut aus seiner Region mit höchstens 5 Hops hält ihn zurück. Die Regeln stehen unter Wer was weitergibt und was nie. |
| Retract | bis zu 3-mal, dazu 1 Flut | Ein Knoten sendet den Retract bis zu 3-mal an direkte Nachbarn. Dazu flutet er ihn einmal. Er wartet vorher 2 bis 30 min. Auf ein Angebot des zurückgezogenen Builds antwortet er höchstens alle 30 s mit dem Retract. Kam das Angebot als Flut, antwortet er nach bis zu 30 min mit einer Flut. Das tut er höchstens einmal am Tag je Retract. Den Takt der Sendungen an Nachbarn erklärt der Absatz unter der Tabelle. |
| Anwenden | ~10 s bauen, 30 bis 39 s tauschen | gemessen: Bauen am Release-Image (9. November 2026), Tauschen am Test-Image (18. Oktober 2026). Der Knoten ist dabei rund 1 min offline, gemessen am Test-Image, am Release-Image nicht. |
| Probestart | Watchdog 30 s, Bestätigung 60 s | Die Bestätigung kommt nach 60 s und einem Funk-Lebenszeichen (ein Paket empfangen, eines gesendet). Beides muss innerhalb der Frist T liegen. T liegt zwischen 15 Minuten und 6 Stunden. Hatte der Knoten vor dem Update keinen Tag Laufzeit, sind es 60 Minuten im Code geprüft. Nach 3 Probestarts ohne Bestätigung folgt der Rückfall auf die alte Firmware. Fehlt nur das Lebenszeichen, gibt es keinen Bann. Ein neuer Versuch wartet im Code geprüft. Am Brett empfing ein Knoten in 18 Minuten kein Paket gemessen. Im Mesh mit normalem Verkehr ist das nicht geprüft offen. |
| When | Value | Explanation |
|---|---|---|
| Offer | 10 s, doubling up to 2 days | Trickle (RFC 6206): announce rarely. The time is random in the second half of the interval. The node listens first. |
| Suppress offer | 1 equal offer heard | The node suppresses its offer only at intervals below 1 h. Load per neighbourhood instead of per node. In long intervals every node offers, so nobody is left without an offer. |
| Interval back to 10 s | Own manifest checked, patch complete, pull resumed, or offering started (for instance after a reboot) | Neighbours learn about the own progress at once. An offer from a neighbour with fewer pages no longer resets the interval. That neighbour is pulling already. |
| Immediate offer | 0.2 to 1 s | The node has checked a new page, and someone was waiting for it. This is pipelining: pages pass on while the rest still arrives. |
| First request, next block | 0.5 s to 1 gap | The wait is random and at most 30 s long. So neighbours that cannot hear each other do not ask in step. |
| Waiting for the first fragment | 2 gaps + 5 s | The node also waits up to 1 gap at random. Every fragment extends the wait to the rest of the block. Without an answer the node asks the next provider or 0xFFFF. After 12 requests without data it pauses. |
| Named provider sends data to others | Wait extended | It is busy, not lost: no failed attempt. |
| Neighbour requests the same block | 3 s silent | The answer to it arrives here as well. |
| Request while nobody offers data | max(30 s, 4 gaps) | Reports demand while nobody has more yet. The neighbour offers at once after its next checked page. |
| Start serving | 50 to 1000 ms | For a request to everybody (0xFFFF), one node starts first. |
| Channel busy | 20 ms, then again | First hear what the neighbour sends, then pick an own fragment. |
| Pull paused | 100 gaps, at least 20 min | The node pauses when neither an offer nor data came for that long. At 0.3 %, that is 10.6 h calculated. Nobody has the campaign any more. At the next offer the node resumes the pull. |
| Manifest damaged 3× | Skip for 10 min | No permanent ban because of a poor link. |
| Offer flood | at most 1 a day, then 1 a week | A provider floods its offer once it has the whole campaign. The daily limit holds in the first week and 1 week after a heard request. After that, the weekly limit holds: at most once a week. The weeks count its running time. In the weekly phase, a heard flood of the same campaign holds it back at most 2 times in a row. Then it floods again 3 weeks after its last flood at the latest. The rules are under Who passes on what, and what never. |
| Holding back the offer flood | up to 3 days | In the first week and 1 week after a heard request, a heard flood of the same campaign holds it back up to 3 days. The 3 days count from its last flood or the last weekly period it held back. After that it floods despite a heard flood, at its next planned time. Only a flood from its region with at most 5 hops holds it back. The rules are under Who passes on what, and what never. |
| Retract | up to 3 times, plus 1 flood | A node sends the retract up to 3 times to direct neighbours. It also floods it once, after waiting 2 to 30 min. It answers offers of the retracted build with the retract at most every 30 s. If an offer was flooded, it answers with a flood after up to 30 min. It does so at most once a day per retract. The paragraph below the table explains the sends to neighbours. |
| Apply | ~10 s build, 30 to 39 s swap | measured: build on the release image (9 November 2026), swap on the test image (18 October 2026). The node is offline for about 1 min meanwhile, measured on the test image, not on the release image. |
| Test boot | Watchdog 30 s, confirmation 60 s | Confirmation needs 60 s and a radio sign of life (one packet received, one sent). Both must come within the deadline T. T is between 15 minutes and 6 hours. Without a day of uptime before the update it is 60 minutes checked in the code. After 3 test boots without confirmation the node reverts to the old firmware. If only the sign of life is missing, there is no ban. A new try waits checked in the code. On the bench a node received no packet in 18 minutes measured. In a mesh with normal traffic this has not been checked open. |
Ein Knoten sendet einen Retract frühestens 0,3 bis 2 s, nachdem er ihn geprüft hat. Die zweite Sendung kommt frühestens 10 bis 20 s danach. Die dritte kommt frühestens 20 bis 40 s nach der zweiten im Code geprüft. Hört er einen Nachbarn denselben Retract senden, lässt er eine Sendung aus.
Jede Sendung wartet außerdem auf das Airtime-Budget. Bei 0,3 % und SF8 wartet er nach einem Retract 211 s (bei CR 4/8 301 s) berechnet. Im Testaufbau hatte er gerade ein Datenpaket gesendet. Die erste Sendung kam darum erst nach 6,0 s gemessen. Ein gezielter Lauf bestätigte das: mit Last 5,4 s (27. Oktober und 3. November 2026), das ist der Rest des Sendebudgets von 6,43 s minus 1,0 s seit dem letzten Fragment. Ohne Last waren es 0,4 s und 1,3 s gemessen.
Die Flut ist eine eigene Sendung. Der Knoten wartet vorher zufällig 2 bis 30 min. Hört er in der Zeit dieselbe Flut aus seiner Region mit höchstens 5 Hops, sendet er keine im Code geprüft.
A node sends a retract at the earliest 0.3 to 2 s after it has verified it. The second send comes at the earliest 10 to 20 s later. The third comes at the earliest 20 to 40 s after the second checked in the code. If it hears a neighbour send the same retract, it skips one send.
Each send also waits for the airtime budget. At 0.3 % and SF8 it waits 211 s (301 s at CR 4/8) after a retract calculated. On the bench it had just sent a data packet. So the first send came only after 6.0 s measured. A targeted run confirmed this: 5.4 s under load (27 October and 3 November 2026), which is the rest of the 6.43 s send budget minus 1.0 s since the last fragment. Without load it was 0.4 s and 1.3 s measured.
The flood is a send of its own. The node first waits 2 to 30 min at random. If it hears the same flood from its own region with at most 5 hops in that time, it sends none checked in the code.