Zum Hauptinhalt springen

Bambu Lab Smart-Home-Integration, kostenlos und Open Source

Bambu Lab-Integration für Gladys Assistant

Verfolge und steuere deine Bambu-Lab-3D-Drucker lokal: Fortschritt, Temperaturen, AMS, Alarme.

Auf GitHub ansehenAlle externen Integrationen

Verfolge und steuere deine Bambu-Lab-3D-Drucker (Serien X1, P1, A1, H2 und P2S) aus Gladys: Status, Fortschritt, Restzeit, Schichten, Temperaturen, AMS-Spulen, HMS-Fehler, Bauraumlicht, Geschwindigkeit, Pause und Fortsetzen, Kamerabild (P1 und A1). Alles bleibt in deinem lokalen Netzwerk: Gladys spricht direkt mit dem Drucker (verschlüsseltes MQTT auf Port 8883, wie Bambu Studio im LAN-Modus), ohne die Bambu-Lab-Cloud.

Ohne die Hardware entwickelt: Die Integration wurde mit echten Druckermeldungen (vom Projekt ha-bambulab veröffentlicht) getestet, die ein echter verschlüsselter MQTT-Broker abgespielt hat, aber noch nicht an einem physischen Drucker. Rückmeldungen sind im Gladys-Forum willkommen.

Voraussetzungen​

  • Gladys Assistant 5.1 oder neuer.
  • Ein Bambu-Lab-Drucker im selben lokalen Netzwerk wie Gladys.
  • Seine Seriennummer (Druckereinstellungen, Geräteinformationen, oder Bambu Handy / Bambu Studio) und sein LAN-Zugangscode (auf dem Druckerdisplay in den Netzwerk-/WLAN-Einstellungen angezeigt).
  • Um aus Gladys mit einer aktuellen Firmware (X1 01.08.05, P1 01.08.02, A1 01.05 und neuer, die „Authorization Control“ von 2025) zu pausieren, fortzusetzen, abzubrechen oder die Geschwindigkeit zu ändern: Schalte am Drucker den Nur-LAN-Modus und dann den Entwicklermodus ein. Ohne ihn lehnt der Drucker diese Befehle ab; Status, Licht und Kamera funktionieren trotzdem. Achtung: Im Nur-LAN-Modus funktionieren Bambu Handy und das Drucken über die Cloud nicht mehr. Siehe das Bambu-Lab-Wiki.

Konfiguration​

  1. Öffne den Reiter Konfiguration der Integration.
  2. Gib die Seriennummer (zum Beispiel 01P00A000000000) und den Zugangscode des Druckers ein.
  3. IP-Adresse: optional. Leer gelassen hört Gladys auf die Ankündigungen des Druckers im Netzwerk und findet ihn selbst (und folgt ihm, wenn sich seine Adresse ändert). Gib sie ein, wenn die Suche den Drucker nicht findet. Speichere.
  4. Die Schaltfläche Drucker im Netzwerk suchen listet die Drucker, die sich melden: Name, Modell, Adresse, Seriennummer, LAN-Modus.
  5. Ein zweiter oder dritter Drucker: Fülle Drucker 2 und Drucker 3 genauso aus.
  6. Kamerabilder (standardmäßig an): ein Bild pro Minute während eines Drucks und auf Anfrage, für die Serien P1 und A1.
  7. Zertifikat des Druckers prüfen (standardmäßig an): Die Verbindung ist verschlüsselt, und das Zertifikat des Druckers wird gegen die Bambu-Lab-Zertifizierungsstellen geprüft. Schalte es nur aus, wenn die Verbindung mit einem Zertifikatsfehler scheitert (ein sehr neues Modell).
  8. Sprache legt die Sprache der Funktionsnamen und Texte fest, die die Integration erzeugt (Standard: Französisch). Funktionsnamen werden beim Hinzufügen des Geräts in Gladys festgelegt.

