Betaflight-Blackbox auswerten: welches Tool wofür?

Du hast einen Blackbox-Log und willst wissen, was er dir sagt? Hier steht, was Betaflight 2026.6.2 in den Log schreibt, mit welcher Spur du welche Frage beantwortest und welches Werkzeug das auswertet: der Blackbox Explorer in der Betaflight-App, PIDtoolbox, PIDscope, PID-Analyzer, FPVtune, PIDoctor und fpvrates. Belegt mit Quellcode, Betaflight-Doku und den Seiten der Werkzeuge. Wie du den Explorer bedienst, steht in Blackbox Explorer benutzen.

Kurz: welche Frage, welche Spur, welches Werkzeug

Die Spurnamen sind die aus dem Tab „Blackbox Viewer“ der Betaflight-App; sie sind dort in allen Sprachen englisch. Ein Klick auf die Frage führt zum Abschnitt.

Welche Frage du mit welcher Spur im Blackbox-Log beantwortest und welches Werkzeug sie auswertet
Deine FrageWas du im Log ansiehstWerkzeug
Passen meine Rates zu meinem Stick?RC Command und Setpoint je Achse, über den ganzen Flug gezählt; die Rates des Flugs stehen in den Kopfzeilenfpvrates (Zonen, ungenutzter Stickweg, Steilheit); Blackbox Viewer für einzelne Momente
Folgt die Drohne meinem Stick?Gyro gegen Setpoint; der Viewer rechnet daraus PID ErrorBlackbox Viewer („Error vs Setpoint“); Sprungantwort: PIDtoolbox, PIDscope, PID-Analyzer
Propwash: wackelt sie beim Sinkflug?Gyro gegen Setpoint bei Tempowechsel und Sinkflug, Gas in RC Command [throttle]Blackbox Viewer (Gyro und Setpoint übereinander, PID Error)
Zittert sie, woher kommt das Rauschen?Gyro und Unfiltered Gyro, Log-Rate 2 kHz; Debug-Modi wie RPM_FILTER oder FFT_FREQAnalyser im Blackbox Viewer (Spektrum, PSD); PIDtoolbox, PIDscope, PID-Analyzer
Welche PIDs und Filter soll ich nehmen?Gyro, Setpoint, PID-Anteile und Spektrum; für den Autotune-Tab ein Log mit Chirp-SweepWerte schlagen vor: FPVtune, PIDoctor, Autotune-Tab der Betaflight-App, PIDscope. fpvrates nicht
Kommen die Motoren an den Anschlag?Motor [1] bis [4] in %, Zeitleiste „Maximum motor differential“Blackbox Viewer
Bricht der Akku ein?Battery volt. (gesamt und je Zelle), AmperageBlackbox Viewer („Statistics“ für den tiefsten Wert)
Ich will selbst rechnen (Tabelle, Python)alle Felder als CSVCSV-Export im Blackbox Viewer; blackbox_decode aus den blackbox-tools

Zu dem, was die Blackbox aufzeichnet, schreibt die Betaflight-Doku: „Das alles wird ohne Näherung und ohne Genauigkeitsverlust gespeichert, so dass auch recht feine Probleme im Log erkennbar sein sollten.“1 Welche Spuren drin sind, hängt davon ab, was du eingeschaltet hast; mehr dazu unter Was Betaflight in den Log schreibt.

Passen deine Rates? Stick und Setpoint

RC Command ist die Stickposition, wie Betaflight sie verarbeitet, für Roll, Pitch, Yaw und Gas; seit Betaflight 4.3 ungeglättet (4.3 Tuning Notes). Setpoint ist laut Quellcode die Soll-Drehrate in °/s, die der PID-Regler bekommt, also das, was deine Rates aus der Stickposition machen (blackbox.c). Legst du beide Spuren übereinander, siehst du deine Rates-Kurve in Aktion. Mit welchen Rates der Log geflogen wurde, steht in seinen Kopfzeilen; wie du sie liest, zeigt der Explorer-Ratgeber.

