Bambu Lab MQTT, in gewone taal

De verbinding

De printer is de server: apps maken er rechtstreeks verbinding mee via je netwerk, zonder de cloud van Bambu Lab.

Rapporten: wat de printer verstuurt

Na het verbinden vraagt een app één keer om een volledig rapport (een pushall-verzoek) en ontvangt daarna de wijzigingen zodra ze gebeuren, tijdens het printen ongeveer elke seconde. Rapporten zijn JSON en bevatten de printopdracht en de fase ervan, voortgang en lagen, resterende tijd, de temperaturen van nozzle, printbed en kamer, ventilatoren, de AMS-trays met hun filament en printerfouten (HMS-codes).

Bambu Bar voegt die wijzigingen samen tot één beeld van de printer, en dat is wat de menubalk, het venster en de widgets tonen. Verschillende modellen geven verschillende velden door; daarom toont een A1 geen kamertemperatuur en een H2D twee nozzles.

Verzoeken: wat apps versturen

Opdrachten gaan naar het verzoektopic: pauzeren, hervatten, stoppen, printsnelheid, de kamerverlichting of een verzoek om een volledig rapport. De printer bepaalt wat hij accepteert: met de huidige firmware kunnen apps van derden alleen printopdrachten sturen als de printer in de modus Alleen LAN staat met Ontwikkelaarsmodus aan. Anders toont Bambu Bar een slotje op die knoppen. Zie waarom de bediening vergrendeld is.

Certificaten: zeker weten dat het jouw printer is

De verbinding is versleuteld met TLS, en elke printer toont een certificaat. Bambu Bar accepteert de printer alleen als dat certificaat terug te voeren is op de eigen certificaatautoriteiten van Bambu Lab, die met de app worden meegeleverd, en is uitgegeven voor het serienummer van de printer. Zo kan geen ander apparaat op je netwerk zich voordoen als de printer en de toegangscode onderscheppen.

Zoeken en de camera

• Zoeken: printers melden zich op je netwerk via UDP (poort 2021). Zo vinden apps printers zonder dat je een IP-adres invoert, en zo merkt Bambu Bar wanneer een printer een nieuw adres krijgt.
• De camera loopt niet via MQTT: X1-, H2-, H3C-, P2S- en X2D-printers streamen hem via RTSPS (poort 322, met LAN Only Liveview aan), en P1-, A1- en A2L-printers via een versleutelde JPEG-stream (poort 6000). Zie de camera op je Mac.

Zelf de rapporten bekijken

Voor diagnose kan elke MQTT-client de rapporten lezen. Met de opdrachtregeltools van Mosquitto, en de waarden van je eigen printer in plaats van de plaatshouders:

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

--insecure slaat de controle van het certificaat over, dus gebruik het alleen op een netwerk dat je vertrouwt, en alleen om te lezen. Plak je toegangscode of serienummer nooit in fora of bugrapporten.

Geen openbare API

Dit is het protocol dat de eigen apps van Bambu Lab op het lokale netwerk gebruiken, geen gedocumenteerde, stabiele API: velden verschillen per model en firmwareversie, en Bambu Lab kan veranderen wat de printer accepteert. Bambu Bar houdt die veranderingen bij, zodat jij dat niet hoeft te doen. Zie LAN-modus uitgelegd voor de betrokken printerinstellingen en waar je de toegangscode vindt.