pdf-icon

Unit MQ 传感器 Home Assistant 集成

Unit MQ 是一款基于半导体气体传感器(MQ-5)设计的可燃气体检测单元,内部集成了 MCU (STM32G030F6P6),主要用于环境中可燃气体(如丙烷、甲烷等)的检测。该单元可通过 I2C 通信接口与各种主控设备进行通信,可获取内部参考电压、传感器电压、12 位和 8 位 ADC 原始值、固件版本、热敏电阻温度等信息。

注意
因为 Unit MQ 只是单独的传感器平台,需要额外的主控设备(如 Atom 系列、Stamp 系列, Stick 系列,Core/Basic 系列等)才能集成至 Home Assistant

配置传感器

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

yaml
1 2 3 4 5
# Example configuration entry for ESP32
i2c:
  sda: GPIOXX
  scl: GPIOXX
  scan: true

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

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

Unit MQ 配置的范例

yaml
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33
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 加热模式,可选CONTINUOUR (持续加热),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会亮起
警告 | 设备需要加热一段时间后才能正常输出(至少需要加热到 29 摄氏度左右才会有ADC读数),配置加热模式 heat_mode: CONTINUOUS 时候,设备会一直加热,接触探头小心烫手

Dashboard 范例

On This Page