Betaflight Lua Script: Einstellungen über den Sender

Der erste Flug mit dem neuen Quad zeigt zu weiche Rates, und der Laptop liegt zu Hause. Genau für diese Situation gibt es das Lua-Script von Betaflight: Es bringt die Einstellungen des Flight Controllers auf das Display der Fernsteuerung, ohne dass ein Kabel im Spiel ist. Wie die Verbindung zustande kommt, was der Sender dafür mitbringen muss und welche Werte sich am Feld sinnvoll ändern lassen.

Das Wichtigste in Kürze

• Das Script zeigt und ändert Flight-Controller-Einstellungen am Sender: PIDs, Rates, Filter, Flugmodi, VTX.
• Die Daten laufen über den Rückkanal der Funkstrecke, es wird kein Kabel angeschlossen.
• Voraussetzung: EdgeTX ab 2.4.0 oder OpenTX ab 2.3.12, dazu aktive Telemetrie.
• Baudrate 400K bei ExpressLRS, Crossfire und Tracer, sonst ist die Strecke zu langsam.
• Nach der Installation liegt bf.lua im Ordner SCRIPTS/TOOLS der SD-Karte.

Was sich damit erledigen lässt

Das Script bildet einen großen Teil dessen ab, was sonst der Configurator am Rechner leistet. Praktisch relevant sind vier Bereiche.

PID-Werte. Sämtliche Regleranteile für Roll, Pitch und Yaw lassen sich anzeigen und verändern. Wer nach dem ersten Flug merkt, dass der Quad nachschwingt, kann direkt reagieren, statt den Tag zu vertagen.

Rates. Die Umrechnung von Knüppelweg in Drehrate ist der Wert, der sich beim Einfliegen am häufigsten ändert. Zusammenhänge und Startwerte stehen im Ratgeber zu Rates und Expo.

Filter. Die Filtereinstellungen sind erreichbar, gehören aber zu den Werten, die man besser am Rechner mit Blackbox-Daten anfasst.

VTX-Einstellungen. Kanal, Band und Sendeleistung lassen sich umstellen, ohne den Quad anzufassen. Das setzt eine passende VTX-Tabelle voraus, und das Herunterladen dieser Tabelle über die Funkstrecke dauert je nach Protokoll spürbar.

Warum das ohne Kabel funktioniert

Eine moderne Funkstrecke überträgt nicht nur vom Sender zum Quad. Sie hat einen Rückkanal, über den normalerweise Telemetriewerte wie Akkuspannung und Empfangsqualität zurücklaufen. Genau diesen Kanal nutzt das Lua-Script, um Anfragen hinzuschicken und Antworten entgegenzunehmen.

Daraus folgt die wichtigste Voraussetzung überhaupt: Ohne funktionierende Telemetrie tut das Script nichts. Der Empfänger muss in Betaflight so eingerichtet sein, dass er Werte zurückmeldet, und der Sender muss diese Sensoren erkannt haben. Ein Blick auf die Telemetrieseite der Fernsteuerung beantwortet das in Sekunden: Stehen dort Werte, ist der Weg frei.

Die zweite Folge ist die Geschwindigkeit. Der Rückkanal ist schmal, und deshalb baut sich eine Seite im Script spürbar langsamer auf als im Configurator. Bei ExpressLRS, Crossfire und Tracer gehört die Baudrate im Sender deshalb auf 400K.

Voraussetzungen im Überblick

Auf Sendern mit Farbdisplay und EdgeTX ab 2.11.7 beziehungsweise 2.12.1 nutzt das Script eine neuere Oberfläche mit Auswahlfeldern und gewohnter Seitennavigation. Auf einfarbigen Displays bleibt das klassische Layout, der Funktionsumfang ist derselbe. Wie die Sender-Firmware aktualisiert wird, steht am Beispiel im Ratgeber zum Radiomaster Firmware-Update.

Installation auf der SD-Karte

Die Installation besteht aus vier Schritten und ist in fünf Minuten erledigt.

1. Release herunterladen. Auf der Release-Seite des offiziellen Projekts liegt ein fertiges Zip-Archiv. Wichtig: Nicht den Inhalt des Repositorys kopieren, dort fehlen die vorbereiteten Dateien.

2. Archiv entpacken. Im Archiv steckt ein Ordner namens obj. Nur dessen Inhalt wird gebraucht.

3. Auf die SD-Karte kopieren. Den Inhalt von obj in das Wurzelverzeichnis der SD-Karte ziehen. Der mitgelieferte Ordner SCRIPTS verschmilzt dabei mit dem vorhandenen, die Dateien landen so automatisch an der richtigen Stelle.

4. Kontrollieren. Nach dem Kopieren muss die Datei bf.lua im Verzeichnis SCRIPTS/TOOLS liegen. Ist das der Fall, war der Rest richtig.

Bei einem Update auf eine neuere Version wird derselbe Weg gegangen, die alten Dateien werden dabei überschrieben.

Aufruf und Bedienung

Im Systemmenü der Fernsteuerung liegt der Punkt Tools. Dort erscheinen nach der Installation die Einträge des Scripts. Ausgewählt wird mit der Bestätigungstaste.

Damit überhaupt Daten kommen, müssen zwei Dinge zutreffen: Der Quad hängt am Akku, und die Funkverbindung steht. Der Propeller-Hinweis gilt hier genauso wie bei jeder Arbeit am armierten Quad: Die Propeller bleiben ab, solange am Aufbau gearbeitet wird.

Die Bedienung folgt der Logik des Senders. Mit den Navigationstasten wird zwischen den Seiten und Zeilen gewechselt, ein langer Druck öffnet das Menü mit den Befehlen zum Speichern und Neuladen. Änderungen gelten erst nach dem Speichern, und ein Neuladen holt den tatsächlichen Zustand des Flight Controllers zurück auf das Display. Wer sich unsicher ist, ob ein Wert angekommen ist, lädt neu und liest ihn ab.

