Grove Vision AI V2 を Home Assistant に接続する
この文書は AI によって翻訳されています。内容に不正確な点や改善すべき点がございましたら、文書下部のコメント欄または以下の Issue ページにてご報告ください。
https://github.com/Seeed-Studio/wiki-documents/issues
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 エコシステムに取り込み、カスタマイズや制御が可能になります。
以下はこの記事の主要な内容構成です。
- HACS プラグインのインストール: Home Assistant Community Store (HACS) をインストールして、Seeed Studio の SenseCraft プラグインを Home Assistant 内でインストールできるようにします。
- 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 に統合し、設定用のビジュアルダッシュボードを構築します。
はじめに
この記事のチュートリアル内容を始める前に、以下のハードウェアを準備する必要があります。
必要な材料
Home Assistant Green は、最も簡単でプライバシーに配慮した方法で家庭を自動化するためのデバイスです。簡単なセットアップを提供し、すべてのスマートデバイスを 1 つのシステムで制御できるようにします。データはデフォルトでローカルに保存されます。このボードは活発な Home Assistant エコシステムの恩恵を受け、オープンソースによって毎月改善されます。
このチュートリアルでは、Home Assistant のホストとして Home Assistant Green を使用することをお勧めしますが、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セットアップに新しい統合を追加します。

検索バーにHACSと入力して、Home Assistant Community Store統合を探します。

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

次に、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をコンピュータに接続します。デバイスドライバが正しくインストールされていることを確認してください。
ウェブブラウザでSenseCraft Model Assistant Toolを開きます。

次に、XIAO ESP32S3を選択し、Connectをクリックします。
ここではXIAO ESP32S3を選択しますが、実際にはXIAO ESP32C3を使用しています!
以下のボタンをクリックしてファームウェアファイルをダウンロードし、ウェブページ上の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のメインページを開きます。
ナビゲーションメニューでVision Workspace -> 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カメラからのライブフィードが表示されます。

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

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

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

EMQXアドオンがインストールされたら、起動時に開始、ウォッチドッグ、およびサイドバーに表示のトグルをオンにします。開始をクリックしてEMQXを起動します。
EMQXのダッシュボードログインページで、デフォルトのユーザー名とパスワードを入力します。
- デフォルトのユーザー名: admin
- デフォルトのパスワード: public
「ログイン」ボタンをクリックしてEMQXのダッシュボードにアクセスします。
EMQXのダッシュボードで、左サイドバーメニューから認証セクションに移動します。データベースタブをクリックします。

作成ボタンをクリックします。メカニズムドロップダウンでパスワードベースを選択し、バックエンドドロップダウンで組み込みデータベースを選択します。「作成」ボタンをクリックして組み込みデータベースを作成します。
組み込みデータベースを作成した後、「認証」セクションのユーザータブをクリックします。「ユーザー追加」ボタンをクリックします。
- 「ユーザー名」フィールドに「seeed」と入力します。
- 「パスワード」フィールドに「seeed」と入力します。
「認証」セクションの「データベース」タブに戻ります。リスト内の先ほど作成したデータベースを見つけます。
データベースの横にあるトグルスイッチをクリックして有効にします。データベースのステータスが「有効」に変わるはずです。

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とパスワード: デバイスはHome Assistantがインストールされているホストと同じLAN上にある必要があります。そのため、同じLANでネットワークを設定してください。XIAOは2.4G WiFiのみをサポートしており、5Gネットワークは利用できません。
- 暗号化: AUTOを選択します。
- ホスト: Home AssistantがインストールされているホストのIPアドレス。
- ポート:
1883
。 - clientId: デバイス識別番号として、
grove_vision_ai_v2_
に続けてカスタムID番号を付けてください。 - ユーザー名: 先ほど作成したEMQXデータベースの名前。
- パスワード: 先ほど作成したEMQXデータベースのパスワード。
その後、下部の適用ボタンをクリックします。保存後、Grove Vision AIがネットワークに接続されたことを意味するわけではありません。左メニューのプロセスに戻り、デバイスのIPアドレスが表示されているか、MQTT接続のステータスが正しいかを確認してください。

IPアドレスが表示されている場合、WiFiに問題がないことを意味します。また、サービスステータスが図のテキストである必要があります。WiFiが正常でない場合、MQTTも正常ではありません。切り替えたばかりの場合、未接続と表示されることがありますが、約10秒ほど待つ必要があります。ステータスが変わると自動的に最新のステータスが表示されるため、リフレッシュする必要はありません。
ステップ11. Home Assistantへの統合
- シナリオ1. デバイスが見つかった場合
- シナリオ2. デバイスが見つからない場合
この時点で通常、Home Assistantの設定->デバイスとサービス内でGrove Vision AI V2を検索できるはずです。

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

設定->デバイスとサービスで、デバイスの詳細を確認し、サポートされているタブを表示できます。表示したいタブを好きなだけ追加できます。

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

もし自宅にデバイスが多すぎる場合、Home Assistantで直接検索できないことがあります。その際は、デバイスを手動で追加する必要があります。
設定ページで、デバイスとサービスを選択します。
その後、右下の統合を追加ボタンをクリックし、SenseCraftを検索します。

SenseCraftをクリックし、アクションとしてホスト/IDを使用してデバイスを追加を選択します。

送信をクリックし、ドロップダウンメニューからデバイスの種類(例:Grove Vision AI V2
)を選択し、再度送信をクリックします。

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


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

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

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

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