Skip to main content

Bambu Lab

A integração Bambu Lab conecta impressoras 3D Bambu Lab ao Portal via MQTT local (TLS), direto na impressora, sem passar pela nuvem da Bambu. Por isso ela roda em um edge da casa, na mesma rede da impressora. Baseada no projeto open-source ha-bambulab (MIT).

Pre-requisitos

  • Edge da casa (modo HOME) na mesma rede da impressora
  • Impressora com modo LAN (LAN Only) ou Developer Mode habilitado
  • Endereço IP da impressora (reserve o IP no roteador)
  • Número de série (Configurações → Dispositivo na tela da impressora)
  • Access code de 8 caracteres (Configurações → Rede / WLAN)
  • Para câmera em X1/H2/P2S/X2D: LAN only liveview habilitado e ffmpeg disponível no edge

Configurar

1

Habilite o acesso local

Na tela da impressora, ative o modo LAN (ou Developer Mode nos firmwares recentes) e anote o IP e o access code.
2

Adicione a integração

Va em Configurações → Integrações → Adicionar → Bambu Lab.
3

Informe IP, serial e access code

O probe conecta na impressora (porta 8883), valida o access code e detecta o modelo automaticamente.

Recursos

As entidades são criadas automaticamente após a primeira conexão, de acordo com o modelo e com as unidades AMS detectadas.
  • Sensores de impressão — status, etapa atual, progresso, tempo restante, término previsto, camada atual/total, arquivo, perfil de velocidade, sinal Wi-Fi, erro de impressão e erros HMS (com link para a wiki da Bambu)
  • Temperaturas — bico (esquerdo/direito em H2D/X2D), mesa e câmara (X1/H2/P2S)
  • light — luz da câmara
  • button — pausar, retomar e parar a impressão
  • select — velocidade (silent, standard, sport, ludicrous)
  • fan — ventilador de resfriamento, auxiliar e da câmara (A1 só tem o de resfriamento), em passos de 10%
  • AMS / filamentos — umidade e temperatura de cada AMS, uma entidade por bandeja (tipo, cor, restante) e spool externo
  • camera — snapshot da câmera da impressora

Como Funciona

O edge mantém uma conexão MQTT persistente com a impressora. Ao conectar, pede a versão (modelo/firmware) e o estado completo; depois a impressora envia apenas as mudanças. Se a impressora parar de enviar relatórios, o edge pede o estado novamente e, se necessário, reconecta. Quando surge um AMS novo, as entidades são sincronizadas de novo automaticamente.

Câmera

  • A1, A1 mini, P1P, P1S — imagem JPEG pela porta 6000
  • X1, H2, P2S, X2D — stream RTSPS na porta 322, capturado via ffmpeg. Exige LAN only liveview ligado na impressora
Para trocar o IP ou o access code, use Reconfigurar. Deixe o access code em branco para manter o atual. O número de série não pode ser alterado.

Solução de problemas

  • “Access code inválido” — o código muda quando o modo LAN é reativado; confira na tela da impressora.
  • “Impressora não encontrada” — verifique o IP e se o edge está na mesma rede.
  • “A impressora não respondeu” — o número de série provavelmente está errado.