AtomS3R-M12 Home Assistant Integration

This tutorial introduces how to integrate AtomS3R-M12 into Home Assistant.

Preparation

• Home Assistant Host.
• Install and enable ESPHome Builder in Home Assistant.
• OV3660 Datasheet.
• View the latest configuration examples on ESPHome: ESP32 Camera.

Note

This tutorial uses ESPHome 2025.12.5 to compile and upload firmware. If you encounter compilation/upload issues, please consider switching the ESPHome version.

Quick Start

Click the button below to flash the firmware with one click. Follow the on-screen instructions to complete the configuration and quickly experience AtomS3R-M12 integration with Home Assistant.

Flash Firmware

Create Device

1. Click the green button in the lower-right corner to create the device.

2. Click CONTINUE.

3. Click New Device Setup.

4. Enter the device name, then click NEXT.

5. Click ESP32-S3.

6. Click SKIP.

7. Click EDIT, we can customize device functions through the YAML file.

Modify Configuration

The following is the core part of the code. Related references and instructions are provided below.

Basic Information and Boot Operation

Add on_boot component:

esphome:
  name: atoms3r-m12
  friendly_name: AtomS3R-M12
  on_boot:
    priority: 800
    then:
      - lambda: |-
          gpio_set_direction(GPIO_NUM_18, GPIO_MODE_OUTPUT);
          gpio_set_level(GPIO_NUM_18, 0);
          vTaskDelay(pdMS_TO_TICKS(1500));

PSRAM Configuration

Add PSRAM component:

psram:
  mode: octal
  speed: 80MHz

External Components

Add External Components component:

external_components:
  - source: github://DennisGaida/m5stack-atoms3r-components/components@main
    components: [bmi270_bmm150]

I2C Bus Configuration

Add I2C component:

i2c:
  - id: BMI270_150
    sda: GPIO45
    scl: GPIO0
  - id: camera_i2c
    sda: GPIO12
    scl: GPIO9
    frequency: 100kHz
    timeout: 10ms

Sensor Configuration

Add Sensor component:

sensor:
  - platform: bmi270_bmm150
    i2c_id: BMI270_150
    address: 0x68
    update_interval: 3s
    acceleration_x:
      name: "BMI270 Accel X"
    acceleration_y:
      name: "BMI270 Accel Y"
    acceleration_z:
      name: "BMI270 Accel Z"
    gyroscope_x:
      name: "BMI270 Gyro X"
    gyroscope_y:
      name: "BMI270 Gyro Y"
    gyroscope_z:
      name: "BMI270 Gyro Z"
    temperature:
      name: "BMI270 Temperature"

Camera Configuration

Add ESP32 Camera component:

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

Download and Flash Firmware

1. After modification, click SAVE and INSTALL in the upper-right corner, then select Manual Download in the pop-up window.

2. Select Factory format(Previously Modern).

3. Connect the device to the host via a USB Type-C data cable. Open ESPHome Web and click CONNECT to connect to the device.

4. Locate the corresponding serial port number.

5. Click INSTALL.

6. Select the compiled firmware to upload.

7. After the download is complete, restart the device.

Quick Start

1. Click Settings -> Device & services to check the device.

2. We can find the corresponding device in the Discover section.

3. After adding the device, the data will be displayed correctly.

4. Finally, we add these entities to the Dashboard; the following are the display results.