Unit MQ ESPHome 组件

Unit MQ 组件用于读取可燃气体检测数据和加热状态。

1. 组件简介

项目	信息
产品名称	Unit MQ
SKU	U199
主要功能	可燃气体和加热状态检测
通信接口	I2C
默认 I2C 地址	`0x11`
ESPHome 组件	`m5stack_unit_mq`（外部组件）
ESPHome 版本要求	/

2. 组件说明

外部组件引入

M5Stack 外部组件 - m5stack_unit_mq

external_components:
  - source: github://m5stack/esphome-yaml/components
    components: [m5stack_unit_mq]
    refresh: 0s 

Sensor 与 Binary Sensor 气体检测

添加 m5stack_unit_mq Sensor Platform，配置加热模式并读取 MQ、NTC 和参考电压等数据；led 配置项会额外创建一个表示数据有效性的 Binary Sensor 实体。

sensor:
  - platform: m5stack_unit_mq
    heat_mode: SWITCH
    temperature:
      name: "Unit MQ Temperature"
    mq_adc:
      name: "MQ ADC"
    ntc_adc:
      name: "NTC ADC"
    ntc_resistance:
      name: "NTC Resistance"
    reference_voltage:
      name: "Internal Reference Voltage"
    mq_voltage:
      name: "MQ Voltage"
    ntc_voltage:
      name: "NTC Voltage"
    led:
      name: "MQ Data Valid"
    update_interval: 20s 

主要参数：

参数	说明
`heat_mode`	加热模式。可选 `CONTINUOUS`、`SWITCH` 或 `OFF`。
`temperature`	根据热敏电阻数据换算的温度。
`mq_adc`	MQ 通道的 12 位 ADC 原始读数。
`ntc_adc`	NTC 通道的 12 位 ADC 原始读数。
`ntc_resistance`	NTC 电阻阻值。
`reference_voltage`	内部参考电压。
`mq_voltage`	MQ 通道电压。
`ntc_voltage`	NTC 通道电压。
`led`	数据有效二值状态；该配置项只读取状态，不控制板载 LED。
`high_level_time`	`SWITCH` 加热模式的高电平持续时间，单位为秒，默认 `30`，最小 `30`。
`low_level_time`	`SWITCH` 加热模式的低电平持续时间，单位为秒，默认 `5`，最小 `5`。
`update_interval`	传感器数据更新间隔。

警告

设备需要加热一段时间后才能正常输出（至少需要加热到 29 摄氏度左右才会有 ADC 读数）。使用 heat_mode: CONTINUOUS 时设备会持续加热，请避免接触高温探头。

3. 参考案例

yaml 
i2c:
  sda: GPIOXX
  scl: GPIOXX
  scan: true

external_components:
  - source: github://m5stack/esphome-yaml/components
    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 Data Valid"
    update_interval: 20s