Le MQTT de Bambu Lab, en termes simples

La connexion

L’imprimante est le serveur : les apps s’y connectent directement par votre réseau, sans le cloud de Bambu Lab.

Les rapports : ce que l’imprimante envoie

Après la connexion, une app demande une fois un rapport complet (une requête pushall), puis reçoit les changements au fur et à mesure, environ toutes les secondes pendant une impression. Les rapports sont en JSON et comprennent la tâche et son étape, la progression et les couches, le temps restant, les températures de la buse, du plateau et de la chambre, les ventilateurs, les emplacements de l’AMS avec leur filament, et les erreurs de l’imprimante (codes HMS).

Bambu Bar fusionne ces changements en une seule image de l’imprimante, celle qu’affichent la barre des menus, la fenêtre et les widgets. Chaque modèle communique des champs différents : c’est pourquoi une A1 n’affiche pas de température de chambre et une H2D affiche deux buses.

Les requêtes : ce que les apps envoient

Les commandes passent par le topic de requête : pause, reprise, arrêt, vitesse d’impression, lumière de la chambre, ou demande de rapport complet. L’imprimante décide de ce qu’elle accepte : avec le firmware actuel, les apps tierces ne peuvent envoyer de commandes d’impression que lorsque l’imprimante est en mode LAN avec le mode Développeur activé. Sinon, Bambu Bar affiche un cadenas sur ces boutons. Consultez pourquoi les commandes sont verrouillées.

Les certificats : s’assurer que c’est bien votre imprimante

La connexion est chiffrée avec TLS, et chaque imprimante présente un certificat. Bambu Bar n’accepte l’imprimante que si ce certificat remonte aux autorités de certification de Bambu Lab, fournies avec l’app, et s’il est émis pour le numéro de série de l’imprimante. Ainsi, aucun autre appareil de votre réseau ne peut se faire passer pour l’imprimante et récupérer le code d’accès.

La détection et la caméra

• Détection : les imprimantes s’annoncent sur votre réseau en UDP (port 2021). C’est ainsi que les apps listent les imprimantes sans adresse IP, et que Bambu Bar remarque quand une imprimante en reçoit une nouvelle.
• La caméra ne passe pas par MQTT : les imprimantes X1, H2, H3C, P2S et X2D la diffusent en RTSPS (port 322, avec LAN Only Liveview activé), et les P1, A1 et A2L via un flux JPEG chiffré (port 6000). Consultez la caméra sur votre Mac.

Consulter les rapports vous-même

Pour un diagnostic, n’importe quel client MQTT peut lire les rapports. Avec les outils en ligne de commande de Mosquitto, en remplaçant les espaces réservés par les valeurs de votre imprimante :

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

--insecure désactive la vérification du certificat : ne l’utilisez que sur un réseau de confiance, et uniquement pour lire. Ne collez jamais votre code d’accès ni votre numéro de série dans des forums ou des rapports de bug.

Pas une API publique

C’est le protocole qu’utilisent les apps de Bambu Lab sur le réseau local, pas une API documentée et stable : les champs diffèrent selon les modèles et les versions de firmware, et Bambu Lab peut changer ce que l’imprimante accepte. Bambu Bar suit ces changements pour que vous n’ayez pas à le faire. Consultez le mode LAN expliqué pour les réglages de l’imprimante concernés, et où trouver le code d’accès.