AtomS3R + Atomic Echo Base 音声アシスタント

このガイドでは、AtomS3R と Atomic Echo Base を組み合わせて、Home Assistant に音声アシスタント機能を統合する方法を説明します。

1. 環境の準備

1. Home Assistant の公式ドキュメントを参照して Home Assistant（2025.12.3 以降）をインストールしてください。
1. 以下のガイドに従って音声認識関連のアドオンをインストールおよび設定してください。
- Home Assistant Cloud
- Assist Pipeline
1. Settings -> Add-ons -> Add-on STORE から ESPHome アドオンをインストールします。
1. ESPHome をインストールしたら、ESPHome 管理ページで Show in sidebar を有効にして左サイドバーに追加します。

変更履歴

2026-02 ESPHome の API 変更により発生したコンパイルエラーを修正しました。ESPHome 2025.1.2 でビルドを確認しています。問題が発生した場合は、このバージョンに切り替えることを検討してください。

2. デバイスを追加する

ESPHome アドオンページを開き、右下の NEW DEVICE をクリックして新しいデバイスを作成します。

ポップアップで CONTINUE をクリックします。

New Device Setup を選択して新しい設定ファイルを作成します。

設定ファイルの名前を入力します。

デバイスタイプとして ESP32-S3 を選択します。

Home Assistant API の Encryption Key を控え、Skip をクリックします。

3. デバイスの設定

生成された設定で EDIT をクリックして設定を編集します。（Wi‑Fi 設定はデフォルトで現在の HA サーバーを参照します。必要に応じて ssid や password を上書きしてください。）

以下のパッケージ参照を追加して、音声アシスタントコンポーネントを読み込みます。

packages:
    m5stack.atoms3r-with-echo-base: github://m5stack/esphome-yaml/common/atoms3r-with-echo-base.yaml@main 

その後、SAVE、INSTALL をクリックし、インストール方法で Manual download を選択します。

ビルド注意:

HA 経由でのファームウェアコンパイルはリソースを消費します。初回はリソースのダウンロードのため時間がかかる場合があります。

4. ファームウェアの書き込み

ファームウェアの保存

1. コンパイルが完了したら Download をクリックし、Factory Format (Previously Modern) を選んでファームウェアをローカルに保存します。
1. Open ESPHome Web をクリックして Web 書き込みツールを開きます。

ヒント

ダウンロード画面で Open ESPHome Web をクリックできます。

接続と書き込み

AtomS3R と Atomic Echo Base を組み立て、AtomS3R を USB‑C ケーブルで PC に接続し、リセットボタンを長押しして緑色 LED が点灯したら放してダウンロードモードに入れます。

Open ESPHome Web で CONNECT をクリックし、デバイスポートを選択します。

INSTALL をクリックします。

先ほどビルドした *.bin を選択し、再度 INSTALL をクリックして書き込みを開始します。

書き込みが完了するまで待ちます。

5. 新しいデバイスの確認

書き込み完了後、デバイスは起動時に自動で Wi‑Fi に接続します。同一 LAN 内の Home Assistant が新しいデバイスを検出します。Notifications でデバイスを選択し Check it out -> CONFIGURE を実行して、表示される手順に沿ってデバイスを追加してください。通知が表示されない場合は Settings -> Device & services を確認してください。