Seeed HA Discovery 経由で IoT Button V2 を Home Assistant に接続
Seeed Studio IoT Button V2 は ESP32-C6 を搭載した多機能スマートスイッチで、カスタマイズ可能な RGB LED インジケーター、プログラム可能なイベントトリガー、USB-C 充電機能を提供します。このプロジェクトでは、Seeed HA Discovery 統合を使用して IoT Button V2 を Home Assistant に接続する方法をガイドします。これは ESP32 デバイスを Home Assistant に簡単に接続し、WebSocket 経由で自動検出とリアルタイム通信を可能にするソリューションです。
ESPHome を使用する場合と比較して、このソリューションはディープスリープに適したボタン使用ケースに特化して設計されています。ESPHome は現在 IoT Button V2 に対してライトスリープのみをサポートしており、これは時間の経過とともに高い電力消費につながり、実際のボタン押下がエンティティを確実にトリガーする前に専用の押下でデバイスを起動する必要があります。このファームウェアと Seeed HA Discovery 統合により、ボタンは適切にディープスリープに入り、ボタン操作で直接起動できるため、これらの制限を回避し、より応答性が高く電力効率的な体験を提供します。
入門ガイド
このプロジェクトでは、3つの主要な段階を説明します：ウェブベースのフラッシャーを使用して IoT Button V2 にファームウェアをフラッシュすること、HACS（Home Assistant Community Store）経由で Seeed HA Discovery 統合をインストールすること、そしてスマートホーム自動化のために Home Assistant でボタンを検出することです。
必要な材料
Home Assistant Green は、ホームオートメーションの最も簡単でプライバシーに配慮した方法です。簡単なセットアップを提供し、すべてのスマートデバイスを1つのシステムで制御でき、すべてのデータはデフォルトでローカルに保存されます。このボードは活発な Home Assistant エコシステムの恩恵を受け、オープンソースにより毎月改善されます。
このチュートリアルでは Home Assistant Green を Home Assistant ホストとして使用することをお勧めしますが、Supervisor を備えた任意の Home Assistant ホストを使用することもできます。
Seeed Studio 製品の一部について Home Assistant のインストール方法も書いていますので、参考にしてください。
- ODYSSEY-X86 での Home Assistant 入門
- reTerminal での Home Assistant 入門
- LinkStar H68K/reRouter CM4 での Home Assistant 入門
Seeed Studio 製品を使用していない場合は、Home Assistant 公式ウェブサイトで他の製品への Home Assistant インストール方法を確認して学習することもできます。
事前準備
このプロジェクトを開始する前に、以下を確認してください：
- 動作中の Home Assistant インスタンス（Home Assistant OS、Container、または Core）
- Home Assistant に HACS（Home Assistant Community Store）がインストールされていること
- Google Chrome または Microsoft Edge ブラウザを搭載したコンピューター（ウェブベースのファームウェアフラッシュに必要）
- WiFi ネットワーク名（SSID）とパスワード
- IoT Button V2 と接続用の USB-C ケーブル
まだ HACS をインストールしていない場合は、公式 HACS インストールガイドに従って最初にセットアップしてください。Seeed HA Discovery 統合をインストールするには HACS が必要です。
IoT Button V2 にファームウェアをフラッシュ
Seeed HA Discovery は ESP32/nRF52840 デバイスを Home Assistant に簡単に接続するための完全なソリューションであり、最初のステップは IoT Button V2 に適切なファームウェアをフラッシュすることです。
ウェブベースのファームウェアフラッシャーは IoT Button V2 のみと互換性があります。現在、IoT Button V1 での使用はサポートされていません。
ステップ 1. ウェブフラッシャーにアクセス
Google Chrome または Microsoft Edge ブラウザを開き、Seeed HA Discovery ウェブフラッシャーにアクセスします：
Web Serial は Google Chrome と Microsoft Edge ブラウザで利用可能です（ただし iOS デバイスでは利用できません）。デスクトップまたはラップトップコンピューターでサポートされているブラウザを使用していることを確認してください。
ステップ 2. IoT Button V2 を接続
Zigbee/ESPHome ファームウェアを使用している場合は、デバイスが自動的にスリープモードに入るかどうかに注意してください。デバイスがスリープモードに入ると、そのシリアルポートを見つけることができない場合があります。ファームウェアをフラッシュする前に、デバイスの青色 LED が点灯し、起動状態を維持していることを確認してください。
ステップ 2.1. USB-C ケーブルを使用して IoT Button V2 をコンピューターに接続します。
ステップ 2.2. ウェブフラッシャーページで、IoT Button V2 ファームウェアオプションを見つけて "Connect" ボタンをクリックします。
ステップ 2.3. 利用可能なシリアルポートを表示するブラウザポップアップが表示されます。IoT Button V2 に対応するポート（通常は USB JTAG またはシリアルとラベル付けされています）を選択し、"Connect" をクリックします。
ステップ 3. ファームウェアをフラッシュ
ステップ 3.1. 接続されたら、"Install IoT Button V2" ボタンをクリックしてファームウェアアップロードプロセスを開始します。
ステップ 3.2. 次に、デバイスを消去するかどうかを選択する必要があります。ネットワーク認証情報を失うことなくデバイスファームウェアのみを更新したい場合は、このオプションをチェックせずに Next をクリックできます。別のファームウェアから切り替える場合は、最初のファームウェアフラッシュ時にこのボタンをチェックすることを強くお勧めします。
フラッシャーは既存のファームウェアを消去し、新しい Seeed HA Discovery ファームウェアをアップロードします。このプロセスは通常 1-2 分かかります。このプロセス中はデバイスを切断しないでください。
ステップ 3.3. "Installation complete!" メッセージが表示されたら、ファームウェアが正常にフラッシュされました。
ファームウェア機能の理解
ディープスリープ機能を備えた IoT Button V2 ファームウェアは、いくつかの主要な機能を提供します：
電源管理：
- deep_sleep コンポーネントは、一定時間後に ESP32 でディープスリープモードに自動的に入るために使用できます。これは特にバッテリーで動作するノードで有用で、可能な限りエネルギーを節約する必要があります[1]。
- ボタンは非アクティブ状態が 3 分続くとライトスリープモードに入り、バッテリー電力を節約します
- スリープからの復帰はボタンを押すことでトリガーされます
ボタンイベント：
- シングルプレス: Home Assistant でシングルクリックイベントをトリガー
- ダブルプレス: Home Assistant でダブルクリックイベントをトリガー
- ロングプレス: ロングプレスイベントをトリガー（通常 1 秒以上）
- トリプルプレス: 開発者モードに入り、デバイスが 3 分間起動状態を維持し、シリアルポート接続を失うことなくファームウェアをフラッシュできます
- ロングプレス（6 秒以上）: LED が点滅した後、ボタンを離すとネットワーク再設定モードが開始され、新しい Wi-Fi ネットワークを設定できます
LED フィードバック：
- RGB LED がボタン押下と接続状態の視覚的フィードバックを提供
- 異なる状態に対するカスタマイズ可能な LED 色
バッテリー監視：
- バッテリーレベル推定のための ADC ベースの電圧読み取り
- Home Assistant へのリアルタイムバッテリー状態レポート
IoT Button V2: ライフサイクル & イベント
Seeed HA Discovery 統合をインストール
IoT Button V2 に適切なファームウェアが搭載されたので、次のステップは HACS を介して Home Assistant に Seeed HA Discovery 統合をインストールすることです。
ステップ 4. HACS をインストール（まだインストールしていない場合）
まだ HACS をインストールしていない場合：
ステップ 4.1. Home Assistant Community Store（HACS）をインストールして、Home Assistant 内で Seeed HA Discovery プラグインのインストールを可能にします。
ステップ 4.2. https://www.hacs.xyz/docs/use/download/download/#to-download-hacs の公式 HACS インストールガイドに従ってください。
ステップ 4.3. HACS がシステムに完全に統合されるために、Home Assistant の再起動が必要な場合があります。
ステップ 5. Seeed HA Discovery リポジトリを追加
ステップ 5.1. Seeed HA Discovery GitHub リポジトリに移動します：
ステップ 5.2. README セクションで、⚡ ワンクリックインストール エリアを見つけて、OPEN HACS REPOSITORY ON MY HA ボタンをクリックします。
このボタンは自動的に Home Assistant インスタンスにリダイレクトし、HACS リポジトリ追加ページを開きます。
ステップ 5.3. Home Assistant URL を表示するリダイレクトページが表示されます。検出された Home Assistant アドレスが正しいことを確認してください（Home Assistant の IP アドレスまたはドメイン名と一致する必要があります）。
-
アドレスが正しい場合は、Open link をクリックして続行します
-
アドレスが間違っている場合は、
http://YOUR_HA_IP:8123またはhttps://YOUR_HA_DOMAINの形式で正しい Home Assistant URL を手動で入力してください
ステップ 5.4. Home Assistant が開き、Seeed HA Discovery リポジトリ URL がすでに入力された HACS リポジトリ追加ダイアログが表示されます。
ステップ 5.5. 右下角の Download をクリックして、リポジトリを HACS に追加します。プラグインの最新バージョンを使用していることを確認してください。インストールスクリプトが完了したら、変更を適用するために Home Assistant を再起動する必要があります。Settings > System > Restart に移動して UI から Home Assistant を再起動できます。
ワンクリックボタンが機能しない場合は、以下の手順でリポジトリを手動で追加できます：
-
Home Assistant サイドバーで HACS を開く
-
右下角のメニューボタン（3つの点）をクリック
-
"Custom repositories" を選択
-
https://github.com/limengdu/Seeed-Homeassistant-Discoveryを入力し、カテゴリ "Integration" を選択
WiFi を設定して IoT Button を発見
統合がインストールされたので、IoT Button V2 を WiFi ネットワークに接続し、Home Assistant で発見できるように設定できます。
ステップ 6. IoT Button V2 で WiFi を設定
ステップ 6.1. ファームウェアをフラッシュした後、IoT Button V2 は初期設定用の WiFi アクセスポイント（AP）を作成します。AP 名は通常 Seeed_IoT_Button_V2_AP になります。
ステップ 6.2. スマートフォンまたはコンピューターを使用して、この WiFi アクセスポイントに接続します。
ステップ 6.3. キャプティブポータルが自動的に開くはずです。開かない場合は、ウェブブラウザを開いて http://192.168.4.1 に移動してください。
ステップ 6.4. 設定ポータルで、ホーム WiFi ネットワークの認証情報を入力します：
IoT Button は現在、5G 周波数帯で動作するネットワークをサポートしていないことにご注意ください。
- SELECTED NETWORK: あなたの WiFi ネットワーク名
- PASSWORD: あなたの WiFi パスワード
ステップ 6.5. "Connect" をクリックして設定を保存します。
ステップ 6.6. IoT Button V2 が再起動し、WiFi ネットワークに接続されます。RGB LED が青色で表示されます。
ステップ 7. Home Assistant に IoT Button を追加
ステップ 7.1. 再起動後、サイドバーの Settings をクリックして設定メニューを開きます。設定メニュー内で、Devices & Services に移動します。
ステップ 7.2. IoT Button V2 が WiFi ネットワークに正常に接続されている場合、WiFi 接続後にデバイスが Home Assistant によって自動的に検出されます。デバイスが自動的に検出されない場合は、右下の "Add Integration" をクリックし、"Seeed HA Discovery" を検索して、デバイスの IP アドレスを入力することで手動で追加することもできます。
デバイスの IP アドレスは、シリアルポートログまたはルーターのバックエンドから取得できます。
ステップ 7.3. 画面の指示に従って統合設定を完了します。ボタンを家のエリアに割り当てる必要がある場合があります。
ステップ 7.4. 設定が完了すると、IoT Button V2 が Home Assistant ダッシュボードに表示され、ボタンイベント、バッテリー状態、LED 制御の利用可能なエンティティが表示されます。
ステップ 8. オートメーションの作成
IoT Button が接続されたので、Home Assistant でオートメーションを作成できます：
ステップ 8.1. Settings > Automations & Scenes に移動します。
ステップ 8.2. "Create Automation" をクリックし、"Start with an empty automation" を選択します。
ステップ 8.3. Trigger では、IoT Button デバイスを選択し、イベントタイプ（シングルプレス、ダブルプレス、またはロングプレス）を選択します。
ステップ 8.4. Action では、実行したい動作を選択します（例：ライトをオンにする、シーンをトリガーする、通知を送信する）。
ステップ 8.5. オートメーションを保存し、IoT Button を押してテストしてください！
技術サポート & 製品ディスカッション
弊社製品をお選びいただき、ありがとうございます！弊社製品での体験が可能な限りスムーズになるよう、さまざまなサポートを提供いたします。さまざまな好みやニーズに対応するため、複数のコミュニケーションチャンネルを提供しています。