メインコンテンツまでスキップ

Grove Vision AI V2 を Home Assistant に接続する

Grove Vision AI V2 を Home Assistant に統合することで、高度なビジュアルセンシング機能が追加され、スマートホーム環境をさらに向上させることができます。この統合により、環境をリアルタイムに解析し、カスタマイズされた自動化を実現できるため、住環境がよりインテリジェントかつ応答性の高いものになります。

この統合を容易にするために、HACS ストアからアクセスできる SenseCraft-HomeAssistant プラグインは、SenseCraft Data Platform を介して Grove Vision AI V2 を Home Assistant に接続します。このプロセスはシンプルでユーザーフレンドリーであり、SenseCraft アカウントにログインするだけで、デバイスとセンサーデータを Home Assistant エコシステムに取り込み、自由にカスタマイズおよび制御できるようになります。

以下は本記事の主な内容構成です。

  1. HACS プラグインのインストール: Home Assistant Community Store (HACS) をインストールし、Home Assistant 内で Seeed Studio の SenseCraft プラグインをインストールできるようにします。
  2. SenseCraft プラグインのインストール: Seeed Studio の SenseCraft プラグインをインストールし、Seeed Studio の製品を素早く Home Assistant に展開できるようにします。
  3. Grove Vision AI V2 用モデルの準備: Grove Vision AI V2 で使用したいモデルを選択してデプロイし、その後 Home Assistant は Vision AI から認識シーンおよび結果の情報を受信します。
  4. Home Assistant での MQTT サービスの構築: ローカル MQTT サービスを利用して、Grove Vision AI V2 と XIAO から Home Assistant へデータを送信します。
  5. Grove Vision AI V2 を Home Assistant に統合: Grove Vision AI V2 を Home Assistant に統合し、設定用のビジュアルダッシュボードを構築します。

はじめに​

本記事のチュートリアルを始める前に、以下のハードウェアを用意しておく必要があります。

必要な材料​

Grove Vision AI V2XIAO ESP32C3Home Assistant Green
今すぐ入手 🖱️
今すぐ入手 🖱️
今すぐ入手 🖱️

Home Assistant Green は、最も簡単かつプライバシー重視のホームオートメーションの方法です。セットアップは簡単で、すべてのスマートデバイスを 1 つのシステムで制御でき、データはデフォルトですべてローカルに保存されます。このボードは活発な Home Assistant エコシステムの恩恵を受けており、オープンソースによって毎月改善されていきます。

本チュートリアルでは Home Assistant のホストとして Home Assistant Green を使用することを推奨しますが、Supervisor を備えた任意の Home Assistant ホストを使用することもできます。

次に、ピンヘッダ（または拡張ボードと Grove インターフェース）を使用して、XIAO と Grove Vision AI V2 を接続する必要があります。

HACS プラグインのインストール​

ステップ 1. Home Assistant で Advanced Mode を有効にする​

Home Assistant の可能性を最大限に引き出し、高度な機能へアクセスするには、ユーザーインターフェースで「Advanced Mode」を有効にします。

Home Assistant web interface にアクセスします。Home Assistant サイドバー左下のプロフィールアイコンをクリックします。プロフィールページで下にスクロールし、Advanced Mode トグルを見つけます。トグルをオンの位置に切り替えます。

ステップ 2. Terminal & SSH をインストールする​

サイドバーの Settings をクリックして設定メニューにアクセスします。Add-ons をクリックしてアドオンストアを開きます。

検索バーを使用するか、利用可能なアドオンをスクロールして Terminal & SSH を探します。

Terminal & SSH を見つけたら、それをクリックして詳細を表示します。アドオンのページには、概要、ドキュメント、設定オプションが表示されます。アドオンをインストールするには、Install ボタンをクリックします。

ステップ 3. HACS をインストールする​

サイドバーで、先ほどダウンロードした Terminal & SSH を探してクリックします。ターミナルで、Home Assistant 設定のルートである config ディレクトリに移動します。

cd /config

次のコマンドを実行して、HACS インストールスクリプトをダウンロードして実行します。

wget -q -O - https://install.hacs.xyz | bash -

インストールスクリプトが完了したら、変更を反映させるために Home Assistant を再起動する必要があります。Settings > System > Restart に移動して、UI から Home Assistant を再起動できます。

再起動後、サイドバーの Settings をクリックして設定メニューを開きます。設定メニュー内で Devices & Services に移動します。

ADD INTEGRATION をクリックして、Home Assistant セットアップに新しいインテグレーションを追加します。

検索バーに HACS と入力して、Home Assistant Community Store インテグレーションを探します。

