Der Deploy war grün. Der Timer hatte den gemergten Commit geholt, das Lua-Script per MAVFTP auf den Flight Controller geschoben, und die kleine fc_version.lua meldete die Soll-Signatur a3b0695ab25c. Trotzdem ließ sich der Copter nicht armen. Im Log stand eine Zeile, die es nach diesem Deploy eigentlich nicht geben durfte:
AP: Lua: Error: /APM/scripts/<script>.lua:517: too many local variables (limit is 100) in main function
AP: PreArm: Scripting: Error
Der angeschlossene ESC piepte „kein Signal“. Kein Flug.
Das ist kein exotischer ArduPilot-Fall. Es ist der Normalfall jeder Deploy-Automatik, die den Transport misst und den Empfänger glauben lässt, damit sei der Start bewiesen. Datei da, Hash richtig, Signatur richtig — und die eigentliche Nutzlast läuft nicht.
Das Problem
Der Deploy läuft alle 120 Sekunden. Ein Timer auf dem Companion prüft, ob sich im Repository etwas geändert hat, macht einen harten Reset auf origin/main und überträgt per MAVFTP ausschließlich Lua-Dateien nach APM/scripts/. Keine Parameter, keine Firmware, kein manueller Upload.
Als Beweis dient eine Signatur über alle Lua-Dateien. Der Deploy berechnet sie, schreibt sie in eine winzige Datei fc_version.lua und lädt die mit hoch. Diese Datei sendet alle 20 Sekunden einen Statustext FCVER <sig>. Ein Listener am MAVProxy-Ausgang liest ihn mit, und das Monitoring vergleicht den gemeldeten Wert mit der Soll-Signatur.
Das klingt nach einem sauberen Ende-zu-Ende-Beweis. Es ist einer für alles, was in fc_version.lua steht. Und fc_version.lua ist ein Einzeiler.
Ein Dateihash belegt, was auf der SD-Karte liegt. Er belegt nicht, was der Lua-Interpreter auf dem Flight Controller daraus gemacht hat. Zwischen „Datei angekommen“ und „Code läuft“ liegt der Compiler — und der hat auf einem Flight Controller andere Grenzen als auf dem Laptop.
Die Diagnose
Die Fehlerzeile war eindeutig, ihr Zustandekommen nicht. luac5.3 -p auf dem Host war grün. Die Datei war vollständig, der Upload sauber, die Signatur korrekt. Drei Prüfungen, drei Mal grün, und das Gerät lief trotzdem nicht.
Also habe ich den Zähler nachgebaut, den der Lua-Parser selbst verwendet. Nicht die Zahl der local-Schlüsselwörter im Text, sondern die Zahl der aktiven lokalen Variablen im Haupt-Chunk zu jedem Zeitpunkt. Der Unterschied ist wichtig: Ein do-Block gibt seine Locals am Ende wieder frei. Zwei Blöcke mit je 100 Locals hintereinander sind kein Verstoß, ein einziger Block mit 103 schon.
Das Ergebnis: Der gemergte Stand hatte 103 aktive Locals im Haupt-Chunk. Der Stand ohne den optionalen Klassifizierer, der den Fehler ausgelöst hatte, kam auf 95. Die Gegenprobe gegen den alten Commit lieferte erwartungsgemäß 103 → FAIL. Der Zähler war nicht das Problem.
Die Sofortmaßnahme war ein Rollback auf den vorherigen Commit. Der Deploy übertrug wieder den alten Stand, der Flight Controller bestätigte 2185af682a1a. Der letzte Scripting: Error im Log stammt von 14:43:20, also von vor dem Reload. Danach war er weg, und der Aktor meldete sich wieder.
Bemerkenswert ist, was der Deploy vorher gemeldet hatte. Er war nicht stumm gescheitert. Er hatte Erfolg gemeldet, weil die Soll-Signatur zurückkam — von der kleinen Datei, die gar nicht das Script war, um das es ging. Die Aussage „ändert das Flugverhalten nicht“ war damit ebenfalls falsch. Das Script lud nicht, es konnte kein Verhalten ändern.
Die Ursache
ArduPilot vendort Lua 5.3.6 in libraries/AP_Scripting/lua. Der Commit 6e7367b86fab vom 17. Juli 2019 („Reduce lua stack usage“) senkte dort zwei Grenzen: MAXVARS von 200 auf 100 und MAXUPVAL von 255 auf 127. Erst der Revert 720771a72398 vom 7. September 2026 hob beide wieder an.
Das geflogene Firmware-Image ist älter als dieser Revert. Für dieses Gerät gelten also 100 Locals pro Funktion und 127 Upvalues. Das ist keine Lua-Standardgrenze und auch keine Eigenschaft des Quelltextes. Es ist eine Grenze der Firmware, die gerade auf dem Flash liegt.
Und hier kommt der Teil, der die grüne Prüfung erklärt: Das Standard-luac aus der Distribution prüft gegen MAXVARS = 200. Eine Datei mit 103 aktiven Locals ist für dieses Werkzeug völlig unauffällig. Es kompiliert sie ohne Warnung. luac5.3 -p prüft Syntax gegen die Referenzimplementierung, nicht gegen das ArduPilot-Binary auf dem Flight Controller.
Die Grenze gilt pro Funktion, nicht pro Datei. Beim Haupt-Chunk ist „Funktion“ der ganze Chunk. Deshalb reicht ein einziger zusätzlicher Klassifizierer im Hauptteil, um ein Script zu sprengen, das vorher monatelang lief. Nicht weil viel Code dazukam, sondern weil der Code an der falschen Stelle deklariert wurde.
Ein Widerspruch gehört an dieser Stelle ehrlich benannt. In meiner eigenen Notiz stand „ArduPilot erlaubt 255“. Das ist der Upstream-Stand nach dem Revert. Es ist nicht der Stand der Firmware, die auf diesem Gerät lief. Ich hatte die Doku gegen das Repository gelesen, nicht gegen das Image auf dem Flight Controller. Beides ist „ArduPilot“, aber nur eines davon ist die Grenze, an der der Deploy scheitert.
Der zweite grüne Beweis: Heap
Am selben Tag kam derselbe Mechanismus ein zweites Mal, nur mit einer anderen Ressource. Diesmal war der Klassifizierer als eine Tabelle gebaut, nicht als acht einzelne Locals. Der Guard war grün, der Haupt-Chunk hatte genau eine zusätzliche Local. Und das Script lud trotzdem nicht:
Lua: not enough mem, increase SCR_HEAP_SIZE
PreArm: Scripting: not enough mem
fc_version.lua bestätigte trotzdem 4e27a6322615. Wieder grün, wieder falsch. Die kleine Datei passt in jeden Heap; das eigentliche Script nicht. Nach dem Anheben von SCR_HEAP_SIZE von 131072 auf 204800 lud es.
Die Lehre daraus ist unbequem: Ein Beweis, der von einem winzigen Helfer erzeugt wird, gilt nur für den Helfer. Die Erfolgsbedingung wurde deshalb erweitert. Ein Deploy gilt erst, wenn zwei Dinge eintreffen: die FCVER-Signatur und ein Statustext aus dem eigentlichen Script. Erst der zweite sagt, dass der große Codeblock tatsächlich geladen wurde und läuft.
Die halbe Datei
Die dritte Lücke war kein Compiler- und kein Heap-Problem, sondern ein Transportproblem. Ein abgebrochener MAVFTP-Transfer kann eine teilweise geschriebene .lua auf dem Flight Controller hinterlassen. cmd_put oder process_ftp_reply laufen in einen Timeout, der Upload gilt als fehlgeschlagen — aber die halbe Datei liegt schon da.
Im Log sah das so aus:
Lua: Error: … syntax error near 'der'
Der Aktor war wieder ohne Signal. Der entscheidende Unterschied zum Signatur-Timeout: Hier ist die Ursache bekannt. Auf einen 30-Sekunden-Timeout zu warten, um dann festzustellen, dass die neue Signatur nicht kommt, ist verlorene Zeit. Der Deploy schreibt in diesem Fall sofort den known-good-Stand zurück und toggelt SCR_ENABLE, statt erst den Timeout abzuwarten. Eine kaputte Datei bleibt nicht liegen, und die defekte Signatur wird markiert, damit derselbe Commit nicht erneut hochgeladen wird.
Der Fix
Der Deploy ist jetzt fail-closed. Der Lauf startet mit deploy.status=0 und setzt 1 nur auf ausdrücklich vorgesehenen Pfaden: nichts zu tun, Flight Controller nicht angeschlossen, oder armed. Alles andere ist ein Fehler, auch eine Exception.
Der Kern ist die Bestätigung. Erfolg gibt es erst, wenn der Flight Controller die neue Signatur meldet, standardmäßig innerhalb von 30 Sekunden. Die Fälle danach sind bewusst getrennt:
| Fall | Reaktion |
|---|---|
| FC meldet alte Signatur, known-good vorhanden | genau ein Rollback, danach erneut auf die alte Signatur warten |
| FC meldet alte Signatur, kein known-good | kein Rollback, Alarm „kein known-good“ |
| FC antwortet gar nicht | kein Rollback, Alarm „FC antwortet nicht“ |
| Fluggerät ist armed | kein Reload, kein Eingriff im Flug |
| Upload bricht ab | sofortiger Rollback, nicht erst der Signatur-Timeout |
Hashes und der known-good-Spiegel werden erst nach der Bestätigung fortgeschrieben. Sonst würde ein fehlgeschlagener Upload den letzten funktionierenden Stand überschreiben — und der Rollback hätte nichts, wohin er zurückrollen könnte.
Vor dem Merge sitzt ein zweiter Guard. Er ist ein reiner Python-Scope-Walk, der die Parser-Semantik von Lua 5.3 nachbaut: new_localvar, adjustlocalvars, removevars, inklusive der versteckten Kontrollvariablen einer for-Schleife und der Unterscheidung zwischen angekündigten und bereits aktiven Locals. Kein externes Werkzeug außer python3, damit es keinen stillen Überspring-Pfad gibt. Syntaxfehler, Lesefehler oder fehlende Zieldateien sind FAIL.
Validiert wurde der Guard gegen einen eigens gebauten luac mit den ArduPilot-Werten MAXVARS=100 und MAXUPVAL=127. Auf allen Repository-Scripts und über 1400 Zufallsprogrammen lieferte er dieselben Ergebnisse. Die Unit-Tests sind eindeutig: 101 aktive Locals = FAIL, 100 = PASS, zwei aufeinanderfolgende do-Blöcke mit je 100 = PASS. Der naive Zähler würde dort 200 melden und falsch blocken.
Der Deploy-Daemon läuft auf dem Companion. Wer diesen Teil nachbaut, kommt mit einem Raspberry Pi 5 8GB hin; die Arbeit ist ein Timer, ein Git-Reset und ein MAVFTP-Upload, keine Rechenlast. Der Deploy-Host, der den Soll-Hash aus dem Repository berechnet und die Signatur gegenprüft, braucht ebenfalls nicht mehr: ein gebrauchter Mini-PC wie ein Lenovo ThinkCentre M720q Tiny (i5-8400T, 16 GB, generalüberholt) reicht dafür. Wer dort zusätzlich baut oder mehrere Backends betreibt, greift zur oberen Klasse Minisforum MS-01 (i5-12600H, Barebone ohne RAM/SSD).
Was du mitnimmst
Die Datei auf der SD-Karte ist kein Beweis. Der Hash ist kein Beweis. Die Signatur einer winzigen Versionsdatei ist kein Beweis. Ein Flight Controller ist erst überzeugt, wenn er den Code, um den es geht, selbst quittiert — per Signatur und per Lebenszeichen aus dem Script.
Die 100 Locals sind dabei nur ein Beispiel für eine ganze Klasse von Fehlern: Grenzen, die zur Laufzeitumgebung gehören und nicht zur Sprache. Heap ist die zweite, eine halb geschriebene Datei die dritte. Alle drei sehen von außen gleich aus: Deploy grün, Gerät tot.
Wer das einmal hatte, baut die Prüfung nicht mehr um den Transport, sondern um den Empfänger. Der Unterschied ist ungefähr der zwischen „das Paket ist angekommen“ und „der Droid hat den Hyperraumantrieb tatsächlich gestartet“. Das eine kann man tracken, das andere muss das Gerät selbst melden.