AtomS3U Home Assistant 集成

本教程将介绍如何通过 ESPHome 将 AtomS3U 集成到 Home Assistant 中。

1. 准备工作

环境准备

1. 参考 Home Assistant 官方文档安装 Home Assistant。
2. 参考 ESPHome 官方文档 完成 ESPHome Device Builder 插件安装。（注意：本教程基于 ESPHome 2026.3.x 版本编写，如遇编译错误，建议先切换至该版本进行验证。）

硬件产品

• AtomS3U

2. 固件编译 & 烧录

本小节将说明如何基于 yaml 配置文件重新编译项目，便于二次开发、功能修改或新增功能。

创建设备

1. 在 Home Assistant 中打开 ESPHome Builder，点击右下角的 NEW DEVICE 按钮，创建一个空的配置文件。

2. 弹出框单击 CONTINUE。

3. 选择 Empty Configuration。

4. 为文件命名（可选）。

修改配置

1. 在新生成的配置文件处点击 EDIT。

2. 复制 atoms3u.factory.yaml 的内容到配置文件中。

3. 根据需要，更改网络配置或者是 API 信息等，比如创建一个 API Encryption Key 用于认证：

api:
  encryption:
    key: "Your_Encryption_Key"

或是使用 secret 里面已经定义的 SSID 和密码：

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password

若不提供，则可使用 improv_serial、BLE 或 AP 进行网络配置。

4. 依次点击右上角 SAVE 和 INSTALL，选择 Manual download。

此时会生成代码并且编译工程。

5. 当编译完成后，选择 Factory format 下载固件。

烧录固件

1. 确认已通过 ESPHome Builder 的 Manual download 方式下载 Factory format 固件。

2. 打开浏览器，访问 ESPHome Web。

3. 将 AtomS3U 连接至电脑，长按 RESET 按钮进入下载模式，点击 CONNECT，选择对应的设备端口。

4. 点击 INSTALL，选择之前下载的固件，再次点击 INSTALL，将固件烧录至设备。

5. 烧录完成后，按下 RESET 按钮进行复位。

3. 开始使用

1. 当设备重启后，会自动连接之前配置的网络，正常情况下可以在 Settings -> Devices & services 发现设备。

2. 点击 Add 将 AtomS3U 集成到 Home Assistant。如果此前设置了 API Encryption Key，此处可能需要填入 API Encryption Key 进行验证。

AtomS3U 的 Dashboard 示例：

4. 外设说明

本节将说明配置文件中使用到的外设。

I2C、I2S

主要使用以下 I2C 和 I2S 引脚：

i2c:
  sda: GPIO2
  scl: GPIO1

i2s_audio:
  i2s_lrclk_pin: GPIO39

红外发射器

红外 LED 连接在 GPIO12 上：

remote_transmitter:
  pin: GPIO12
  carrier_duty_percent: 50%
  non_blocking: true
  rmt_symbols: 48

可以添加 IR Remote Climate 组件实现空调控制，例如：

# Example IR Remote Climate
climate:
  - platform: coolix
    name: "Default AC"
    visual:
      min_temperature: 18
      max_temperature: 30
      temperature_step: 1

RGB 灯光

一颗 RGB LED 通过 WS2812 连接到 GPIO35 上：

light:
  - platform: esp32_rmt_led_strip
    rgb_order: GRB
    pin: GPIO35
    num_leds: 1
    chipset: ws2812
    name: "Light"
    rmt_symbols: 48    

PDM 麦克风

设备上带有一个 PDM 麦克风：

microphone:
  - platform: i2s_audio
    id: echo_microphone
    i2s_din_pin: GPIO38
    adc_type: external
    pdm: true