open4neptune-new/docs/NOZZLE_WIPER_SETUP.md
root 54631c21a7 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.
2026-03-13 16:49:57 +00:00

9.2 KiB

🧹 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:

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

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:

[include KNCM_settings.cfg]

Schritt 3: PRINT_START Macro anpassen

In user_settings.cfg oder printer.cfg:

[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:

    M109 S140    ; Auf 140°C heizen (PLA)
    
  2. Home den Drucker:

    G28
    
  3. Fahr zur Wiper-Position:

    G1 X0 Y320 F3000    ; Hinten rechts (Wiper-Position)
    
  4. Teste Höhe (langsam!):

    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:

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:

    G28
    
  2. Fahr zu X=0:

    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:

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:

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

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

    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:

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

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

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

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


📋 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.