MQTT タブは、同じ測定値をどのブローカーへでも公開します。Home Assistant 以外のシステムへ流し込む方や、Home Assistant にも自分のブローカー経由で流したい方に向いています。
ネイティブ統合と同じく、接続はあなたの端末からあなたのマシンへ直接向かい、当社のサーバーを経由しません。
ブローカーを入力する
ブローカーアドレスとポートを入力します。ブローカーが認証を求めるなら、ユーザーとパスワードも入力します。
ブローカーがネットワークの外に出ている場合はTLS (SSL) を使用するをオンにしてください。WebSocketを使用するとベースパスは、プロキシの後ろにあるブローカー向けです。
プロトコルのバージョンを選ぶ
MQTT 3.1.1 と MQTT 5.0 のボタンでバージョンを選びます。迷ったら、より広く互換のある 3.1.1 を選んでください。
形式を選ぶ
MQTT形式は、トピックの形と各メッセージの形式を決めます。五つの選択肢があります。
- Home Assistant Discovery:自動検出により、エンティティが名前、単位、アイコンつきで自動的に作られます。
- Homie 4.0:Homie の取り決めに従います。
- シンプルトピック:トピックごとに値が一つで、余分な構造はありません。スクリプトから扱うのがいちばん簡単です。
- 統合JSON:すべてを一つのメッセージにまとめ、指定したトピックへ送ります。
- ThingsBoard:ThingsBoard のテレメトリー形式です。
形式によっては独自の設定があります。シンプルトピックのJSONペイロード(値 + タイムスタンプ)や、ThingsBoard のタイムスタンプを含めるなどです。
トピックのプレフィックスを決める
トピックのプレフィックスは、アプリが公開するすべての根になります。値は最初に決め、あとから変えるのは避けてください。変更すると古いトピックがブローカーに取り残されます。
離れる前にテストする
テスト接続をタップします。テストは、送信をオンにする前に、アドレス、ポート、TLS、認証情報を確かめます。
送信をオンにして保存する
送信を有効にするをオンにし、送信間隔を決めて、フローティングボタンで保存します。
- ブローカーアドレスとポート
- アプリが公開する先です。どのブローカーでもかまいません。Mosquitto、EMQX、Home Assistant 内のアドオン、ホスティングされたサービスなどです。
- TLS (SSL) を使用する
- ブローカーへの接続を暗号化します。ネットワークの外に出ているときは必ず勧められます。
- WebSocketを使用するとベースパス
- リバースプロキシの後ろにあるブローカー向けに考えられています。
- MQTT形式
- Home Assistant Discovery、Homie 4.0、シンプルトピック、統合JSON、ThingsBoard のいずれかです。
- トピックのプレフィックス
- 公開されるトピックの根です。あとから変えると古いトピックがブローカーに取り残されます。
- ユーザーとパスワード
- ブローカーが認証を求めるときの認証情報です。
- テスト接続
- 送信がオンになる前に、アドレス、ポート、TLS、認証情報を確かめます。
- 送信間隔
- ライブセンサーのスナップショットをどれくらいの頻度で送るか。
- 保存ボタン
- 開いているタブの設定と同期モードを保存します。