Unit MQ Sensor Home Assistant Integration

This chapter introduces the configuration methods and practical steps for integrating the Unit MQ combustible gas detection unit into Home Assistant.

Precautions

The Unit MQ is merely a sensor platform and requires an additional host device (such as the Atom series, Stamp series, Stick series, Core/Basic series, etc.) to be integrated into Home Assistant.

Preparation

1. Refer to the relevant documentation:
   • Communication Protocol
   • MQ5 Datasheet
2. Prepare a compatible host device (such as Atom series, Stamp series, Stick series, Core/Basic series, etc.)
3. Confirm the I2C pin definitions of the host device (pins vary by host device).

Configuring the Sensor

1. You need to enable the I²C component in the ESPHome configuration:

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

The GPIO pins here will differ depending on the host device used. For example, using Atom Lite as the host:

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

Example configuration for Unit MQ:

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

Configurable options:

• heat_mode (Required): Unit MQ heating mode. Options: CONTINUOUS, SWITCH, and OFF.
• temperature (Optional): Temperature data derived from the thermistor reading.
• mq_adc (Optional): 12-bit MQ ADC reading.
• ntc_adc (Optional): 12-bit NTC ADC reading.
• ntc_resistance (Optional): NTC resistance value.
• reference_voltage (Optional): Internal reference voltage.
• mq_voltage (Optional): MQ voltage reading.
• led (Optional): LED status reading. The LED lights up when the reading is valid.

Dashboard Example

Example display after configuration and integration into Home Assistant:

Related Videos