Seeed Studio IoTボタンの使い方
この文書は AI によって翻訳されています。内容に不正確な点や改善すべき点がございましたら、文書下部のコメント欄または以下の Issue ページにてご報告ください。
https://github.com/Seeed-Studio/wiki-documents/issues

はじめに
IoTボタンは、ESPHomeとZigbeeを通じてHome Assistantに統合可能な多機能スマートスイッチです。ESP32-C6を搭載し、カスタマイズ可能なRGB LEDインジケーター、プログラム可能なイベントトリガー、USB-C充電、柔軟な取り付けオプションを備えています。直感的なスマートホームコントロールに必要なすべてが揃っています。
特徴
- Home Assistant対応
- 1つのスイッチでカスタマイズ可能なアクション
- 信頼性の高い電源供給
- 簡単な取り付けソリューション
- カスタマイズに対応
ハードウェア概要
使用を開始する前に、製品の基本的なパラメータを把握することが重要です。以下の表は、IoTボタンの特性に関する情報を提供します。
パラメータ | 説明 |
---|---|
MCU | Espressif ESP32-C6 |
フラッシュ | 4MB |
LED | ユーザーRGB LED: WS2812B (GPIO19 使用時にはGPIO18も有効にする必要があります) 充電LED: 緑 ユーザーLED: 青 (GPIO2) |
無線 | 2.4GHz Wi-Fi Zigbee |
バッテリー | 3.6V リチウムイオン18650充電式バッテリー |
充電インターフェース | USB Type-C |
バッテリー保護 | 逆極性保護 |
ファームウェア更新 | OTA対応 |
寸法 | 92x32x25 mm |


使用開始
ステップ1: 初期設定
IoTボタンを初めて受け取った際には、使用前に初期アクティベーションを行うことが重要です。以下の手順に従ってください:
- 標準的な5V USB Type-Cデータケーブルを使用して、IoTボタンを電源に接続します。
- この初回の電源接続は、内蔵バッテリーをアクティブ化するために重要です。
- このアクティベーションステップを行わないと、デバイスは正常に動作しません。
IoTボタンには省電力スリープモードが搭載されています:
- 未設定状態:デバイスは2分間操作がないとスリープモードに入ります。スリープ解除にはボタンを1回押す必要があります。
- ESPHome設定後:バッテリーを節約するため、ボタンを離してから9秒後にスリープモードに入ります。操作を行う前にボタンを1回押してスリープを解除する必要があります。
IoTボタンにはESPHome互換のファームウェアがプリロードされているため、アクティベーション後は以下の手順に従ってHome Assistantとの統合を進めることができます。
アクティベーションプロセスには、適合した5V USB Type-Cケーブルを使用してください。非標準ケーブルを使用すると、アクティベーションが正しく行われない場合があります。
ステップ2: Home Assistantの設定
インストール: 最適なパフォーマンスを得るために、Raspberry PiにHome Assistant OSをインストールすることをお勧めします。公式のインストールガイドに従ってください。
Home AssistantのインストールSeeed Studio製品向けにHome Assistantのインストール方法を記載したガイドもありますので、参考にしてください。
また、以下のボタンをクリックして、Home Assistant GreenまたはHome Assistant Yellowを購入し、直接使用することもできます。
ESPHomeアドオンの有効化:
- Home Assistantのダッシュボードにアクセスします。
- 「アドオン」セクションに移動し、ESPHomeアドオンを検索します。
- 「インストール」をクリックし、その後「開始」をクリックして有効化します。

