PM2.5 Air Quality Kit (SHT30) Home Assistant Integration

This section introduces the method of integrating the PM2.5 Air Quality Kit-SHT30 air quality monitoring kit into Home Assistant and outputting data to the LCD screen.

Preparation

• Home Assistant host.
• Install and enable ESPHome Builder in Home Assistant.
• Reference documents:
  • SHT30 Datasheet
  • PMSA003 Datasheet

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 the PM2.5 Air Quality Kit (SHT30) integration with Home Assistant.

Flash Firmware

Note

• In this tutorial, the kit is compiled and uploaded under ESPHome 2025.9.0. If you encounter compilation/upload issues, consider switching ESPHome to this version.

Create Device

1. Open ESPHome Builder, click NEW DEVICE in the bottom right corner to create a new device.

   

2. Click CONTINUE in the pop-up window.

   

3. Select New Device Setup to create a new configuration file.

   

4. Fill in the configuration file name.

   

5. Select the device type: first uncheck Use recommended settings, then click ESP32, and select M5Stack Core ESP32.

   

   

6. Copy the Encryption Key for backup, then click SKIP.

   

Modify Configuration

1. Click EDIT under the generated configuration file card to edit it.

   

2. Add the following to the end of the file:

   yaml packages: m5stack.pm2_5-air-quality-kit: github://m5stack/esphome-yaml/common/pm2_5-air-quality-kit-base.yaml@main

   1 2

   packages:
     m5stack.pm2_5-air-quality-kit: github://m5stack/esphome-yaml/common/pm2_5-air-quality-kit-base.yaml@main

   

3. Then click SAVE and INSTALL in the upper right corner. In the pop-up installation method, select Manual download.

   

   Note:

   The first compilation may take a long time, depending on the performance of the Home Assistant host and the network quality.

4. After compilation is complete, click the Download button and select Factory Format to download the firmware.

   

Download and Flash Firmware

1. Download Firmware: Download the Factory Format firmware via the Manual download method in ESPHome Builder.

2. Flash firmware using web tools:

   • Connect the kit to the host via a USB-C cable, open ESPHome Web, and click CONNECT to connect the device.

     

   • Then click INSTALL and select the previously compiled firmware to upload.

     

   • Click INSTALL again to flash, and wait for the process to complete.

     

Getting Started

1. After flashing the firmware, the device will automatically connect to Wi-Fi upon startup. The Home Assistant service will automatically discover the new device. Select the new device in Notifications and click Check it out -> CONFIGURE. Follow the steps in the pop-up window to add the device to a specified area to complete the configuration.

   

2. If no notification message for the new device is received, you can also navigate to Settings -> Device & services to check the device status. Click Add to add the device to Home Assistant.

   

3. Dashboard Example:

   

4. At the same time, the buttons on the Basic host can switch pages to display more information.

Video