> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unicontrol.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Bambu Lab

> Monitore e controle impressoras 3D Bambu Lab (A1, P1, P2S, X1, H2) pela rede local

# 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](https://github.com/greghesp/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

> [!NOTE]
>
> 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.