AtomS3R-M12 Home Assistant Integration

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

1. Preparation

Environment Setup

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

Hardware

AtomS3R-M12

References

2. Online Flashing

Click the Online Flashing button below and follow the prompts to flash the firmware and configure Wi-Fi. You can then quickly experience AtomS3R-M12 integration with Home Assistant.

For detailed flashing and configuration steps, refer to the Online ESPHome Firmware Flashing and Configuration Guide.

After completing online flashing, you do not need to perform the "Firmware Compilation & Flashing" steps. Proceed directly to 4. Getting Started.

3. 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.

Compilation Time

The first build may take some time, depending on the performance of the Home Assistant host and network quality.

Create Device

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

Click CONTINUE.

Click New Device Setup.

Enter the device name, then click NEXT.

Click ESP32-S3.

Click SKIP.

Modify Configuration

Click EDIT to customize device functions through the YAML file.

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)); 

I2C Communication Note

Due to the hardware circuit design, AtomS3R-M12 needs to pull GPIO18 low after power-on to enable correct I2C communication. If GPIO18 is not set to a low level before I2C bus initialization or access, I2C communication may fail. Therefore, GPIO18 control must be assigned the highest priority to ensure it is pulled low during the early stages of system startup.

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] 

Third-Party Components

Since ESPHome does not yet provide official BMI270 / BMM150 components, this project uses a third-party component library contributed by a community developer. Thanks to the author for their contribution.

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 