# 🧹 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.