Home Assistant
Home Assistant
主控与整机
扩展模块
灯光控制
PM2.5 Air Quality Kit-SHT30 ESPHome 集成
PM2.5 Air Quality Kit-SHT30 的 ESPHome 集成包含温湿度、颗粒物、按键和 LCD 组件。
1. 设备简介
| 项目 | 信息 |
|---|---|
| 产品名称 | PM2.5 Air Quality Kit-SHT30 |
| SKU | K023-B |
| 主要功能 | 温湿度、PM1.0/PM2.5/PM10 检测和 LCD 显示 |
| 通信接口 | I2C、UART、SPI |
| ESPHome 组件 | sht3xd、pmsx003、gpio、mipi_spi、ledc、monochromatic |
| ESPHome 版本要求 | / |
2. 组件说明
SHT30 温湿度传感器
SHT30 使用 ESPHome 官方 SHT3X-D Platform，输出温度和湿度实体：
i2c:
sda: GPIO21
scl: GPIO22
sensor:
- platform: sht3xd
heater_enabled: false
temperature:
name: "Temperature"
humidity:
name: "Humidity"
address: 0x44
update_interval: 60sPMSA003 颗粒物传感器
PMSA003 使用 ESPHome 官方 PMSX003 Platform，输出 PM1.0、PM2.5 和 PM10 实体：
uart:
tx_pin: GPIO17
rx_pin: GPIO16
baud_rate: 9600
sensor:
- platform: pmsx003
type: PMSX003
pm_1_0:
name: "PM1"
pm_2_5:
name: "PM2.5"
pm_10_0:
name: "PM10"按键与显示
Button A、B、C 使用 ESPHome 官方 GPIO Binary Sensor Platform，分别读取 GPIO39、GPIO38 和 GPIO37 的按键状态：
binary_sensor:
- platform: gpio
pin:
number: GPIO39
inverted: true
name: "Button A"
- platform: gpio
pin:
number: GPIO38
inverted: true
name: "Button B"
- platform: gpio
pin:
number: GPIO37
inverted: true
name: "Button C"LCD 使用 MIPI SPI Display Platform，背光由 LEDC Output 和 Monochromatic Light Platform 控制：
spi:
clk_pin: GPIO18
mosi_pin: GPIO23
display:
- platform: mipi_spi
model: M5CORE
invert_colors: true
data_rate: 40MHz
output:
- platform: ledc
pin: GPIO32
id: backlight_output
light:
- platform: monochromatic
output: backlight_output
name: "Display Backlight"
restore_mode: ALWAYS_ON3. 参考案例
完整整机配置可通过 packages 引入：
packages:
m5stack.pm2_5-air-quality-kit: github://m5stack/esphome-yaml/common/pm2_5-air-quality-kit-base.yaml@main源码：
设备连接 Home Assistant 后，可查看传感器实体并将其添加到 Dashboard：
Basic 主机上的按键可以切换 LCD 页面：
4. 相关链接
5. 相关视频
Page Tools