AtomS3R-CAM Home Assistant Integration

This chapter describes how to integrate AtomS3R-CAM with Home Assistant.

1. Preparation

Environment Setup

1. Install Home Assistant by following the official Home Assistant documentation.
2. Install the ESPHome Device Builder add-on by following the official ESPHome documentation. (Note: This tutorial is based on ESPHome 2026.3.0. If you encounter compilation errors, switch to this version for verification.)

Hardware

• AtomS3R-CAM

2. Firmware Compilation & Flashing

This section explains how to recompile the project from the yaml configuration file for secondary development, feature modifications, or adding new features.

Create Device

1. Open ESPHome Dashboard. If the initial wizard appears, click CONTINUE.

2. Click the green + button in the bottom right to create a new device.

3. Click New Device Setup to enter the device creation wizard.

4. Enter a device name and click NEXT.

5. Select the device type and click ESP32S3.

6. Click SKIP to skip the encryption key setup.

Modify Configuration

1. Click EDIT to open the YAML editor and customize the device configuration.

External Components Configuration

Add the External Components entry to load the early_init component from the M5Stack ESPHome repository.

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

PSRAM Configuration

Add the PSRAM component to enable the on-chip octal PSRAM required by the camera.

psram:
  mode: octal
  speed: 80MHz

I2C Bus Configuration

Add the I2C bus for the OV3660 camera.

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

Camera Configuration

Add the ESP32 Camera component to stream video from the OV3660 camera.

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

Compile Firmware

1. After editing the YAML configuration, click SAVE in the top right, then click INSTALL.

2. In the popup dialog, select Manual Download.

3. Wait for the firmware to compile, then click Download and choose Factory format (Previously Modern) to save the firmware file locally.

Flash Firmware

1. Connect AtomS3R-CAM to your computer using a USB Type-C cable. Open ESPHome Web and click CONNECT.

2. In the serial port selection dialog, select the correct port.

3. Click INSTALL.

4. Select the previously downloaded firmware file and start flashing.

3. Getting Started

1. In Home Assistant, go to Settings > Devices & Services to open the integration management page.

2. In the Discovered section, find the AtomS3R-CAM device, click CONFIGURE, and follow the wizard to complete the setup.

3. After the device is added, you can view it in the Devices list.

4. Finally, add these sensor entities to a dashboard.