Creality 3D Drucker Integration

Was dieser Adapter bewirkt

Verbindet Creality Klipper-Drucker (primäres Ziel: SPARKX i7 mit CFS lite) über zwei lokale APIs mit ioBroker:

Moonraker HTTP (Standardport)7125 ) — Druckstatistiken, Temperaturen, Lüfter, CFS-Filamentbox, G-Code
Creality WebSocket (Standardport)9999 ) — LED am Werkzeugkopf, Pause/Fortsetzen/Stopp, Status der Nivellierung/des Selbsttests, verbleibende Zeit (printLeftTime )

Moonraker allein reicht nicht aus, um die Creality-UI-Zustände anzuzeigen (z. B. Levelaufstiege, während Klipper noch Meldungen ausgibt).standby ) oder die Werkzeugkopfleuchte.

Hersteller: Creality . Andere Creality Klipper-Modelle funktionieren möglicherweise nach bestem Wissen und Gewissen; bisher wurde nur der SPARKX i7 getestet.

Konfiguration

Einstellung	Standard	Beschreibung
Host / IP	—	Druckeradresse (erforderlich)
Moonraker HTTP-Port	`7125`	Fluidd Reverse Proxy verwendet häufig`4408`
Creality WebSocket-Port	`9999`	Werkzeugkopf-LED und Drucksteuerung
Umfrageintervall	`5` S	Moonraker-Umfrage (Min. 2 Sek.)
API-Schlüssel	leer	Optionale Moonraker-Autorisierung
Drucksteuerung / CFS / Lüfter	An	Funktionsumschalter für den Zustandsbaum

Ein Drucker pro Adapterinstanz.

Datenpunkte

Untercreality.<instance>.* (Beispiele):

Zustand	Beschreibung
`state` /`stateKlipper` /`selfTestStep`	UI-/Klipper-Status
`currentJob.*`	Fortschritt, Datei, Zeiten, Schichten, Vorschub/Fluss, aktives Filament
`info.*`	Modell, Firmware, Hostname, Seriennummer, Festplatte, Druckstunden/Druckaufträge, Fehler
`temp.*`	Düse, Bett, Kasten/Kammer
`fans.partCooling`	Teilekühlungs -UI % (entspricht der Anzeige des Slicers/Druckers; Creality)`fan0_min` Neuzuordnung)
`fans.partCoolingPwm`	PWM-% für die Teilekühlung (Rohdaten des Hardware-Tastverhältnisses von Moonraker)
`fans.` /`cfs.`	Andere Lüfter / CFS (optional)
`control.light` /`sleepMode` /`pause` /`resume` /`stop`	Bedienelemente
`webcam.available`	Kamera vorhanden (schreibgeschützt; die lokale API kann sie auf dem SPARKX i7 nicht ausschalten)
`webcam.streamUrl`	URL für VIS-iFrame (Creality WebRTC-Seite, Standard)`http://<host>:8000` )
`webcam.webrtcUrl`	WebRTC-Signalisierungsendpunkt

Hinweis zur Webcam: SPARKX verwendet WebRTC auf Port8000 , nicht klassisches MJPEG.webcam.streamUrl Verweist auf die Creality-Viewer-Seite – verwendbar in einem VIS-iFrame, sofern der Browser die Drucker-IP-Adresse erreichen kann. Für Home Assistant / go2rtc verwenden Siewebcam.webrtcUrl Die

Unterstützung

Wenn Ihnen unsere Arbeit gefällt und Sie uns unterstützen möchten, freuen wir uns über jede Spende. (Dieser Link führt zu unserem PayPal-Konto und steht in keiner Verbindung zu ioBroker.)

Changelog

0.4.1 (2026-08-25)

(skvarel) Fixed currentJob.filament* for external spool holder (filament_rack) when CFS is not active

0.4.0 (2026-08-20)

(skvarel) Adapter requires admin >= 7.8.23 now.

0.3.0 (2026-08-14)

(skvarel) Fixed button states control.pause|resume|stop to use read: false
(skvarel) Added manufacturer / SPARKX i7 product links to README
(skvarel) Modified CFS temperature/humidity roles to value.temperature / value.humidity
(skvarel) Modified Moonraker poll loop to use setTimeout chain instead of setInterval
(skvarel) Modified currentJob.finishAt to include local date (YYYY-MM-DD HH:MM)

0.2.0 (2026-08-08)

(skvarel) Fixed part cooling fan % to match slicer/display (Creality fan0_min remapping)
(skvarel) Added fans.partCoolingPwm for raw PWM duty cycle

0.1.4 (2026-08-02)

(skvarel) Fixed string state roles for repository object check

License

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.