Betaflight Setup und Betaflight CMS

Das Projekt liefert zwei Werkzeuge, die verschiedene Wege gehen.

Betaflight Setup ist die eigenständige Oberfläche. Sie fragt die Einstellungen über das MSP-Protokoll ab und sortiert sie auf Seiten, die thematisch aufgebaut sind. Dieses Werkzeug funktioniert mit allen unterstützten Funksystemen.

Betaflight CMS spiegelt das Menüsystem, das sonst über eine Knüppelbewegung im OSD erscheint, auf das Senderdisplay. Der Vorteil ist die vollständige Übereinstimmung mit dem OSD-Menü, der Nachteil die Einschränkung: Dieser Zugang setzt TBS Crossfire oder Tracer voraus.

Was am Feld sinnvoll ist und was nicht

Die technische Möglichkeit, alles zu ändern, macht nicht jede Änderung zu einer guten Idee.

Gut geeignet am Feld:

• Rates anpassen, wenn die Steuerung zu direkt oder zu träge wirkt
• VTX-Kanal wechseln, weil jemand anderes auf derselben Frequenz sendet
• Sendeleistung senken, sobald die Strecke kurz ist
• einen Blick auf die aktuellen Werte werfen, bevor der nächste Pack drankommt

Besser am Rechner:

• Filtereinstellungen, weil ihre Wirkung sich ohne Blackbox-Daten kaum beurteilen lässt
• größere PID-Umbauten, für die der strukturierte Weg im Ratgeber zum PID-Tuning beschrieben ist
• alles, was die Konfiguration insgesamt betrifft

Ein Grundsatz macht die Feldarbeit sicherer: Vorher sichern. Ein Backup der Konfiguration kostet eine Minute am Rechner und macht jeden missglückten Versuch am Feld folgenlos.

Was das Script nicht kann

Die Grenzen ergeben sich aus dem schmalen Rückkanal und daraus, dass kein Datenträger angeschlossen ist.

Firmware flashen. Ein Update des Flight Controllers verlangt eine USB-Verbindung und läuft über den Configurator oder den Installer. Über die Funkstrecke geht das nicht.

Blackbox-Daten lesen. Die Aufzeichnung umfasst Megabyte, der Rückkanal überträgt Bytes je Sekunde. Für die Auswertung bleibt der Weg über die Blackbox am Rechner.

Motoren testen. Der Motortest mit drehenden Propellern gehört auf die Werkbank mit Sichtkontakt, und der Configurator verlangt dafür bewusst eine Bestätigung.

Die Konfiguration sichern. Ein vollständiges Diff lässt sich über die Funkstrecke nicht abziehen. Das Backup entsteht am Rechner, bevor es zum Feld geht.

Praktisch heißt das: Das Script ist das Werkzeug für Korrekturen an bekannten Werten. Der Aufbau eines neuen Quads bleibt Arbeit am Rechner.

Die Alternative ohne Script: das OSD-Menü

Betaflight bringt ein eigenes Menü mit, das sich ohne jedes Zubehör aufrufen lässt. Der Quad hängt dafür am Akku und bleibt disarmiert, dann öffnet eine Knüppelkombination das Menü: Gas in die Mitte, Yaw nach links, Pitch nach oben. Es erscheint im OSD und wird mit den Knüppeln bedient.

Beide Wege führen zum selben Ziel. Der Unterschied liegt im Komfort: Am Senderdisplay liest sich eine Werteliste bequemer als durch die Brille, und die Navigation über Tasten ist eindeutiger als über Knüppelwege.

Wenn das Script nichts findet

Die Fehlersuche hat eine feste Reihenfolge, weil jeder Punkt den nächsten voraussetzt.

1. Hat der Quad Strom? Ohne angesteckten Akku antwortet der Flight Controller nicht. Ein per USB versorgter Aufbau reicht ebenfalls, solange die Funkstrecke steht.

2. Kommt Telemetrie an? Die Telemetrieseite des Senders zeigt es. Stehen dort keine Sensoren, gehört zuerst die Telemetrie in Betaflight und im Empfänger eingeschaltet, danach werden die Sensoren am Sender neu gesucht.

3. Stimmt die Baudrate? Bei ExpressLRS, Crossfire und Tracer muss sie auf 400K stehen. Auf einem niedrigeren Wert erscheinen Seiten gar nicht oder brechen mitten im Aufbau ab.

4. Passen die Versionen? Zu alte Firmware im Funksystem ist eine häufige Ursache. Für ExpressLRS beschreibt der Ratgeber zum ELRS Firmware-Update den Weg, und dort gilt ohnehin, dass Sender und Empfänger dieselbe Hauptversion tragen müssen.

5. Liegt die Datei richtig? bf.lua gehört nach SCRIPTS/TOOLS. Wurde der Ordner obj selbst kopiert statt sein Inhalt, taucht der Eintrag im Tools-Menü nicht auf.

Fazit: der Laptop bleibt zu Hause

Das Lua-Script ersetzt den Configurator nicht, und das soll es auch nicht. Es löst ein anderes Problem: den Moment am Feld, in dem eine Zahl offensichtlich nicht passt und der nächste Pack schon geladen ist.

Die Einrichtung ist eine einmalige Angelegenheit von wenigen Minuten, und der entscheidende Punkt daran ist die Telemetrie. Steht sie, steht auch das Script. Wer zusätzlich vor dem ersten Ausflug ein Backup der Konfiguration anlegt, kann am Feld ohne Risiko ausprobieren.