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.
Anzeige · Affiliate-Link – kaufst du darüber, erhalte ich ggf. eine Provision. Für dich ändert sich am Preis nichts.
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: medianWichtig: 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=paperAblauf
- Der Kopf fährt auf Z = 1.0 (dein
descend_z-Wert) - Nutze die Buttons in Mainsail oder
TESTZ Z=-0.1um die Düse abzusenken - Papier zwischen Düse und Bett – es sollte leicht klemmen
- Klicke auf ACCEPT
- Gib
SAVE_CONFIGein
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=4Heizung manuell starten
Da der Befehl die Heizung nicht selbst aktiviert:
SET_HEATER_TEMPERATURE HEATER=heater_bed TARGET=80Ablauf
- 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_CONFIGTipp: 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_CALIBRATEFü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_PROBEspeichert dauerhaft invariables.cfg
Sicherheitshinweis für den ersten Test
- 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.
Anzeige · Affiliate-Link – kaufst du darüber, erhalte ich ggf. eine Provision. Für dich ändert sich am Preis nichts.
