Atomic Audio-3.5 Base (Echo Base) Home Assistant 集成

1. 准备工作

硬件

1 x AtomS3R
1 x Atomic Audio-3.5 Base (Echo Base)
1 x Home Assistant 主机（服务器、迷你电脑、NAS 等）

软件及版本

ESPHome Device Builder 2026.4.0 或更高版本

2. 创建设备

打开 ESPHome Dashboard。如果出现初始向导，点击 CONTINUE。

点击右下角的绿色 + 按钮创建新设备。

点击 New Device Setup 进入设备创建向导。

输入设备名称，然后点击 NEXT。

选择设备类型，点击 ESP32S3。

点击 SKIP 跳过加密密钥设置。

点击 EDIT 打开 YAML 编辑器并自定义设备配置。

3. 设备配置

3.1 基础配置

添加 psram 组件
添加 I2C 组件

esp32:
  variant: esp32s3
  flash_size: 8MB
  cpu_frequency: 240MHz
  framework:
    type: esp-idf
    sdkconfig_options:
      CONFIG_ESP32S3_DEFAULT_CPU_FREQ_240: "y"
      CONFIG_ESP32S3_DATA_CACHE_64KB: "y"
      CONFIG_ESP32S3_DATA_CACHE_LINE_64B: "y"

psram:
  mode: octal
  speed: 80MHz

i2c:
  - id: bsp_bus
    sda:
      number: GPIO45
      ignore_strapping_warning: true
    scl:
      number: GPIO0
      ignore_strapping_warning: true
    scan: true
  - id: ext_bus
    sda: GPIO38
    scl: GPIO39 

注意

AtomS3R 对应 SDA: GPIO38, SCL: GPIO39。如果使用其他接口，请根据实际引脚进行调整。

3.2 音频配置

添加 i2s_audio 组件
添加 audio_dac 组件
添加 speaker 组件

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

audio_dac:
  - platform: es8311
    id: es8311_dac
    i2c_id: ext_bus
    bits_per_sample: 16bit
    sample_rate: 48000
    use_microphone: false
    use_mclk: false

speaker:
  - platform: i2s_audio
    id: i2s_speaker
    i2s_audio_id: i2s_audio_bus
    i2s_dout_pin: GPIO5
    dac_type: external
    audio_dac: es8311_dac
    sample_rate: 48000
    channel: left 

3.3 媒体播放器配置

添加 media_player 组件

media_player:
  - platform: speaker
    name: "${friendly_name}"
    id: speaker_media_player
    volume_min: 0.5
    volume_max: 0.8
    announcement_pipeline:
      speaker: i2s_speaker
      format: FLAC
      sample_rate: 48000
      num_channels: 1 

3.4 SPI 和字体配置

添加 spi 组件
添加 font 组件

spi:
  clk_pin: GPIO15
  mosi_pin: GPIO21

font:
  - file: "gfonts://Roboto"
    id: font_medium
    size: 14 

3.5 扬声器功放配置

添加 pi4ioe5v6408 组件
添加 switch 组件

pi4ioe5v6408:
  - id: pi4ioe5v6408_hub
    i2c_id: ext_bus
    address: 0x43

switch:
  - platform: gpio
    name: "Speaker Enable"
    id: speaker_enable
    pin:
      pi4ioe5v6408: pi4ioe5v6408_hub
      number: 0
      mode:
        output: true
    icon: "mdi:volume-high"
    restore_mode: RESTORE_DEFAULT_ON 

3.6 显示屏和 LED 配置

添加 output 组件
添加 light 组件
添加 display 组件

lp5562:
  id: lp5562_led
  i2c_id: bsp_bus
  use_internal_clk: true
  white_current: 17.5

output:
  - platform: lp5562
    id: lp5562_white_channel
    lp5562_id: lp5562_led
    channel: white

light:
  - platform: monochromatic
    name: "LCD Backlight"
    id: lcd_backlight
    output: lp5562_white_channel
    icon: "mdi:television"
    restore_mode: RESTORE_DEFAULT_ON

display:
  - platform: mipi_spi
    id: atoms3r_lcd
    model: ST7789V
    dc_pin: GPIO42
    reset_pin: GPIO48
    cs_pin: GPIO14
    data_rate: 40MHz
    update_interval: 1s
    dimensions:
      height: 128
      width: 128
      offset_width: 2
      offset_height: 1
    invert_colors: true
    rotation: 180°
    lambda: |-
      it.fill(Color::BLACK);
      it.print(
        it.get_width() / 2,
        it.get_height() / 2,
        id(font_medium),
        Color::WHITE,
        TextAlign::CENTER,
        "Audio-3.5 Base"
      ); 