Hersteller-Leitfaden

Einführung

Wenn du ein Hersteller von 3D-FDM-Druckern bist, ist der Einsatz von Repetier-Server als Controller die beste Wahl, um deinen Benutzen das bestmögliche Druckerlebnis zu bieten. Noch besser ist es, wenn du eine optimierte Version für deine Drucker anbietest. Das macht es für deine Kunden viel einfacher und sie werden sich über die Umsetzung freuen. Da es sich bei Repetier-Server um ein allgemeines Produkt handelt, ist es natürlich nicht mit speziellen Einstellungen für bestimmte Drucker konfiguriert.

Der folgende Text wird versuchen, dir zu zeigen, was du tun kannst, um die Benutzererfahrung zu verbessern, und auf welche Punkte du achten musst, um sich später nicht in Schwierigkeiten zu bringen. Es wäre schade, wenn du ein gutes Produkt lieferst und vergisst, den Update-Pfad anzupassen, um beispielsweise ein spezielles Update für dein Unternehmen bereitzustellen.

Druckerkonfiguration und Backup

Eine Sache, in der Repetier-Server sehr gut ist, ist die Flexibilität. Mit unserer Druckerkonfiguration kannst du viele Funktionen anpassen und sogar neue Funktionen hinzufügen. Du kannst zwar einfach unseren Assistenten verwenden, um eine funktionierende Druckerkonfiguration zu erstellen, aber dies lässt sich erheblich verbessern, wenn du mehr über Repetier-Server und insbesondere über die G-Code-Programmiersprachenerweiterung erfährst.

Das sind nur einige Ideen, die du verbessern kannst, wenn du genau weißt, welchen Drucker du hast:

  • Zusätzliche Assistenten für einige Kalibrierungen oder laufende Prüfverfahren.
  • Optimiere die Handhabung von Pausen und Stopps.
  • Kontrolliere Lampen.
  • Erhalte neue Meldungen von deinem Drucker, die Aktionen oder Meldungen auslösen.
  • Definiere die richtigen Werte für Beschleunigungen, Höchstgeschwindigkeit, Bettpositionen, Heiz- und Kühlgeschwindigkeiten für eine optimale Zeitvorhersage.
  • Konfiguriere die Webcam, wenn du weißt, dass es eine gibt.
  • Füge ein Bild auf dem Druckbett hinzu, z.B. mit deinem Logo, um es leicht zu erkennen, oder mit einigen Markierungen, die für deinen Drucker von besonderer Bedeutung sind.

Seit Version 1.4.x haben Drucker eine echte Backup-Funktion. Wenn du ein Backup ausführst, entscheide selbst, was gesichert werden soll – das kann nur die Konfiguration sein oder auch Beispiel-G-Codes, Protokolle und Zeitraffer-Video. All dies wird in eine einzige Datei komprimiert. Du kannst diese Backups auf deiner Homepage zur Verfügung stellen, für den Fall, dass Benutzer zu viel mit den Einstellungen gespielt haben und eine neue Installation benötigen, oder einfach eine verbesserte Konfiguration mit mehr Assistenten, …

Ein gut vorkonfiguriertes Backup macht es den Anwendern sehr leicht, schnell mit deinem Drucker zu arbeiten.

Auch wenn du den Repetier-Server NICHT direkt mit deinem Drucker verkaufst, möchten deine Kunden ihn vielleicht trotzdem nutzen, um ihre Drucker zu steuern. Die Bereitstellung dieser Art von Drucker-Backup ist alles, was sie brauchen, um einen optimalen Start zu haben.

Branding

Der Kern von Repetier-Server ist ein Drucker-Daemon mit integriertem Webserver. Alle Benutzerinteraktionen mit der Außenwelt erfolgen über Webaufrufe oder das Öffnen einer Benutzeroberfläche vom Webserver aus. Alles, was die Benutzer sehen, hängt also von diesen Webdateien ab. Repetier-Server verwendet zwei Stammverzeichnisse für diese Webdateien. Eines für unsere Original-Webdateien und das andere für dich. Wenn eine Datei im Shadow-Ordner an der gleichen Position existiert, wird sie verwendet, um deine Version anstelle der Standardversion zu liefern.

So kannst du jede beliebige Datei durch den von dir gewünschten Inhalt ersetzen. Du kannst sogar die Benutzeroberfläche komplett durch eine eigene Version ersetzen. Aber eine komplett eigene Version ist eine Menge Arbeit, deshalb wirst du das normalerweise nicht tun. Was du lieber machen kannst, ist, unsere Dateien zu modifizieren, um Funktionen zu entfernen, die du nicht willst, oder die css-Datei zu ändern, um die Oberfläche in anderen Farben darzustellen oder den Namen und das Symbol zu ändern.