Die Schaltfläche Verbindung testen zeigt für jeden Drucker Modell, Firmware und Status, und ob die Firmware Befehle ablehnt. Füge den Drucker danach im Reiter Entdecken hinzu.

Das Druckergerät​

Ein Gerät pro Drucker, benannt nach dem Namen des Druckers (von der Netzwerksuche gefunden) oder nach seinem Modell. Der Drucker sendet seinen Status jede Sekunde; die Integration gibt ihn höchstens alle 5 Sekunden an Gladys weiter, und sofort, wenn sich der Druckstatus ändert.

FunktionWas sie zeigt
StatusBereit, Vorbereitung, Druckt, Pausiert, Fertig, Fehlgeschlagen, Offline, Drucker nicht erreichbar, Zugangscode abgelehnt
DateiDer Name des laufenden oder letzten Drucks
FortschrittProzent des Drucks
RestzeitVom Drucker geschätzt, in Minuten
Schicht, Schichten gesamtSchichtnummern (eine Szene kann „Schicht > 3“ prüfen)
Düse, DruckbettTemperaturen in ganzen Grad und ihre Sollwerte, nur lesbar
BauraumBauraumtemperatur (X1, H2, P2S) und ihr Sollwert bei Modellen mit beheiztem Bauraum (X1E, H2)
DruckgeschwindigkeitListe: Leise, Standard, Sport, Extrem (während eines Drucks)
BauraumlichtSchalter
Pausieren, FortsetzenDrucktasten
HMS-Fehler„Kein Fehler“ oder Code und Text des ersten HMS-Fehlers (und die Zahl der weiteren)
KameraDas Kamerabild (Serien P1 und A1)

Am Gerät gibt es absichtlich keine Taste Abbrechen: Ein Tippen ohne Bestätigung würde einen Druck ruinieren. Abbrechen bieten das Widget (mit Bestätigung) und die Szenen an. Die Solltemperaturen sind nur lesbar, und die Integration heizt nie: Nichts kann vom Dashboard, von HomeKit, Alexa oder Google aus ein Heizen starten. Für Gladys sind es „Gerätetemperaturen“, die nie zur Raumtemperatur zählen. Das Licht ist ein Schalter, keine Lampe: Eine Szene „alle Lichter aus“ lässt einen Druck (und seinen Zeitraffer) nicht im Dunkeln.

Dashboard-Widget​

Füge das Widget Bambu-Lab-3D-Druck zu einem Dashboard hinzu und wähle den Drucker in seinen Einstellungen. Es zeigt:

  • die Fortschrittsanzeige, die Restzeit, die Temperaturen von Düse und Druckbett (live);
  • das letzte Kamerabild (P1, A1);
  • Status, Datei, Schicht, voraussichtliches Ende, Geschwindigkeit, HMS-Fehler;
  • die im AMS geladenen Spulen (AMS A1, AMS A2… AMS B1 für ein zweites AMS): Material, Farbe und geschätzter Rest, die verwendete mit einem Haken markiert; sonst die externe Spule;
  • die gerade passenden Tasten: Pausieren oder Fortsetzen und Abbrechen (fragt nach Bestätigung) während eines Drucks, sonst Licht an oder Licht aus. Lehnt die Firmware Befehle ab, sagt das Widget es („Entwicklermodus nötig“), statt nutzlose Tasten zu zeigen.

Szenenauslöser​

In der Kategorie Integrationen des Szeneneditors. Jeder lässt sich auf einen Drucker beschränken.

  • Druck gestartet: Variablen Druckername, Datei.
  • Druck fertig: Variablen Druckername, Datei, Druckdauer (als Text wie 1 Std. 05 Min. und in Minuten).
  • Druck fehlgeschlagen oder abgebrochen: lässt sich auf einen Grund beschränken (abgebrochen, Fehler). Variablen Druckername, Datei, Dauer, Grund, Fehlercode und Fehlermeldung.
  • Druck pausiert: von jemandem oder vom Drucker selbst (Filamentende, Stau). Variablen Druckername, Datei, verstrichene Zeit, Fehlercode und Fehlermeldung, falls vorhanden.
  • HMS-Fehler: eine neue Meldung der Zustandsüberwachung des Druckers. Lässt sich auf einen Schweregrad beschränken (fatal, schwer, häufig, Information). Variablen Druckername, Code (0300_0100_0001_0007), Meldung (in der Sprache der Integration), Schweregrad.

