Unit MQ 传感器 Home Assistant 集成

本章节介绍将 Unit MQ 可燃气体检测单元集成至 Home Assistant 的配置方法与实操步骤。

1. 准备工作

环境准备

参考 Home Assistant 官方文档安装 Home Assistant。
参考 ESPHome 官方文档完成 ESPHome Device Builder 插件安装。
查阅相关资料：

确认主控设备的 I2C 引脚定义（不同主控引脚不同）。

硬件产品

Unit MQ
兼容主控设备（如 Atom 系列、Stamp 系列、Stick 系列、Core/Basic 系列等）

注意

Unit MQ 是单独的传感器平台，需要额外的主控设备（如 Atom 系列、Stamp 系列， Stick 系列，Core/Basic 系列等）才能集成至 Home Assistant。

2. 修改配置

需要在 ESPHome 配置中启用 I²C 组件：

yaml 
# Example configuration entry for ESP32
i2c:
  sda: GPIOXX
  scl: GPIOXX
  scan: true

这里的 GPIO 引脚会因为使用的主控设备不一而不同。比如使用 Atom Lite 作为主控：

yaml 
# I2C Bus on Grove Port (HY2.0-4P)
i2c:
  sda: GPIO26
  scl: GPIO32

Unit MQ 配置的范例：

yaml 
external_components:
  - source: github://m5stack/esphome-yaml/components@main
    components: m5stack_unit_mq
    refresh: 0s

sensor:
  - platform: m5stack_unit_mq
    heat_mode: SWITCH
    temperature:
      id: mq_temp
      name: "Unit MQ Temperature"
    mq_adc:
      id: mq_adc_val
      name: "MQ ADC"
    ntc_adc:
      id: ntc_adc_val
      name: "NTC ADC"
    ntc_resistance:
      id: ntc_resistance_val
      name: "NTC Resistance"
    reference_voltage:
      id: in_ref_volt
      name: "Internal Reference Voltage"
    mq_voltage:
      id: mq_volt
      name: "MQ Voltage"
    ntc_voltage:
      id: ntc_volt
      name: "NTC Voltage"
    led:
      id: mq_led
      name: "MQ LED Status"
    update_interval: 20s

可配置选项：

heat_mode (Required): Unit MQ 加热模式，可选CONTINUOUS (持续加热)，SWITCH (间歇加热) 和 OFF 关闭
temperature (Optional): 来自热敏电阻读转换得出的温度数据
mq_adc (Optional): 12 Bit MQ ADC 读数
ntc_adc (Optional)： 12 Bit NTC ADC 读数
ntc_resistance (Optional): NTC 电阻阻值
reference_voltage (Optional): 内部参考电压
mq_voltage (Optional): MQ 电压读数
led (Optional): LED 有效读数，当读数有效时，LED 会亮起