Ein einzelner Moment sagt dir aber nicht, ob die Rates zu dir passen. Dafür braucht es die Verteilung: Wie oft steht dein Stick wo, wie weit gehst du im normalen Flug, wie viel Stickweg bleibt ungenutzt? Der Explorer zählt das nicht zusammen, seine „Statistics“ kennen nur Minimum, Maximum und Mittelwert (mehr dazu im Explorer-Ratgeber).

Genau das rechnet fpvrates aus demselben Log: Aus RC Command, Setpoint und Gyro misst es fünf Zonen auf deinem Stick (Fein, Präzision, normaler Flug, ungenutzt, Flips & Rolls) und ob deine Kurve zum Rand hin zu steil wird. Gewertet wird nur Acro; Angle- und Horizon-Flüge sortiert fpvrates aus, weil die Drohne dort selbst stabilisiert und die Drehung nicht direkt aus deinem Stick kommt. Der Gratis-Check zeigt dir das ohne Konto und ohne Vorschlag. Passende Actual Rates als CLI-Block für die Betaflight-App gibt es mit dem Tuning-Pass für 19 € (1 Drohne) oder 29 € (5 Drohnen), einmalig. Die Analyse läuft in deinem Browser, die Datei bleibt bei dir. Wie du Rates einstellst, steht in Betaflight-Rates einstellen.

Wie gut passen deine Rates zu deinem Stick? Der Gratis-Check misst es an deinem Blackbox-Log. Ohne Konto, die Datei bleibt bei dir.

Log gratis prüfen

Noch kein Log? Beispiel-Ergebnis ansehen · Logging einschalten, mit Bildern

Für deinen nächsten Flugtag
  • Betaflight-App, Tab Flugschreiber: Log-Gerät Flash oder SD-Karte, Log-Geschwindigkeit 1 kHz
  • RC Commands, Setpoint und Gyro an, dann „Speichern und Neustarten“
  • 3 bis 5 Akkus ganz normal Acro fliegen
  • Danach den Log von der Drohne holen und in den Gratis-Check ziehen

Folgt die Drohne? Setpoint, Gyro und Propwash

Gyro ist die Drehrate, die die Drohne tatsächlich fliegt, nach den Filtern (blackbox.c). Liegt Gyro auf Setpoint, setzt die Drohne um, was du forderst. Den Abstand rechnet der Blackbox Viewer selbst als Spur PID Error: Setpoint minus Gyro (flightlog.js). Im Analyser zeigt „Error vs Setpoint“ den mittleren Fehler je Drehrate (graph_spectrum_calc.js).

Propwash entsteht laut PID Tuning Guide der Doku bei Tempowechseln: Die Propeller erzeugen Verwirbelungen, und die Drohne wird beim Lenken unruhig, am stärksten im senkrechten Sinkflug. Die Doku bewertet Propwash danach, wie Gyro dem Setpoint folgt, und hält fest, dass auch Propwash PID Error erzeugt. Im Log suchst du also Tempowechsel und Sinkflüge, etwa die Momente nach dem Gaswegnehmen (RC Command [throttle]), und vergleichst dort Gyro mit Setpoint. Was gegen Propwash hilft, vom Flugstil bis zum D-Term, steht in Propwash: was es ist, was hilft.

Wie sauber Gyro einem schnellen Stickausschlag folgt, zeigt die Sprungantwort (Step Response). Die rechnen PIDtoolbox, PIDscope und der PID-Analyzer von Plasmatree, Letzterer laut README aus Setpoint und Gyro. Was du an PIDs änderst, steht hier bewusst nicht: fpvrates misst Rates, keine PIDs und Filter. Fliegt deine Drohne unruhig, geht Drohne zappelig: woran es liegt die Ursachen der Reihe nach durch.