HACS が見つかると、利用可能なインテグレーションの一覧に表示されます。それをクリックしてインストールプロセスを開始します。

ライセンス契約または利用規約がポップアップ表示される場合があります。内容をよく読み、同意する場合はすべてのチェックボックスをオンにして同意を示します。SUBMIT をクリックしてインストールを続行します。

次に、GitHub アカウントでログインするよう求められます。これは、HACS が GitHub と連携してコミュニティが作成したインテグレーションやプラグインのインストールを管理するために必要です。

指示に従って、Home Assistant に GitHub アカウントへのアクセスを許可します。通常は、本人確認のために GitHub から提供される確認コードを入力する手順が含まれます。

Home Assistant に GitHub アカウントの使用を許可すると、HACS のインストールが完了します。

HACS をシステムに完全に統合するには、Home Assistant を再起動する必要がある場合があります。

SenseCraft プラグインのインストール​

ステップ 4. HACS 経由で SenseCraft プラグインをインストールする​

サイドバーで HACS を探してクリックし、HACS インターフェースを開きます。右下にメニューボタン（HACS のバージョンによっては三点リーダーまたはプラス記号）が表示されます。Custom repositories をクリックします。

リポジトリ URL の入力を求めるダイアログボックスが表示されます。ここに、SenseCraft インテグレーション用のカスタムリポジトリ URL を入力します。URL を入力したら、カテゴリを選択します（SenseCraft インテグレーションの場合は Integration を選択します）。

https://github.com/Seeed-Solution/SenseCraft-HomeAssistant.git

Add をクリックします。これでリポジトリが HACS に追加され、Integrations の一覧の中から SenseCraft インテグレーションを見つけられるようになります。

SenseCraft インテグレーションを見つけて "DOWNLOAD" をクリックします。

ここまでで、SenseCraft プラグインのインストールは正常に完了しています。

Grove Vision AI V2 用のモデルを準備する​

ステップ 5. XIAO ESP32C3 にファームウェアを書き込む​

適切な USB-C ケーブルを使用して XIAO ESP32C3 をコンピュータに接続します。デバイスドライバが正しくインストールされていることを確認してください。

Web ブラウザで SenseCraft Model Assistant Tool を開きます。

SenseCraft AI Tool

次に XIAO ESP32S3 を選択し、Connect をクリックします。

注意

ここでは XIAO ESP32-S3 が選択されていますが、実際に使用しているのは XIAO ESP32-C3 です！

下のボタンをクリックしてファームウェアファイルをダウンロードし、Web ページ上の Add File ボタンをクリックして、0x0 アドレスに SSCMA_XIAO_ESP32C3_adapter_sensecraft_v1.1.8.bin ファームウェアを書き込みます。

ファイルをダウンロード

最後に Flash ボタンをクリックし、プログラムが正常に書き込まれるまで待ってから、XIAO ESP32C3 をコンピュータから取り外します。

ステップ 6. Grove Vision AI V2 を SenseCraft AI Model Assistant に接続する​

SenseCraft AI > Models > Workspace > Grove Vision AI V2 から Grove Vision AI V2 のワークスペースにアクセスするか、ワークスペースへの直接リンクを使用します。

Type-C ケーブルを使用して Grove Vision AI V2 をコンピュータに接続してください。

次に左上の Connect ボタンをクリックし、デバイスのポート番号を選択します。

ステップ 7. 適切なモデルをアップロードする​

その後、Select Model をクリックしたうえで使用したい適切なモデルを選択し、Grove Vision AI V2 にアップロードしてください。

モデルがアップロードされるまで 1〜2 分ほど待ちます。

ステップ 8. 動作確認​

モデルが正常にアップロードされると、右側のプレビューで Grove Vision AI V2 カメラからのライブ映像が表示されます。


右側の Preview Settings では、モデルの認識精度を最適化するために変更できる設定項目が 2 つあります。

ヒント

プレビューに画面が表示されない、またはモデル情報に何も表示されない場合は、モデルに問題がある可能性があるため、モデルを再選択するか再度アップロードする必要があります。

Home Assistant で MQTT サービスを構築する​

ステップ 9. EMQX をインストールする​

サイドバーの Settings をクリックして設定メニューにアクセスします。Add-ons をクリックしてアドオンストアにアクセスします。

検索バーを使用するか、利用可能なアドオンを参照して emqx を探します。

EMQX を見つけたらクリックして詳細を表示します。アドオンのページには概要、ドキュメント、設定オプションが表示されます。アドオンをインストールするには Install ボタンをクリックします。

EMQX アドオンがインストールされたら、Start on boot、Watchdog、Show in sidebar のトグルをオンにします。Start をクリックして EMQX を起動します。

