Перейти до вмісту
Bambu Bar

Посібник

MQTT у Bambu Lab — простими словами

Принтери Bambu Lab повідомляють свій стан через MQTT — легкий протокол обміну повідомленнями — напряму програмам у вашій мережі. Ось як працює це з’єднання і як його використовує Bambu Bar.

Коротко

Кожен принтер Bambu Lab запускає сервер MQTT у вашій локальній мережі, на порту 8883 із шифруванням TLS. Програма входить з іменем користувача bblp і кодом доступу принтера, підписується на топік звітів принтера й отримує оновлення стану приблизно щосекунди.

Читання стану працює в будь-якому режимі. Надсилати команди, як-от пауза й зупинка, сторонні програми можуть лише з увімкненими Лише LAN і режимом розробника. Саме так працюють і LAN-з’єднання Bambu Studio, і Bambu Bar.

З’єднання

Протокол MQTT через TLS
Порт 8883 на принтері
Ім’я користувача bblp
Пароль 8-символьний код доступу принтера
Топік стану device/<serial>/report
Топік команд device/<serial>/request

Сервером є принтер: програми підключаються до нього напряму через вашу мережу, без хмари Bambu Lab.

Звіти: що надсилає принтер

Після підключення програма один раз запитує повний звіт (запит pushall), а потім отримує зміни в міру того, як вони відбуваються, — під час друку приблизно щосекунди. Звіти мають формат JSON і містять завдання та його етап, прогрес і шари, залишок часу, температури сопла, столу й камери друку, вентилятори, лотки AMS з їхнім філаментом і помилки принтера (коди HMS).

Bambu Bar об’єднує ці зміни в одну картину стану принтера — саме її показують смуга меню, вікно й віджети. Різні моделі повідомляють різні поля, тому A1 не показує температуру камери друку, а H2D показує два сопла.

Запити: що надсилають програми

Команди надходять у топік запитів: пауза, продовження, зупинка, швидкість друку, освітлення камери або запит повного звіту. Що прийняти, вирішує принтер: на поточній прошивці сторонні програми можуть надсилати команди друку, лише коли принтер працює в режимі Лише LAN з увімкненим режимом розробника. Інакше Bambu Bar показує на цих кнопках замок. Див. чому керування заблоковано.

Сертифікати: це справді ваш принтер

З’єднання зашифровано TLS, і кожен принтер надає сертифікат. Bambu Bar приймає принтер, лише якщо ланцюжок цього сертифіката веде до власних центрів сертифікації Bambu Lab, які постачаються разом із програмою, і виданий на серійний номер принтера. Так жоден інший пристрій у вашій мережі не зможе видати себе за принтер і вивідати код доступу.

Пошук принтерів і відеокамера

  • Пошук: принтери оголошують про себе у вашій мережі через UDP (порт 2021). Так програми показують принтери без IP-адреси, і так Bambu Bar помічає, що принтер отримав нову адресу.
  • Відеокамера працює не через MQTT: принтери X1, H2, H3C, P2S і X2D транслюють її через RTSPS (порт 322, з увімкненим LAN Only Liveview), а принтери P1, A1 і A2L — через зашифрований потік JPEG (порт 6000). Див. камера на вашому Mac.

Перегляньте звіти самі

Для діагностики звіти може читати будь-який клієнт MQTT. З інструментами командного рядка Mosquitto, підставивши замість заповнювачів значення свого принтера:

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

--insecure пропускає перевірку сертифіката, тож використовуйте його лише в мережі, якій довіряєте, і лише для читання. Ніколи не публікуйте свій код доступу чи серійний номер на форумах або у звітах про помилки.

Не публічний API

Це протокол, яким власні програми Bambu Lab користуються в локальній мережі, а не задокументований стабільний API: поля відрізняються залежно від моделі й версії прошивки, а Bambu Lab може змінити те, що приймає принтер. Bambu Bar стежить за цими змінами, щоб вам не довелося. Про відповідні налаштування принтера див. пояснення режиму LAN, а також де знайти код доступу.

Запитання й відповіді

Який порт використовує принтер Bambu Lab для MQTT?

Порт 8883, із TLS. Ім’я користувача — bblp, пароль — код доступу принтера.

Чи потрібен режим «Лише LAN», щоб читати стан через MQTT?

Ні. Принтер повідомляє стан локальним програмам і в хмарному режимі. «Лише LAN» з режимом розробника потрібні для того, щоб сторонні програми могли надсилати команди друку.

Чи користується Bambu Bar хмарою Bambu Lab?

Ні. Вона підключається до локального сервера MQTT принтера напряму, як Bambu Studio в режимі LAN, і спершу перевіряє сертифікат принтера.

Годі ходити до принтера

Стежте за друком Bambu Lab на Mac: прогрес, час до завершення, температури, філамент AMS і камера наживо. Сповіщення й віджети без відкривання Bambu Studio.

Купити за 9,99 USDНезабаром уMac App Store

Прогрес друку, сповіщення та філаментmacOS 26+, Apple silicon та IntelДалі — Windows і Linux