Klipper Firmware Update – Schritt-für-Schritt-Anleitung (2026)

Warum ein vollständiges Firmware-Update nötig ist

Klipper besteht aus mehreren Komponenten: der Host-Software auf dem Raspberry Pi und der Firmware auf jeder angeschlossenen MCU. Bei einem Update müssen alle MCUs exakt die gleiche Firmware-Version erhalten. Stimmen die Versionen nicht überein, quittiert Klipper den Dienst mit einem gefürchteten „Protocol Error”.

Diese Anleitung zeigt den kompletten Ablauf am Beispiel eines typischen Setups:

• Mainboard: BTT Octopus Pro (STM32F429) via USB
• Probe: BTT Eddy USB (RP2040) via USB
• Toolboard: EBB / SB2209 o. ä. (STM32G0B1) via CAN-Bus
• Host-MCU: Raspberry Pi (Linux process)

Tipp: Falls dein Setup andere Hardware nutzt, passe die Prozessor- und Interface-Einstellungen entsprechend an – die Grundstruktur bleibt identisch.

---

Schritt 1: Host-System (Raspberry Pi) aktualisieren

Bevor die Hardware geflasht wird, muss die Klipper-Software auf dem Pi aktuell sein. Immer zuerst den Host, dann die MCUs.

1.1 Klipper-Update einspielen

cd ~/klipper
git pull
sudo service klipper restart

1.2 Linux-MCU ([mcu rpi]) flashen

Viele Setups nutzen den Pi selbst als MCU – z. B. für ADXL345-Beschleunigungssensoren oder GPIO-Steuerung. Diese MCU muss ebenfalls neu kompiliert werden, sonst kommt es zum Protocol-Error.

cd ~/klipper
make menuconfig

menuconfig-Einstellungen:

Einstellung	Wert
Micro-controller Architecture	Linux process

Das ist die einzige Option – es gibt hier keine weiteren Untermenüs. Bestätigen und speichern.

make clean && make
make flash

Der Pi flasht sich damit selbst. Kein Neustart nötig, Klipper wird automatisch die neue Version laden.

---

Schritt 2: Mainboard flashen (BTT Octopus Pro – STM32F429)

Das Octopus Pro ist per USB mit dem Pi verbunden. Es nutzt einen STM32F429-Chip mit 32 KiB Bootloader.

2.1 menuconfig konfigurieren

cd ~/klipper
make menuconfig

menuconfig-Einstellungen im Detail:

Einstellung	Wert	Erklärung
Micro-controller Architecture	STMicroelectronics STM32	Die STM32-Familie von ST
Processor model	STM32F429	Der Chip auf dem Octopus Pro. Beim Octopus V1.1 wäre es z. B. STM32F446
Bootloader offset	32KiB bootloader	Der Octopus Pro hat einen 32 KiB Bootloader. Falscher Offset = Board bootet nicht!
Clock Reference	8 MHz crystal	Externer Quarz auf dem Board. Manche Boards nutzen 12 MHz – Board-Dokumentation prüfen
Communication interface	USB (on PA11/PA12)	Die USB-Pins des Octopus Pro. Andere Boards können andere Pins nutzen (z. B. PA9/PA10)

Warum ist der Bootloader-Offset wichtig? Der Bootloader belegt die ersten Bytes des Flash-Speichers. Klipper muss wissen, ab welcher Adresse die eigentliche Firmware beginnt. Ein falscher Offset überschreibt den Bootloader und das Board startet nicht mehr (Rettung dann nur per DFU oder ST-Link).

2.2 Kompilieren und flashen (SD-Karten-Methode)

make clean && make

Die fertige Firmware liegt unter out/klipper.bin.

Flash-Vorgang:

1. out/klipper.bin vom Pi auf deinen PC kopieren (z. B. per SCP/SFTP).
2. Die Datei in firmware.bin umbenennen – der Name ist wichtig!
3. Auf eine FAT32-formatierte SD-Karte kopieren (max. 32 GB empfohlen).
4. SD-Karte in den Slot am Octopus stecken.
5. Reset-Knopf am Board drücken (oder Stromversorgung kurz trennen).
6. Ca. 5 Sekunden warten, dann SD-Karte prüfen.

Erfolgskontrolle: Die Datei auf der SD-Karte heißt jetzt FIRMWARE.CUR statt firmware.bin. Das bestätigt, dass der Bootloader die Firmware geflasht hat.

Alternativ: Du kannst auch direkt per USB flashen, wenn du die serial-ID kennst: bash make flash FLASH_DEVICE=/dev/serial/by-id/usb-Klipper_stm32f429xx_... Die SD-Methode ist aber am zuverlässigsten und funktioniert auch bei korrupter Firmware.

