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 を有効にして左サイドバーに追加します。

ヒント

本ガイドは ESPHome 2025.12.5 でコンパイルしています（推奨）。ビルドに問題がある場合はこれらのバージョンに切り替えてください。

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 を確認してください。