Die Variablen liest du in den folgenden Aktionen zum Beispiel mit {{triggerEvent.data.file}} und {{triggerEvent.data.message}}. Die Auslöser folgen dem Drucker selbst: Ein aus Bambu Studio gestarteter oder am Display pausierter Druck löst sie auch aus.

Szenenaktionen​

  • Druck pausieren, fortsetzen oder abbrechen: gibt Ausgeführt falsch zurück, wenn nichts zu pausieren, fortzusetzen oder abzubrechen war (die Szene läuft weiter). Ein Abbruch ist endgültig.
  • Bauraumlicht ein- oder ausschalten: funktioniert auch ohne Entwicklermodus.
  • Druckgeschwindigkeit ändern: Leise, Standard, Sport, Extrem; nur während eines Drucks (sonst Ausgeführt: falsch).

Szenenbeispiele​

  • Druck fertig → Benachrichtigung: Auslöser Druck fertig, Aktion „Nachricht senden“: {{triggerEvent.data.file}} fertig in {{triggerEvent.data.duration}}.
  • Rauch erkannt → alles stoppen: Auslöser am Rauchmelder, Aktionen Druck pausieren, fortsetzen oder abbrechen (abbrechen), dann die smarte Steckdose des Druckers ausschalten.
  • Nachts leise: um 22 Uhr Druckgeschwindigkeit ändern (Leise); ohne Wirkung, wenn nichts druckt.
  • Schwerer Fehler → Alarm: Auslöser HMS-Fehler, beschränkt auf die Schweregrade fatal und schwer, Aktion „Nachricht senden“: {{triggerEvent.data.printer}}: {{triggerEvent.data.message}}.

Fehlerbehebung​

  • Drucker nicht erreichbar: Prüfe die IP-Adresse (Druckerdisplay, Netzwerkeinstellungen), dass der Drucker eingeschaltet und im selben Netzwerk wie Gladys ist. Lass die Adresse leer, damit Gladys ihn sucht.
  • Zugangscode oder Seriennummer abgelehnt: Der Zugangscode kann sich ändern (LAN-Modus aus- und wieder eingeschaltet, Zurücksetzen); gib ihn neu ein. Prüfe auch die Seriennummer (15 Zeichen). Nach einer Ablehnung wartet die Integration 5 Minuten, bevor sie es erneut versucht.
  • Unerwartetes Zertifikat: ein Modell, das neuer ist als die Zertifizierungsstellen, die die Integration kennt; schalte Zertifikat des Druckers prüfen aus und melde es im Forum. Ohne Prüfung folgt Gladys dem Drucker nicht mehr, wenn sich seine Adresse ändert (eine Netzwerkankündigung könnte gefälscht sein): Gib seine IP-Adresse ein.
  • „Die Drucker-Firmware nimmt nur Befehle aus Bambu-Lab-Apps an“: Schalte am Drucker den Nur-LAN-Modus und dann den Entwicklermodus ein (siehe Voraussetzungen).
  • Die Netzwerksuche findet nichts: Die Suche hört 10 Sekunden lang auf die Ankündigungen der Drucker (UDP-Ports 1990 und 2021, über Gladys); ein Netzwerk, das Broadcasts sperrt (VLAN, Gast-WLAN), verbirgt sie. Gib dann die IP-Adresse ein.
  • Kein Kamerabild: Nur die Serien P1 und A1 haben eine so erreichbare Kamera; Gladys lehnt ein Bild über 150 KB ab.
  • Protokolle: auf der Seite der Integration in Gladys oder mit docker logs auf dem Host. LOG_LEVEL=debug zeigt die Details. Der Zugangscode erscheint nie in den Protokollen.