必要なコンポーネントを揃え、ESPHomeアドオンを使用してHome Assistantを設定することで、IoTボタンの統合を進める準備が整います。
ステップ3: キットの準備
デフォルトでは、デバイスにはIoTボタン用のファームウェアがプリフラッシュされています。ただし、以下の2つのシナリオではファームウェアを更新する必要があります:
- ファームウェアの再フラッシュ: 既存のファームウェアが破損している場合や、新たに開始する必要がある場合。
- ファームウェアのアップグレード: 機能が改善された新しいバージョンのファームウェアがある場合。
ファームウェアをフラッシュするには、以下の2つの簡単な方法があります:
このWeb Toolを使用すると、簡単かつ直接的にファームウェアをフラッシュできます。画面上の指示に従うだけです。
- 接続を開始するには、
CONNECT
ボタンをクリックしてください。このツールは自動的にファームウェアを更新します。
問題が発生した場合は、画面上のトラブルシューティング手順に従うか、ESPHome Web
の方法に切り替えてプロセスを完了してください。
この方法では、こちらからbin
ファームウェアファイルをダウンロードする必要があります(ダウンロードしたファイルを解凍してください)。
- IoTボタンをPCに接続します。
- ESPHome Webページにアクセスします。
*.factory.bin
というサフィックスが付いたファームウェアファイルを選択します。
以下の動画で、ESPHome Webを使用したファームウェアフラッシュの詳細な手順をご覧ください:
どちらの方法でも、ファームウェアが更新され、Home Assistantとの統合の準備が整います。
キットのホットスポットに接続する
ファームウェアを使用してIoTボタンの電源を入れると、seeedstudio-iot-button
というWi-Fiアクセスポイントが表示されます。
192.168.4.1
にアクセスして、Home Assistantサーバーのローカルネットワーク設定を構成してください。


ステップ4: Home Assistantでデバイスを検出して追加する
このセクションでは、Home Assistantアプリを使用したプロセスを説明します。このロジックはWeb版と同じです。
アプリを開く: アプリを起動したら、Home Assistantサーバーを選択します。アプリは自動的にサーバーを検出します。
アカウントを作成する: アカウントをまだ作成していない場合は、作成する必要があります。その後、資格情報を使用してログインしてください。
統合ページに移動する: ログイン後、Home Assistantの「統合」ページに移動します。ESPHomeアドオンをインストールしており、IoTボタンとHome Assistantサーバーが同じネットワーク上にある場合、
Seeed Studio IoT Button
というデバイスが検出されたデバイスとして表示されます。デバイスを追加する: デバイスをHome Assistantのセットアップに追加するにはクリックします。
CONFIGURE
ボタンをクリックし、SUBMIT
ボタンを押して確認し、デバイスを希望のエリア(例:リビングルーム)に割り当てます。その後、このデバイスはESPHome統合を通じて管理され、Home Assistantで完全な制御と監視が可能になります。noteセットアッププロセス中にエリアを割り当てる必要がない場合は、後でHome Assistantの「統合」セクションに移動し、デバイスを選択してエリアを手動で設定できます。
IoTボタンを使用したオートメーションの作成
IoTボタンのセットアップが完了したら、スマートホーム内のデバイスを制御するためのオートメーションを作成できます。ここでは、ボタンを押すとライトが点灯するシンプルなオートメーションを作成してみましょう。
- Home Assistantで、設定 > オートメーションとシーン に移動します。

- オートメーションを作成 をクリックします。

- オートメーションを設定します:
- 名前: 「IoTボタン シングルプレス - ライトを点灯」など、わかりやすい名前を付けます。
- トリガー: トリガータイプとして「状態」を選択
- エンティティ: 「Switch 1」(シングルプレス用)を選択
- From: 「off」
- To: 「on」
- アクション: 制御したいデバイスを選択
- 例: ライトを選択し、点灯するように設定

- 保存 をクリックしてオートメーションを作成します。

高度な使用法: 異なる押下パターンで異なるデバイスを制御
IoTボタンの設定の強力な機能の1つは、異なる押下パターンを検出できることです。以下は各パターンを活用するアイデアです:
シングルプレス(Switch 1):
- 現在の部屋のライトをオン/オフ
- よく使うデバイスをトグル
ダブルプレス(Switch 2):
- シーンをアクティブ化(例: 「ムービーナイト」でライトを暗くし、テレビをオン)
- 複数のデバイスを同時に制御
長押し(Switch 3):
- セキュリティ機能をアクティブ化(アラームのオン/オフ)
- 緊急ルーチンをトリガー
- 複数のデバイスを一括でオフ
これらの高度なオートメーションを設定するには、上記の手順に従って追加のオートメーションを作成し、適切なスイッチ(Switch 1、2、または3)をトリガーとして選択し、希望するアクションを設定してください。
技術サポートと製品に関するディスカッション
弊社の製品をお選びいただきありがとうございます!製品をスムーズにご利用いただけるよう、さまざまなサポートをご提供しています。お客様の好みやニーズに応じた複数のコミュニケーションチャネルをご用意しています。