Plugins in Z-Mod¶

Jeder Benutzer kann sein eigenes Plugin erstellen und mit dem zmod verbinden.

In Z-Mod enthaltene Plugins:

Recommend - Einstellungen, deren Verwendung unmittelbar nach der Installation der Mod empfohlen wird
G28_tenz - Parken der Z-Achse durch Wägezellen
Nopoop - Maximierung der Abfallreduzierung von ninjamida.
Zeitraffer - Moonraker Zeitraffer
Notify - Erhalten Sie Benachrichtigungen auf Telegram und über 100 anderen Diensten.

Externe Plugins, die nicht vom Autor von Z-Mod entwickelt wurden.

Bambufy - Kompatibel mit Bambu Studio, verbessert die Kontrolle des Futterturms, bietet genaue Zeit- und Materialverbrauchsschätzungen, reduziert Abfall, unterstützt Mainsail, schnelle Farbwechsel und erweiterte Druckfunktionen. KANN NICHT MIT DEM NATIVEN BILDSCHIRM VERWENDET WERDEN.
lessWaste ist eine Abspaltung von BamBufy
Dryer - Filamenttrocknung über das Heizbett
IFS Jacker – Plugin zur Unterstützung des IFS Jacker Hardware-Mods. Es ermöglicht die automatische Erkennung der verfügbaren Kanalanzahl sowie die Klipper-Integration für Lüfter, LEDs und Sensoren, die über einen IFS Jacker verbunden sind.

Um das Repository für externe Plugins zu aktivieren, führen Sie den Befehl ENABLE_EXTRA_PLUGINS aus.

Plugin verwalten¶

Plugin aktivieren:

ENABLE_PLUGIN name=g28_tenz

wird das Plugin herunterladen und Klipper bei Erfolg neu starten.

Plugin deaktivieren:

DISABLE_PLUGIN name=g28_tenz

Klassische Klipper-Plugins mit Python-Modulen installieren¶

Klassische Klipper-Plugins, die mit Python-Modulen arbeiten (z.B. klipper-led_effect), erfordern einen speziellen Installationsprozess mit der Erstellung eines symbolischen Links zum Klipper-Modul.

Beispiel: Installation von led_effect¶

led_effect ist ein Plugin zur Steuerung von WS2812 RGB LED-Streifen über Klipper.

Schritt 1: Klonen des Repositorys

Führen Sie diese Befehle in einer chroot-Umgebung aus:

# Für FF5M:
chroot /data/.mod/.zmod/
# Für FF5X:
chroot /usr/data/.mod/.zmod/

# Gleich für alle Modelle:
cd /opt/config/mod_data/plugins/
git clone https://github.com/julianschill/klipper-led_effect.git

Schritt 2: Hinzufügen eines Eintrags zur Moonraker-Konfiguration

Fügen Sie in der Datei mod_data/user.moonraker.conf den folgenden Abschnitt hinzu:

[update_manager led_effect]
Typ: git_repo
Kanal: stable
Pfad: /opt/config/mod_data/plugins/klipper-led_effect
Herkunft: https://github.com/julianschill/klipper-led_effect.git
is_system_service: Falsch
primärer_Zweig: master

Schritt 3: Erstellen eines symbolischen Links auf das Klipper-Modul

Erstellen Sie einen symbolischen Link, um das Modul mit Klipper zu verbinden:

ln -s /opt/config/mod_data/plugins/klipper-led_effect/src/led_effect.py /usr/prog/klipper/klippy/extras/led_effect.py

Ersetzen Sie mit:

klipper-led_effect in Ihrem Plugin-Ordner
led_effect.py in den Modulnamen (kann je nach Plugin unterschiedlich sein)

Schritt 4: Klipper neu laden

Nachdem Sie den symbolischen Link erstellt haben, müssen Sie Klipper über die Fluidd/Mainsail-Weboberfläche neu laden, indem Sie auf die Schaltfläche reload klicken.

Wichtige Hinweise

Modul muss mit der Klipper-Version kompatibel sein Stellen Sie sicher, dass die Plugin-Version mit der installierten Klipper-Version kompatibel ist.

Erstellen Sie Ihr eigenes Plugin¶

Plugin-Beispiel: https://github.com/ghzserg/g28_tenz (Alle Beispiele unten verwenden den Namen g28_tenz - ersetzen Sie ihn durch den Namen Ihres Plugins).

Hinzufügen eines Plugins¶

In der Datei mod_data/user.moonraker.conf. fügen Sie einen Abschnitt hinzu:

[update_manager g28_tenz]
type: git_repo
channel: dev
path: /root/printer_data/config/mod_data/plugins/g28_tenz
origin: https://github.com/ghzserg/g28_tenz.git
is_system_service: False
primary_branch: main

Pfad zum Plugin: /root/printer_data/config/mod_data/plugins/g28_tenz.
Quelle: https://github.com/ghzserg/g28_tenz.git.

Info

Stabile Plugins können in der zmod-Lieferung enthalten sein, werden aber von ihren Autoren aktualisiert und verwaltet.

Installationsskript¶

Nach dem Aufruf von ENABLE_PLUGIN wird automatisch die Datei install.sh aufgerufen.

Nach dem Aufruf von DISABLE_PLUGIN, wird automatisch die Datei uninstall.sh aufgerufen.

Einsprachiges Plugin¶

Muss die Datei enthalten:

g28_tenz.cfg

Sie enthält alle Funktionen.

Mehrsprachiges Plugin¶

Die Dateien sind in Unterverzeichnissen nach Sprachen geordnet:

en/g28_tenz.cfg
ru/g28_tenz.cfg
de/g28_tenz.cfg
...

Alle Zeilen der Ausgabe müssen escaped werden, z.B.:

RESPOND PREFIX="info" MSG="===Schneiden des Fadens==="

Übersetzung¶

Übersetzungen werden im Verzeichnis translate/ in Dateien der Form de.csv gespeichert:

Cutting the filament;Schneiden des Filaments

Format:

Englische Phrase;Übersetzung in die gewünschte Sprache

Um Sprachdateien zu erzeugen, führen Sie aus:

./Make.sh

Das Skript erstellt die erforderlichen Verzeichnisse und .cfg-Dateien.