SenseCraft-HomeAssistant ユーザーマニュアル
この文書は AI によって翻訳されています。内容に不正確な点や改善すべき点がございましたら、文書下部のコメント欄または以下の Issue ページにてご報告ください。
https://github.com/Seeed-Studio/wiki-documents/issues
SenseCraft-HomeAssistant ユーザーマニュアル
はじめに
SenseCraft-HomeAssistant は HomeAssistant 用のプラグインです。このプラグインを使用することで、ユーザーは SenseCraft データプラットフォーム（以前の SenseCAP クラウドプラットフォーム）のアカウントでログインし、HomeAssistant プラットフォーム上でクラウドデバイスやセンサーデータにアクセスし、カスタムデバイスレポートダッシュボードを生成することができます。
SenseCraft-HomeAssistant プラグインは現在、HomeAssistant システム上のサードパーティアプリストアである HACS を介してのみインストール可能です。HomeAssistant が提供する公式統合が十分でない場合、HACS を使用するとサードパーティ統合を簡単に追加および管理できます。
1.1 HACS のインストール手順
HACS プラグインをダウンロードするにはターミナルコマンドが必要なため、まずターミナルアプリをインストールする必要があります。
- 高度なモードを有効にしてターミナルアプリを検索
- 高度なモードを開き、アドオンに移動してターミナルアプリケーションを検索します。
- 見つからない場合は、まずネットワーク接続を確認し、次に HomeAssistant を再起動してみてください。
- インストール、起動、およびターミナルインターフェースの開放
- ターミナルで以下のコマンドを入力して HACS インストールパッケージをダウンロード（詳細は https://hacs.xyz/docs/setup/download を参照）:
- config ディレクトリに移動:
cd config
- HACS をダウンロードしてインストール:
wget -q -O - https://install.hacs.xyz | bash -
- Home Assistant を再起動
- HACS プラグインを検索してインストール
- ライセンス契約が表示されるので、すべての契約を確認して送信
- リンクをクリックして GitHub ページに移動し、ログインして、下部に表示される 8 文字のコードを GitHub インターフェースに入力
- 認証を行う
- これで HACS ストアがインストールされます
1.2 SenseCraft プラグインのインストール
- 上記の手順を完了すると、左側のメニューバーに新しい「HACS」項目が表示されます。
- SenseCraft リポジトリ URL とカテゴリを入力し、「追加」ボタンをクリックします:
- リポジトリ:
https://github.com/Seeed-Solution/SenseCraft-HomeAssistant.git - カテゴリ:
Integration
- 検索ボックスに「sensecraft」と入力し、SenseCraft プラグインを見つけます。
- SenseCraft プラグインをクリックしてプラグイン紹介ページに移動し、「ダウンロード」ボタンをクリックします。
これで、SenseCraftを現在のHome Assistantセットアップに追加する作業が完了しました。
Grove Vision AI(V2)とSenseCraft-HomeAssistant
デバイスをファームウェアやモデルなしで購入した場合、まずファームウェアとモデルを書き込む必要があります。
デバイスにすでにファームウェアとモデルが含まれている場合は、ステップ2をスキップできます。以下は、デバイスにファームウェアとモデルが含まれているかどうかを確認する方法です。ファームウェアとモデルは一緒にバンドルされています。
2.1 デバイスにファームウェアとモデルが含まれているか確認する
- ウェブサイト https://seeed-studio.github.io/SenseCraft-Web-Toolkit/#/setup/process を開き、デバイスをコンピュータに接続します。
Grove Vision AI V2をコンピュータに接続します。
Grove Vision AIオプションに切り替えます。
- 初めての場合、権限を求められます。表示されたデバイスを選択し、「接続」をクリックします。
- 表示される情報と画像がスクリーンショットに似ている場合、正常に動作しています。
2.2 ファームウェアとモデルの書き込み
モデル情報が検出されず、ライブプレビューがない場合は、ファームウェアとモデルを再書き込みする必要があります。
プリセットモデル（例：性別検出）を選択し、「送信」をクリックします。ファームウェアの書き込みが完了するまで待ちます。
2.3 MQTTサービスの設定
オプション1: Home AssistantでMQTTサービスを設定する
- 「設定 > アドオン > アドオンストア」を開くし、右下の「アドオンストア」を見つけます。
- ストアで「mqtt」を検索します。
- インストールをクリックし、MQTTサービスをユーザー名とパスワードで設定します。
- 「オプション > ログイン」に移動し、ユーザー名またはパスワードを希望のものに置き換えます。設定を保存します。
- username: user
- password: passwd
エラーがない場合は成功です。エラーがある場合は、アンインストールして再インストールし、再度設定を試してください。
オプション2: 自分のコンピュータにMQTTサービスをインストールする
https://www.emqx.com/en/downloads/broker/5.4.0 からシステムに適したEMQXをダウンロードし、OSに応じた指示に従います。
MacOSを例に取ると：
以下を使用してパッケージをダウンロードします：
wget https://www.emqx.com/en/downloads/broker/5.4.0/emqx-5.4.0-macos13-amd64.zip
そしてEMQXをインストールします：
mkdir -p emqx && unzip emqx-5.4.0-macos13-amd64.zip -d emqx
最後にEMQXを実行します：
./emqx/bin/emqx start
- 機能しているかテストします：
MQTTダウンロード にアクセスしてターミナルをダウンロードします。
MQTTサービス成功の確認
- MQTTXダウンロードページ からMQTTXクライアントをダウンロードし、MQTTサービスがPCからアクセス可能か確認します（公開ネットワークサーバー上に展開されている場合、またはPCと同じネットワークセグメント内にある場合）。
- 接続が成功すれば問題ありません。
2.4 WIFIとMQTTの設定
なぜこれらを設定する必要があるのか？
Grove Vision AIのHome Assistantでの操作はMQTTを通じて行われます。また、MQTT自体がネットワーク接続を必要とするため、WIFIの設定が必要です。5G WIFIは選択できないことに注意してください。設定ページに移動します：
対応する情報を入力し、「保存」をクリックしてください。ただし、ここでの保存は情報を保存するだけであり、実際に正しく設定されたかどうかは不明です。設定が正しいか確認するには、再び「プロセス」ページに戻る必要があります。
IPアドレスが表示されている場合、Wi-Fiに問題がないことを意味します。サービスステータスは、正常な動作を示すために画像のように表示される必要があります。注意点として、Wi-Fiが正常でない場合、MQTTも確実に正常ではありません。
切り替えた際、最初は「切断」と表示されることがありますが、約10秒、通常は20秒以内に接続されます。
ステータスを確認するためにリフレッシュする必要はありません。ステータスは自動的に最新の状態に更新されます。
2.5 Discoveryを使用してHAに統合する
デバイスを「発見済み」セクションに表示させるには、デバイスとHAが同じネットワークセグメント上にある必要があります。そうでない場合、デバイスは表示されません。ネットワークセグメントが不明な場合は、HAとデバイスを同じWi-Fiまたは同じルーターにイーサネットで接続してください。
上記の操作を完了したばかりの場合は、デバイスの電源を切り、再度接続することをお勧めします。設定ページにアクセスしてください：
次に、以下のページが表示されます：
ここで、最初に発見されたデバイスが表示されます。対応するIDを確認して、それが自分のデバイスかどうかを確認してください：
丸で囲まれた部分がデバイスIDであり、以下のウェブサイト上のデバイスIDに対応しています： https://seeed-studio.github.io/SenseCraft-Web-Toolkit/#/setup/process
それが自分のデバイスである場合、「設定」をクリックしてください。ここで、MQTTサービスにユーザー名とパスワードがない場合、以下のダイアログボックスが表示されます。そうでない場合は、ユーザー名とパスワードの入力を求められます。その後、「送信」をクリックしてください。
MQTTサービスにユーザー名とパスワードがある場合は、以下のようになります：
次に、デバイスの場所を選択します。例えば、リビングルーム、キッチンなどです。
ここではリビングルームを選択し、「完了」をクリックします。これでデバイスがHAに追加されます。この時点で、「概要」をクリックして、設定が完了した効果を確認できます。
2.6 手動でHAに統合する
発見済みデバイスを使用できる場合は、手動設定よりも簡単なため、発見済みセクションから設定してください。「設定」を選択し、「デバイスとサービス」を選択します。
次に、以下のように「SenseCraft」の別のインスタンスを選択します：
次に、<Add device using host/id (LAN integration)>を選択します。
その後、「送信」をクリックし、ドロップダウンからgrove_vision_ai_we2を選択して「送信」をクリックします。
次に、デバイスIDを入力します。これはウェブサイトに対応するデバイスIDであり、任意の値ではありません。
その後、「送信」をクリックし、次にMQTTサービスの設定を行います。
ここに入力する詳細は、ウェブサイトで設定した内容と一致している必要があります。以前にユーザー名とパスワードがなかった場合、ここでも入力する必要はありません。その後、「送信」をクリックします。成功すると、デバイスの場所を選択するよう求められます。
実際の状況に基づいて場所を選択し、「完了」をクリックします。この方法で概要で効果を確認することができます。残りの手順は「発見済み」方法と同じです。
センサーノードをHAに統合する
当社には光や二酸化炭素などの多くのセンサーがあり、これらも簡単にHAに統合することができます。センサーノードを統合するには、SENSECAPウェブサイトでアカウントを作成する必要があります。そのため、まず国際サイトまたは国内サイトでアカウントを登録し、センサーノードをアカウントに追加してください。
以下では、アプリを使用してデバイスを追加する方法について説明します：
3.1 SenseCAP Mateアプリを使用してセンサーノードを追加する
まずアプリのホームページにログインしてください。以下の手順に従って追加します。
3.2 ウェブサイトを使用してセンサーノードを追加する
SENSECAPウェブサイトにアクセスし、センサー機器のEUI、Keyなどを入力して「確認」をクリックします。
その後、センサーノードリストに追加したデバイスが表示されます。
3.3 HAへの追加
「設定 > 統合を追加」に移動します。
表示されるダイアログで「sensecraft」を検索します。
その後、フィルター結果をクリックし、<another instance of device "SenseCraft">を選択して、「SenseCraftアカウントを使用してデバイスを追加」を選択します。
「送信」をクリックし、登録したアカウントとパスワードを入力して環境を選択します。これは、国際ステーション（グローバル）または国内ステーション（中国）で登録したかどうかによります。
追加が完了したら、必要に応じてセンサー設定を構成することができます。
さらに詳しく
Home Assistant を NVIDIA Jetson に統合する機能は近日公開予定です！
技術サポート & 製品ディスカッション
弊社製品をお選びいただきありがとうございます！お客様が弊社製品をスムーズにご利用いただけるよう、さまざまなサポートを提供しております。異なる好みやニーズに対応するため、いくつかのコミュニケーションチャネルをご用意しています。