mirror of
https://github.com/miguel5612/MQSensorsLib.git
synced 2025-03-15 05:17:30 +03:00
161 lines
6.4 KiB
Markdown
161 lines
6.4 KiB
Markdown
[](https://zenodo.org/badge/latestdoi/170540207)
|
|
|
|
|
|
# MQSensorsLib
|
|
|
|
This is a unified library to use sensors MQ: 2, 3, 4, 5, 6, 7, 8, 9, 131, 135, 303A and 309A.
|
|
|
|
## Getting Started
|
|
|
|
```
|
|
#define placa "Arduino UNO"
|
|
#define Voltage_Resolution 5
|
|
#define pin A0 //Analog input 0 of your arduino
|
|
#define type "MQ-4" //MQ4
|
|
#define ADC_Bit_Resolution 10 // For arduino UNO/MEGA/NANO
|
|
MQUnifiedsensor MQ4(placa, Voltage_Resolution, ADC_Bit_Resolution, pin, type); //Example if sensor is MQ4 on Arduino UNO board
|
|
MQ4.setRegressionMethod("Exponential"); //_PPM = a*ratio^b
|
|
MQ4.setA(1012.7); MQ4.setB(-2.786); // Configurate the ecuation values to get CH4 concentration
|
|
MQ4.setR0(3.86018237);
|
|
MQ4.init();
|
|
MQ4.update();
|
|
float ppmCH4 = MQ4.readSensor();
|
|
```
|
|
|
|
## Wiring
|
|
|
|
### Arduino
|
|
|
|
|
|
### ESP8266
|
|
|
|
|
|
### User Manual New!! 12.2019
|
|
[Manual](https://drive.google.com/open?id=1BAFInlvqKR7h81zETtjz4_RC2EssvFWX)
|
|
|
|
[Excel_Help_Spreadsheet (Fill only Volaje Between RL - RS - RL Values)](https://drive.google.com/open?id=1MKDcudQ7BHL_vLGi-lgPh9-pblvygRMq)
|
|
|
|
### Prerequisites
|
|
|
|
You'll need Arduino desktop app 1.8.9 or later.
|
|
|
|
### Sensor manufacture:
|
|
| Sensor | Manufacture | URL Datasheet |
|
|
|----------|----------|----------|
|
|
| MQ-2 | Pololulu| [datasheet](https://www.pololu.com/file/0J309/MQ2.pdf) |
|
|
| MQ-3 | Sparkfun | [datasheet](https://www.sparkfun.com/datasheets/Sensors/MQ-3.pdf) |
|
|
| MQ-4 | Sparkfun | [datasheet](https://www.sparkfun.com/datasheets/Sensors/Biometric/MQ-4.pdf) |
|
|
| MQ-5 | parallax | [datasheet](https://www.parallax.com/sites/default/files/downloads/605-00009-MQ-5-Datasheet.pdf) |
|
|
| MQ-6 | Sparkfun | [datasheet](https://www.sparkfun.com/datasheets/Sensors/Biometric/MQ-6.pdf) |
|
|
| MQ-7 | Sparkfun | [datasheet](https://www.sparkfun.com/datasheets/Sensors/Biometric/MQ-7.pdf) |
|
|
| MQ-8 | Sparkfun | [datasheet](https://dlnmh9ip6v2uc.cloudfront.net/datasheets/Sensors/Biometric/MQ-8.pdf) |
|
|
| MQ-9 | Haoyuelectronics | [datasheet](http://www.haoyuelectronics.com/Attachment/MQ-9/MQ9.pdf) |
|
|
| MQ-131 | Sensorsportal | [datasheet](http://www.sensorsportal.com/DOWNLOADS/MQ131.pdf) |
|
|
| MQ-135 | HANWEI Electronics | [datasheet](https://www.electronicoscaldas.com/datasheet/MQ-135_Hanwei.pdf) |
|
|
| MQ-303A | HANWEI Electronics | [datasheet](http://www.kosmodrom.com.ua/pdf/MQ303A.pdf) |
|
|
| MQ-309A | HANWEI Electronics | [datasheet](http://www.sensorica.ru/pdf/MQ-309A.pdf) |
|
|
|
|
### Info of datasheets
|
|
|
|
Review WPDigitalizer [folder](https://github.com/miguel5612/MQSensorsLib_Docs/tree/master/WPDigitalizer) [website](https://automeris.io/WebPlotDigitizer/)
|
|
|
|
### 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](https://github.com/miguel5612/MQSensorsLib_Docs/tree/master/Datasheets) - Curves and behavior for each sensor, using logarithmic graphs.
|
|
* [Main purpose](https://github.com/miguel5612/MQSensorsLib_Docs/blob/master/static/img/bg.jpg) - Every sensor has high sensibility for a specific gas or material.
|
|
|
|
## Contributing
|
|
|
|
Please read [CONTRIBUTING.md](https://github.com/miguel5612/MQSensorsLib/blob/master/CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us.
|
|
|
|
## Authors
|
|
|
|
* **Miguel A. Califa U.** - [*GitHub*](https://github.com/miguel5612) - [CV](https://scienti.colciencias.gov.co/cvlac/visualizador/generarCurriculoCv.do?cod_rh=0000050477)
|
|
* **Ghiordy F. Contreras C.** - [*GitHub*](https://github.com/Ghiordy) - [CV](https://scienti.colciencias.gov.co/cvlac/visualizador/generarCurriculoCv.do?cod_rh=0000050476)
|
|
* **Yersson R. Carrillo A.** - [*GitHub*](https://github.com/Yercar18/Dronefenix) - [CV](https://scienti.colciencias.gov.co/cvlac/visualizador/generarCurriculoCv.do?cod_rh=0001637655)
|
|
|
|
## Collaborators
|
|
|
|
* **Andres A. Martinez.**
|
|
* **Juan A. Rodríguez.** - [*Github*](https://github.com/Obiot24)
|
|
* **Mario A. Rodríguez O.** - [*GitHub*](https://github.com/MarioAndresR) - [CV](https://scienti.colciencias.gov.co/cvlac/visualizador/generarCurriculoCv.do?cod_rh=0000111304)
|
|
|
|
See also the list of [contributors](https://github.com/miguel5612/MQSensorsLib/contributors) who participated in this project.
|
|
|
|
## License
|
|
|
|
This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details
|
|
|
|
## Cite as
|
|
|
|
* Plain text: Califa Urquiza, Miguel Angel, Contreras Contreras, Ghiordy, & Carrillo Amado, Yerson Ramiro. (2019, September 3). miguel5612/MQSensorsLib: Arduino Preview V1.03 (Version 1.0.3). Zenodo. http://doi.org/10.5281/zenodo.3384301
|
|
* CSL: {
|
|
"publisher": "Zenodo",
|
|
"DOI": "10.5281/zenodo.3384301",
|
|
"title": "miguel5612/MQSensorsLib: Arduino Preview V1.03",
|
|
"issued": {
|
|
"date-parts": [
|
|
[
|
|
2019,
|
|
9,
|
|
3
|
|
]
|
|
]
|
|
},
|
|
"abstract": "<p>Publishing on Zenodo platform as software in order to extend its applications for other works allowing to recognize MQSensorLib's Authors this work into scientific community using Digital Object Identifier System (DOI).</p>",
|
|
"author": [
|
|
{
|
|
"family": "Califa Urquiza, Miguel Angel"
|
|
},
|
|
{
|
|
"family": "Contreras Contreras, Ghiordy"
|
|
},
|
|
{
|
|
"family": "Carrillo Amado, Yerson Ramiro"
|
|
}
|
|
],
|
|
"version": "1.0.3",
|
|
"type": "article",
|
|
"id": "3384301"
|
|
}
|
|
* BibTeX:
|
|
@misc{califa_urquiza_miguel_angel_2019_3384301,
|
|
author = {Califa Urquiza, Miguel Angel and
|
|
Contreras Contreras, Ghiordy and
|
|
Carrillo Amado, Yerson Ramiro},
|
|
title = {miguel5612/MQSensorsLib: Arduino Preview V1.03},
|
|
month = sep,
|
|
year = 2019,
|
|
doi = {10.5281/zenodo.3384301},
|
|
url = {https://doi.org/10.5281/zenodo.3384301}
|
|
}
|