Gas Sensor

created by hek , updated

There are quite a few different gas sensors you can use together with MySensors. Detect alcohol, methane (fart-sensor?), fire etc. We list a few in the buying guide below.

The example provided here uses the MQ2 sensor to detect air quality.

Wiring Things Up

Start by connecting the radio module.

Sensor Arduino Comment
VCC +5V -
A-out A0 -


Last updated by web-flow, 7 Dec 2016, "Repo restyled using astyle (#683)"

 * The MySensors Arduino library handles the wireless radio link and protocol
 * between your home built sensors/actuators and HA controller of choice.
 * The sensors forms a self healing radio network with optional repeaters. Each
 * repeater and gateway builds a routing tables in EEPROM which keeps track of the
 * network topology allowing messages to be routed to nodes.
 * Created by Henrik Ekblad <[email protected]>
 * Copyright (C) 2013-2015 Sensnology AB
 * Full contributor list:
 * Documentation:
 * Support Forum:
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * version 2 as published by the Free Software Foundation.
 * Connect the MQ2 sensor as follows :
 *   A H A   >>> 5V
 *   B       >>> A0
 *   H       >>> GND
 *   B       >>> 10K ohm >>> GND
 * Contribution: epierre
 * Based on
 * License: Attribution-NonCommercial-ShareAlike 3.0 Unported (CC BY-NC-SA 3.0)
 * Modified by HEK to work in 1.4

// Enable debug prints to serial monitor
#define MY_DEBUG

// Enable and select radio type attached
#define MY_RADIO_NRF24
//#define MY_RADIO_RFM69

#include <MySensors.h>

#define     CHILD_ID_MQ                   0
/************************Hardware Related Macros************************************/
#define     MQ_SENSOR_ANALOG_PIN         (0)  //define which analog input channel you are going to use
#define         RL_VALUE                     (5)     //define the load resistance on the board, in kilo ohms
#define         RO_CLEAN_AIR_FACTOR          (9.83)  //RO_CLEAR_AIR_FACTOR=(Sensor resistance in clean air)/RO,
//which is derived from the chart in datasheet
/***********************Software Related Macros************************************/
#define         CALIBARAION_SAMPLE_TIMES     (50)    //define how many samples you are going to take in the calibration phase
#define         CALIBRATION_SAMPLE_INTERVAL  (500)   //define the time interal(in milisecond) between each samples in the
//cablibration phase
#define         READ_SAMPLE_INTERVAL         (50)    //define how many samples you are going to take in normal operation
#define         READ_SAMPLE_TIMES            (5)     //define the time interal(in milisecond) between each samples in
//normal operation
/**********************Application Related Macros**********************************/
#define         GAS_LPG                      (0)
#define         GAS_CO                       (1)
#define         GAS_SMOKE                    (2)
unsigned long SLEEP_TIME = 30000; // Sleep time between reads (in milliseconds)
float Ro = 10000.0;    // this has to be tuned 10K Ohm
int val = 0;           // variable to store the value coming from the sensor
float valMQ =0.0;
float lastMQ =0.0;
float           LPGCurve[3]  =  {2.3,0.21,-0.47};   //two points are taken from the curve.
//with these two points, a line is formed which is "approximately equivalent"
//to the original curve.
//data format:{ x, y, slope}; point1: (lg200, 0.21), point2: (lg10000, -0.59)
float           COCurve[3]  =  {2.3,0.72,-0.34};    //two points are taken from the curve.
//with these two points, a line is formed which is "approximately equivalent"
//to the original curve.
//data format:{ x, y, slope}; point1: (lg200, 0.72), point2: (lg10000,  0.15)
float           SmokeCurve[3] = {2.3,0.53,-0.44};   //two points are taken from the curve.
//with these two points, a line is formed which is "approximately equivalent"
//to the original curve.
//data format:{ x, y, slope}; point1: (lg200, 0.53), point2:(lg10000,-0.22)

MyMessage msg(CHILD_ID_MQ, V_LEVEL);

void setup()
    Ro = MQCalibration(
             MQ_SENSOR_ANALOG_PIN);         //Calibrating the sensor. Please make sure the sensor is in clean air

void presentation()
    // Send the sketch version information to the gateway and Controller
    sendSketchInfo("Air Quality Sensor", "1.0");

    // Register all sensors to gateway (they will be created as child devices)
    present(CHILD_ID_MQ, S_AIR_QUALITY);

