Aller au contenu principal

Intégration domotique Bambu Lab, gratuite et open source

Intégration Bambu Lab pour Gladys Assistant

Suivez et pilotez vos imprimantes 3D Bambu Lab en local : progression, températures, AMS, alertes.

Voir sur GitHubToutes les intégrations externes

Suivez et pilotez vos imprimantes 3D Bambu Lab (séries X1, P1, A1, H2, P2S) depuis Gladys : état, progression, temps restant, couches, températures, bobines de l'AMS, erreurs HMS, lumière du caisson, vitesse, pause et reprise, image de la caméra (P1 et A1). Tout reste sur votre réseau local : Gladys parle directement à l'imprimante (MQTT chiffré sur le port 8883, comme Bambu Studio en mode LAN), sans passer par le cloud Bambu Lab.

Développée sans le matériel : l'intégration a été éprouvée contre des rapports réels d'imprimantes (publiés par le projet ha-bambulab) rejoués par un vrai broker MQTT chiffré, mais pas encore sur une imprimante physique. Vos retours sont les bienvenus sur le forum Gladys.

Prérequis​

  • Gladys Assistant 5.1 ou plus récent.
  • Une imprimante Bambu Lab sur le même réseau local que Gladys.
  • Son numéro de série (réglages de l'imprimante, informations de l'appareil, ou Bambu Handy / Bambu Studio) et son code d'accès LAN (affiché sur l'écran de l'imprimante, dans les réglages réseau / WLAN).
  • Pour mettre en pause, reprendre, annuler ou changer la vitesse depuis Gladys avec un firmware récent (X1 01.08.05, P1 01.08.02, A1 01.05 et suivants, « Authorization Control » de 2025) : activer sur l'imprimante le mode LAN uniquement puis le mode Développeur. Sans lui, l'imprimante refuse ces commandes ; la lecture de l'état, la lumière et la caméra fonctionnent quand même. Attention : en mode LAN uniquement, Bambu Handy et l'impression à distance par le cloud ne fonctionnent plus. Voir le wiki Bambu Lab.

Configuration​

  1. Ouvrez l'onglet Configuration de l'intégration.
  2. Saisissez le Numéro de série (par exemple 01P00A000000000) et le Code d'accès de l'imprimante.
  3. Adresse IP : facultative. Laissée vide, Gladys écoute les annonces de l'imprimante sur le réseau et la trouve toute seule (et la suit si son adresse change). Saisissez-la si la recherche ne la trouve pas. Enregistrez.
  4. Le bouton Chercher les imprimantes sur le réseau liste les imprimantes qui s'annoncent : nom, modèle, adresse, numéro de série, mode LAN.
  5. Une deuxième ou troisième imprimante : remplissez Imprimante 2 et Imprimante 3 de la même façon.
  6. Images de la caméra (activé par défaut) : une image par minute pendant une impression, et à la demande, pour les séries P1 et A1.
  7. Vérifier le certificat de l'imprimante (activé par défaut) : la connexion est chiffrée et le certificat de l'imprimante est vérifié auprès des autorités de Bambu Lab. Ne le désactivez que si la connexion échoue avec une erreur de certificat (un modèle très récent).
  8. Langue choisit la langue des noms de fonctionnalités et des textes créés par l'intégration (français par défaut). Les noms des fonctionnalités sont fixés à l'ajout de l'appareil dans Gladys.

Le bouton Tester la connexion indique pour chaque imprimante son modèle, son firmware, son état, et si le firmware refuse les commandes. Ajoutez ensuite l'imprimante depuis l'onglet Découverte.

L'appareil imprimante​

Un appareil par imprimante, nommé d'après le nom donné à l'imprimante (trouvé par la recherche réseau) ou d'après son modèle. L'imprimante envoie son état chaque seconde ; l'intégration le transmet à Gladys au plus toutes les 5 secondes, et tout de suite quand l'état d'impression change.

FonctionnalitéCe qu'elle affiche
ÉtatPrête, Préparation, Impression, En pause, Terminée, Échouée, Hors ligne, Imprimante injoignable, Code d'accès refusé
FichierLe nom de l'impression en cours, ou de la dernière
ProgressionPourcentage de l'impression
Temps restantEstimé par l'imprimante, en minutes
Couche, Couches au totalNuméros de couche (une scène peut tester « couche > 3 »)
Buse, PlateauTempératures, en degrés entiers, et leurs consignes en lecture seule
CaissonTempérature du caisson (X1, H2, P2S), et sa consigne sur les modèles à caisson chauffé (X1E, H2)
Vitesse d'impressionListe : Silencieux, Standard, Sport, Extrême (pendant une impression)
Lumière du caissonInterrupteur
Pause, RepriseBoutons poussoirs
Erreurs HMS« Aucune erreur », ou le code et le texte de la première erreur HMS (et le nombre des autres)
CaméraL'image de la caméra (séries P1 et A1)

