Klipper-Update 2026: BTT Eddy richtig konfigurieren nach der Deprecation von z_offset

2. April 2026

Vollständige Anleitung zur Migration auf descend_z – Konfiguration, Kalibrierung und Makro-Anpassung

Mit dem Klipper-Update 2026 wurde z_offset im probe_eddy_current-Block als deprecated markiert und durch descend_z ersetzt. Dieser Artikel zeigt Schritt für Schritt, wie du deine printer.cfg, Homing-Makros und den gesamten Kalibrierungsprozess für den BTT Eddy (USB) anpassen musst.

BTT Eddy USB – Induktiver Probe-Sensor von BigTreeTech

Was hat sich geändert?

Mit dem Klipper-Update 2026 hat sich eine fundamentale Änderung am Probe-System ergeben: Der Parameter z_offset ist im [probe_eddy_current]-Block jetzt deprecated (veraltet). An seine Stelle tritt descend_z – ein Wert mit einer völlig anderen Bedeutung.

Während z_offset den vertikalen Versatz zwischen Düse und Sensorpunkt beschrieb, definiert descend_z lediglich die Anfahrhöhe für den Kalibrierungsvorgang. Der eigentliche Z-Offset wird jetzt intern über die Kalibrierungstabelle verrechnet.

Wer nach dem Update einfach seinen alten z_offset-Wert in descend_z einträgt, riskiert einen Crash der Düse ins Bett. Diese Anleitung zeigt dir Schritt für Schritt, wie du alles korrekt umstellst.

Teil 1: Die richtige Konfiguration (printer.cfg)

Stelle sicher, dass dein [probe_eddy_current]-Block exakt so aussieht. Der Wert descend_z ist kein Offset, sondern nur die Anfahrhöhe für den Kalibriertest:

[probe_eddy_current btt_eddy]
sensor_type: ldc1612
i2c_mcu: eddy
i2c_bus: i2c0f
x_offset: 0
y_offset: 74.0

# descend_z ist die Höhe, auf die der Kopf beim Kalibrieren fährt.
# 1.0 ist sicher. Stell es NICHT auf deinen alten Z-Offset!
descend_z: 1.0

samples: 2
samples_result: median

Wichtig: Ein descend_z von 1.0 ist ein sicherer Startwert – der Kopf fährt auf 1 mm über das Bett.

Teil 2: Das korrigierte Homing-Makro

Hier lag bei vielen Nutzern die Ursache für Crashes: Das alte Makro hat descend_z vom Messwert abgezogen. Das neue Klipper verrechnet den Offset intern über die Kalibrierungstabelle. Ersetze dein altes Makro:

[gcode_macro SET_Z_FROM_PROBE]
gcode:
    {% set cf = printer.configfile.settings %}
    # Z auf Messwert des Eddy + manuellen Runtime-Offset setzen
    SET_GCODE_OFFSET_ORIG Z={printer.probe.last_z_result + printer["gcode_macro SET_GCODE_OFFSET"].runtime_offset}
    G90
    # Nach Homing auf Sicherheitsabstand fahren
    G1 Z{cf.safe_z_home.z_hop}

Was das Makro tut:

Liest den Messwert des Eddy (last_z_result)
Addiert deinen manuellen Runtime-Offset
Fährt auf die sichere Z-Hop-Höhe

Was es nicht mehr tut: descend_z abziehen – das war der Bug-Verursacher.

Teil 3: Basis-Kalibrierung (Frequenz-Mapping)

Bevor der Eddy präzise arbeiten kann, muss er lernen, wie das Bett unter ihm aussieht. Diese Kalibrierung erstellt eine Frequenz-Abstands-Tabelle.

Vorbereitung

Bett auf 60 °C vorheizen
Druckkopf in die Mitte des Betts fahren

Kalibrierung starten

PROBE_EDDY_CURRENT_CALIBRATE CHIP=btt_eddy METHOD=paper

Ablauf

