Bambu Lab MQTT, einfach erklärt

Die Verbindung

Der Drucker ist der Server: Apps verbinden sich direkt über dein Netzwerk mit ihm, ohne die Cloud von Bambu Lab.

Reports: was der Drucker sendet

Nach dem Verbinden fordert eine App einmal einen vollständigen Report an (eine pushall-Anfrage) und empfängt danach Änderungen, sobald sie passieren, während eines Drucks etwa jede Sekunde. Reports sind JSON und enthalten den Auftrag und seine Phase, Fortschritt und Schichten, Restzeit, Düsen-, Druckbett- und Kammertemperatur, Lüfter, die AMS-Slots mit ihrem Filament und Druckerfehler (HMS-Codes).

Bambu Bar führt diese Änderungen zu einem Gesamtbild des Druckers zusammen, das Menüleiste, Fenster und Widgets anzeigen. Verschiedene Modelle melden verschiedene Felder, deshalb zeigt ein A1 keine Kammertemperatur und ein H2D zwei Düsen.

Requests: was Apps senden

Befehle gehen an das Request-Topic: Pausieren, Fortsetzen, Stoppen, Druckgeschwindigkeit, die Kammerbeleuchtung oder die Anfrage nach einem vollständigen Report. Was er annimmt, entscheidet der Drucker: Mit aktueller Firmware können Apps von Drittanbietern Druckbefehle nur senden, wenn der Drucker im Nur-LAN-Modus mit eingeschaltetem Entwicklermodus ist. Sonst zeigt Bambu Bar ein Schloss auf diesen Tasten. Siehe warum die Steuerung gesperrt ist.

Zertifikate: Ist es wirklich dein Drucker?

Die Verbindung ist mit TLS verschlüsselt, und jeder Drucker legt ein Zertifikat vor. Bambu Bar akzeptiert den Drucker nur, wenn dieses Zertifikat auf die eigenen Zertifizierungsstellen von Bambu Lab zurückgeht, die mit der App ausgeliefert werden, und auf die Seriennummer des Druckers ausgestellt ist. So kann sich kein anderes Gerät in deinem Netzwerk als der Drucker ausgeben und den Zugangscode abgreifen.

Erkennung und Kamera

• Erkennung: Drucker kündigen sich in deinem Netzwerk über UDP an (Port 2021). So listen Apps Drucker ohne IP-Adresse auf, und so bemerkt Bambu Bar, wenn ein Drucker eine neue bekommt.
• Die Kamera läuft nicht über MQTT: X1, H2, H3C, P2S und X2D streamen sie über RTSPS (Port 322, mit eingeschaltetem LAN Only Liveview), P1, A1 und A2L über einen verschlüsselten JPEG-Stream (Port 6000). Siehe die Kamera auf deinem Mac.

Die Reports selbst ansehen

Zur Diagnose kann jeder MQTT-Client die Reports lesen. Mit den Kommandozeilenwerkzeugen von Mosquitto und den Werten deines Druckers anstelle der Platzhalter:

mosquitto_sub -h <printer-ip> -p 8883 -u bblp -P <access-code> --insecure -t "device/<serial>/report"

--insecure überspringt die Zertifikatsprüfung, nutze die Option also nur in einem Netzwerk, dem du vertraust, und nur zum Lesen. Füge deinen Zugangscode oder deine Seriennummer nie in Foren oder Fehlerberichte ein.

Keine öffentliche API

Das ist das Protokoll, das die Apps von Bambu Lab selbst im lokalen Netzwerk nutzen, keine dokumentierte, stabile API: Die Felder unterscheiden sich zwischen Modellen und Firmwareversionen, und Bambu Lab kann ändern, was der Drucker annimmt. Bambu Bar verfolgt diese Änderungen, damit du es nicht tun musst. Siehe LAN-Modus erklärt für die beteiligten Druckereinstellungen und wo du den Zugangscode findest.