AtomS3R-CAM Home Assistant 集成

本章节介绍将 AtomS3R-CAM 集成至 Home Assistant 的方法。

1. 准备工作

环境准备

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

硬件产品

• AtomS3R-CAM

2. 固件编译 & 烧录

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

创建设备

1. 打开 ESPHome Dashboard。若出现初始向导，点击 CONTINUE。

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

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

4. 输入设备名称，点击 NEXT。

5. 选择设备类型，点击 ESP32S3。

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

修改配置

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

外部组件配置

添加 External Components 条目，从 M5Stack ESPHome 仓库加载 early_init 组件。

external_components:
  - source: github://m5stack/esphome-yaml/components
    components: [early_init]

PSRAM 配置

添加 PSRAM 组件，启用摄像头所需的片上八路 PSRAM。

psram:
  mode: octal
  speed: 80MHz

I2C 总线配置

添加 OV3660 摄像头所需的 I2C 总线。

i2c:
  - id: camera_i2c
    sda: GPIO12
    scl: GPIO9
    frequency: 100kHz
    timeout: 10ms
    scan: true

摄像头配置

添加 ESP32 Camera 组件，通过 OV3660 摄像头进行视频流传输。

esp32_camera:
  name: "OV3660 Camera"
  external_clock:
    pin: GPIO21
    frequency: 20MHz
  i2c_id: camera_i2c
  data_pins: [GPIO3, GPIO42, GPIO46, GPIO48, GPIO4, GPIO17, GPIO11, GPIO13]
  vsync_pin: GPIO10
  href_pin: GPIO14
  pixel_clock_pin: GPIO40
  resolution: 640X480
  jpeg_quality: 10

编译固件

1. 编辑完 YAML 配置后，点击右上角 SAVE，再点击 INSTALL。

2. 在弹出对话框中选择 Manual Download。

3. 等待固件编译完成，点击 Download 并选择 Factory format (Previously Modern) 将固件文件保存到本地。

烧录固件

1. 使用 USB Type-C 数据线将 AtomS3R-CAM 连接到电脑。打开 ESPHome Web 并点击 CONNECT。

2. 在串口选择对话框中，选择正确的端口。

3. 点击 INSTALL。

4. 选择之前下载的固件文件，开始烧录。

3. 开始使用

1. 在 Home Assistant 中，前往 Settings > Devices & Services 打开集成管理页面。

2. 在 Discovered 区域找到 AtomS3R-CAM 设备，点击 CONFIGURE，按向导完成设置。

3. 设备添加后，可在设备列表中查看。

4. 最后，将传感器实体添加到仪表板中。