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

Grove Vision AI V2 を Home Assistant に統合することで、高度な視覚センシング機能を追加してスマートホームセットアップを向上させることができます。この統合により、リアルタイムの環境分析とカスタマイズされた自動化が可能になり、ホーム環境をより知的で応答性の高いものにします。
この統合を促進するため、HACS ストアからアクセス可能な SenseCraft-HomeAssistant プラグインが、SenseCraft データプラットフォームを通じて Grove Vision AI V2 を Home Assistant に接続します。このプロセスは合理化されユーザーフレンドリーで、SenseCraft アカウントログインだけでデバイスとセンサーデータを Home Assistant エコシステムに取り込み、カスタマイズと制御の準備が整います。
以下は本記事の主要コンテンツフレームワークです。
- HACS プラグインのインストール: Home Assistant Community Store (HACS) をインストールして、Home Assistant 内で Seeed Studio の SenseCraft プラグインのインストールを可能にします。
- SenseCraft プラグインのインストール: Seeed Studio による SenseCraft プラグインをインストールし、Seeed Studio の製品を Home Assistant に迅速にデプロイできるようにします。
- Grove Vision AI V2 用モデルの準備: Grove Vision AI V2 に使用したいモデルを選択してデプロイし、その後 Home Assistant が Vision AI からの認識シーンと結果の情報を受信します。
- Home Assistant での MQTT サービス構築: ローカル MQTT サービスを活用して、Grove Vision AI V2 と XIAO から Home Assistant にデータを送信します。
- Grove Vision AI V2 を Home Assistant に統合: Grove Vision AI V2 を Home Assistant に統合し、設定用の視覚的ダッシュボードをセットアップします。
はじめに
本記事のチュートリアル内容が始まる前に、以下のハードウェアを準備する必要があります。
必要な材料
Grove Vision AI V2 | XIAO ESP32C3 | Home Assistant Green |
---|---|---|
![]() | ![]() | ![]() |
Home Assistant Green は、あなたの家を自動化する最も簡単でプライバシーに重点を置いた方法です。簡単なセットアップを提供し、すべてのスマートデバイスを1つのシステムで制御でき、すべてのデータはデフォルトでローカルに保存されます。このボードは繁栄している Home Assistant エコシステムの恩恵を受け、オープンソースによって毎月改善されます。
このチュートリアルでは、Home Assistant Green を Home Assistant ホストとして使用することをお勧めしますが、Supervisor を搭載した任意の Home Assistant ホストを使用することもできます。
次に、XIAO と Grove Vision AI V2 をピンの列を介して接続する必要があります(または拡張ボードと Grove インターフェースを使用します)。

HACS プラグインのインストール
ステップ 1. Home Assistant でアドバンスドモードを開く
Home Assistant の全ポテンシャルを解放し、高度な機能にアクセスするために、ユーザーインターフェースで「アドバンスドモード」を有効にできます。
Home Assistant ウェブインターフェースに移動します。Home Assistant サイドバーの左下角にあるプロフィールアイコンをクリックします。プロフィールページで、下にスクロールしてアドバンスドモードのトグルを見つけます。トグルをオンの位置に切り替えます。

ステップ 2. Terminal & SSH をインストール
サイドバーの設定をクリックして設定メニューにアクセスします。アドオンをクリックしてアドオンストアにアクセスします。

検索バーを使用するか、利用可能なアドオンを閲覧してTerminal & SSHを見つけます。

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

ステップ 3. HACS をインストール
サイドバーで最近ダウンロードしたTerminal & SSHを見つけます。ターミナルで、Home Assistant 設定のルートである config ディレクトリに移動します:
cd /config
以下のコマンドを実行してHACSインストールスクリプトをダウンロードし、実行します:
wget -q -O - https://install.hacs.xyz | bash -
インストールスクリプトが完了した後、変更を適用するためにHome Assistantを再起動する必要があります。UIから設定 > システム > 再起動に移動してHome Assistantを再起動できます。

再起動後、サイドバーの設定をクリックして設定メニューを開きます。設定メニュー内で、デバイスとサービスに移動します。

統合を追加をクリックして、Home Assistantセットアップに新しい統合を追加します。

検索バーでHACSと入力して、Home Assistantコミュニティストア統合を検索します。

HACSが見つかった場合、利用可能な統合のリストに表示されるはずです。それをクリックしてインストールプロセスを開始します。
ライセンス契約または利用規約がポップアップする場合があります。契約を注意深く読み、条件に同意する場合は、すべてのボックスにチェックを入れて同意を示します。送信をクリックしてインストールを続行します。

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

指示に従ってHome AssistantがあなたのGitHubアカウントにアクセスすることを承認します。これは通常、GitHubから提供される認証コードを入力してあなたの身元を確認することを含みます。

Home AssistantがあなたのGitHubアカウントを使用することを承認すると、HACSのインストールが完了します。

HACSがシステムに完全に統合されるために、Home Assistantを再起動する必要がある場合があります。
SenseCraftプラグインのインストール
ステップ4. HACSを介したSenseCraftプラグインのインストール
サイドバーでHACSを探してクリックし、HACSインターフェースを開きます。右下隅に、メニューボタン(HACSのバージョンによって3つの点またはプラス記号)があります。カスタムリポジトリをクリックします。

リポジトリURLの入力を求めるダイアログボックスが表示されます。ここで、SenseCraft統合のカスタムリポジトリURLを入力します。URLを入力した後、カテゴリを選択します(SenseCraft統合の場合、統合を選択します)。
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を開きます。