---

Schritt 3: Probe flashen (BTT Eddy USB – RP2040)

Der BTT Eddy ist ein induktiver Probe mit eigenem RP2040-Chip und permanenter USB-Verbindung. Auch er braucht die passende Klipper-Firmware.

3.1 menuconfig konfigurieren

cd ~/klipper
make menuconfig

menuconfig-Einstellungen im Detail:

Einstellung	Wert	Erklärung
Micro-controller Architecture	Raspberry Pi RP2040	Der Chip im Eddy (und vielen anderen Boards wie z. B. dem Pi Pico)
Bootloader	No bootloader	Der RP2040 hat keinen permanenten Bootloader im klassischen Sinne – er wird im UF2-Boot-Modus geflasht
Flash chip	W25Q080 with generic 03h SPI	Standard-Flash-Chip auf dem Eddy. Bei den meisten RP2040-Boards korrekt
Communication interface	USB	Der Eddy hängt dauerhaft per USB am Pi

Warum „No bootloader”? Beim RP2040 wird die Firmware direkt in den Flash geschrieben. Der Boot-ROM des Chips übernimmt die Bootloader-Funktion – du musst nur den Boot-Modus manuell aktivieren.

3.2 Kompilieren und flashen

make clean && make

Boot-Modus aktivieren:

1. USB-Kabel vom Eddy trennen (oder am Pi abziehen).
2. Boot-Knopf am Eddy gedrückt halten.
3. USB-Kabel wieder einstecken (Knopf weiter halten).
4. Knopf loslassen – der Eddy meldet sich jetzt als USB-Bootloader-Device.

make flash FLASH_DEVICE=2e8a:0003

Die ID 2e8a:0003 ist die USB-ID des RP2040 im Boot-Modus. Falls unsicher:

lsusb | grep -i "2e8a"

Nach dem Flash startet der Eddy automatisch mit der neuen Firmware.

---

Schritt 4: Toolboard flashen (STM32G0B1 via CAN-Bus)

Das Toolboard (z. B. BTT EBB36/42, SB2209, Mellow FLY-SB2040) hängt am CAN-Bus. Hier muss die CAN-Bitrate exakt stimmen.

4.1 menuconfig konfigurieren

cd ~/klipper
make menuconfig

menuconfig-Einstellungen im Detail:

Einstellung	Wert	Erklärung
Micro-controller Architecture	STMicroelectronics STM32	STM32-Familie
Processor model	STM32G0B1	Der Chip auf dem Toolboard. Beim EBB36 v1.2 z. B. auch STM32G0B1, ältere Versionen ggf. STM32F072
Bootloader offset	No bootloader	Kein separater Bootloader – Klipper wird direkt geflasht. Falls Katapult installiert ist: 8KiB bootloader
Clock Reference	8 MHz crystal	Standard bei den meisten STM32-Toolboards
Communication interface	CAN bus (on PB0/PB1)	Die CAN-Pins des Toolboards. Unbedingt im Schaltplan prüfen – falsche Pins = keine Kommunikation
CAN bus speed	1000000	Deine CAN-Bitrate. Muss auf allen CAN-Teilnehmern identisch sein! Übliche Werte: 250000, 500000, 1000000

CAN-Pins – häufige Boards: - BTT EBB36/42 v1.2: PB0/PB1 - BTT SB2209: PB0/PB1 - Mellow FLY-SB2040: Nutzt RP2040 mit eigener CAN-Konfiguration

Falsche Pins sind der häufigste Fehler beim CAN-Setup! Immer die Pin-Belegung des konkreten Board-Revisions prüfen.

Zur CAN-Bitrate: Alle Geräte am CAN-Bus müssen dieselbe Bitrate verwenden – das Toolboard, das Host-Interface (can0 am Pi) und ggf. ein CAN-Bridge-Board. Typische Werte sind 500000 (500k) oder 1000000 (1M). Höhere Bitraten erlauben mehr Durchsatz, erfordern aber kurze, sauber terminierte Leitungen.

4.2 Kompilieren und flashen

make clean && make

Empfohlen: Flash über USB (Rettungsweg)

Das Flashen über CAN funktioniert nicht immer zuverlässig – insbesondere ohne Katapult-Bootloader. Schließe das Toolboard daher einmalig per USB direkt an den Pi an:

1. CAN-Kabel vom Toolboard trennen.
2. USB-Kabel zwischen Toolboard und Pi anschließen.
3. Serial-ID ermitteln:

ls /dev/serial/by-id/*

Beispielausgabe:

/dev/serial/by-id/usb-Klipper_stm32g0b1xx_12345678-if00

1. Flashen:

make flash FLASH_DEVICE=/dev/serial/by-id/usb-Klipper_stm32g0b1xx_DEINE_ID

1. USB-Kabel trennen, CAN-Kabel wieder anschließen.

Alternativ: Flash über CAN (mit Katapult/CanBoot-Bootloader)

Falls Katapult auf dem Toolboard installiert ist, kannst du direkt über den CAN-Bus flashen:

python3 ~/katapult/scripts/flash_can.py -i can0 -u DEINE_CAN_UUID -f ~/klipper/out/klipper.bin

Die CAN-UUID findest du mit:

~/klippy-env/bin/python ~/klipper/scripts/canbus_query.py can0

---

Zusammenfassung: Beispiel-Setup

Komponente	Chip	Verbindung	Identifikation
BTT Octopus Pro	STM32F429	USB	/dev/serial/by-id/usb-Klipper_stm32f429xx_...
BTT Eddy USB	RP2040	USB	/dev/serial/by-id/usb-Klipper_rp2040_...
Toolboard (EBB/SB)	STM32G0B1	CAN (1M)	UUID (z. B. 5e654f097xxx)
Raspberry Pi	Linux	Intern	n/a

---

Checkliste nach dem Flashen

1. Klipper-Dienst starten

sudo service klipper start

2. Firmware-Versionen prüfen

Öffne Mainsail oder Fluidd → Machine → System Information. Alle MCUs müssen die identische Versionskennung anzeigen, z. B.:

mcu: Klipper v0.13.0-xxx
mcu rpi: Klipper v0.13.0-xxx
mcu EBBCan: Klipper v0.13.0-xxx
mcu eddy: Klipper v0.13.0-xxx

Weicht eine Version ab, wurde diese MCU nicht korrekt geflasht.

3. CAN-Interface prüfen

ip -details link show can0

Erwartete Ausgabe:

can0: <NOARP,UP,LOWER_UP,ECHO> mtu 16 qdisc pfifo_fast state UP ...
    bitrate 1000000 sample-point 0.750

Falls can0 nicht aktiv ist, prüfe /etc/network/interfaces.d/can0:

allow-hotplug can0
iface can0 can static
    bitrate 1000000
    up ifconfig $IFACE txqueuelen 1024

Passe die bitrate an dein Setup an und starte das Interface neu:

sudo ifdown can0 && sudo ifup can0

4. Homing-Test

Führe G28 (Home All) aus – Finger am Not-Aus! So prüfst du, ob Endstops und Probe korrekt arbeiten.

5. Probe-Kalibrierung

Nach einem Firmware-Update können sich Offsets minimal ändern. Führe die Kalibrierung erneut durch:

PROBE_CALIBRATE
BED_MESH_CALIBRATE

---

Fehlerbehebung

Problem	Ursache	Lösung
„Protocol Error” nach Update	Firmware-Versionen stimmen nicht überein	Alle MCUs auf identische Version flashen
CAN-Toolboard antwortet nicht	Bitrate stimmt nicht oder Interface ist down	ip link show can0 prüfen, Bitrate vergleichen
SD-Karte: Datei bleibt firmware.bin	Board hat nicht geflasht	Andere SD-Karte probieren, FAT32 formatieren, Reset erneut drücken
make flash am RP2040 schlägt fehl	Boot-Modus nicht aktiv	Knopf beim Einstecken gedrückt halten, lsusb prüfen
make flash am Toolboard via USB: „No device found”	Falscher Device-Pfad	ls /dev/serial/by-id/* erneut prüfen, USB-Kabel testen
Eddy liefert nach Update falsche Werte	Kalibrierung fehlt	PROBE_CALIBRATE und ggf. Eddy-spezifische Kalibrierung neu durchführen

---

menuconfig Kurzreferenz

Zur schnellen Übersicht – alle vier Konfigurationen auf einen Blick:

Pi (Linux-MCU):

[*] Linux process

Octopus Pro (STM32F429):

[*] STMicroelectronics STM32
    Processor: STM32F429
    Bootloader: 32KiB bootloader
    Clock: 8 MHz crystal
    Interface: USB (on PA11/PA12)

Eddy USB (RP2040):

[*] Raspberry Pi RP2040
    Bootloader: No bootloader
    Interface: USB

Toolboard CAN (STM32G0B1):

[*] STMicroelectronics STM32
    Processor: STM32G0B1
    Bootloader: No bootloader
    Interface: CAN bus (on PB0/PB1)
    CAN speed: 1000000

---

Wenn alle Firmware-Versionen in Mainsail/Fluidd grün und identisch sind, läuft dein Drucker wieder synchron. Viel Erfolg beim Update!