MQTT

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

MQTTセクションは、同じ数値を任意のブローカーに配信します。主に、openHAB、Node-RED、Domoticz、ThingsBoard など Home Assistant 以外のプラットフォームを使う人や、ブローカー経由で Home Assistant 自体にデータを送りたい人向けです。

ネイティブ統合と同じく、データはスマートフォンからブローカーへ直接送られます。

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

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

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

    アドレス、ポート、接続オプション、認証情報はこのスマートフォンにのみ保存されます。同じアカウントの別のスマートフォンでは、もう一度入力してください。

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

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

  3. 形式を選ぶ

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

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

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

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

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

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

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

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

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


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