AtomS3R-CAM Home Assistant 集成

1. 准备工作

1. 硬件

• 1 x AtomS3R-CAM
• 1 x Home Assistant 主机（服务器、迷你主机、NAS 等）

2. 软件及版本

• ESPHome Device Builder 2026.3.0 或更高版本

2. 创建设备

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

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

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

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

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

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

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

3. 设备配置

3.1 外部组件配置

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

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

3.2 PSRAM 配置

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

psram:
  mode: octal
  speed: 80MHz

3.3 I2C 总线配置

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

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

3.4 摄像头配置

添加 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

4. 构建并烧录固件

4.1 构建固件

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

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

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

4.2 烧录固件

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

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

6. 点击 INSTALL。

7. 选择步骤 3 中下载的固件文件，开始烧录。

5. 开始在 Home Assistant 中使用

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

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

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

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