Betaflight-Backup: diff all sichern und zurückspielen
Bevor du Rates änderst, einen Preset einspielst oder neue Firmware flashst, sicherst du deine Einstellungen. Dafür reicht ein Befehl in der Kommandozeile der Betaflight-App: diff all. Hier steht, wie du die Ausgabe als Datei speicherst und zurückspielst, wann dump passt und warum du nach einem Firmware-Update nicht einfach alles einfügst. Geprüft gegen den Quellcode von Betaflight 2026.6.2 (Firmware und App) und die Betaflight-Doku, Stand 12. November 2026.
Sichern in vier Schritten
Der Setup Guide der Betaflight-Doku sagt es knapp: „Bevor du etwas änderst, sichere deine aktuelle Konfiguration.“1 In der Betaflight-App 2026.6 geht das so:
- Verbinden: Drohne per USB-Datenkabel an den Computer, in der App auf „Verbinden“, Akku ab. Die App rät selbst, vor Befehlen in der Kommandozeile keinen Akku anzuschließen, weil manche Befehle die Motoren anlaufen lassen können.
- Fenster leeren: Tab „Kommandozeile“ öffnen und unten auf „CLI-Ausgaben löschen“ klicken. „In Datei speichern“ nimmt alles, was im Fenster steht (
useCli.js); so landet in der Datei nur das Backup. - Befehl senden:
diff alleintippen und Enter drücken. Fertig ist die Ausgabe, wenn am Endesavesteht. - Speichern: „In Datei speichern“ klicken. Die App schlägt eine .txt-Datei vor, deren Name den Namen der Drohne (Craft name), Datum und Uhrzeit enthält. Alternativ „In die Zwischenablage kopieren“ und in eine Textdatei einfügen.
# Ziel-Drohne: <Name deiner Drohne> diff all
Alles hinter # ist ein Kommentar, Betaflight ignoriert es (cli.c). Beim Sichern änderst du nichts. Klickst du danach auf „Trennen“ oder wechselst den Tab, schickt die App exit und der Flugcontroller (FC) startet neu, verloren geht dabei nichts. Leg die Datei zusätzlich an einen zweiten Ort, etwa auf einen USB-Stick.
Was in der Datei steht
diff all gibt nur aus, was vom Standard abweicht, aber für alle Profile. Die Ausgabe ist gleich ein Skript zum Zurückspielen. Der Aufbau laut Quellcode (cli.c, Funktion printConfig):
| Zeile in der Datei | Was sie tut |
|---|---|
# version, darunter # Betaflight / … MSP API: … | Kommentar mit Firmware-Version, Ziel (Target), Build-Datum und MSP-Version. Dieselbe Zeile zeigt der Befehl version. |
batch start | Startet eine Batch: Betaflight merkt sich jeden Fehler bis zum save am Ende. |
defaults nosave | Setzt alles auf den Standard zurück, ohne zu speichern und ohne Neustart. Danach kommen nur deine Abweichungen dazu. |
board_name …, manufacturer_id …, mcu_id … | Board und Hersteller (nur wenn gesetzt) und die Kennung des Prozessors. mcu_id zeigt nur an, es ändert nichts. |
# name: … | Name der Drohne (Craft name) als Kommentar. |
feature …, serial …, aux …, set … = … | Alles außerhalb der Profile, etwa Ports, Modi und OSD, jeweils nur, was vom Standard abweicht. |
profile … mit set … = … | Jedes PID-Profil mit seinen Abweichungen, danach wieder dein aktives Profil. Die CLI zählt ab 0: profile 0 ist in der App Profil 1. |
rateprofile …, battery_profile … | Jedes Ratenprofil und jedes Akku-Profil, danach wieder deine aktive Auswahl. |
save | Speichert und startet den FC neu. |
diff oder dump? Wann was
Alle Befehle stehen so in der Hilfe der CLI (cli.c): diff listet „configuration changes from default“, dump die ganze Konfiguration.
| Befehl | Was drin ist | Wofür |
|---|---|---|
diff all | Abweichungen vom Standard, alle PID-, Raten- und Akku-Profile | Das Backup. Setzt beim Zurückspielen erst alles zurück und endet mit save. |
diff | Abweichungen, nur die aktiven Profile | Schneller Blick, was du geändert hast. Setzt nichts zurück, endet ohne save. |
dump all | Jeder Wert, auch Standardwerte, alle Profile | Zwei Stände Zeile für Zeile vergleichen. Endet mit save, setzt aber nichts zurück. |
dump | Jeder Wert, nur die aktiven Profile | Wie dump all, kürzer. Endet ohne save. |
diff rates | Nur das aktive Ratenprofil | Deine Rates nachschauen. |
Zum Sichern nimmst du diff all: kurz, mit allen Profilen und schon als Skript gebaut. Zwei Zusätze gibt es für diff und dump: defaults (etwa diff all defaults) schreibt über jede geänderte Zeile den Standardwert als Kommentar, bare lässt batch, defaults nosave, save und mcu_id weg.
Zurückspielen auf dieselbe Firmware-Version
- Version prüfen: In der Kommandozeile
versioneingeben. Die Versionsnummer darin muss dieselbe sein wie in der Versionszeile oben in deiner Datei. Ist sie anders, lies erst den Abschnitt zum Firmware-Update. - Datei laden: „Aus Datei laden“ klicken und die .txt-Datei wählen. Die App zeigt den Inhalt erst in einer Vorschau: „Du kannst Befehle vor der Ausführung überprüfen und bearbeiten.“ Mit „Ausführen“ schickt sie ihn Zeile für Zeile an den FC. Oder du kopierst den Inhalt in das Eingabefeld und drückst Enter.
- Laufen lassen:
defaults nosavesetzt zurück, deine Zeilen kommen dazu,savespeichert und startet neu. - Prüfen: Neu verbinden und die Tabs durchsehen, vor allem Empfänger, Modi und Motoren. Armt die Drohne danach nicht, zeigt
statusden Grund; die Liste aller Gründe steht in Drohne armt nicht: alle Arming-Flags.
# Ziel-Drohne: <Name deiner Drohne> # 1. Version anzeigen, mit der Versionszeile oben in deiner Datei vergleichen version # 2. Danach den ganzen Inhalt deiner Datei einfügen und Enter drücken. # Er beginnt mit batch start und endet mit save.
Wenn eine Zeile nicht passt
Jeden Fehler zeigt die CLI als Zeile mit ###ERROR IN …###: INVALID NAME für eine Einstellung, die es nicht gibt, INVALID VALUE mit dem erlaubten Bereich für einen Wert außerhalb davon, UNKNOWN COMMAND, TRY 'HELP' für einen unbekannten Befehl (cli.c). Weil diff all als Batch läuft, speichert das save am Ende dann nicht: Betaflight meldet ERRORS WERE DETECTED - PLEASE REVIEW BEFORE CONTINUING und PLEASE FIX ERRORS THEN 'SAVE' (cli.c).
Der FC hat die Datei dann halb übernommen, aber nichts gespeichert. Gib exit ein: Er startet neu und hat wieder den alten Stand („leaving CLI mode, unsaved changes lost“). Dann die Zeile mit dem Fehler in der Datei korrigieren oder löschen und die Datei neu laden.
Datei von einem anderen Flugcontroller
Hier scheitert oft schon die Zeile board_name: Ist auf dem neuen FC ein anderer Boardname gespeichert, meldet Betaflight BOARD_NAME CANNOT BE CHANGED, und das save am Ende greift nicht (cli.c). Richte einen neuen FC deshalb so ein wie nach einem Update: von Hand, mit der alten Datei als Spickzettel, und übernimm nur einzelne Teile.
Wie gut passen deine Rates zu deinem Stick? Der Gratis-Check misst es an deinem Blackbox-Log. Ohne Konto, die Datei bleibt bei dir.
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
Nach einem Firmware-Update: nicht blind alles einfügen
Die CLI-Seite der Doku ist eindeutig: „Füge nie einen diff oder dump aus einer Firmware-Version in eine andere ein. Parameternamen und gültige Bereiche ändern sich zwischen den Versionen, und die Konfiguration wird unbemerkt beschädigt.“2 Die Seite zum Firmware Flasher formuliert es weicher: „Grundsätzlich empfehlen wir, alles von Hand neu einzurichten. Wird von derselben Punktversion geflasht, ist es meist in Ordnung, einen gespeicherten Preset zu importieren oder einen diff einzufügen. Teile eines diff lassen sich auch gezielt in die CLI einfügen, etwa die VTX-Tabelle oder die Modi und aux-Einstellungen.“3
Zwei Beispiele, warum. In Betaflight 2026.6 ist die Einstellung pos_hold_without_mag weggefallen, die es in 2025.12 noch gab; laut den Release Notes 2026.6 wird ein gespeicherter diff, der sie enthält, beim Einspielen abgelehnt, die CLI meldet INVALID NAME. Gefährlich wird ein diff aus Betaflight vor 4.3 bei den Rates. Die Doku zu 4.3 warnt: „Fügt jemand seine Betaflight-Rates-Zahlen etwa aus einem ‚diff all‘ ein, fehlt die Angabe rates_type. Dann sind Actual Rates aktiv, aber mit den CLI-Zahlen der Betaflight-Rates. Die Drohne ist nicht flugfähig!“4
So gehst du bei einem Update vor:
- Vorher sichern wie oben. Ist der FC beim Flashen normal per USB verbunden, macht die App 2026.6 ab Werk selbst ein Backup per
diff allund fragt nach dem Speicherort; brichst du das ab, flasht sie nicht (useFirmwareFlashing.js). Wie das Flashen selbst geht, steht in Betaflight-Firmware flashen und updaten. - Gleiche Version: Datei zurückspielen wie oben.
- Neue Version: In den Tabs von Hand einrichten, die alte Datei als Spickzettel daneben. Teile, die die Doku nennt, etwa die Modi (
aux) oder die VTX-Tabelle (vtxtable), fügst du gezielt in die Kommandozeile ein. Mitbatch startdavor speichert dassavenur, wenn keine Zeile einen Fehler hatte. - Rates trägst du in der App neu ein, wie in Betaflight-Rates einstellen beschrieben. Kopierst du sie doch aus der Datei, nimm die Zeile
rates_typemit, wenn sie dort steht. - Vor dem ersten Flug: „Prüfe nach dem Flashen immer, ob jede Einstellung so ist, wie sie sein soll, bevor du testfliegst.“5
# Ziel-Drohne: <Name deiner Drohne> batch start # hier die Zeilen aus deiner alten Datei einfügen, die mit aux beginnen save
Was die Betaflight-App 2026.6 selbst sichert
- Tab „Presets“: „Backup speichern“ holt ein
diff allund speichert es als .txt, „Backup laden“ spielt so eine Datei wie einen Preset ein. Bei Fehlern listet die App die betroffenen Befehle (Meldung auf Englisch: „Configuration has been applied with CLI errors“) und fragt: „Abbrechen“ (nichts wird gespeichert) oder „Trotzdem speichern“. Beides braucht Firmware 4.5.4 oder neuer (PresetsTab.vue). Vor dem Anwenden von Presets warnt die App selbst, ohne Backup gebe es keine Möglichkeit, zur vorherigen Konfiguration zurückzukehren. - Firmware Flasher: Das Backup vor dem Flashen ist ab Werk an; gab es eins, bietet die App nach erfolgreichem Flashen „Restore Backup“ an. Die Einstellung „Create a backup before flashing new target“ steht in den erweiterten Optionen, die die App nur im Expertenmodus zeigt. Beide Texte erscheinen auch in der deutschen App englisch, weil die Übersetzung fehlt.
- Tab „Backups“: Sicherungen in einem Betaflight-Konto in der Cloud, mit „Restore“ zum Zurückspielen. Den Tab gibt es nur, wenn du in der App angemeldet bist (Release Notes 2026.6).
Der Weg über die Kommandozeile braucht kein Konto, die Datei ist als Text lesbar, und er geht auch mit Firmware vor 4.5.4.
Vor dem Ändern der Rates: erst sichern
Rates änderst du in der App oder per CLI-Block. Der CLI-Block, den fpvrates mit dem Tuning-Pass ausgibt, schreibt in Ratenprofil 3 der App und lässt deine anderen Ratenprofile, wie sie sind. Gesichert wird trotzdem vorher: diff all, Datei speichern, dann einfügen. So kommst du jederzeit auf deinen alten Stand zurück. Ob deine jetzigen Rates zu deinem Stick passen, zeigt der Gratis-Check an deinem Blackbox-Log; wie du das Log aufzeichnest und ausliest, steht in Blackbox-Log einrichten und auslesen.
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):
- Betaflight-Doku: Command Line Interface (CLI), Firmware Flasher Tab, Setup Guide, 4.3 Tuning Notes, Release Notes 2026.6.
- Quellcode der Firmware:
cli.c,common_pre.h; zum Vergleichparameter_names.hin 2025.12.5. - Quellcode der App:
CliTab.vue,useCli.js,PresetsTab.vue,AutoBackup.js, deutsche Textelocales/de/messages.json.
Originalzitate (Englisch) und Quellen
Die Zitate stammen aus der englischen Betaflight-Doku. Im Text stehen sie von fpvrates übersetzt, hier im Wortlaut mit Quelle.
- “Before making any changes, back up your current configuration.” Betaflight-Doku: Setup Guide ↩
- “Never paste a diff or dump from one firmware version into a different version — variable names and valid ranges change between releases and will silently corrupt the configuration.” Betaflight-Doku: Command Line Interface (CLI) ↩
- “Generally, we recommend full manual re-configuration. When the flash is from the same point version, usually it's OK to import a saved Preset, or paste a Diff. Parts of a diff can also be selectively pasted into the CLI, eg the VTX Table, or the modes and aux settings.” Betaflight-Doku: Firmware Flasher Tab ↩
- “If a user pastes in their Betaflight rates numbers from say a 'diff all', the rates_type information will not be included. The result will be that Actual Rates will be active, but with Betaflight CLI numbers. The quad will be un-flyable!” Betaflight-Doku: Betaflight 4.3 Tuning Notes ↩
- “After flashing, always check that every setting is 'as it should be', before test flying.” Betaflight-Doku: Firmware Flasher Tab ↩
Stand: 12. November 2026 · geprüft mit Betaflight 2026.6.2