MQSensorsLib
We present a unified library for MQ sensors, this library allows to read MQ signals easily from Arduino, Genuino, ESP8266, ESP-32 boards whose references are MQ2, MQ3, MQ4, MQ5, MQ6, MQ7, MQ8, MQ9, MQ131, MQ135, MQ303A, MQ309A.
Table of Contents
Getting Started
//Include the library
#include <MQUnifiedsensor.h>
/************************Hardware Related Macros************************************/
#define Board ("Arduino UNO")
#define Pin (A4) //Analog input 4 of your arduino
/***********************Software Related Macros************************************/
#define Type ("MQ-4") //MQ4
#define Voltage_Resolution (5)
#define ADC_Bit_Resolution (10) // For arduino UNO/MEGA/NANO
#define RatioMQ4CleanAir (4.4) //RS / R0 = 60 ppm
/*****************************Globals***********************************************/
//Declare Sensor
MQUnifiedsensor MQ4(Board, Voltage_Resolution, ADC_Bit_Resolution, Pin, Type);
// Setup
MQ4.setRegressionMethod("Exponential"); //_PPM = a*ratio^b
MQ4.setA(1012.7); MQ4.setB(-2.786); // Configure the equation to to calculate CH4 concentration
MQ4.setR0(3.86018237); // Value getted on calibration
// Loop
MQ4.init();
MQ4.update();
float ppmCH4 = MQ4.readSensor();
Wiring
Sensor
Important points:
Points you should identify
- VCC -> 5V Power supply (+) wire
- GND -> GND Ground (-) wire
- AO -> Analog Output of the sensor
Data of board that you should have
- RL Value in KOhms
- If the sensor uses a different supply voltage than the ADC reference, call
yourSensor.setVCC(<voltage>);
Graph
RS/R0 value (From datasheet of your sensor)
- RS/R0 (Clean air - English) -> (Aire puro - Spanish)
- Note: RS/R0 is equal to Ratio variable on the program
Arduino
MQ-7 / MQ-309A
** Note ** issue: MQ-7 and MQ-309 needs two different voltages for heater, they can be supplied by PWM and DC Signal controlled by your controller, another option is to use two different power sources, you should use the best option for you, next i will show the PWM option and on the examples this will be the way .
ESP8266-ESP32
ESP32 WROOM 32D
The ESP32 WROOM 32D does not need an external power supply. A0 goes to PIN36, Vcc to 3v3 and GND to any GND port on the board. Check the ESP2/ESP32_WROOM_32 folder to fixing the measuring issue when connecting to wifi.
Manuals
User Manual (v1.0) 12.2019
Manual
User Manual (v2.0) 04.2020
Manual
Serial debug (optional)
If your sensor is an MQ2 (Same for others sensors):
MQ2.serialDebug(true);
MQ2.serialDebug();
Note:
Yellow -> Calibration status.
Green -> Hardware and software characteristics.
Red -> Headers of the library calculations.- Only valid for 1 gas sensor readings.
Usage
- Quick troubleshooting, since it shows everything the library does and the results of the calculations in each function.
Prerequisites
You’ll need Arduino desktop app 1.8.9 or later.
Sensor manufacturers:
Info of datasheets
Review WPDigitalizer folder website
Installing
Clone this repository into your desktop machine
git clone https://github.com/miguel5612/MQSensorsLib
Running the tests
Use calibration systems if you have several sensors that read the same gas.
Break down into end to end tests
These tests can re-adjust values defined previously and you can contribute to improve conditions or features obtained from particular scenes.
Examples/MQ-3
And coding style tests
These tests may generate statistics validation using descriptive tools for quantitative variables.
Examples/MQ-board.ino
Built With
- Data sheets - Curves and behavior for each sensor, using logarithmic graphs.
- Main purpose - Every sensor has high sensibility for a specific gas or material.
Issues
Consulte docs/issues.md para un resumen de los problemas abiertos y sus soluciones.
Contributing
Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.
Reviewers
Authors
Collaborators
See also the list of contributors who participated in this project.
License
This project is licensed under the MIT License - see the LICENSE.md file for details
Cite as
评论