Add complete Calibration Suite with automated macros

New calibration system for Neptune 4 Plus:

📁 Files added:
- calibration/CALIBRATION_GUIDE.md - Complete step-by-step guide
- calibration/README.md - Installation & overview
- calibration/calibration_macros.cfg - All calibration macros
- calibration/test_patterns.cfg - Printable test patterns

🎯 Available macros:
- CALIBRATION_MENU - Main menu with all options
- CALIBRATE_Z_OFFSET - Cartographer Z0 calibration
- CALIBRATE_INPUT_SHAPER - ADXL resonance measurement
- CALIBRATE_PRESSURE_ADVANCE - PA tuning (per filament)
- CALIBRATE_FLOW_RATE - Flow rate calibration
- CALIBRATE_TEMPERATURE - Temperature tower
- CALIBRATE_RETRACTION - Retraction testing
- CALIBRATE_BED_MESH - Bed mesh verification
- CALIBRATION_FULL - Complete suite (~2.5 hours)
- CALIBRATION_QUICK - Essential calibrations (~30 min)

🔧 Test patterns:
- PA_TEST_PATTERN - Pressure Advance test squares
- FLOW_TEST_CUBE - Flow rate calibration cube
- RETRACT_TEST_PATTERN - Retraction test towers
- TEMP_TOWER - Temperature tower

 Features:
- Fully automated calibration sequences
- Cartographer integration for precise Z0
- Per-filament calibration support
- Clear console messages for each step
- Automatic SAVE_CONFIG reminders
- Supports both Original and Bambu hotends

Usage: Run CALIBRATION_MENU in Klipper console
This commit is contained in:
root 2026-03-12 10:52:06 +00:00
parent 1cf9620736
commit 3c40c660cf
4 changed files with 982 additions and 0 deletions

View file

