HomeAssistant 向けアプリケーション
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) をインストールし、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 に統合し、設定用のビジュアルダッシュボードを構築します。
本記事のチュートリアルを始める前に、以下のハードウェアを用意しておく必要があります。
Home Assistant Green は、最も簡単かつプライバシー重視のホームオートメーションの方法です。セットアップは簡単で、すべてのスマートデバイスを 1 つのシステムで制御でき、データはデフォルトですべてローカルに保存されます。このボードは活発な Home Assistant エコシステムの恩恵を受けており、オープンソースによって毎月改善されていきます。
本チュートリアルでは Home Assistant のホストとして Home Assistant Green を使用することを推奨しますが、Supervisor を備えた任意の Home Assistant ホストを使用することもできます。
次に、ピンヘッダ（または拡張ボードと Grove インターフェース）を使用して、XIAO と Grove Vision AI V2 を接続する必要があります。
HACS プラグインのインストール
Section titled “HACS プラグインのインストール”ステップ 1. Home Assistant で Advanced Mode を有効にする
Section titled “ステップ 1. Home Assistant で Advanced Mode を有効にする”Home Assistant の可能性を最大限に引き出し、高度な機能へアクセスするには、ユーザーインターフェースで「Advanced Mode」を有効にします。
Home Assistant web interface にアクセスします。Home Assistant サイドバー左下のプロフィールアイコンをクリックします。プロフィールページで下にスクロールし、Advanced Mode トグルを見つけます。トグルをオンの位置に切り替えます。
ステップ 2. Terminal & SSH をインストールする
Section titled “ステップ 2. Terminal & SSH をインストールする”サイドバーの Settings をクリックして設定メニューにアクセスします。Add-ons をクリックしてアドオンストアを開きます。
検索バーを使用するか、利用可能なアドオンをスクロールして Terminal & SSH を探します。
Terminal & SSH を見つけたら、それをクリックして詳細を表示します。アドオンのページには、概要、ドキュメント、設定オプションが表示されます。アドオンをインストールするには、Install ボタンをクリックします。
ステップ 3. HACS をインストールする
Section titled “ステップ 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 プラグインのインストール
Section titled “SenseCraft プラグインのインストール”ステップ 4. HACS 経由で SenseCraft プラグインをインストールする
Section titled “ステップ 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 用のモデルを準備する
Section titled “Grove Vision AI V2 用のモデルを準備する”ステップ 5. XIAO ESP32C3 にファームウェアを書き込む
Section titled “ステップ 5. XIAO ESP32C3 にファームウェアを書き込む”適切な USB-C ケーブルを使用して XIAO ESP32C3 をコンピュータに接続します。デバイスドライバが正しくインストールされていることを確認してください。
Web ブラウザで SenseCraft Model Assistant Tool を開きます。
次に XIAO ESP32S3 を選択し、Connect をクリックします。
下のボタンをクリックしてファームウェアファイルをダウンロードし、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 に接続する
Section titled “ステップ 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. 適切なモデルをアップロードする
Section titled “ステップ 7. 適切なモデルをアップロードする”その後、Select Model をクリックしたうえで使用したい適切なモデルを選択し、Grove Vision AI V2 にアップロードしてください。
モデルがアップロードされるまで 1〜2 分ほど待ちます。
ステップ 8. 動作確認
Section titled “ステップ 8. 動作確認”モデルが正常にアップロードされると、右側のプレビューで Grove Vision AI V2 カメラからのライブ映像が表示されます。
右側の Preview Settings では、モデルの認識精度を最適化するために変更できる設定項目が 2 つあります。
Home Assistant で MQTT サービスを構築する
Section titled “Home Assistant で MQTT サービスを構築する”ステップ 9. EMQX をインストールする
Section titled “ステップ 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 に統合する
Section titled “Grove Vision AI V2 を Home Assistant に統合する”ステップ 10. Grove Vision AI V2 と XIAO のネットワーク設定
Section titled “ステップ 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 接続のステータスが正しいかを確認してください。
ステップ 11. Home Assistant への統合
Section titled “ステップ 11. Home Assistant への統合”ここまでの手順が完了していれば、通常は Home Assistant の Settings->Devices & services 内で Grove Vision AI V2 を検索できるようになっています。
Configure ボタンをクリックして関連情報を設定すると、デバイスの追加が完了します。
Settings->Devices & services では、デバイスの詳細とサポートされているタブが表示されます。概要に表示するタブは、必要なだけ追加することができます。
自宅にデバイスが多すぎる場合、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 の Web サイト上で確認できます。
次のステップでは MQTT サービスを設定します。Web サイト上で設定した 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 サービスを使用するように構成できるはずです。
トラブルシューティング
Section titled “トラブルシューティング”Q1: Grove Vision AI V2 が切断された後、HA でデータメッセージが再び表示されなくなった場合はどうすればよいですか？
Section titled “Q1: Grove Vision AI V2 が切断された後、HA でデータメッセージが再び表示されなくなった場合はどうすればよいですか？”SenseCraft でデバイスを削除して再追加する必要がある場合があります。削除後は自動検索ができなくなる可能性があり、その場合はデバイスを手動で追加する必要があります。デバイスを再追加するには、こちらの手順 を参照してください。
技術サポート & 製品ディスカッション
Section titled “技術サポート & 製品ディスカッション”当社製品をお選びいただきありがとうございます。お客様が当社製品をスムーズにご利用いただけるよう、さまざまなサポートをご用意しています。お好みやニーズに応じて選択いただけるよう、複数のコミュニケーションチャネルを提供しています。