Connecting a sensor to the Grove port of the device allows the sensor to use the device's power supply and Wi-Fi connection. Home Assistant can then detect the sensor and start using it. This page provides configuration details for a few selected sensors.

Prerequisites

• Home Assistant Voice Preview Edition set up and running in Home Assistant
• Opened the Grove port
• Have one or more external sensors, such as:
  • M5Stack SHT40-BMP280 temperature, humidity, air pressure sensor
  • M5Stack PIR motion sensor
  • M5Stack SGP30 TVOC, eCO2 gas sensor
  • M5Stack BH1750 ambient light sensor
• If you are adding more than one sensor, you need an expansion unit like this Grove hub

To connect a sensor to the grove port

Step 1

Taking control of the device in the ESPHome add-on

1. Go to Settings > Add-ons and install the ESPHome Device Builder add-on.
2. Start the add-on and select Open web UI.
3. On the Home Assistant Voice card, select Take control, and follow the steps of the installer.

Step 2

Installing a new device configuration

1. To open the device configuration file, on the Home Assistant Voice card, select Edit.

2. In the configuration file, under packages, add the configuration for the sensor.

   • In this example, we are adding the configuration for the M5Stack SHT40-BMP280 temperature, humidity, air pressure sensor.

   packages:
     grove-i2c: github://esphome/home-assistant-voice-pe/modules/grove-i2c.yaml
   sensor:
     - platform: sht4x
       i2c_id: grove_i2c
       temperature:
         name: Temperature
       humidity:
         name: Humidity
   
     - platform: bmp280_i2c
       i2c_id: grove_i2c
       address: 0x76
       pressure:
         name: Pressure
   

   • For other sensors, refer to the section on Configuration data for selected sensors.

3. Now, you need to recompile the firmware with the new configuration settings. To start the process, select Install.

4. Wait for the compilation to complete. Depending on your hardware, this may take a while.

Step 3

Connecting the sensor to the Grove port

1. Disconnect the device from power.
2. Connect the sensor to the Grove port.
   • Mind the color coding. Make sure the black cable is connected to the ground (GND) pin.
3. Reconnect the device to the power supply.

Step 4

Opening the ESPHome integration page

1. Go to Settings > Devices & services and select the ESPHome integration.
2. From the list, under Home Assistant Voice, select Device.

Step 5

Viewing the sensor data

• On the device page, under Sensors, you can view the new sensor data.

Configuration data for selected sensors

This section shows some configuration examples for selected sensors. The configuration information needs to be added to the configuration file.

1. To open the device configuration file, on the Home Assistant Voice card, select Edit.
2. In the configuration file, under packages, add the configuration for the specific sensor.

Example 1: PIR motion sensor

Configuration for the M5Stack PIR motion sensor.

packages:
  grove-power: github://esphome/home-assistant-voice-pe/modules/grove-power.yaml
binary_sensor:
  - platform: gpio
    pin:
      number: 2
    name: Motion
    device_class: motion

Example 2: SGP30 TVOC, eCO2 gas sensor

Configuration for the M5Stack SGP30 TVOC, eCO2 gas sensor.

packages:
  grove-i2c: github://esphome/home-assistant-voice-pe/modules/grove-i2c.yaml
sensor
  - platform: sgp30
    i2c_id: grove_i2c
    tvoc:
      name: "TVOC"
    eco2:
      name: "eCO2"

Example 3: BH1750 ambient light sensor

Configuration for the M5Stack BH1750 ambient light sensor.

packages:
  grove-i2c: github://esphome/home-assistant-voice-pe/modules/grove-i2c.yaml
sensor:
  - platform: bh1750
    i2c_id: grove_i2c
    name: "Light Intensity"

Related topics

• M5Stack SHT40-BMP280 temperature, humidity, air pressure sensor
• M5Stack PIR motion sensor
• M5Stack SGP30 TVOC, eCO2 gas sensor
• M5Stack BH1750 ambient light sensor