Bambu LabのMQTTを、やさしく解説

接続

サーバーはプリンター自身です。アプリはBambu Labのクラウドを経由せず、ネットワーク上でプリンターに直接接続します。

レポート：プリンターが送るもの

接続後、アプリは一度だけ完全なレポートを要求し（pushallリクエスト）、その後は変化があるたびに受け取ります。造形中はおよそ1秒ごとです。レポートはJSON形式で、ジョブとそのステージ、進捗とレイヤー、残り時間、ノズル・ベッド・チャンバーの温度、ファン、AMSのトレイとそのフィラメント、プリンターのエラー（HMSコード）が含まれます。

Bambu Barはこうした変化をまとめてプリンターの全体像を組み立て、それをメニューバー、ウインドウ、ウィジェットに表示します。報告されるフィールドは機種によって異なります。A1にチャンバー温度が表示されず、H2Dに2つのノズルが表示されるのはそのためです。

リクエスト：アプリが送るもの

コマンドはリクエストトピックに送られます。一時停止、再開、中止、造形速度、チャンバー照明、または完全なレポートの要求です。何を受け付けるかはプリンターが決めます。現在のファームウェアでは、サードパーティ製アプリが造形コマンドを送れるのは、プリンターがLAN専用モードで開発者モードがオンのときだけです。そうでない場合、Bambu Barはそれらのボタンに鍵マークを表示します。操作がロックされる理由をご覧ください。

証明書：自分のプリンターであることを確かめる

接続はTLSで暗号化され、各プリンターは証明書を提示します。Bambu Barがプリンターを受け入れるのは、その証明書が、アプリに同梱されたBambu Lab独自の認証局につながっていて、かつプリンターのシリアル番号に対して発行されている場合だけです。こうすることで、ネットワーク上のほかのデバイスがプリンターになりすましてアクセスコードを集めることはできません。

検出とカメラ

• 検出：プリンターは、UDP（ポート2021）でネットワーク上に自身の存在を通知します。アプリがIPアドレスなしでプリンターを一覧できるのも、プリンターのアドレスが変わったことにBambu Barが気づけるのも、このおかげです。
• カメラはMQTTを使いません。X1、H2、H3C、P2S、X2DプリンターはRTSPS（ポート322、LAN Only Liveviewがオンのとき）で、P1、A1、A2Lプリンターは暗号化されたJPEGストリーム（ポート6000）で映像を送ります。Macでカメラを見るをご覧ください。

レポートを自分で見る

診断のために、どのMQTTクライアントでもレポートを読み取れます。Mosquittoのコマンドラインツールを使い、プレースホルダーをお使いのプリンターの値に置き換えてください：

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

--insecureは証明書の確認を省略するので、信頼できるネットワーク上で、読み取りのためだけに使ってください。アクセスコードやシリアル番号を、フォーラムやバグ報告に絶対に貼り付けないでください。

公開APIではありません

これはBambu Labの純正アプリがローカルネットワーク上で使っているプロトコルで、ドキュメント化された安定したAPIではありません。フィールドは機種やファームウェアのバージョンによって異なり、プリンターが何を受け付けるかをBambu Labが変更することもあります。Bambu Barがそうした変更に追従するので、ユーザーが気にする必要はありません。関係するプリンターの設定はLANモードの解説、アクセスコードはアクセスコードの確認方法をご覧ください。