Grenzen​

  • Höchstens drei Drucker.
  • Kein Hochladen von Dateien und kein Starten von Drucken, keine G-Code-Befehle, keine Temperatureinstellung, kein Zeitraffer.
  • Kamera: nur Serien P1 und A1 (die Serien X1, H2 und P2S filmen über RTSPS, das die Integration nicht liest), ein Bild pro Minute während eines Drucks und auf Anfrage, kein Videostream.
  • H2D: Die angezeigte Temperatur ist die der aktiven Düse.
  • Die Texte der HMS-Fehler stammen aus den Tabellen, die Bambu Lab veröffentlicht (von ha-bambulab gesammelt): Ein sehr neuer Code kann ohne Text erscheinen.
  • Ein Druck, der endet, während die Integration getrennt war, löst keine Szene aus.
  • Ohne die Hardware entwickelt: Rückmeldungen willkommen.
  • Keine Verbindung zu Bambu Lab.

Konfigurationseinstellungen​

Diese Einstellungen fragt Bambu Lab in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Verbinde deinen Bambu-Lab-DruckersectionNeinGladys spricht mit dem Drucker in deinem lokalen Netzwerk, ohne die Bambu-Lab-Cloud. Öffne auf dem Druckerdisplay die Netzwerkeinstellungen: Notiere den Zugangscode (und die IP-Adresse) und schalte den Nur-LAN-Modus mit dem Entwicklermodus ein, wenn du Drucke aus Gladys pausieren, fortsetzen oder abbrechen willst (aktuelle Firmwares lehnen diese Befehle sonst ab; Lesen klappt immer). Die Seriennummer steht in den Geräteeinstellungen des Druckers oder in Bambu Handy. Bis zu drei Drucker.
SeriennummerstringJa
ZugangscodesecretJaWird auf dem Druckerdisplay in den Netzwerkeinstellungen (WLAN) angezeigt.
IP-AdressestringNeinOptional: Leer gelassen sucht Gladys den Drucker im Netzwerk.
Drucker 2 (optional)sectionNeinEin weiterer Bambu-Lab-Drucker, genauso verbunden.
Seriennummer 2stringNein
Zugangscode 2secretNeinWird auf dem Druckerdisplay in den Netzwerkeinstellungen (WLAN) angezeigt.
IP-Adresse 2stringNeinOptional: Leer gelassen sucht Gladys den Drucker im Netzwerk.
Drucker 3 (optional)sectionNeinEin weiterer Bambu-Lab-Drucker, genauso verbunden.
Seriennummer 3stringNein
Zugangscode 3secretNeinWird auf dem Druckerdisplay in den Netzwerkeinstellungen (WLAN) angezeigt.
IP-Adresse 3stringNeinOptional: Leer gelassen sucht Gladys den Drucker im Netzwerk.
OptionensectionNeinSprache der Namen und Texte, die die Integration erzeugt (Funktionsnamen werden beim Hinzufügen des Geräts festgelegt).
Kamerabilder (Serien P1 und A1)booleanNeinEin Bild pro Minute während eines Drucks und auf Anfrage.
Zertifikat des Druckers prüfenbooleanNeinGegen die Bambu-Lab-Zertifizierungsstellen. Schalte es nur aus, wenn die Verbindung mit einem Zertifikatsfehler scheitert.
SpracheselectNein

So installierst du Bambu Lab in Gladys​

  1. Öffne in Gladys Integrationen: Bambu Lab erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/guim31/gladys-bambulab:1.0.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-bambulab.

Bambu Lab benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.

Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.

Über externe Integrationen​

Bambu Lab ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂
Zuletzt aktualisiert am