Il n'y a volontairement pas de bouton annuler sur l'appareil : un appui sans confirmation ruinerait une impression. L'annulation est proposée par le widget (avec confirmation) et par les scènes. Les consignes de température sont en lecture seule et l'intégration ne chauffe jamais : rien ne peut lancer une chauffe depuis le tableau de bord, HomeKit, Alexa ou Google. Ce sont des « températures d'appareil » pour Gladys : elles ne comptent jamais dans la température de la pièce. La lumière est un interrupteur, pas une lampe : une scène « éteindre toutes les lumières » ne plonge pas une impression (et son timelapse) dans le noir.

Widget de tableau de bord​

Ajoutez le widget Impression 3D Bambu à un tableau de bord et choisissez l'imprimante dans ses réglages. Il affiche :

  • la jauge de progression, le temps restant, les températures de la buse et du plateau (en direct) ;
  • la dernière image de la caméra (P1, A1) ;
  • l'état, le fichier, la couche, l'heure de fin prévue, la vitesse, les erreurs HMS ;
  • les bobines chargées dans l'AMS (AMS A1, AMS A2… AMS B1 pour un deuxième AMS) : matière, couleur et reste estimé, celle en cours marquée d'une coche ; la bobine externe sinon ;
  • les boutons utiles au moment : Pause ou Reprendre et Annuler (demande confirmation) pendant une impression, Allumer ou Éteindre la lumière sinon. Si le firmware refuse les commandes, le widget l'indique (« Mode Développeur requis ») au lieu d'afficher des boutons inutiles.

Déclencheurs de scène​

Dans la catégorie Intégrations de l'éditeur de scènes. Chacun peut être limité à une imprimante.

  • Impression démarrée : variables nom de l'imprimante, fichier.
  • Impression terminée : variables nom de l'imprimante, fichier, durée d'impression (en texte, comme 1 h 05 min, et en minutes).
  • Impression échouée ou annulée : peut être limité à une raison (annulée, erreur). Variables nom de l'imprimante, fichier, durée, raison, code et message d'erreur.
  • Impression en pause : par un utilisateur ou par l'imprimante elle-même (fin de filament, bourrage). Variables nom de l'imprimante, fichier, temps écoulé, code et message d'erreur s'il y en a un.
  • Erreur HMS : une nouvelle alerte du système de surveillance de l'imprimante. Peut être limité à une gravité (fatale, grave, courante, information). Variables nom de l'imprimante, code (0300_0100_0001_0007), message (dans la langue de l'intégration), gravité.

Les variables se lisent dans les actions suivantes avec, par exemple, {{triggerEvent.data.file}} et {{triggerEvent.data.message}}. Les déclencheurs suivent l'imprimante elle-même : une impression lancée depuis Bambu Studio ou mise en pause sur l'écran déclenche aussi.

Actions de scène​

  • Mettre en pause, reprendre ou annuler une impression : renvoie Appliqué à faux quand il n'y avait rien à mettre en pause, reprendre ou annuler (la scène continue). Une annulation est définitive.
  • Allumer ou éteindre la lumière du caisson : fonctionne aussi sans le mode Développeur.
  • Changer la vitesse d'impression : Silencieux, Standard, Sport, Extrême ; pendant une impression seulement (sinon Appliqué : faux).

Exemples de scènes​

  • Impression terminée → notification : déclencheur Impression terminée, action « Envoyer un message » : {{triggerEvent.data.file}} terminé en {{triggerEvent.data.duration}}.
  • Fumée détectée → tout arrêter : déclencheur sur le détecteur de fumée, actions Mettre en pause, reprendre ou annuler une impression (annuler), puis éteindre la prise connectée de l'imprimante.
  • Silence la nuit : à 22 h, Changer la vitesse d'impression (Silencieux) ; sans effet si rien n'imprime.
  • Erreur grave → alerte : déclencheur Erreur HMS limité aux gravités fatale et grave, action « Envoyer un message » : {{triggerEvent.data.printer}} : {{triggerEvent.data.message}}.

Dépannage​

  • Imprimante injoignable : vérifiez l'adresse IP (écran de l'imprimante, réglages réseau), que l'imprimante est allumée et sur le même réseau que Gladys. Laissez l'adresse vide pour que Gladys la cherche.
  • Code d'accès ou numéro de série refusé : le code d'accès peut changer (mode LAN désactivé puis réactivé, réinitialisation) ; ressaisissez-le. Vérifiez aussi le numéro de série (15 caractères). Après un refus, l'intégration attend 5 minutes avant de réessayer.
  • Certificat inattendu : un modèle trop récent pour les autorités connues de l'intégration ; désactivez Vérifier le certificat de l'imprimante et signalez-le sur le forum. Sans vérification, Gladys ne suit plus l'imprimante si son adresse change (une annonce réseau pourrait être usurpée) : saisissez son adresse IP.
  • « Le firmware n'accepte que les commandes des applications Bambu Lab » : activez le mode LAN uniquement puis le mode Développeur sur l'imprimante (voir Prérequis).
  • La recherche réseau ne trouve rien : elle écoute les annonces des imprimantes pendant 10 secondes (ports UDP 1990 et 2021, via Gladys) ; un réseau qui ne laisse pas passer la diffusion (VLAN, Wi-Fi invité) les bloque. Saisissez alors l'adresse IP.
  • Pas d'image de caméra : seules les séries P1 et A1 ont une caméra accessible ainsi ; Gladys refuse une image de plus de 150 Ko.
  • Logs : dans la page de l'intégration de Gladys, ou docker logs sur l'hôte. LOG_LEVEL=debug donne le détail. Le code d'accès n'apparaît jamais dans les logs.