@ -0,0 +1,255 @@
# 🎯 Neptune 4 Plus Calibration Suite
## 📋 Vollständiger Einstell-Fahrplan
Diese Makros führen dich durch die **komplette Kalibrierung** deines Druckers von Z-Offset bis Pressure Advance.
---
## 🚀 Quick Start
```gcode
; Im Klipper Console oder Mainsail Macro ausführen:
CALIBRATION_MENU
```
---
## 📊 Empfohlene Reihenfolge
### **BEIM ERSTEN SETUP:**
| Schritt | Makro | Dauer | Wichtigkeit |
|---------|-------|-------|-------------|
| 1⃣ | `CALIBRATE_Z_OFFSET` | 5 min | ⭐⭐⭐⭐⭐ |
| 2⃣ | `CALIBRATE_INPUT_SHAPER` | 10 min | ⭐⭐⭐⭐⭐ |
| 3⃣ | `CALIBRATE_PRESSURE_ADVANCE` | 20 min | ⭐⭐⭐⭐⭐ |
| 4⃣ | `CALIBRATE_FLOW_RATE` | 30 min | ⭐⭐⭐⭐ |
| 5⃣ | `CALIBRATE_TEMPERATURE` | 45 min | ⭐⭐⭐⭐ |
| 6⃣ | `CALIBRATE_RETRACTION` | 30 min | ⭐⭐⭐⭐ |
| 7⃣ | `VERIFY_BED_MESH` | 10 min | ⭐⭐⭐ |
**Gesamtzeit:** ~2.5 Stunden (kann auf mehrere Sessions verteilt werden)
### **BEI HOTEND-WECHSEL:**
| Hotend-Typ | Notwendige Kalibrierung |
|------------|-------------------------|
| **Original → Original** | Nur Z-Offset |
| **Original → Bambu** | Z-Offset + Pressure Advance + Flow Rate |
| **Bambu → Original** | Z-Offset + Pressure Advance + Flow Rate |
| **Stahl → Messing** | Z-Offset + Pressure Advance + Flow Rate + Temp |
### **ROUTINE (alle 3-6 Monate):**
- Z-Offset prüfen
- Pressure Advance nachkalibrieren
- Bed Mesh neu machen
---
## 📝 Detaillierte Anleitung
### 1⃣ Z-Offset Kalibrierung
**Wann:** Bei jedem Hotend-Wechsel, Nozzle-Tausch, oder wenn First Layer Probleme hat
```gcode
CALIBRATE_Z_OFFSET
```
**Ablauf:**
1. Drucker heizt vor (50°C Nozzle, 60°C Bed)
2. Cartographer misst an 5 Punkten
3. Du kannst manuell nachjustieren
4. Wird automatisch in `SAVE_CONFIG` gespeichert
**Ergebnis:** Perfekte First Layer Höhe
---
### 2⃣ Input Shaper Kalibrierung
**Wann:** Nach mechanischen Änderungen, Vibrationsproblemen, oder alle 6 Monate
```gcode
CALIBRATE_INPUT_SHAPER
```
**Voraussetzung:** ADXL345 muss installiert sein (Cartographer hat eingebauten ADXL!)
**Ablauf:**
1. Druckkopf vibriert in X und Y Richtung
2. ADXL misst Resonanzfrequenzen
3. Klipper berechnet optimale Shaper-Werte
**Ergebnis:** Weniger Vibrationen, schärfere Ecken, höhere Geschwindigkeiten möglich
**Automatisch in `[input_shaper]` Sektion gespeichert**
---
### 3⃣ Pressure Advance Kalibrierung
**Wann:** Bei Hotend-Wechsel, Filament-Wechsel, oder wenn Ecken Probleme haben
```gcode
CALIBRATE_PRESSURE_ADVANCE FILAMENT=PLA
```
**Optionen:**
- `FILAMENT=PLA` (default)
- `FILAMENT=PETG`
- `FILAMENT=ABS`
- `FILAMENT=TPU`
**Ablauf:**
1. Druckt ein Quadrat mit variierendem PA (0.01 - 0.05)
2. Du suchst die beste Ecke (scharf, keine Blasen)
3. Wert wird notiert und gespeichert
**Ergebnis:** Scharfe Ecken, keine Überextrusion an Richtungswechseln
**Typische Werte:**
- PLA Original: 0.025-0.030
- PLA Bambu: 0.020-0.025
- PETG: 0.028-0.035
- ABS: 0.030-0.038
- TPU: 0.010-0.018
---
### 4⃣ Flow Rate Kalibrierung
**Wann:** Bei neuem Filament, Hotend-Wechsel, oder wenn Layer nicht haften
```gcode
CALIBRATE_FLOW_RATE FILAMENT=PLA
```
**Ablauf:**
1. Druckt einen Würfel mit variierenden Flow-Werten (90%-110%)
2. Du misst die Wände mit Messschieber
3. Berechnest den optimalen Flow-Wert
4. Wird im Filament-Profil gespeichert
**Ergebnis:** Exakte Wandstärken, keine Lücken zwischen Perimetern
---
### 5⃣ Temperature Tower
**Wann:** Bei neuem Filament-Typ, Hotend-Wechsel, oder Qualitätsproblemen
```gcode
CALIBRATE_TEMPERATURE FILAMENT=PLA
```
**Ablauf:**
1. Druckt einen Turm mit 5 Temperatur-Stufen (z.B. 195-215°C)
2. Du bewertest jede Stufe (Bridging, Stringing, Layer-Adhesion)
3. Optimale Temperatur wird gewählt
**Ergebnis:** Perfekte Temperatur für dein Filament
---
### 6⃣ Retraction Test
**Wann:** Bei Stringing-Problemen, Hotend-Wechsel, oder neuem Filament
```gcode
CALIBRATE_RETRACTION FILAMENT=PLA
```
**Ablauf:**
1. Druckt ein Modell mit variierenden Retract-Werten
2. Du suchst die Einstellung mit wenigstem Stringing
3. Wert wird gespeichert
**Ergebnis:** Minimales Stringing, keine Underextrusion
**Typische Werte:**
- Original Hotend: 2.0-3.0mm
- Bambu Hotend: 1.5-2.0mm
---
### 7⃣ Bed Mesh Verification
**Wann:** Nach Leveling, alle 1-3 Monate, oder wenn First Layer inkonsistent
```gcode
CALIBRATE_BED_MESH
```
**Ablauf:**
1. Heizt Bett auf Drucktemperatur
2. Misst komplettes Bett mit Cartographer
3. Speichert Mesh-Profil
**Ergebnis:** Perfekte First Layer Haftung über das gesamte Bett
---
## 🎯 Quick Reference Card
```
┌─────────────────────────────────────────────────────────────┐
│ NEPTUNE 4 PLUS CALIBRATION QUICK REFERENCE │
├─────────────────────────────────────────────────────────────┤
│ │
│ Z-Offset: CALIBRATE_Z_OFFSET │
│ Input Shaper: CALIBRATE_INPUT_SHAPER │
│ Pressure Advance: CALIBRATE_PRESSURE_ADVANCE FILAMENT=X │
│ Flow Rate: CALIBRATE_FLOW_RATE FILAMENT=X │
│ Temperature: CALIBRATE_TEMPERATURE FILAMENT=X │
│ Retraction: CALIBRATE_RETRACTION FILAMENT=X │
│ Bed Mesh: CALIBRATE_BED_MESH │
│ │
│ Complete Suite: CALIBRATION_FULL │
│ │
└─────────────────────────────────────────────────────────────┘
```
---
## 📊 Kalibrierungs-Protokoll
Führe Buch über deine Kalibrierungen:
```markdown
| Datum | Hotend | Filament | Z-Offset | PA | Flow | Temp | Retract | Notes |
|-------|--------|----------|----------|----|------|------|---------|-------|
| | | | | | | | | |
```
---
## 🔧 Troubleshooting
| Problem | Lösung |
|---------|--------|
| **First Layer haftet nicht** | Z-Offset neu kalibrieren, Bed Mesh |
| **Stringing** | Retraction Test, Temperature Tower |
| **Ecken nicht scharf** | Pressure Advance neu kalibrieren |
| **Vibrationen** | Input Shaper neu messen |
| **Underextrusion** | Flow Rate kalibrieren, Nozzle prüfen |
| **Layer Adhesion schlecht** | Temperature Tower, Flow Rate |
---
## 💡 Tipps
1. **Immer SAVE_CONFIG** nach jeder Kalibrierung ausführen!
2. **Filament trocken lagern** feuchtes Filament verfälscht Ergebnisse
3. **Gleiche Filament-Marke** für Kalibrierung und Druck verwenden
4. **Notizen machen** welche Settings für welches Filament funktionieren
5. **Bei Hotend-Wechsel:** Mindestens Z-Offset + Pressure Advance neu machen
---
**Created:** 2026-03-12
**Printer:** Elegoo Neptune 4 Plus
**Probe:** Cartographer 3D
**Firmware:** Open4Neptune + Klipper