OctoPrint

OctoPrint anbinden: Druckstatus, laufenden Druckjob und Temperaturen anzeigen und den Drucker steuern.

Stable 1.1Beta 2.0536 Downloads18 in 30 Tagen

Privat kostenlos Gewerblich auf Anfrage Anfrage senden

Diese Dokumentation beschreibt immer die neueste Version des Moduls, aktuell 2.0 im Kanal Beta. Im Kanal Stable liegt noch die Version 1.1. Dort können Funktionen fehlen, die hier beschrieben sind.

OctoConnect

Diese Splitter-Instanz stellt die Verbindung zum OctoPrint-Server her. Sie sendet Befehle per HTTP an die OctoPrint-API und verteilt die Statusdaten, die über den WebSocket Client eintreffen, an die Kind-Instanzen. Sie zeigt ihren Zustand im Instanzstatus an (API URL oder Key fehlt, OctoPrint nicht erreichbar, Key ungültig). Normalerweise wird sie über die OctoPrint Discovery angelegt, sie kann aber auch von Hand angelegt werden. Als übergeordnete Instanz dient ein WebSocket Client mit der Adresse ws://<IP>:<Port>/sockjs/websocket.

Inhaltsverzeichnis

1. Konfiguration

FeldBeschreibung
API URLAdresse des OctoPrint-Servers mit Port, zum Beispiel http://192.168.1.10:5000.
API KeySchlüssel für die OctoPrint-API. Er wird für die Befehle und für die Anmeldung am WebSocket benötigt. Ein Benutzername und ein Passwort sind nicht nötig.
AktualisierungsintervallWie oft OctoPrint den Status sendet, als Vielfaches von 0,5 Sekunden. Standard 2 (jede Sekunde). Größere Werte verringern die Last.

Der Button API Key anfordern holt einen Key über die Application Keys von OctoPrint (ab OctoPrint 1.3.10, das Plugin muss aktiv sein):

  1. API URL eintragen und die Änderungen übernehmen.
  2. Auf den Button klicken. Die Anfrage “IP-Symcon OctoPrint” in der OctoPrint-Weboberfläche bestätigen. Dafür bleiben 90 Sekunden Zeit.
  3. Der Key wird in das Feld eingetragen. Danach die Änderungen noch einmal übernehmen.

Alternativ kann ein vorhandener User-Key oder der globale API Key von Hand eingetragen werden. Der Key braucht die Rechte, den Status zu lesen und Befehle auszuführen.

Der Button Anmelden meldet sich erneut am WebSocket an.

Fehler bei Befehlen (zum Beispiel “Pause” ohne laufenden Druck) stehen als Warnung im Meldungsfenster mit dem HTTP-Code von OctoPrint.

2. Variablen

Diese Instanz legt keine Variablen an. Die Daten gehen an die Kind-Instanzen.

3. Funktionen

string OCTO_sendHTTPRequest(integer $InstanzID, string $Endpoint, array $Params, string $Method); Sendet eine Anfrage an die OctoPrint-API (GET, POST, PUT oder DELETE, Standard GET) und gibt die Antwort als Text zurück. Bei einem Verbindungsfehler ist der Rückgabewert leer.

void OCTO_OctoPrintLogin(integer $InstanzID); Meldet sich mit dem API Key bei OctoPrint an und übergibt die Session an den WebSocket. Wird beim Verbinden und bei reauthRequired automatisch aufgerufen. Der alte Name OCTO_OtcoPrintLogin() bleibt als veralteter Alias erhalten.

void OCTO_RequestAPIKey(integer $InstanzID); Fordert einen API Key über die Application Keys an. Die Funktion wartet bis zu 90 Sekunden auf die Bestätigung in OctoPrint und ist für den Button im Formular gedacht.

OCTO_OctoPrintLogin(12345);

4. Spenden

Dieses Modul ist für die nicht kommerzielle Nutzung kostenlos, Schenkungen als Unterstützung für den Autor werden hier akzeptiert:

PayPal Amazon Wunschzettel

5. Lizenz

CC BY-NC-SA 4.0