From 54631c21a7934daab6cccedd50a680f6779df358 Mon Sep 17 00:00:00 2001 From: root Date: Fri, 13 Mar 2026 16:49:57 +0000 Subject: [PATCH] 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. --- docs/NOZZLE_WIPER_SETUP.md | 417 +++++++++++++++++++++++++++++++++++++ 1 file changed, 417 insertions(+) create mode 100644 docs/NOZZLE_WIPER_SETUP.md diff --git a/docs/NOZZLE_WIPER_SETUP.md b/docs/NOZZLE_WIPER_SETUP.md new file mode 100644 index 0000000..b16571d --- /dev/null +++ b/docs/NOZZLE_WIPER_SETUP.md @@ -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.