Fehler nach Firmwareupdate gezielt zurückverfolgen
09.10.2026
Nach einem Firmwareupdate lässt sich eine Regression am besten eingrenzen, wenn ein reproduzierbares Symptom mit dem bekannten funktionierenden Stand verglichen und Konfigurationsänderungen berücksichtigt werden.
Erst den Fehler einfrieren, dann ändern
Ein Drucker, der unmittelbar nach einem Firmwareupdate anders reagiert, liefert zunächst nur einen zeitlichen Zusammenhang – noch keinen Beweis, dass die neue Firmware die Ursache ist. Bevor du Einstellungen zurücksetzt oder mehrere Komponenten gleichzeitig aktualisierst, sichere den aktuellen Zustand: genaue Firmwareversion, Zeitpunkt des Updates, Druckermodell, geänderte Konfiguration und den G-Code, bei dem der Fehler auffällt. Notiere außerdem ein sichtbares Symptom statt einer Deutung: etwa „Düse fährt beim Homing weiter nach unten“ oder „Druck pausiert beim Filamentwechsel“. So bleibt später erkennbar, ob ein Vergleich wirklich dasselbe Problem prüft. Lege für den Vergleich eine möglichst konstante Ausgangslage fest. Verwende denselben Drucker, dieselbe Konfiguration, denselben G-Code und denselben Ablauf; ändere jeweils nur eine Sache. Ein Fehlervergleich wird unbrauchbar, wenn gleichzeitig Firmware, Slicerprofil, Filament oder Verkabelung geändert werden. Klippers Konfigurationshistorie weist ausdrücklich auf Änderungen hin, die nicht rückwärtskompatibel sind; daher kann eine alte Konfiguration nach dem Update selbst zum Auslöser werden, auch wenn der Firmwarecode allein nicht defekt ist. ([Klipper: Konfigurationsänderungen](https://www.klipper3d.org/Config_Changes.html))
Version und Konfiguration als Vergleichspaar behandeln
Vergleiche nicht nur „vorher“ und „nachher“ anhand des Update-Datums. Schreibe die exakten Versionsstände auf, einschließlich Hostsoftware und Controller-Firmware, wenn dein System beide Teile getrennt aktualisiert. Bewahre eine Kopie der Konfigurationsdatei auf, und vermerke, ob sich Kalibrierwerte, Makros, Sensoren oder angeschlossene Hardware seit dem letzten funktionierenden Druck geändert haben. Bei 3D-Druckern können diese Ebenen zusammenwirken: ein Host kann aktualisiert sein, während die Steuerplatine noch einen anderen Firmwarestand verwendet. Das ist bei Klipper praktisch relevant: Die FAQ rät, vor dem Upgrade die Konfigurationsänderungen zu prüfen, weil sich Einstellungen mit einer Softwareänderung anpassen müssen. Sie stellt auch klar, dass die G-Code-Befehle RESTART und FIRMWARE_RESTART keine neue Software laden. Ein Neustart, der lediglich den Fehlerzustand löscht, ist deshalb kein aussagekräftiger Rollback- oder Versionsvergleich. Folge für ein tatsächliches Update den passenden Host- und Flash-Schritten für die betroffene Komponente; nicht blind neu flashen, wenn noch unklar ist, welche Komponente sich geändert hat. ([Klipper: FAQ zum Upgrade](https://www.klipper3d.org/FAQ.html))
Releasehinweise gegen Einstellungen abgleichen
Prüfe nach dem Sichern des Ausgangszustands die Releasehinweise und die versionsbezogene Konfigurationshistorie des Firmwareprojekts. Suche nicht nur nach dem Wort „Bugfix“: Änderungen an Parametern, Befehlen, Bewegungsplanung oder Kalibrierung können ein zuvor stabiles Setup anders reagieren lassen. Klippers Änderungsseite ist ein Beispiel für eine solche Historie: Sie dokumentiert nicht nur neue Funktionen, sondern ausdrücklich inkompatible Konfigurationsänderungen. Ein Eintrag vom 16. September 2025 nennt aktualisierte Definitionen für mehrere Input Shaper. Wenn ein Druck nach einem Update etwa stärker vibriert, ist das ein Anlass, die Shaper-Einstellung und Kalibrierdaten als mögliche Kandidaten zu prüfen – aber kein Beweis, dass der Eintrag den Fehler verursacht. Passe nur den passenden Wert an, dokumentiere ihn und wiederhole den festgelegten Test. Wenn das Symptom unverändert bleibt, stelle den vorherigen Wert wieder her, bevor du einen anderen Kandidaten prüfst. ([Klipper: Konfigurationsänderungen](https://www.klipper3d.org/Config_Changes.html))
Bei verfügbarer Versionshistorie schrittweise eingrenzen
Wenn du die Firmware selbst aus einem Git-Repository baust und der Fehler in der Quellhistorie liegt, kann eine binäre Suche die Suche verkürzen. Dafür brauchst du einen bekannten guten und einen bekannten fehlerhaften Commit. Git wechselt dann zu einem Zwischenstand; dort baust du die Software und prüfst genau das vorher festgelegte Symptom. Markiere den Stand als funktionierend oder fehlerhaft und wiederhole den Ablauf. Die Git-Dokumentation beschreibt bisect als binäre Suche nach dem Commit, der einen Fehler eingeführt hat. ([Git: git-bisect](https://git-scm.com/docs/git-bisect)) Wichtig ist die Grenze: Bei einer fertigen Herstellerdatei ohne zugängliche Quellhistorie kannst du nicht auf diese Weise den auslösenden Commit finden. Vergleiche dann nur verfügbare Firmwareversionen, sofern der Hersteller sie für genau dein Modell unterstützt, und ändere nichts am Gerät, wenn ein Downgrade nicht ausdrücklich vorgesehen ist. Auch bei eigener Firmware ist ein Zwischenschritt nur aussagekräftig, wenn er sich bauen und unter möglichst gleichen Bedingungen prüfen lässt. Variiert der Fehler zufällig oder hängt er von Temperatur, Material oder mechanischem Zustand ab, kann ein einfacher gut/schlecht-Test eine falsche Grenze liefern.
Ergebnis sichern und Ursache nicht überdehnen
Halte am Ende fest, was sich tatsächlich geändert hat: Version, Konfigurationszeile, Testablauf und beobachtetes Resultat. Wenn eine einzelne Anpassung den Fehler verschwinden lässt, ist das ein starker Hinweis, aber kein allgemeiner Beleg dafür, dass dieselbe Einstellung bei anderen Druckern oder Firmwareständen ebenfalls falsch ist. Stelle nach der Eingrenzung einen sicheren, unterstützten Stand her und führe vor einem Druck mit beheiztem Bett oder Düse zunächst einen vorsichtigen Funktionstest durch. Lässt sich kein stabiler Vorher-nachher-Vergleich herstellen, benenne die Unsicherheit: Ein Firmwareupdate kann zeitgleich mit einer gelockerten Steckverbindung, geändertem Slicerprofil oder neuem Material zusammenfallen. Der hilfreiche nächste Schritt ist dann keine weitere pauschale Rücksetzung, sondern ein einzelner kontrollierter Vergleich. Diese Disziplin macht aus „seit dem Update spinnt der Drucker“ eine prüfbare Fehlerbeschreibung – und verhindert, dass eine Regression mit einer zufälligen Begleitänderung verwechselt wird.