Zittern und Rauschen: Gyro, Spektrum, Filter

Neben Gyro gibt es Unfiltered Gyro, die Drehrate vor den Filtern (blackbox.c). Der Unterschied zwischen beiden zeigt, was die Filter wegnehmen. Mit der Taste A öffnet der Viewer den Analyser. Er zeigt die Spektren „Frequency“, „Freq. vs Throttle“, „Freq. vs RPM“, „Power Spectral Density“, „PSD vs Throttle“ und „PSD vs RPM“ (SpectrumAnalyser.vue). Laut Betaflight-Blog zeichnet er die eingestellten Filtergrenzen ein, damit du siehst, wo sie gegenüber dem tatsächlich geloggten Rauschen liegen. Die Ansicht über der Drehzahl hilft laut Doku vor allem, wenn der RPM-Filter läuft.

Für Rauschen brauchst du eine hohe Log-Rate, siehe Log-Rate und Debug-Modus. Zusätzliche Spuren liefert ein Debug-Modus: RPM_FILTER schreibt laut Doku die Frequenz jedes Motors, wie der Regler (ESC) sie meldet, FFT_FREQ laut Debug-Modes-Seite die Mittenfrequenzen der dynamischen Notch-Filter.

Spektren und Heatmaps über Gas oder Zeit zeigen auch PIDtoolbox und PIDscope, Rausch-Plots der PID-Analyzer. Die Doku empfiehlt PID Toolbox mehrfach für die Spektralanalyse, etwa auf der Seite zum RPM-Filter für Logs vor und nach einer Änderung.

Motoren und Akku

Motor [1] bis [4] ist der Ausgang an jeden Motor; der Viewer zeigt ihn in Prozent (flightlog_fields_presenter.js). Für die Zeitleiste kannst du „Maximum motor differential“ wählen, dann springst du zu den Stellen mit dem größten Unterschied zwischen den Motoren. Was das bedeutet, beschreiben die 4.2 Tuning Notes am Beispiel schneller Yaw-Befehle: Steht ein Motorpaar auf 100 % und das andere auf null, kann die Drohne nicht liefern, was du forderst.

Mit bidirektionalem DShot schreibt Betaflight die Drehzahl jedes Motors mit (RPM [1] usw.); der Viewer rechnet sie mit der Polzahl aus dem Log in U/min und Hz um. Battery volt. zeigt die Spannung gesamt und je Zelle, Amperage den Strom. Den tiefsten Wert eines Flugs findest du unter „Statistics“.

Was Betaflight in den Log schreibt

Welche Felder im Log landen, stellst du im Tab „Flugschreiber“ der App ein, im Kasten „Debug Fields included“; ab Werk sind alle an. Wie das geht, steht in Blackbox-Log einrichten und auslesen. Das steckt hinter den Schaltern (Quellcode blackbox.c, Betaflight 2026.6.2):

  • PID: P, I, D und Feedforward je Achse, im Viewer „PID P“, „PID I“, „PID D“ und „PID Feedforward“. D steht nur für Achsen drin, deren D nicht null ist. „PID Sum“ rechnet der Viewer selbst.
  • RC Commands: die Stickpositionen von Roll, Pitch, Yaw und Gas.
  • Setpoint: die Soll-Drehrate je Achse und das Gas, das der Mixer am Ende benutzt.
  • Gyro und Gyro (Unfiltered): die gemessene Drehrate nach und vor den Filtern.
  • Motor und RPM: der Ausgang an jeden Motor und, mit DShot-Telemetrie, seine Drehzahl.
  • Battery und RSSI: Spannung, Strom und Empfangsstärke.
  • Accelerometer, Attitude, Magnetometer, Altitude, GPS, Servo: Beschleunigung, Lage, Kompass, Höhe, Position und Servos.
  • Debug Log: acht Werte, deren Inhalt der Debug-Modus festlegt.

