MQTT

測定値を自前のブローカーへ公開し、五つのメッセージ形式から選びます。

MQTT タブは、同じ測定値をどのブローカーへでも公開します。Home Assistant 以外のシステムへ流し込む方や、Home Assistant にも自分のブローカー経由で流したい方に向いています。

ネイティブ統合と同じく、接続はあなたの端末からあなたのマシンへ直接向かい、当社のサーバーを経由しません。

  1. ブローカーを入力する

    ブローカーアドレスポートを入力します。ブローカーが認証を求めるなら、ユーザーパスワードも入力します。

    ブローカーがネットワークの外に出ている場合はTLS (SSL) を使用するをオンにしてください。WebSocketを使用するベースパスは、プロキシの後ろにあるブローカー向けです。

  2. プロトコルのバージョンを選ぶ

    MQTT 3.1.1MQTT 5.0 のボタンでバージョンを選びます。迷ったら、より広く互換のある 3.1.1 を選んでください。

  3. 形式を選ぶ

    MQTT形式は、トピックの形と各メッセージの形式を決めます。五つの選択肢があります。

    • Home Assistant Discovery:自動検出により、エンティティが名前、単位、アイコンつきで自動的に作られます。
    • Homie 4.0:Homie の取り決めに従います。
    • シンプルトピック:トピックごとに値が一つで、余分な構造はありません。スクリプトから扱うのがいちばん簡単です。
    • 統合JSON:すべてを一つのメッセージにまとめ、指定したトピックへ送ります。
    • ThingsBoard:ThingsBoard のテレメトリー形式です。

    形式によっては独自の設定があります。シンプルトピックのJSONペイロード(値 + タイムスタンプ)や、ThingsBoard のタイムスタンプを含めるなどです。

  4. トピックのプレフィックスを決める

    トピックのプレフィックスは、アプリが公開するすべての根になります。値は最初に決め、あとから変えるのは避けてください。変更すると古いトピックがブローカーに取り残されます。

  5. 離れる前にテストする

    テスト接続をタップします。テストは、送信をオンにする前に、アドレス、ポート、TLS、認証情報を確かめます。

  6. 送信をオンにして保存する

    送信を有効にするをオンにし、送信間隔を決めて、フローティングボタンで保存します。


うまくいかないとき

この順に確かめてください。アドレスとポート、端末がブローカーに届くネットワークにいるか、TLS (SSL) を使用するがブローカーの想定と合っているか、ユーザーとパスワードが正しいか。

ポート 1883 はたいてい TLS なし、8883 は TLS ありで動きます。TLS を使わないポートに対して TLS をオンにすると、役に立つメッセージのないまま失敗します。

自動検出があるのは Home Assistant Discovery だけなので、その形式を選んでください。他の形式では、エンティティを手で宣言する必要があります。

Home Assistant ならネイティブ統合も検討してください。双方向で、イベントをバスに公開し、ブローカーが要りません。

アプリは、前の形式のトピックを片づけるかどうかを尋ねます。残すと答えた場合、そこで削除されるまでブローカーに残ります。

Home Assistant にはネイティブ統合のほうが多くを与えます。双方向で、イベントをバスに公開し、ブローカーが要りません。

MQTT が正しい選択になるのは、すでにブローカーを動かしているとき、Home Assistant ではないシステムへ流し込むとき、あるいは同じデータを同時に複数の場所で使いたいときです。


← すべてのガイドFAQ: Home Assistant と MQTT →