pdf-icon

Echo Pyramid Home Assistant 連携

はじめに

Echo Pyramid は、Atom / Atom-Lite / AtomS3 / AtomS3R 向けのプロフェッショナルな音声開発ベースです。ATOM コントローラを挿すだけで、スマート音声デバイスを素早く構築できます。ATOM モジュール はオーディオ処理、無線通信、IoT 制御を担当し、専用 STM32 マイコンがタッチボタンと RGB ライティングを制御して、レスポンスの良いインタラクションと視覚的なフィードバックを実現します。高性能オーディオコーデックシングルマイク内蔵スピーカーアンプ を備えた Echo Pyramid は、遠距離からの音声収音と再生に優れており、音声アシスタント、スマートスピーカー、IoT 音声アプリケーションに最適です。

準備

  • Home Assistant ホスト
  • Home Assistant に ESPHome Builder をインストールして有効化
  • マスターコントローラ AtomS3R
Tip
本チュートリアルでは、ESPHome 2026.1.2 でファームウェアのビルドと書き込みを行います。ビルドまたは書き込み時に問題が発生する場合は、ESPHome をこのバージョンに切り替えて試してみてください。

ステップ 1. 新しいデバイスを作成
— 右下の緑色のボタンをクリックして、新しいデバイスを作成します。

ステップ 2. デバイス名を作成
CONTINUE をクリックします。

New Device Setup をクリックします。

— デバイス名を入力し、NEXT をクリックします。

ステップ 3. デバイスタイプを選択

ESP32-S3 を選択します。

SKIP をクリックしてスキップします。

ステップ 4. YAML ファイルの編集を開始
EDIT をクリックし、YAML ファイルでデバイスの機能をカスタマイズします。

デバイス設定

以下は設定のコア部分です。関連するリファレンスと説明を後述します。

PSRAM 設定

  • PSRAM コンポーネントを追加
psram:
  mode: octal
  speed: 80MHz

外部コンポーネント

external_components:
  - source: github://m5stack/esphome-yaml/components
    components: [aw87559,si5351,lp5562,pyramidrgb,pyramidtouch]
    refresh: 0s

I2C バス設定

  • I2C コンポーネントを追加
i2c:
  - id: bsp_bus
    sda: GPIO45
    scl: GPIO0
    scan: true
  - id: ext_bus # Atomic Echo ベースで使用
    sda: GPIO38
    scl: GPIO39

I2S オーディオ設定

i2s_audio:
  - id: i2s_audio_bus
    i2s_lrclk_pin: GPIO8
    i2s_bclk_pin: GPIO6

オーディオ DAC 設定

audio_dac:
  - platform: es8311
    id: es8311_dac
    i2c_id: ext_bus
    bits_per_sample: 16bit
    sample_rate: 16000

オーディオ ADC 設定

audio_adc:
  - platform: es7210
    id: es7210_adc
    i2c_id: ext_bus
    address: 0x40
    bits_per_sample: 16bit
    sample_rate: 16000

マイク設定

microphone:
  - platform: i2s_audio
    id: i2s_mic
    sample_rate: 16000
    i2s_din_pin: GPIO5
    bits_per_sample: 16bit
    adc_type: external
    channel: stereo

スピーカー設定

  • Speaker コンポーネントを追加
speaker:
  - platform: i2s_audio
    id: i2s_speaker
    i2s_dout_pin: GPIO7
    dac_type: external
    bits_per_sample: 16bit
    sample_rate: 16000
    channel: mono
    audio_dac: es8311_dac

ファームウェアビルド

INSTALL を再度クリックしてファームウェアを書き込み、完了するまで待ちます。

— 設定を変更した後、右上の SAVEINSTALL をクリックし、ポップアップで Manual Download を選択します。

— ファームウェアのビルドが完了したら、Factory format(Previously Modern) を選択してダウンロードします。

Tip
Echo Pyramid をクリックすると、完全なサンプル設定を確認できます。初回ビルドには、Home Assistant ホストの性能やネットワーク品質に応じて時間がかかる場合があります。

ファームウェア書き込み

— デバイスを USB Type‑C ケーブルでホストに接続します。ESPHome Web を開き、CONNECT をクリックしてデバイスに接続します。

— 対応するシリアルポート番号を確認します。

INSTALL をクリックします。

— 先ほどビルドしたファームウェアを選択してアップロードします。

Tip
ダウンロード完了後は、必ずデバイスをリセットしてください。

Home Assistant 連携

— Home Assistant で Settings -> Device & services を開き、デバイスを確認します。

Discover セクションに、該当デバイスが表示されます。

— デバイスを追加すると、関連データが正しく表示されます。

— 最終的に、ユーザーはコントロールパネルから Echo Pyramid の各種ハードウェアを操作できるようになり、カスタム音声ウェイクワード (Echo-Pyramid Wake Word) でデバイスを起動して、天気や時刻・日付の確認など、さまざまなスマート音声インタラクションを行うことができます。

On This Page