Alles beginnt mit der Bereitstellung einer überschreibenden Startkonfigurationsdatei. Siehe unter Startup-Konfiguration, wie man diese definiert. Dort wird auch erklärt, wie man einen eigenen Namen und ein Symbol festlegt.

Wenn du die von uns verwendeten Dateien überprüfst, wirst du feststellen, dass sie komprimiert und nicht sehr lesbar sind. Zumindest die javascript- und css-Dateien. Verwende sie also nicht direkt.

Die meisten wollen ein optimiertes Touchscreen-Interface. Diese App ist eine moderne Angular-basierte Webapplikation, die in wenigen Dateien vorkompiliert ist. Um Änderungen vorzunehmen, musst du ihre eigene vollständige Version kompilieren. Wir stellen die vollständigen Quelldateien zur Verfügung und du darfst diese für eigene Repetier-Server-Schnittstellen verwenden. Du kannst auch nur die Kommunikationsschicht verwenden und eine eigene Benutzeroberfläche in Kombination einsetzen. Du kannst selbst entscheiden, was die besser gefällt. Wie man sie bekommt und kompiliert ist hier beschrieben: Touchscreen-Interface anpassen

Die reguläre Benutzeroberfläche existiert etwas länger und hat eine Menge zusätzlicher Funktionen, so dass es nicht wirklich ratsam ist, sie tiefgreifend zu verändern. Du kannst einzelne html-Dateien ändern, um einige Funktionen zu entfernen. Beachte aber immer, dass du bei jedem Update auch eine aktualisierte Version dieser Dateien bereitstellen musst. Wir stellen hier auch die Quellen zur Verfügung, aber sie sind nicht so einfach zu benutzen, also kontaktiere uns bitte, wenn du Zugang zu ihnen benötigst.

Der wichtigste Punkt beim eigenen Branding ist ein eigener Updater. Ließ Eigener Updater für Repetier-Server für Details dazu. Nur mit einem eigenen Updater bist du in der Lage, deine eigenen Änderungen auch zu aktualisieren!

Hersteller-News

Als Hersteller möchtest du vielleicht einen zusätzlichen Kanal mit deinen Benutzer haben, um sie über wichtige Updates oder Upgrades für deine Drucker zu informieren. Ab Version 1.4.5 ist dies für alle Benutzer oder nur für Benutzer eines bestimmten Modells von dir problemlos möglich. Wir haben einen kleinen Editor entwickelt, in dem du deine Nachrichten definieren kannst, indem du deine letzte Nachrichtendatei hochlädst oder eine neue erstellst, wenn es das erste Mal ist. Du speicherst die News-Datei auf deinem eigenen Webserver, so dass du sie jederzeit ändern kannst. Um dies in deinem Repetier-Server zu ermöglichen, musst du eine zusätzliche Zeile mit der News-URL in die Konfiguration einfügen. Dies ist alles auf der Startseite des Editors beschrieben. Dies erfordert eine OEM- oder Pro-Lizenz!

Nachrichten-Editor öffnen

Individuelles OS-Image

Repetier-Server unterstützt zur Zeit 7 verschiedene CPU/OS-Kombinationen und kann daher auf vielen verschiedenen Hardwaresystemen laufen. Es ist nicht möglich, Beispielinstallationen für alle Kombinationen bereitzustellen, auf denen er laufen würde. Wir stellen ein Image für den beliebtesten SBC – den Raspberry Pi – zur Verfügung. Wenn dein Image auf Linux basiert, kannst du dieses Image als Inspiration für die Umsetzung verwenden.

Raspberry Pi Image

Nur um dir eine Liste guter Ergänzungen zu einem Basis-Image zu geben, hier ist, was wir mit dem Pi-Image gemacht haben. Es basiert auf dem offiziellen Raspbian OS, das auf Debian Bullseye basiert.

  • Erzwingt Sie eine Überprüfung des Dateisystems bei jedem Bootvorgang. Wenn der Pi nicht sauber heruntergefahren wurde, könnte er sich in einem ungültigen Zustand befinden.
  • Benutzerdefiniertes Logo anzeigen.
  • Erweitert das Dateisystem beim ersten Start auf die volle Größe der SD-Karte.
  • USB-Sticks immer in 3 speziellen Ordnern mounten, so dass wir sie in Repetier-Server als Importquellen hinzufügen können, um G-Code direkt vom USB-Stick zu importieren.
  • Eine eigene Logik für mjpg_streamer, die es erlaubt, angeschlossene Webcams automatisch zu erkennen und in der Benutzeroberfläche zur schnellen Konfiguration anzubieten.
  • Erlaubt die WLAN-Konfiguration über die Benutzeroberfläche mit der Möglichkeit der manuellen Überschreibung.
  • Vorkonfigurierter Desktop zum Starten von Chromium mit Touchscreen-GUI im Kiosk-Modus beim Starten.
  • Einfache Anpassung des Bildes mit dem Repetier-Setup-Tool.
  • Bildschirmschoner vom Repetier-Server aus steuern.
  • Zeigt einige Hardware-Informationen beim Blitz-Symbol an.
  • Unnötige Softwarepakete wurden entfernt.

