Poradnik
MQTT w Bambu Lab, po ludzku
Drukarki Bambu Lab zgłaszają swój stan przez MQTT – lekki protokół przesyłania wiadomości – bezpośrednio do aplikacji w Twojej sieci. Oto jak działa to połączenie i jak korzysta z niego Bambu Bar.
W skrócie
Każda drukarka Bambu Lab uruchamia w Twojej sieci lokalnej serwer MQTT na porcie 8883 z szyfrowaniem TLS. Aplikacja loguje się nazwą użytkownika bblp i kodem dostępu drukarki, subskrybuje temat raportów drukarki i otrzymuje aktualizacje stanu mniej więcej co sekundę.
Odczyt stanu działa w każdym trybie. Wysyłanie poleceń, takich jak wstrzymanie i zatrzymanie, działa w aplikacjach innych firm tylko przy włączonym trybie Tylko LAN i trybie programisty. Tak działa zarówno połączenie LAN w Bambu Studio, jak i Bambu Bar.
Połączenie
| Protokół | MQTT przez TLS |
| Port | 8883 na drukarce |
| Nazwa użytkownika | bblp |
| Hasło | 8-znakowy kod dostępu drukarki |
| Temat stanu | device/<serial>/report |
| Temat poleceń | device/<serial>/request |
Drukarka jest serwerem: aplikacje łączą się z nią bezpośrednio przez Twoją sieć, bez chmury Bambu Lab.
Raporty: co wysyła drukarka
Po połączeniu aplikacja raz prosi o pełny raport (żądanie pushall), a potem otrzymuje zmiany na bieżąco, podczas druku mniej więcej co sekundę. Raporty mają format JSON i zawierają zadanie i jego etap, postęp i warstwy, pozostały czas, temperatury dyszy, stołu i komory, wentylatory, gniazda AMS z ich filamentem oraz błędy drukarki (kody HMS).
Bambu Bar scala te zmiany w jeden obraz drukarki, który pokazują pasek menu, okno i widżety. Różne modele zgłaszają różne pola, dlatego A1 nie pokazuje temperatury komory, a H2D pokazuje dwie dysze.
Żądania: co wysyłają aplikacje
Polecenia trafiają do tematu żądań: wstrzymanie, wznowienie, zatrzymanie, prędkość druku, oświetlenie komory lub prośba o pełny raport. To drukarka decyduje, co przyjmie: w aktualnym oprogramowaniu sprzętowym aplikacje innych firm mogą wysyłać polecenia dotyczące wydruku tylko wtedy, gdy drukarka jest w trybie Tylko LAN z włączonym trybem programisty. W przeciwnym razie Bambu Bar pokazuje kłódkę na tych przyciskach. Zobacz dlaczego sterowanie jest zablokowane.
Certyfikaty: pewność, że to Twoja drukarka
Połączenie jest szyfrowane za pomocą TLS, a każda drukarka przedstawia certyfikat. Bambu Bar akceptuje drukarkę tylko wtedy, gdy łańcuch tego certyfikatu prowadzi do urzędów certyfikacji samego Bambu Lab, dołączonych do aplikacji, i jest wystawiony na numer seryjny drukarki. Dzięki temu żadne inne urządzenie w Twojej sieci nie może podszyć się pod drukarkę i przechwycić kodu dostępu.
Wykrywanie i kamera
- Wykrywanie: drukarki ogłaszają się w Twojej sieci przez UDP (port 2021). Dzięki temu aplikacje wyświetlają drukarki bez podawania adresu IP, a Bambu Bar zauważa, gdy drukarka dostanie nowy adres.
- Kamera nie korzysta z MQTT: drukarki X1, H2, H3C, P2S i X2D przesyłają obraz przez RTSPS (port 322, z włączoną opcją LAN Only Liveview), a drukarki P1, A1 i A2L – przez szyfrowany strumień JPEG (port 6000). Zobacz kamerę na Twoim Macu.
Zajrzyj do raportów samodzielnie
Do diagnostyki raporty może odczytać dowolny klient MQTT. Na przykład za pomocą narzędzi wiersza poleceń Mosquitto, z wartościami Twojej drukarki w miejsce symboli zastępczych:
mosquitto_sub -h <printer-ip> -p 8883 -u bblp -P <access-code> --insecure -t "device/<serial>/report"
--insecure pomija sprawdzanie certyfikatu, więc używaj go tylko w sieci, której ufasz, i tylko do odczytu. Nigdy nie wklejaj kodu dostępu ani numeru seryjnego na forach ani w zgłoszeniach błędów.
To nie jest publiczne API
To protokół, którego aplikacje samego Bambu Lab używają w sieci lokalnej, a nie udokumentowane, stabilne API: pola różnią się między modelami i wersjami oprogramowania sprzętowego, a Bambu Lab może zmienić to, co drukarka przyjmuje. Bambu Bar śledzi te zmiany, więc nie musisz się nimi przejmować. Zobacz wyjaśnienie trybu LAN, aby poznać odpowiednie ustawienia drukarki, oraz gdzie znaleźć kod dostępu.
Pytania i odpowiedzi
Jakiego portu używa drukarka Bambu Lab dla MQTT?
Portu 8883, z TLS. Nazwa użytkownika to bblp, a hasło to kod dostępu drukarki.
Czy do odczytu stanu przez MQTT potrzebuję trybu Tylko LAN?
Nie. Drukarka zgłasza stan aplikacjom lokalnym także w trybie chmury. Tryb Tylko LAN z włączonym trybem programisty jest potrzebny, by aplikacje innych firm mogły wysyłać polecenia dotyczące wydruku.
Czy Bambu Bar korzysta z chmury Bambu Lab?
Nie. Łączy się bezpośrednio z lokalnym serwerem MQTT drukarki, tak jak Bambu Studio w trybie LAN, i najpierw sprawdza certyfikat drukarki.
Czytaj dalej
- Tryb LAN – wyjaśnienieTryb chmury, Tylko LAN, LAN Only Liveview i tryb programisty: cztery różne ustawienia i to, których naprawdę potrzebujesz.
- Tryb programisty i blokada sterowaniaDlaczego wstrzymanie, zatrzymanie i prędkość mają w Bambu Bar kłódkę, co tryb programisty zmienia w drukarce i czy go potrzebujesz.
- Kod dostępu i adres IPGdzie drukarka pokazuje swój 8-znakowy kod dostępu i adres IP oraz jak użyć ich do połączenia z Maca.
- Prywatność: lokalne dane drukarek i analityka stronyJak Bambu Bar obsługuje lokalne dane drukarek, kody dostępu, podgląd z kamery, licencje wspierających i analitykę strony.

Przestań biegać do drukarki
Śledź wydruki Bambu Lab na Macu: postęp, pozostały czas, temperatury, filament AMS i obraz z kamery na żywo. Powiadomienia i widżety na biurku bez otwierania Bambu Studio.
Postęp druku, powiadomienia i filamentmacOS 26+, Apple silicon i Intel Windows i Linux już wkrótce