Skip to content

OpenHABとの接続

OpenHAB(open Home Automation Busとも呼ばれます)は、Javaで書かれたオープンソースのホームオートメーションソフトウェアです。さまざまなデバイスの統合、わかりやすいユーザーインターフェースの提供、そして最も柔軟なツールのサポートという強みを持ち、OpenHABはホームオートメーション分野で最も優れたプラットフォームの一つとなっています。

高い柔軟性と使いやすさを備えたOpenHABは、ユーザーがMQTTブローカーに接続するための専用バインディングを提供しています。本記事では、EMQX Cloud MQTTブローカーをOpenHABと連携させる設定手順をご紹介します。

前提条件

OpenHABアプリケーションをEMQX Cloudに接続する前に、MQTTブローカーをデプロイしていることを確認してください。

MQTTブローカーのデプロイ

アプリケーションをEMQX Cloudに接続するには、デプロイメントを作成して設定する必要があります。

サーバレスデプロイメント

  1. EMQX Cloudコンソールでサーバレスデプロイメントを作成します。

  2. デプロイメントが作成されて稼働したら、デプロイメントの概要ページに移動し、以下を含むMQTT接続情報を確認します。

    • ブローカーアドレス

    • ポート番号(サーバレスではTLSポートのみ対応)

  3. サーバレスデプロイメントはTLS接続が必須です。概要ページからCA証明書をダウンロードし、TLS用のポート8883を使用してください。

  4. デプロイメントのアクセス制御 -> クライアント認証で、デフォルト認証(ユーザー名/パスワード)を設定します。

詳細はサーバレスポートガイドを参照してください。

Dedicated Flex または BYOC デプロイメント

  1. EMQX CloudコンソールでDedicated FlexまたはBYOCのデプロイメントを作成できます。

  2. 作成後、デプロイメントの概要ページに移動し、以下を含むMQTT接続情報を取得します。

    • ブローカーアドレス

    • MQTTおよびWebSocket用のTCPおよびTLSポート番号(TCPおよびTLS接続の両方に対応)

  3. デプロイメントのアクセス制御 -> クライアント認証で、デフォルト認証(ユーザー名/パスワード)を設定します。

詳細なポート設定については、Dedicated & BYOCポートガイドをご覧ください。

OpenHABの初期設定

OpenHABで初めてMQTTを使用する場合は、クイックスタートを参照してください。

  1. OpenHABのインストール

    本例では、Dockerを使ってOpenHABを素早くインストールします。

    bash
    docker run -d --name=openhab --restart=always --network=host \
     -v /opt/openhab/conf:/openhab/conf \
     -v /opt/openhab/userdata:/openhab/userdata \
     -v /opt/openhab/addons:/openhab/addons \
     openhab/openhab

    その後、ローカルIPの対応ポート(例:x.x.x.x:8080)にアクセスし、アカウントを作成します。

    openhab_create_account

    次に、言語、地域、タイムゾーン、ホームの場所を選択します。設定が完了すると、OpenHABのコンソール画面にリダイレクトされます。

    openhab_console

  2. バインディングのインストール

    Settings ---> Bindings ---> MQTT Binding に進み、MQTTバインディングをインストールします。

    openhab_binding

  3. ThingsMQTT Brokerを追加

    openhab_add_thing_1

    次に、MQTT Brokerを選択し、先に作成したデプロイメントの情報を入力します。

    openhab_add_thing_2

TCPポートでの接続

このセクションでは、OpenHABクライアントをTCPポート経由でMQTTブローカーに接続する方法を説明します。

  • ブローカーのアドレス、ポート、ユーザー名およびパスワード(存在する場合)を入力します。
  • MQTTトランスポートにTCPを選択します。

openhab_mqtt_connection

TLS/SSLポートでの接続

このセクションでは、OpenHABクライアントをTLS/SSLポート経由でMQTTブローカーに接続する方法を説明します。

  • ブローカーのアドレス、ポート、ユーザー名およびパスワード(存在する場合)を入力します。
  • Secure Connectionを有効にします。
  • MQTTトランスポートにTCPを選択します。

openhab_mqtts_connection_1
openhab_mqtts_connection_2

接続のテスト

Settings ---> Things ---> MQTT Brokerに移動し、「online」と表示された緑色のラベルがあれば、OpenHABとEMQX Cloudの接続に成功しています。おめでとうございます!

openhab_connection

また、EMQX Cloudのモニターページからもステータスを確認できます。

openhab_monitor