Docs: Add comprehensive Nozzle Wiper setup guide

Created docs/NOZZLE_WIPER_SETUP.md with complete instructions for:
- Wiper holder installation (Printables links)
- KNCM installation and configuration
- cleaning_height calibration (step-by-step)
- bed_corner_to_wiper_offset measurement
- All configuration options explained
- Troubleshooting common issues
- Maintenance tips (cleaning, replacement)
- Testing procedures
- Checklist for setup

This guide helps users properly install and configure the
official Klipper Nozzle Clean Macro (KNCM) for Neptune 4 Plus.
This commit is contained in:
root 2026-03-13 16:49:57 +00:00
parent e22df9b5ab
commit 54631c21a7

417
docs/NOZZLE_WIPER_SETUP.md Normal file
View file

@ -0,0 +1,417 @@
# 🧹 Nozzle Wiper Installation & Setup - Neptune 4 Plus
Komplette Anleitung zur Installation und Konfiguration des Nozzle Cleaning Systems für den Elegoo Neptune 4 Plus.
---
## 📦 Was du brauchst
### 1. **Wiper Holder (3D-Druck)**
**Offizielles Design für Neptune 4 Plus:**
- [Neptune 4 Plus Corner Guide with Wiper](https://www.printables.com/model/1221208-neptune-4-plus-corner-guide-with-wiper)
- Alternative: [Neptune 4 Corner Alignment Guides](https://www.printables.com/model/1196153-neptune-4-corner-alignment-guides-promax)
**Empfohlenes Material:**
- PLA oder PETG
- 100% Infill (für Stabilität)
- 3-4 Wall Layers
### 2. **Cleaning Brush / Silicone Wiper**
- **Option A:** Siliconebürste (empfohlen)
- Länge: ~35-40mm
- Breite: ~8-10mm
- Höhe: ~15-20mm
- **Option B:** Zahnbürste (günstige Alternative)
- Alte Zahnbürste abschneiden
- Borsten auf ~15mm kürzen
### 3. **Schrauben (optional)**
- 2x M3x8 Schrauben (falls nicht im Lieferumfang)
- Zum Befestigen am Eckführer
---
## 🔧 Installation
### Schritt 1: Wiper Holder drucken
1. STL von Printables herunterladen
2. In Slicer laden (Orca/PrusaSlicer)
3. Einstellungen:
```
Material: PLA/PETG
Infill: 100%
Walls: 3-4
Supports: Keine nötig
```
4. Drucken (Dauer: ~1-2 Stunden)
### Schritt 2: Wiper einsetzen
1. **Bürste zuschneiden** (falls nötig):
- Länge: 35-40mm
- Höhe: 15-20mm über Halterung
2. **Bürste in Halterung stecken**:
- Sollte fest sitzen
- Nicht zu tief (sonst reinigt es nicht)
- Nicht zu hoch (sonst wackelt es)
### Schritt 3: Halterung am Drucker montieren
**Position: Hinten rechts (empfohlen)**
1. **Drucker ausschalten** und Bett abkühlen lassen
2. **Rechte hintere Ecke finden**:
- Das ist die Ecke bei X=300, Y=330 (für N4 Plus)
3. **Halterung positionieren**:
- Über die Eckführung stülpen
- Sollte bündig anliegen
4. **Festschrauben** (falls Schrauben verwendet):
- 2x M3x8 durch die Löcher
- Nicht zu fest anziehen (PLA bricht leicht)
---
## ⚙️ Konfiguration in Klipper
### Schritt 1: KNCM installieren
```bash
cd ~/printer_data/config
git clone https://git.sky-net.it/nocci/open4neptune-new.git
cp -r open4neptune-new/KNCM/ ~/printer_data/config/
cp open4neptune-new/KNCM_settings.cfg ~/printer_data/config/
```
### Schritt 2: Include in Config hinzufügen
**In `printer.cfg` oder `moonraker.conf`:**
```ini
[include KNCM_settings.cfg]
```
### Schritt 3: PRINT_START Macro anpassen
**In `user_settings.cfg` oder `printer.cfg`:**
```ini
[gcode_macro PRINT_START]
gcode:
# ... deine bestehenden Commands ...
# Nozzle cleaning NACH dem Heizen und Mesh
CLEAN_NOZZLE FILAMENT_TYPE={FILAMENT_TYPE}
# ... weitere Commands ...
```
---
## 📏 WICHTIG: Kalibrierung!
### ⚠️ cleaning_height kalibrieren
**Das ist der WICHTIGSTE Wert!** Zu niedrig = beschädigt Wiper, zu hoch = reinigt nicht!
**Schritt-für-Schritt:**
1. **Heize Nozzle vor:**
```gcode
M109 S140 ; Auf 140°C heizen (PLA)
```
2. **Home den Drucker:**
```gcode
G28
```
3. **Fahr zur Wiper-Position:**
```gcode
G1 X0 Y320 F3000 ; Hinten rechts (Wiper-Position)
```
4. **Teste Höhe (langsam!):**
```gcode
G1 Z35 F100 ; Start bei Z35 (sicher)
G1 Z32 F100 ; Langsam runter
G1 Z30 F100 ; Weiter runter
G1 Z28 F100 ; Bis Brush leicht berührt wird
```
5. **Optimale Höhe finden:**
- Nozzle sollte **leicht** die Borsten berühren
- **Nicht** tief eindrücken!
- **Nicht** darüber schweben!
6. **Wert notieren und eintragen:**
**In `KNCM_settings.cfg`:**
```ini
variable_cleaning_height: 30 ; ← Deinen Wert eintragen!
```
---
### 📐 bed_corner_to_wiper_offset messen
**Dieser Wert sagt dem Macro wo der Wiper ist!**
**So messen:**
1. **Drucker homed:**
```gcode
G28
```
2. **Fahr zu X=0:**
```gcode
G1 X0 F3000
```
3. **Miss den Abstand:**
- Von der **X=0 Position** (Nozzle-Mitte)
- Bis zum **Start der Silikon-Borsten**
- Mit Messschieber oder Lineal
4. **Wert eintragen:**
**In `KNCM_settings.cfg`:**
```ini
variable_bed_corner_to_wiper_offset: 40.5 ; ← Deinen Wert eintragen!
```
**Typische Werte für Neptune 4 Plus:**
- Ohne Halterung: ~35-40mm
- Mit Eckführung: ~40-45mm
---
## 🎯 Alle Einstellungen im Überblick
### In `KNCM_settings.cfg` anpassen:
```ini
# ------------------------------------------------------------------------
# NEPTUNE 4 PLUS SPECIFIC - ANPASSEN!
# ------------------------------------------------------------------------
# ⚠️ KALIBRIEREN! (siehe Anleitung oben)
variable_cleaning_height: 30
# ⚠️ MESSEN! (siehe Anleitung oben)
variable_bed_corner_to_wiper_offset: 40.5
# Neptune 4 Plus hat 330mm Y-Achse
variable_printer_bed_y_max: 330
# Neptune 4: Bed bewegt sich auf Y-Achse
variable_wiping_axis: 'Y'
# ------------------------------------------------------------------------
# OPTIONAL ANPASSEN
# ------------------------------------------------------------------------
# Mehr Loops = gründlicher, aber langsamer
variable_cleaning_loops: 1
# PurgeShake entfernt Fäden vor dem Reinigen
variable_purge_shake: 1
# Debug-Nachrichten (1=an, 0=aus)
variable_debug: 0
# Geschwindigkeiten (mm/s)
variable_travel_speed: 350
variable_slow_speed: 250
variable_fast_speed: 500
# Reinigungstemperaturen (niedriger als Drucktemp!)
variable_cleaning_temperatures: {
"PLA":140,
"PETG":160,
"TPU":180,
"ABS":190,
"ASA":190
}
```
---
## 🧪 Testen
### Manueller Test:
```gcode
# Nozzle auf Temperatur bringen
M109 S140
# Cleaning ausführen
CLEAN_NOZZLE FILAMENT_TYPE=PLA
```
**Beobachten:**
- ✅ Nozzle fährt zur Wiper-Position
- ✅ Nozzle senkt auf cleaning_height
- ✅ Nozzle wischt in Wellenbewegung (sinus)
- ✅ Nozzle hebt wieder
- ✅ Keine Kollisionen!
### Im PRINT_START testen:
1. **Slicer Start-Gcode:**
```gcode
PRINT_START EXTRUDER_TEMP=[nozzle_temperature] BED_TEMP=[bed_temperature] FILAMENT_TYPE={filament_type[0]}
```
2. **Druck starten**
3. **Beobachten:**
- Nach dem Homing und Mesh
- Sollte automatisch reinigen
- Dann Purge-Line drucken
---
## 🐛 Troubleshooting
### ❌ Nozzle fährt an falsche Position
**Problem:** Wiper wird verfehlt
**Lösung:**
```ini
# bed_corner_to_wiper_offset überprüfen und neu messen!
variable_bed_corner_to_wiper_offset: 40.5 ; ← NEU MESSEN!
```
### ❌ Nozzle reinigt nicht richtig
**Problem:** Zu hoch über dem Wiper
**Lösung:**
```ini
# cleaning_height verringern (langsam!)
variable_cleaning_height: 30 ; ← Auf 28 oder 29 testen
```
### ❌ Nozzle kratzt zu stark / beschädigt Wiper
**Problem:** Zu tief in den Borsten
**Lösung:**
```ini
# cleaning_height erhöhen (sofort!)
variable_cleaning_height: 30 ; ← Auf 32 oder 33 erhöhen
```
### ❌ Macro zeigt Fehler "Insufficient vertical clearance"
**Problem:** printer_bed_y_max ist zu nah am Maximum
**Lösung:**
```ini
# printer_bed_y_max überprüfen (N4 Plus = 330)
variable_printer_bed_y_max: 330
```
### ❌ Keine Reinigung im PRINT_START
**Problem:** CLEAN_NOZZLE wird nicht aufgerufen
**Lösung:**
1. PRINT_START Macro überprüfen
2. Diese Zeile muss drin sein:
```gcode
CLEAN_NOZZLE FILAMENT_TYPE={FILAMENT_TYPE}
```
3. Nach dem Heizen und Mesh, vor der Purge-Line
---
## 📊 Wartung
### Wiper reinigen
**Alle 10-20 Drucke:**
1. Nozzle auf 50°C heizen
2. Wiper mit Pinzette herausnehmen
3. Mit Isopropanol reinigen
4. Trocknen lassen
5. Wieder einsetzen
### Wiper austauschen
**Alle 50-100 Drucke (oder wenn abgenutzt):**
1. Alten Wiper entfernen
2. Neuen Wiper zuschneiden (gleiche Maße)
3. Einsetzen
4. cleaning_height neu kalibrieren!
---
## 📝 Tipps
### 💡 Beste Ergebnisse
1. **Immer auf Temperatur reinigen:**
- PLA: 140°C
- PETG: 160°C
- TPU: 180°C
2. **Nicht zu oft reinigen:**
- Nur bei PRINT_START
- Nicht bei jedem Layer-Change (verschleißt Wiper)
3. **Wiper-Position optimieren:**
- Sollte leicht erreichbar sein
- Sollte nicht im Weg sein beim Drucken
- Hinten rechts ist optimal für N4 Plus
### 💡 Alternative Positionen
**Wenn hinten rechts nicht passt:**
| Position | Vorteile | Nachteile |
|----------|----------|-----------|
| **Hinten rechts** (empfohlen) | Außerhalb Druckbereich | Schwerer zu erreichen |
| **Hinten links** | Leichter zu erreichen | Im Weg bei manchen Drucken |
| **Seitlich** | Sehr gut erreichbar | Extra Halterung nötig |
---
## 🔗 Links & Ressourcen
- **Offizielle KNCM Doku:** https://github.com/Open-Elegoo-Community/klipper-nozzle-clean-macro
- **Wiper Holder N4 Plus:** https://www.printables.com/model/1221208-neptune-4-plus-corner-guide-with-wiper
- **Wiper Holder N4/Pro/Max:** https://www.printables.com/model/1196153-neptune-4-corner-alignment-guides-promax
- **Elegoo Discord:** https://discord.gg/elegoo (KNCM Support Channel)
---
## 📋 Checkliste
- [ ] Wiper Holder gedruckt
- [ ] Wiper/Bürste eingesetzt
- [ ] Halterung montiert (hinten rechts)
- [ ] KNCM installiert (Files kopiert)
- [ ] Include in Config (`[include KNCM_settings.cfg]`)
- [ ] cleaning_height kalibriert (TESTZ!)
- [ ] bed_corner_to_wiper_offset gemessen
- [ ] PRINT_START angepasst
- [ ] Manuell getestet (CLEAN_NOZZLE)
- [ ] Testdruck mit PRINT_START
---
**Viel Erfolg beim Einrichten!** 🎉
Bei Fragen: Open-Elegoo-Community Discord oder Issues im Repo.