次にXIAO ESP32S3を選択し、Connectをクリックします。
ここではXIAO ESP32S3が選択されていますが、実際にはXIAO ESP32C3を使用していることに注意してください!
下のボタンをクリックしてファームウェアファイルをダウンロードし、WebページのAdd Fileボタンをクリックして0x0
アドレス用のSSCMA_XIAO_ESP32C3_adapter_sensecraft_v1.1.8.bin
ファームウェアをフラッシュします。

最後にFlashボタンをクリックし、プログラムが正常にアップロードされるまで待ってから、XIAO ESP32C3をコンピュータから切断します。
ステップ6. Grove Vision AI V2をSenseCraft AIモデルアシスタントに接続する
まず、SenseCraft AIのメインページを開く必要があります。
ナビゲーションメニューでVision Workspace -> Grove Vision AI V2をクリックします。

Type-Cタイプのケーブルを使用してGrove Vision AI V2をコンピュータに接続してください。
次に左上のConnectボタンをクリックし、デバイスのポート番号を選択します。

ステップ7. 適切なモデルをアップロードする
次に、Select Modelをクリックした後、使用したい適切なモデルを選択してGrove Vision AI V2にアップロードしてください。

モデルがアップロードされるまで1〜2分待ちます。
ステップ8. 観察
モデルが正常にアップロードされると、右側のPreviewでGrove Vision AI V2カメラからのライブフィードを見ることができます。

右側のPreview Settingsには、モデルの認識精度を最適化するために変更できる2つの設定オプションがあることがわかります。
Previewに画面が表示されない場合やモデル情報に情報がない場合は、モデルに問題がある可能性があり、モデルを再選択するか再度アップロードする必要があります。
Home AssistantでのMQTTサービス構築
ステップ9. EMQXのインストール
サイドバーのSettingsをクリックして設定メニューにアクセスします。Add-onsをクリックしてアドオンストアにアクセスします。

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

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

EMQXアドオンがインストールされたら、Start on boot、Watchdog、Show in sidebarのトグルをオンにします。StartをクリックしてEMQXを開始します。
EMQXダッシュボードのログインページで、デフォルトのユーザー名とパスワードを入力します。
- デフォルトユーザー名:admin
- デフォルトパスワード:public
「Login」ボタンをクリックしてEMQXダッシュボードにアクセスします。
EMQXダッシュボードで、左サイドバーメニューから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 Asistantがインストールされているホストと同じ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アドレスが表示されている場合、WiFiに問題がないことを意味し、Service statusは図のテキストが正常を表す必要があります。WiFiが正常でない場合、MQTTは確実に正常ではないことに注意してください。切り替えたばかりの時は未接続と表示される場合があり、約10秒程度待つ必要があります。リフレッシュする必要はなく、ステータスが変更された後に自動的に最新のステータスが表示されます。
ステップ11. Home Assistantへの統合
- シナリオ1. デバイスが見つかった場合
- シナリオ2. デバイスが見つからない場合
この時点で、通常はHome AssistantのSettings->Devices & services内でGrove Vision AI V2を検索できるはずです。

Configureボタンをクリックして関連情報を設定してください。これでデバイスの追加が完了しました。

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

- 前のステップでユーザー名とパスワードを設定した場合、デバイスを追加する際にそれらの入力を求められる場合があります。
- Home Assistantに複数のVision AIデバイスを追加する場合は、デバイスのID番号に注意してください。これは異なるGroveフラグ間の識別マークとして機能します。

自宅にデバイスが多すぎる場合、Home Assistantで直接検索できないことがあります。その場合、手動でデバイスを追加する必要があります。
Settingsページで、Devices & Servicesを選択します。
右下角のADD INTEGRATIONボタンをクリックし、SenseCraftを検索します。

SenseCraftをクリックし、ActionとしてAdd device using host/idを選択します。

SUBMITをクリックし、ドロップダウンメニューからGrove Vision AI V2
などのデバイスタイプを選択し、再度SUBMITをクリックします。

次の入力フィールドに、デバイスの正確なIDを入力します。このIDは通常、デバイス本体またはSenseCraft AIウェブサイトで確認できます。


次のステップはMQTTサービスの設定です。ウェブサイトで設定したMQTTサービスの詳細と一致する情報を入力します。以前にユーザー名とパスワードを設定していない場合は、ここで入力する必要はありません。その後、SUBMITをクリックします。

- Broker: Home AssistantのIPアドレス。
- Port:
1883
。 - clientId: デバイス識別番号には、
grove_vision_ai_v2_
をプレフィックスとして付け、その後にカスタムID番号を続けてください。 - username: 作成したEMQXデータベースの名前。
- password: 作成したEMQXデータベースのパスワード。
設定が成功すると、システムは通常、デバイスの場所を選択するよう促します。実際の状況に基づいて適切な部屋またはエリアを選択し、Finishをクリックします。
設定が完了すると、Home Assistantの「Overview」ページでデバイスとその状態を確認できます。
これらの手順に従うことで、「SenseCraft」デバイスをHome Assistantインスタンスに正常に追加し、MQTTサービスを使用するように設定できるはずです。

トラブルシューティング
Q1: Grove Vision AI V2が切断された後、HAでデータメッセージが再び表示されない場合はどうすればよいですか?
SenseCraftでデバイスを削除して再追加する必要があります。削除後、自動検索できなくなる可能性があり、手動でデバイスを追加する必要があります。デバイスを再追加するには、**こちらの手順**を参照してください。

技術サポート & 製品ディスカッション
弊社製品をお選びいただき、ありがとうございます!お客様の製品体験を可能な限りスムーズにするため、さまざまなサポートを提供いたします。異なる好みやニーズに対応するため、複数のコミュニケーションチャネルをご用意しております。