Vielleicht fällt dir auf, dass das Pi-Image in den allgemeinen Einstellungen den Eintrag wifi und in der Webcam-Konfiguration die Webcams anzeigt. Dies wird durch spezielle Bash-Skripte und Einstellungen erreicht. Du findest sie alle in /usr/local/Repetier-Setup. Einige erfordern die Installation von Diensten oder udev-Regeln. Alle Dateien dafür befinden sich im Ordner template. Kopiere diese in dein Image und passe sie bei Bedarf an. Nur mit diesen Dateien siehst du die zusätzlichen Einträge in der Benutzeroberfläche.

Image vorbereiten

Du hast dein Image so bearbeitet, dass es genau deinen Vorstellungen entspricht, und möchtest es nun in ein Image umwandeln. Hier ist alles, was du wissen musst.

Beachte zunächst die Größe der SD-Karte. Du kannst ein Image nur dann auf einer neuen SD-Karte/einem neuen Laufwerk installieren, wenn das Zielgerät mindestens die gleiche Größe hat wie dein Original-Image. Du kannst mit einer kleinen Original-SD-Karte auskommen, z. B. 8 GB, so dass alle 16-GB-SD-Karten und größer keine Probleme haben. Das bedeutet immer noch, dass du mehrere GB an Daten hast, die keinen Nutzen haben, außer die Imagegröße zu erhöhen. Für unser Pi-Image verwenden wir PiShrink, um eine neue img-Datei aus unserem Image zu erstellen, bei der das Dateisystem auf die minimale Größe reduziert ist und noch etwas Spielraum für die Arbeit beim Booten bleibt.

Überprüfe auch, ob du eine Erweiterung des Dateisystems beim ersten Start aktiviert hast. In unserem Pi-Image legen wir eine Datei /usr/local/Repetier-Setup/etc/needExpandFS an, die unser Startskript erkennt und die Erweiterung ausführt. Das funktioniert nur mit unseren speziellen Startskripten, bei anderen Installationen braucht man vielleicht eine eigene Lösung oder die Linux-Variante hat eine Option dafür.

Prüfe, ob nicht benötigte Dateien entfernt wurden. Während der Entwicklung werden häufig Dateien erstellt, die später nicht benötigt werden, oder du kannst Protokolldateien entfernen und die apt-Datenbank bereinigen.

Wenn du verschiedene Drucker verkaufst und nur ein einziges Image wünscht, solltest du alle Drucker löschen und später nach der Installation das Drucker-Backup installieren, um das richtige Modell wiederherzustellen. Dies kann die Arbeit erheblich reduzieren.

Entferne die Datei key.sql vor dem Herunterfahren, um das Image zu erstellen. Diese Datei sollte niemals Teil eines Images sein – sie enthält alle Parameter, die pro Serverinstallation eindeutig sein müssen, wie Server-UUID, API-Schlüssel, Registrierungsschlüssel, Servername und einige mehr. Du solltest auch user.sql verwenden, um ohne bestehende Benutzer und einige andere Dateien zu liefern.

sudo service RepetierServer stop
sudo rm /var/lib/Repetier-Server/database/key.sql
sudo rm /var/lib/Repetier-Server/database/user.sql
sudo rm /var/lib/Repetier-Server/database/repetier-network.xml
sudo rm /var/lib/Repetier-Server/database/repetier-network-stored.xml
sudo rm /var/lib/Repetier-Server/database/history.sql
sudo shutdown -h now

Jetzt kannst du daraus ein Image machen, es verkleinern und zippen.

Für unser Image haben wir ein Skript, das alle Löschvorgänge automatisch durchführt. Du findest es unter /usr/local/Repetier-Setup/bin/prepareSnapshot, aber bitte verwende es nicht blindlings. Wir liefern ohne Druckerkonfigurationen und vieles mehr. Dies kann auch Dateien enthalten, die du behalten willst, also lösche die Zeilen für Dateien, die du behalten willst.