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

本チュートリアルでは、AtomS3R と Atomic Voice Base を組み合わせて、音声アシスタント機能を Home Assistant に統合する方法を説明します。

1. 準備

環境準備

Home Assistant 公式ドキュメントを参照して Home Assistant をインストールします。
ESPHome 公式ドキュメントを参照して ESPHome Device Builder アドオンをインストールします。（注：本チュートリアルは ESPHome 2025.1.2 を基準に作成されています。コンパイルエラーが発生した場合は、このバージョンに切り替えて確認してください。）
音声認識関連アドオンをインストールして設定します。

ハードウェア製品

2. オンライン書き込み

下の オンライン書き込み ボタンをクリックし、画面の指示に従ってファームウェアの書き込みと Wi-Fi 設定を完了すると、AtomS3R + Atomic Voice Base を Home Assistant にすぐに接続して試すことができます。

書き込みと設定の詳細については、ESPHome ファームウェアのオンライン書き込みと設定を参照してください。

オンライン書き込みを使用した場合、「ファームウェアのコンパイルと書き込み」の手順は不要です。4. 使い方へ進んでください。

3. ファームウェアのコンパイルと書き込み

このセクションでは、二次開発、機能変更、機能追加を行うために、yaml 設定ファイルを基にプロジェクトを再コンパイルする方法を説明します。

コンパイル時間

HA でのファームウェアコンパイルは多くのリソースを消費します。初回コンパイル時は、HA サービスを実行するデバイスの性能やネットワーク品質によって、リソースのダウンロードに時間がかかる場合があります。

デバイスの追加

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

ダイアログで CONTINUE をクリックします。

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

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

デバイスタイプを選択します。ESP32-S3 をクリックしてください。

Home Assistant API Encryption Key をコピーして保管しておき、Skip をクリックします。

設定の変更

新しく生成された設定の EDIT をクリックして設定を編集します。（Wi-Fi 設定はデフォルトで現在の HA サーバーの Wi-Fi 設定が使用されますが、必要に応じて ssid、password などを設定することも可能です。）

以下のリソースパッケージ設定を追加して、デバイスに音声アシスタントの機能コンポーネントを追加します。

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

右上の SAVE、INSTALL をクリックし、表示されるインストール方法の選択画面で Manual download を選択します。

ファームウェアのダウンロードと書き込み

ファームウェアのコンパイル完了後、Download ボタンをクリックし、Factory Format (Previously Modern) 形式のファームウェアをローカルにダウンロードします。

Open ESPHome Web をクリックして、Web 書き込みツールを使用して書き込みを行います。

ヒント

ダウンロード選択画面で Open ESPHome Web をクリックすることができます。

AtomS3R と Atomic Voice Base を組み立て、AtomS3R を USB-C ケーブルでパソコンに接続します。リセットボタンを緑色のランプが点灯するまで長押しして離します。ボタンを離すと緑色のランプが消灯し、デバイスがダウンロードモードに入ったことを確認できます。

ESPHome Web で CONNECT をクリックしてデバイスに接続し、対応するデバイスポートを選択します。

INSTALL をクリックします。

先ほどコンパイルした *.bin ファイルを選択し、再度 INSTALL ボタンをクリックして書き込みを開始します。

書き込みが完了するまでお待ちください。

4. 使い方

ファームウェアの書き込み完了後、デバイスの電源を入れると自動的に Wi-Fi に接続します。同一 LAN 上の Home Assistant サービスが新しいデバイスを検出し、通知を表示します。Notifications から新しいデバイスを選択して Check it out -> CONFIGURE をクリックし、ダイアログの手順に従ってデバイスを指定のエリアに追加すれば設定完了です。新しいデバイスの通知が届かない場合は、Settings > Devices & Services からデバイスの状況を確認してください。

続けて Voice Assistant の設定を行うことも、このステップをスキップして後で設定することも可能です。
- ウェイクワードをテストします。
- エリアを選択します。
- Pipeline を選択します。
- 設定を完了します。

デバイスの追加と、準備手順での Home Assistant Cloud および Assist pipeline アドオンの設定が完了したら、ウェイクワード「Okay Nabu」で音声アシスタントを起動できます。

デモ動画：

5. 動画

Page Tools

On This Page