Dazu schreibt Betaflight Kopfzeilen mit den Einstellungen des Flugs: Firmware-Version, Board, Craft name, Rates, PIDs, Filter und Feedforward (blackbox.c). Laut Betaflight-Blog liest der Viewer in der App diese Kopfzeilen mit, damit die Einstellungen hinter einer Spur nie weit weg sind.

Log-Rate und Debug-Modus

Ab Werk loggt Betaflight jeden vierten Durchlauf der Regelschleife. Laut Doku gilt: „1/4 ergibt etwa 2 kHz Logging und 1/8 etwa 1 kHz. Für eine genaue Tuning-Analyse werden 2 kHz empfohlen; 1 kHz reicht für den allgemeinen Gebrauch und braucht weniger Speicher.“2 Die 4.3 Tuning Notes nennen 1 kHz für normale Zwecke und 2 kHz fürs Filter-Tuning, bei 1/16 erkennst du laut Blackbox-Doku nur noch grobe Probleme, keine Vibrationen. fpvrates reicht 1 kHz mit RC Commands, Setpoint und Gyro.

Der Debug-Modus steht ab Werk auf NONE, dann schreibt Betaflight keine Debug-Werte. Du stellst ihn im Tab „Flugschreiber“ oder per CLI mit debug_mode ein; es gilt immer nur einer. Vorsicht bei älteren Anleitungen: Der PID Tuning Guide der Doku nennt noch GYRO_SCALED, den Betaflight 2026.6.2 nicht mehr kennt (debug.c). Das ungefilterte Gyro bekommst du heute über das Feld Gyro (Unfiltered).

Die Werkzeuge im Überblick

Die Betaflight-Doku nennt im PID Tuning Guide unter „Analysis Tools“ vier Werkzeuge: Blackbox Explorer, PID Toolbox, Plasmatree und blackbox-tools. PIDscope, FPVtune und PIDoctor stehen nicht in der Doku. Preise und Stand laut den Seiten der Anbieter am 12. November 2026.

Blackbox Viewer (Blackbox Explorer) in der Betaflight-App

Zeigt laut Release Notes 2026.6 einstellbare Graphen, einen Spektrum-Analyser, die Lage der Drohne in 2D und 3D, eine GPS-Karte, Wiedergabe über die Zeit und CSV-Export. Vorschläge für Einstellungen gehören laut dieser Liste nicht dazu. Läuft unter app.betaflight.com und in den Desktop- und Mobil-Versionen der App, Open Source (GPL-3.0). Seit 2026.6 ist er ein Tab der App; der alte eigenständige Explorer ist eingefroren, sein Repository wird laut README am 1. Dezember 2026 archiviert. Bedienung: Blackbox Explorer benutzen.

Autotune-Tab der Betaflight-App

Seit 2026.6, experimentell und nur im Expertenmodus sichtbar. Er liest einen Log mit Chirp-Sweep (Flugmodus CHIRP), rechnet daraus den Frequenzgang und empfiehlt Werte für die Regler des Simplified Tuning; mit verbundenem FC schreibt „Apply Gains“ sie zurück (Release Notes 2026.6). In der deutschen App heißt der Tab „Autotune“.

blackbox-tools

Kommandozeilenprogramme von Betaflight: blackbox_decode macht aus dem Log CSV-Dateien, blackbox_render eine Bildfolge für ein Video (README). Open Source (GPL-3.0), letzter Commit am 25. Oktober 2026; fertige Downloads listet GitHub derzeit keine. Für eine Tabelle reicht meist der CSV-Export im Blackbox Viewer.

PIDtoolbox