void loop()
    uint16_t valMQ = MQGetGasPercentage(MQRead(MQ_SENSOR_ANALOG_PIN)/Ro,GAS_CO);

    Serial.print(MQGetGasPercentage(MQRead(MQ_SENSOR_ANALOG_PIN)/Ro,GAS_LPG) );
    Serial.print( "ppm" );
    Serial.print("    ");
    Serial.print(MQGetGasPercentage(MQRead(MQ_SENSOR_ANALOG_PIN)/Ro,GAS_CO) );
    Serial.print( "ppm" );
    Serial.print("    ");
    Serial.print(MQGetGasPercentage(MQRead(MQ_SENSOR_ANALOG_PIN)/Ro,GAS_SMOKE) );
    Serial.print( "ppm" );

    if (valMQ != lastMQ) {
        lastMQ = ceil(valMQ);

    sleep(SLEEP_TIME); //sleep for: sleepTime

/****************** MQResistanceCalculation ****************************************
Input:   raw_adc - raw value read from adc, which represents the voltage
Output:  the calculated sensor resistance
Remarks: The sensor and the load resistor forms a voltage divider. Given the voltage
         across the load resistor and its resistance, the resistance of the sensor
         could be derived.
float MQResistanceCalculation(int raw_adc)
    return ( ((float)RL_VALUE*(1023-raw_adc)/raw_adc));

/***************************** MQCalibration ****************************************
Input:   mq_pin - analog channel
Output:  Ro of the sensor
Remarks: This function assumes that the sensor is in clean air. It use
         MQResistanceCalculation to calculates the sensor resistance in clean air
         and then divides it with RO_CLEAN_AIR_FACTOR. RO_CLEAN_AIR_FACTOR is about
         10, which differs slightly between different sensors.
float MQCalibration(int mq_pin)
    int i;
    float val=0;

    for (i=0; i<CALIBARAION_SAMPLE_TIMES; i++) {          //take multiple samples
        val += MQResistanceCalculation(analogRead(mq_pin));
    val = val/CALIBARAION_SAMPLE_TIMES;                   //calculate the average value

    val = val/RO_CLEAN_AIR_FACTOR;                        //divided by RO_CLEAN_AIR_FACTOR yields the Ro
    //according to the chart in the datasheet

    return val;
/*****************************  MQRead *********************************************
Input:   mq_pin - analog channel
Output:  Rs of the sensor
Remarks: This function use MQResistanceCalculation to caculate the sensor resistenc (Rs).
         The Rs changes as the sensor is in the different consentration of the target
         gas. The sample times and the time interval between samples could be configured
         by changing the definition of the macros.
float MQRead(int mq_pin)
    int i;
    float rs=0;

    for (i=0; i<READ_SAMPLE_TIMES; i++) {
        rs += MQResistanceCalculation(analogRead(mq_pin));

    rs = rs/READ_SAMPLE_TIMES;

    return rs;

/*****************************  MQGetGasPercentage **********************************
Input:   rs_ro_ratio - Rs divided by Ro
         gas_id      - target gas type
Output:  ppm of the target gas
Remarks: This function passes different curves to the MQGetPercentage function which
         calculates the ppm (parts per million) of the target gas.
int MQGetGasPercentage(float rs_ro_ratio, int gas_id)
    if ( gas_id == GAS_LPG ) {
        return MQGetPercentage(rs_ro_ratio,LPGCurve);
    } else if ( gas_id == GAS_CO ) {
        return MQGetPercentage(rs_ro_ratio,COCurve);
    } else if ( gas_id == GAS_SMOKE ) {
        return MQGetPercentage(rs_ro_ratio,SmokeCurve);

    return 0;

/*****************************  MQGetPercentage **********************************
Input:   rs_ro_ratio - Rs divided by Ro
         pcurve      - pointer to the curve of the target gas
Output:  ppm of the target gas
Remarks: By using the slope and a point of the line. The x(logarithmic value of ppm)
         of the line could be derived if y(rs_ro_ratio) is provided. As it is a
         logarithmic coordinate, power of 10 is used to convert the result to non-logarithmic
int  MQGetPercentage(float rs_ro_ratio, float *pcurve)
    return (pow(10,( ((log(rs_ro_ratio)-pcurve[1])/pcurve[2]) + pcurve[0])));

Gas Sensor Comparison

Sensor Detects Heater Voltage
MQ-2 Methane, Butane, LPG, smoke 5V
MQ-3 Alcohol, Ethanol, smoke 5V
MQ-4 Methane, CNG Gas 5V
MQ-5 Natural gas, LPG 5V
MQ-6 LPG, butane gas 5V
MQ-7 Carbon Monoxide Alternating 5V and 1.4V
MQ-8 Hydrogen Gas 5V
MQ-9 Carbon Monoxide, flammable gasses. Alternating 5V and 1.4V
MQ131 Ozone 6V
MQ135 Air Quality (Benzene, Alcohol, smoke) 5V
MQ136 Hydrogen Sulfide gas 5V
MQ137 Ammonia 5V
MQ138 Benzene, Toluene, Alcohol, Acetone, Propane, Formaldehyde gas, Hydrogen 5V
MQ214 Methane, Natural gas 6V
MQ216 Natural gas, Coal gas 5V
MQ303A Alcohol, Ethanol, smoke 0.9V
MQ306A LPG, butane gas 0.9V
MQ307A Carbon Monoxide Alternating 0.2V and 0.9V.
MQ309A Carbon Monoxide, flammable gasses Alternating 0.2V and 0.9V
MG811 Carbon Dioxide (CO2) 6V
AQ-104 Air quality -


NameSize# Downloads
SNS-MQ135.pdf144.97 kB483
MQ2.pdf179.82 kB661
MQ-3.pdf54.95 kB188
MQ-4.pdf52.71 kB206
MQ5.pdf59.55 kB212
MQ-6.pdf53.88 kB172
MQ-7.pdf52.19 kB353
MG811.pdf95.92 kB263
ESP3SAQ201.pdf165.46 kB429
MQ307A.pdf151.27 kB326
MQ303A.pdf152.2 kB123
1341.pdf39.66 kB463
MQ-138.pdf59.92 kB1154
NH3.pdf143.21 kB136
MQ-136.pdf142.92 kB1015
Ozone.pdf154.03 kB158
MQ9.pdf176.2 kB232
MQ-8 Ver1.3 - Manual.pdf451.29 kB154

Shopping Guide

MQ-135 Air Quality Sensor
Sensitive for Benzene, Alcohol, smoke.
883 available - $1.71   Buy
In stock - $2.65   Buy
MQ-2 Gas Sensor
Sensitive for Methane, Butane, LPG, smoke.
741 available - $1.99   Buy
In stock - $0.98   Buy
MQ-3 Alcohol Sensor
Build a breath analyzer. Sensitive for Alcohol, Ethanol, smoke.
310 available - $1.34   Buy
In stock - $1.73   Buy
MQ-4 Gas Sensor Module
Sensitive for Methane, CNG Gas
419 available - $1.15   Buy
In stock - $1.22   Buy


Sensors & Actuators

Related Content