open4neptune-new/calibration/CALIBRATION_GUIDE.md
root 3c40c660cf 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
2026-03-12 10:52:06 +00:00

255 lines
7.1 KiB
Markdown
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 🎯 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