Programm mit Log-Viewer, Sprungantwort, Spektrum, Heatmaps über Gas und Zeit und einem „PID slider tool“; die Pro-Fassung hat zusätzlich unter anderem eine Filter-Simulation und RPM- und Notch-Overlays (Funktionsliste auf Patreon vom 1. Oktober 2026). Seit Mai 2024 gibt es neue Versionen nur über Patreon: Den Download enthalten die bezahlten Stufen für 6 kanadische Dollar (Standard) oder 8 kanadische Dollar (Pro) im Monat. Laut seiner letzten GitHub-Beschreibung läuft es unter Windows und Mac. Neueste Version laut Patreon: V094 vom 2. August 2026. Das GitHub-Repository und der PIDtoolbox-Link in der Betaflight-Doku liefern inzwischen einen Fehler 404.

PIDscope

Freier Fork von PIDtoolbox auf GNU Octave: Spektren, Sprungantwort, Rausch-Heatmaps, PID-Balance und Filterverzögerung, dazu eine Autotune-Funktion nach dem Vorbild der Betaflight-App. Laut README kostenlos, ohne Pro-Stufe und ohne Abo; Open Source (GPL-3.0), für Windows, macOS und Linux. Version 26.10.1 vom 30. Oktober 2026.

PID-Analyzer (Plasmatree)

Python-Programm, das aus Setpoint und Gyro die Sprungantwort rechnet und Rausch-Plots zeigt; das Ergebnis kommt als Grafik und PNG. Es braucht blackbox_decode und gibt es als Quellcode und Windows-Programm auf GitHub. Letzte Version 0.52 vom 8. Juni 2018, laut README getestet mit Logs von Betaflight 3.x. Ob es mit aktuellen Logs läuft, steht nirgends.

FPVtune

Webdienst: Du lädst Log und CLI-Dump hoch und bekommst Werte für PIDs, Filter und Feedforward als CLI-Befehle, laut Anbieter berechnet von einem neuronalen Netz. Für Logs ab Betaflight 4.5. Laut Preisseite 9,90 US-Dollar je Tune oder ein Abo ab 19,95 US-Dollar im Monat bei jährlicher Zahlung.

PIDoctor

Webdienst für Betaflight 4.x: Diagnose mit FFT-Spektren, Filter-Wirksamkeit, Sprungantwort und Tune-Score, dazu regelbasierte Vorschläge für PIDs und Filter als CLI-Befehle, die er auch direkt auf den verbundenen FC schreiben kann (pidoctor.app). Laut Nutzungsbedingungen kostenlos, Spenden sind freiwillig. Hochgeladene Logs speichert der Anbieter laut Datenschutzerklärung unter deinem Konto auf seinem Server.

fpvrates

Misst, wie du den Stick nutzt: Zonen, ungenutzter Stickweg und ob die Kurve zum Rand hin zu steil wird. Der Gratis-Check zeigt das ohne Konto und ohne Vorschlag, der Tuning-Pass für 19 € oder 29 € einmalig gibt dir passende Actual Rates als CLI-Block, mit beliebig vielen Runden. Für Betaflight ab 4.3 mit Actual- oder Betaflight-Rates, geflogen in Acro. Die Analyse läuft in deinem Browser, die Datei bleibt bei dir. PIDs und Filter macht fpvrates bewusst nicht.

Quellen

Stand 12. November 2026, geprüft gegen Betaflight 2026.6.2 (Firmware und App vom 16. September 2026, an diesem Tag die neuesten Versionen):

Originalzitate (Englisch) und Quellen

Die Zitate stammen aus der englischen Betaflight-Doku. Im Text stehen sie von fpvrates übersetzt, hier im Wortlaut mit Quelle.

  1. “This is all stored without any approximation or loss of precision, so even quite subtle problems should be detectable from the flight data log.” Betaflight-Doku: Blackbox Flight Data Recorder ↩
  2. “1/4 gives approximately 2 kHz logging and 1/8 gives approximately 1 kHz. A rate of 2 kHz is recommended for detailed tuning analysis; 1 kHz is sufficient for general use and reduces storage requirements.” Betaflight-Doku: Blackbox Flight Data Recorder ↩

Stand: 12. November 2026 · geprüft mit Betaflight 2026.6.2