Limites​

  • Trois imprimantes au plus.
  • Pas d'envoi de fichier ni de lancement d'impression, pas de commandes G-code, pas de réglage de température, pas de timelapse.
  • Caméra : séries P1 et A1 seulement (les séries X1, H2 et P2S filment en RTSPS, que l'intégration ne lit pas), une image par minute pendant une impression et à la demande, pas de flux vidéo.
  • H2D : la température affichée est celle de la buse active.
  • Les textes des erreurs HMS viennent des tables publiées par Bambu Lab (reprises par ha-bambulab) : un code très récent peut s'afficher sans texte.
  • Une impression terminée pendant que l'intégration était déconnectée ne déclenche pas de scène.
  • Développée sans le matériel : vos retours sont les bienvenus.
  • Sans lien avec Bambu Lab.

Paramètres de configuration​

Voici les paramètres demandés par Bambu Lab dans son écran de configuration dans Gladys.

ParamètreTypeObligatoireDescription
Connecter votre imprimante Bambu LabsectionNonGladys dialogue avec l'imprimante sur votre réseau local, sans le cloud Bambu Lab. Sur l'écran de l'imprimante, ouvrez les réglages réseau : notez le code d'accès (et l'adresse IP), et activez le mode LAN uniquement avec le mode Développeur si vous voulez mettre en pause, reprendre ou annuler des impressions depuis Gladys (les firmwares récents refusent sinon ces commandes ; la lecture fonctionne toujours). Le numéro de série est dans les réglages de l'appareil sur l'imprimante ou dans Bambu Handy. Jusqu'à trois imprimantes.
Numéro de sériestringOui
Code d'accèssecretOuiAffiché sur l'écran de l'imprimante, dans les réglages réseau (WLAN).
Adresse IPstringNonFacultative : laissée vide, Gladys cherche l'imprimante sur le réseau.
Imprimante 2 (facultatif)sectionNonUne autre imprimante Bambu Lab, connectée de la même façon.
Numéro de série 2stringNon
Code d'accès 2secretNonAffiché sur l'écran de l'imprimante, dans les réglages réseau (WLAN).
Adresse IP 2stringNonFacultative : laissée vide, Gladys cherche l'imprimante sur le réseau.
Imprimante 3 (facultatif)sectionNonUne autre imprimante Bambu Lab, connectée de la même façon.
Numéro de série 3stringNon
Code d'accès 3secretNonAffiché sur l'écran de l'imprimante, dans les réglages réseau (WLAN).
Adresse IP 3stringNonFacultative : laissée vide, Gladys cherche l'imprimante sur le réseau.
OptionssectionNonLangue des noms et textes créés par l'intégration (les noms des fonctionnalités sont fixés à l'ajout de l'appareil).
Images de la caméra (séries P1 et A1)booleanNonUne image par minute pendant une impression, et à la demande.
Vérifier le certificat de l'imprimantebooleanNonAuprès des autorités Bambu Lab. Ne le désactivez que si la connexion échoue sur une erreur de certificat.
LangueselectNon

Comment installer Bambu Lab dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Bambu Lab apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
  2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/guim31/gladys-bambulab:1.0.1), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration).
  3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
  4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-bambulab.

Bambu Lab nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.

Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.

À propos des intégrations externes​

Bambu Lab est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par guim31, et non par l'équipe cœur de Gladys.

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂
Dernière mise à jour le