Der Kopf fährt auf Z = 1.0 (dein descend_z-Wert)
Nutze die Buttons in Mainsail oder TESTZ Z=-0.1 um die Düse abzusenken
Papier zwischen Düse und Bett – es sollte leicht klemmen
Klicke auf ACCEPT
Gib SAVE_CONFIG ein

Klipper schreibt eine Datentabelle ans Ende deiner printer.cfg.

Teil 4: Temperatur-Kompensation

Induktive Sensoren reagieren auf Temperaturänderungen. Die Temperatur-Kalibrierung erstellt eine Korrekturtabelle.

Voraussetzung

Der Drucker muss kalt sein (Zimmertemperatur). Alle Heizungen aus.

Kalibrierung starten

TEMPERATURE_PROBE_CALIBRATE PROBE=btt_eddy TARGET=56 STEP=4

Heizung manuell starten

Da der Befehl die Heizung nicht selbst aktiviert:

SET_HEATER_TEMPERATURE HEATER=heater_bed TARGET=80

Ablauf

Klipper fordert zum Papiertest auf → ACCEPT
Warten: Der Eddy erwärmt sich durch die Bettwärme
Bei jeder Stufe (+4 °C): erneuter Papiertest
Fortfahren bis Zieltemperatur (56 °C) erreicht

Abschluss

TEMPERATURE_PROBE_COMPLETE
SAVE_CONFIG

Tipp: Dieser Vorgang dauert 30–60 Minuten.

Teil 5: Der tägliche Betrieb

1. Homing (G28)

Der Eddy misst den Abstand. SET_Z_FROM_PROBE setzt den Z-Nullpunkt automatisch.

2. Bed Mesh

BED_MESH_CALIBRATE

Führt einen rapid_scan aus – blitzschnell, der Kopf hält nicht an.

3. Feinjustierung

Nutze den Z-Offset-Regler im Mainsail/Fluidd-Interface
Z_OFFSET_APPLY_PROBE speichert dauerhaft in variables.cfg

Sicherheitshinweis für den ersten Test

Achtung – Erster Test nach der Umstellung

Führe ein G28 aus
Halte den Finger am Not-Aus!

✅ Okay: Kopf fährt nach oben auf ca. 10 mm
❌ Stopp: Kopf fährt ins Bett → alter Wert in der Berechnung

Prüfe: Zieht dein Makro noch descend_z ab? Hast du Teil 3 neu durchgeführt? Steht noch ein alter z_offset in der Config?

Zusammenfassung

Was	Alt (vor 2026)	Neu (ab 2026)
Z-Offset im Probe-Block	`z_offset: -1.54`	Deprecated – durch `descend_z` ersetzen
Anfahrhöhe Kalibrierung	implizit	`descend_z: 1.0`
Offset-Verrechnung	Manuell im Makro	Intern via Kalibrierungstabelle
Makro-Logik	`last_z_result - descend_z`	`last_z_result + runtime_offset`

Die Umstellung macht das System am Ende robuster und genauer. Der Eddy arbeitet nach der neuen Kalibrierung deutlich zuverlässiger.

Klipper-Update 2026: BTT Eddy richtig konfigurieren nach der Deprecation von z_offset

Vollständige Anleitung zur Migration auf descend_z – Konfiguration, Kalibrierung und Makro-Anpassung

Was hat sich geändert?

Teil 1: Die richtige Konfiguration (printer.cfg)

Teil 2: Das korrigierte Homing-Makro

Teil 3: Basis-Kalibrierung (Frequenz-Mapping)

Vorbereitung

Kalibrierung starten

Ablauf

Teil 4: Temperatur-Kompensation

Voraussetzung

Kalibrierung starten

Heizung manuell starten

Ablauf

Abschluss

Teil 5: Der tägliche Betrieb

1. Homing (G28)

2. Bed Mesh

3. Feinjustierung

Sicherheitshinweis für den ersten Test

Zusammenfassung

Teilen:

Schreibe einen Kommentar