EMQX Dashboard のログインページで、デフォルトのユーザー名とパスワードを入力します。

  • デフォルトのユーザー名: admin
  • デフォルトのパスワード: public

"Login" ボタンをクリックして EMQX Dashboard にアクセスします。

EMQX Dashboard で、左側のサイドバーメニューから Authentication セクションに移動します。Databases タブをクリックします。

Create ボタンをクリックします。Mechanism ドロップダウンで Password-Based を選択し、Backend ドロップダウンで Built-in Database を選択します。"Create" ボタンをクリックして Built-in Database を作成します。

Built-in Database を作成したら、「Authentication」セクションの Users タブをクリックします。"Add User" ボタンをクリックします。

  • "Username" フィールドに "seeed" と入力します。
  • "Password" フィールドに "seeed" と入力します。

「Authentication」セクションの "Databases" タブに戻ります。データベース一覧から先ほど作成したデータベースを探します。

データベースの横にあるトグルスイッチをクリックして有効化します。データベースのステータスが "Enabled" に変わるはずです。

Grove Vision AI V2 を Home Assistant に統合する​

ステップ 10. Grove Vision AI V2 と XIAO のネットワーク設定​

Grove Vision AI V2 をコンピュータに接続し、Grove Vision AI V2 の設定ページを開きます。

左上をクリックして Grove Vision AI V2 に接続した後、MQTT ボタンをオンにし、ページ上で入力する必要がある以下の情報を入力してください。

  • SSID & Password: デバイスは Home Assistant がインストールされているホストと同じ LAN 上にある必要があります。そのため、同じ LAN 上のネットワークを設定してください。XIAO は 2.4G WiFi のみをサポートしており、5G ネットワークは使用できません。
  • Encryption: AUTO を選択します。
  • Host: Home Assistant がインストールされているホストの IP アドレス。
  • Port: 1883。
  • clientId: デバイスの識別番号で、grove_vision_ai_v2_ をプレフィックスとして付け、その後に任意の ID 番号を続けてください。
  • username: 先ほど作成した EMQX データベースのユーザー名。
  • password: 先ほど作成した EMQX データベースのパスワード。

その後、下部の Apply ボタンをクリックします。保存しても、Grove Vision AI がネットワークに接続されたことを意味するわけではありません。左側のメニューバーの Process に戻り、デバイスの IP アドレスが表示されているか、MQTT 接続のステータスが正しいかを確認してください。

注意

IP Address が表示されていれば WiFi に問題はなく、Service status は図のテキストと同じであれば正常であることを示します。WiFi に問題がある場合、MQTT も必ず正常ではありません。また、画面を切り替えた直後は未接続と表示されることがありますが、約 10 秒ほど待つ必要があります。ステータスを確認するためにリフレッシュする必要はなく、状態が変化すると自動的に最新のステータスが表示されます。

ステップ 11. Home Assistant への統合​

ここまでの手順が完了していれば、通常は Home Assistant の Settings->Devices & services 内で Grove Vision AI V2 を検索できるようになっています。

Configure ボタンをクリックして関連情報を設定すると、デバイスの追加が完了します。

Settings->Devices & services では、デバイスの詳細とサポートされているタブが表示されます。概要に表示するタブは、必要なだけ追加することができます。

注記
  1. 以前の手順でユーザー名とパスワードを設定している場合、デバイスを追加するときにそれらの入力を求められることがあります。
  2. 複数の Vision AI デバイスを Home Assistant に追加する場合は、各 Grove フラグを区別するための識別マークとして機能するデバイスの ID 番号に注意してください。

セットアップが成功すると、通常はデバイスの設置場所を選択するように求められます。実際の状況に応じて適切な部屋やエリアを選択し、Finish をクリックします。

設定が完了すると、Home Assistant の "Overview" ページでデバイスとそのステータスを確認できます。

これらの手順に従うことで、"SenseCraft" デバイスを Home Assistant インスタンスに正常に追加し、MQTT サービスを使用するように構成できるはずです。

トラブルシューティング​

Q1: Grove Vision AI V2 が切断された後、HA でデータメッセージが再び表示されなくなった場合はどうすればよいですか？​

SenseCraft でデバイスを削除して再追加する必要がある場合があります。削除後は自動検索ができなくなる可能性があり、その場合はデバイスを手動で追加する必要があります。デバイスを再追加するには、こちらの手順 を参照してください。

技術サポート & 製品ディスカッション​

当社製品をお選びいただきありがとうございます。お客様が当社製品をスムーズにご利用いただけるよう、さまざまなサポートをご用意しています。お好みやニーズに応じて選択いただけるよう、複数のコミュニケーションチャネルを提供しています。

Loading Comments...