MQTT da Bambu Lab, em palavras simples

A conexão

A impressora é o servidor: os apps se conectam direto a ela pela sua rede, sem a nuvem da Bambu Lab.

Relatórios: o que a impressora envia

Depois de se conectar, um app pede uma vez um relatório completo (uma solicitação pushall) e então recebe as mudanças conforme elas acontecem, mais ou menos a cada segundo durante a impressão. Os relatórios são em JSON e incluem o trabalho e a etapa dele, o progresso e as camadas, o tempo restante, as temperaturas do bico, da mesa e da câmara, os ventiladores, os slots do AMS com seus filamentos e os erros da impressora (códigos HMS).

O Bambu Bar junta essas mudanças numa visão única da impressora, que é o que a barra de menus, a janela e os widgets mostram. Modelos diferentes informam campos diferentes, e é por isso que uma A1 não mostra temperatura da câmara e uma H2D mostra dois bicos.

Solicitações: o que os apps enviam

Os comandos vão para o tópico de solicitações: pausar, retomar, parar, velocidade de impressão, a luz da câmara ou um pedido de relatório completo. A impressora decide o que aceitar: no firmware atual, apps de terceiros só podem enviar comandos de impressão quando a impressora está no modo Somente LAN com o Modo de desenvolvedor ativado. Caso contrário, o Bambu Bar mostra um cadeado nesses botões. Veja por que os controles ficam bloqueados.

Certificados: a garantia de que é a sua impressora

A conexão é criptografada com TLS, e cada impressora apresenta um certificado. O Bambu Bar só aceita a impressora se esse certificado for encadeado às autoridades certificadoras da própria Bambu Lab, que vêm com o app, e tiver sido emitido para o número de série da impressora. Assim, nenhum outro dispositivo na sua rede consegue se passar pela impressora e capturar o código de acesso.

Descoberta e câmera

• Descoberta: as impressoras se anunciam na sua rede por UDP (porta 2021). É assim que os apps listam impressoras sem um endereço IP, e como o Bambu Bar percebe quando uma impressora recebe um endereço novo.
• A câmera não passa pelo MQTT: as impressoras X1, H2, H3C, P2S e X2D a transmitem por RTSPS (porta 322, com o LAN Only Liveview ativado), e as P1, A1 e A2L por uma transmissão JPEG criptografada (porta 6000). Veja a câmera no seu Mac.

Veja os relatórios você mesmo

Para diagnóstico, qualquer cliente MQTT consegue ler os relatórios. Com as ferramentas de linha de comando do Mosquitto, e os valores da sua impressora no lugar dos marcadores:

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

--insecure pula a verificação do certificado, então use só numa rede em que você confia, e só para ler. Nunca cole seu código de acesso ou número de série em fóruns ou relatos de bugs.

Não é uma API pública

Este é o protocolo que os próprios apps da Bambu Lab usam na rede local, não uma API documentada e estável: os campos variam entre modelos e versões de firmware, e a Bambu Lab pode mudar o que a impressora aceita. O Bambu Bar acompanha essas mudanças para que você não precise. Veja o modo LAN explicado para as configurações da impressora envolvidas e onde encontrar o código de acesso.