El MQTT de Bambu Lab, en palabras claras

La conexión

La impresora es el servidor: las apps se conectan a ella directamente a través de tu red, sin la nube de Bambu Lab.

Informes: lo que envía la impresora

Tras conectarse, una app pide una vez un informe completo (una solicitud pushall) y después recibe los cambios a medida que se producen, aproximadamente cada segundo mientras imprime. Los informes están en JSON e incluyen el trabajo y su fase, el progreso y las capas, el tiempo restante, las temperaturas de la boquilla, la cama y la cámara de impresión, los ventiladores, las bandejas del AMS con su filamento y los errores de la impresora (códigos HMS).

Bambu Bar combina esos cambios en una imagen única de la impresora, que es lo que muestran la barra de menús, la ventana y los widgets. Cada modelo informa de campos distintos, y por eso una A1 no muestra temperatura de la cámara de impresión y una H2D muestra dos boquillas.

Solicitudes: lo que envían las apps

Las órdenes van al tema de solicitudes: pausar, reanudar, detener, la velocidad de impresión, la luz de la cámara de impresión o la petición de un informe completo. La impresora decide qué acepta: con el firmware actual, las apps de terceros solo pueden enviar órdenes de impresión cuando la impresora está en modo Solo LAN con el Modo desarrollador activado. Si no, Bambu Bar muestra un candado en esos botones. Consulta por qué los controles están bloqueados.

Certificados: asegurarse de que es tu impresora

La conexión está cifrada con TLS, y cada impresora presenta un certificado. Bambu Bar solo acepta la impresora si ese certificado se encadena a las autoridades de certificación de Bambu Lab, que vienen incluidas en la app, y está emitido para el número de serie de la impresora. Así, ningún otro dispositivo de tu red puede hacerse pasar por la impresora y quedarse con el código de acceso.

Detección y cámara

• Detección: las impresoras se anuncian en tu red por UDP (puerto 2021). Así es como las apps muestran las impresoras sin una dirección IP, y como Bambu Bar se entera de que una impresora tiene una nueva.
• La cámara no va por MQTT: las impresoras X1, H2, H3C, P2S y X2D la transmiten por RTSPS (puerto 322, con LAN Only Liveview activado), y las P1, A1 y A2L mediante un flujo JPEG cifrado (puerto 6000). Consulta la cámara en tu Mac.

Consulta los informes por tu cuenta

Para hacer diagnósticos, cualquier cliente MQTT puede leer los informes. Con las herramientas de línea de comandos de Mosquitto, y los valores de tu impresora en lugar de los marcadores:

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

--insecure omite la comprobación del certificado, así que úsalo solo en una red de confianza, y solo para leer. Nunca pegues tu código de acceso ni tu número de serie en foros o informes de errores.

No es una API pública

Es el protocolo que usan las propias apps de Bambu Lab en la red local, no una API documentada y estable: los campos varían entre modelos y versiones de firmware, y Bambu Lab puede cambiar lo que acepta la impresora. Bambu Bar sigue esos cambios para que tú no tengas que hacerlo. Consulta el modo LAN explicado para ver los ajustes de la impresora implicados y dónde encontrar el código de acceso.