2019-09-02 20:00:44 -05:00
[](https://zenodo.org/badge/latestdoi/170540207)
2019-09-02 19:40:29 -05:00

2019-09-02 19:40:02 -05:00
2019-02-13 11:26:33 -05:00
# MQSensorsLib
2019-04-17 10:51:56 -05:00
2019-08-15 10:03:05 -05:00
This is a unified library to use sensors MQ: 2, 3, 4, 5, 6, 7, 8, 9, 131, 135, 303A and 309A.
2019-04-17 10:51:56 -05:00
## Getting Started
```
2019-08-15 09:18:13 -05:00
MQUnifiedsensor MQ4(pin, 4); //Example if sensor is MQ4, type = 4
float ppmCH4 = MQ4.readSensor();
2019-04-17 10:51:56 -05:00
```
2019-12-09 07:22:12 -05:00
### User Manual New!! 12.2019
2019-12-09 07:21:52 -05:00
[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 )
2019-04-17 10:51:56 -05:00
### Prerequisites
2019-08-27 16:25:56 -05:00
You'll need Arduino desktop app 1.8.9 or later.
2019-04-17 10:51:56 -05:00
2019-08-27 16:25:56 -05:00
### Sensor manufacture:
| Sensor | Manufacture | URL Datasheet |
2019-05-18 14:02:32 -05:00
|----------|----------|----------|
| MQ-2 | Pololulu| [datasheet ](https://www.pololu.com/file/0J309/MQ2.pdf ) |
2019-05-18 13:59:18 -05:00
| 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 ) |
2019-05-18 14:03:00 -05:00
| MQ-9 | Haoyuelectronics | [datasheet ](http://www.haoyuelectronics.com/Attachment/MQ-9/MQ9.pdf ) |
| MQ-131 | Sensorsportal | [datasheet ](http://www.sensorsportal.com/DOWNLOADS/MQ131.pdf ) |
2019-05-18 13:59:18 -05:00
| 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 ) |
2019-08-15 09:15:21 -05:00
### Info of datasheets
2019-08-15 11:35:41 -05:00
Review WPDigitalizer [folder ](https://github.com/miguel5612/MQSensorsLib/tree/master/WPDigitalizer ) [website ](https://automeris.io/WebPlotDigitizer/ )
2019-05-19 09:49:06 -05:00
2019-04-17 10:51:56 -05:00
### Installing
2019-08-27 16:25:56 -05:00
Clone this repository into your desktop machine
2019-04-17 10:51:56 -05:00
```
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
2019-08-27 16:25:56 -05:00
These tests can re-adjust values defined previously and you can contribute to improve conditions or features obtained from particular scenes.
2019-04-17 10:51:56 -05:00
```
2019-08-15 12:03:34 -05:00
Examples/MQ-3
2019-04-17 10:51:56 -05:00
```
### And coding style tests
2019-08-27 16:25:56 -05:00
These tests may generate statistics validation using descriptive tools for quantitative variables.
2019-04-17 10:51:56 -05:00
```
2019-08-15 12:03:34 -05:00
Examples/MQ-board.ino
2019-04-17 10:51:56 -05:00
```
## Built With
* [Data sheets ](https://github.com/miguel5612/MQSensorsLib/tree/master/Datasheets ) - Curves and behavior for each sensor, using logarithmic graphs.
* [Main purpose ](https://github.com/miguel5612/MQSensorsLib/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/NO_Functional/CONTRIBUTING.md ) for details on our code of conduct, and the process for submitting pull requests to us.
## Authors
2019-05-10 09:32:04 -05:00
* **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 )
2019-05-25 19:32:33 -05:00
* **Yersson R. Carrillo A.** - [*GitHub* ](https://github.com/Yercar18/Dronefenix ) - [CV ](https://scienti.colciencias.gov.co/cvlac/visualizador/generarCurriculoCv.do?cod_rh=0001637655 )
2019-05-20 10:42:40 -05:00
2019-08-27 16:25:56 -05:00
## Collaborators
2019-08-15 09:15:21 -05:00
* **Andres A. Martinez.**
2019-08-15 10:47:35 -05:00
* **Juan A. Rodríguez.** - [*Github* ](https://github.com/Obiot24 )
2019-08-15 10:04:14 -05:00
* **Mario A. Rodríguez O.** - [*GitHub* ](https://github.com/MarioAndresR ) - [CV ](https://scienti.colciencias.gov.co/cvlac/visualizador/generarCurriculoCv.do?cod_rh=0000111304 )
2019-05-20 10:42:40 -05:00
2019-04-18 00:50:45 -05:00
See also the list of [contributors ](https://github.com/miguel5612/MQSensorsLib/contributors ) who participated in this project.
2019-04-17 10:51:56 -05:00
## License
This project is licensed under the MIT License - see the [LICENSE.md ](LICENSE.md ) file for details
2019-09-02 19:40:02 -05:00
## Cite as
2019-09-02 20:00:44 -05:00
* 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& #39 ; 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"
}
2019-09-02 19:40:02 -05:00
* BibTeX:
2019-09-02 20:00:44 -05:00
@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},
2019-09-02 19:40:02 -05:00
month = sep,
year = 2019,
2019-09-02 20:00:44 -05:00
doi = {10.5281/zenodo.3384301},
url = {https://doi.org/10.5281/zenodo.3384301}
2019-09-02 19:40:02 -05:00
}