Skip to content

Commit

Permalink
Committing dev changes
Browse files Browse the repository at this point in the history
  • Loading branch information
Main Push Robot committed Apr 20, 2023
1 parent b620d36 commit d699a8f
Show file tree
Hide file tree
Showing 2 changed files with 35 additions and 62 deletions.
95 changes: 34 additions & 61 deletions README.md
View file
Original file line number Diff line number Diff line change
@@ -1,11 +1,12 @@
# MQX Gas Sensor Arduino library

[![Make docs and publish to GitHub Pages](https://github.com/SolderedElectronics/Soldered-MQ-Gas-Sensor-Arduino-Library/actions/workflows/make_docs.yml/badge.svg?branch=dev)](https://github.com/SolderedElectronics/Soldered-MQ-Gas-Sensor-Arduino-Library/actions/workflows/make_docs.yml)
[![Arduino Library Manager Compatibility](https://github.com/SolderedElectronics/Soldered-MQ-Gas-Sensor-Arduino-Library/actions/workflows/arduino_lint.yml/badge.svg?branch=dev)](https://github.com/SolderedElectronics/Soldered-MQ-Gas-Sensor-Arduino-Library/actions/workflows/arduino_lint.yml)


| ![Butane, LPG & Smoke sensor MQ2 breakout](https://upload.wikimedia.org/wikipedia/commons/8/8f/Example_image.svg) |
| :---------------------------------------------------------------------------------------------------------------: |

| [Butane, LPG & Smoke sensor MQ2 breakout](https://www.solde.red/333102)
| [Butane, LPG & Smoke sensor MQ2 breakout](https://www.solde.red/333102) |

Gas sensor registers the presence of various gases, such as oil and gasoline vapors, butane, propane, methane, ethanol(alcohol), hydrogen, smoke. It registers gases the best while they are in the liquid form, but since we cannot find them in that state that often, it measures a good concentration of substances in a gaseous state. It takes a short time to heat up in order to work correctly.

Expand All @@ -18,8 +19,7 @@ The breakout board works with both digital (DO) and analog signals (AO). The dig

| ![Alcohol, Ethanol sensor MQ3 breakout](https://github.com/SolderedElectronics/Alcohol--Ethanol-sensor-MQ3-breakout-hardware-design/blob/main/OUTPUTS/V1.1.1/333103.jpg) |
| :----------------------------------------------------------------------------------------------------------------------------------------------------------------------: |

| [Alcohol, Ethanol sensor MQ3 breakout](https://www.solde.red/333103)
| [Alcohol, Ethanol sensor MQ3 breakout](https://www.solde.red/333103) |

An alcohol sensor is capable of detecting alcohol (ethanol) particles on itself and gives the information in digital form back to us to manipulate it.

Expand All @@ -32,8 +32,7 @@ The breakout board works with both digital (DO) and analog signals (AO). The dig

| ![Methane, CNG sensor MQ4 breakout](https://github.com/SolderedElectronics/Methane.-CNG-sensor-MQ4-breakout-hardware-design/blob/main/OUTPUTS/V1.1.1/333104.jpg) |
| :--------------------------------------------------------------------------------------------------------------------------------------------------------------: |

| [Methane, CNG sensor MQ4 breakout](https://www.solde.red/333104)
| [Methane, CNG sensor MQ4 breakout](https://www.solde.red/333104) |

Have you ever wondered how much natural gas and methane are in your living room? You can easily measure that! The MQ4 breakout board is a simple-to-use sensor that detects the natural gas and methane (CH4) in the air. Once heated to working temperature, it detects changes in air concentrations very quickly between 200 and 10000 ppm.

Expand All @@ -50,8 +49,7 @@ On the through-holes, the DO stands for digital out and AO for analog out. The d

| ![Natural gas, LPG sensor MQ5 breakout](https://github.com/SolderedElectronics/Natural-gas--LPG-sensor-MQ5-breakout-hardware-design/blob/main/OUTPUTS/V1.1.1/333105.jpg) |
| :----------------------------------------------------------------------------------------------------------------------------------------------------------------------: |

| [Natural gas, LPG sensor MQ5 breakout](https://www.solde.red/333105)
| [Natural gas, LPG sensor MQ5 breakout](https://www.solde.red/333105) |

Is your office near a high-traffic area? Are you concerned about the amount of natural and liquefied petroleum gases in your work environment? The MQ5 is a simple-to-use sensor to put your mind at ease. It detects gas particles very quickly between 200 and 10000 ppm.

Expand All @@ -68,8 +66,7 @@ The breakout board works with both digital (DO) and analog signals (AO). The dig

| ![LPG, Butane sensor MQ6 breakout ](https://github.com/SolderedElectronics/LPG--Butane-sensor-MQ6-breakout-hardware-design/blob/main/OUTPUTS/V1.1.1/333106.jpg) |
| :-------------------------------------------------------------------------------------------------------------------------------------------------------------: |

| [LPG, Butane sensor MQ6 breakout ](https://www.solde.red/333106)
| [LPG, Butane sensor MQ6 breakout ](https://www.solde.red/333106) |

Humans can detect many scents, but can have difficulties when it comes to differentiating gases. That’s why we use sensors like MQ6. It detects LPG and butane in the air. When heated to the optimum working temperature, it detects changes in air concentrations very quickly between 200 and 10000 ppm.

Expand All @@ -86,8 +83,7 @@ The DO pin stands for digital out. AO stands for analog out. The digital output

| ![CO sensor MQ7 breakout](https://github.com/SolderedElectronics/CO-sensor-MQ7-breakout-hardware-design/blob/main/OUTPUTS/V1.1.1/333107.jpg) |
| :------------------------------------------------------------------------------------------------------------------------------------------: |

| [CO sensor MQ7 breakout](https://www.solde.red/333107)
| [CO sensor MQ7 breakout](https://www.solde.red/333107) |

Gas sensor MQ7 detects the presence of Carbon Monoxide (CO) in the air. The best results are given when alcohol is in liquid form, however, it still does an amazing job when measuring in gas form. It needs a bit of time to warm up in order to work correctly.

Expand All @@ -101,8 +97,7 @@ The breakout board works with both digital (DO) and analog signals (AO). The dig

| ![Hydrogen sensor MQ8 breakout](https://github.com/SolderedElectronics/Hydrogen-sensor-MQ8-breakout-hardware-design/blob/main/OUTPUTS/V1.1.1/333108.jpg) |
| :------------------------------------------------------------------------------------------------------------------------------------------------------: |

| [Hydrogen sensor MQ8 breakout](https://www.solde.red/333108)
| [Hydrogen sensor MQ8 breakout](https://www.solde.red/333108) |

Hydrogen is all around us, and it’s very flammable. Its leakage can be very dangerous to both life and property. That’s why it's important to detect any leakage to prevent in the industry. To help with that, hydrogen sensors like the MQ8 breakout board are used. The sensor detects hydrogen at the range of 100-1000 ppm.

Expand All @@ -119,8 +114,7 @@ The digital and analog outs are on the breakout through-hole pins. They are mark

| ![CO, flammable gasses sensor MQ9 breakout](https://github.com/SolderedElectronics/CO--flammable-gasses-sensor-MQ9-breakout-hardware-design/blob/main/OUTPUTS/V1.1.1/333109.jpg) |
| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |

| [CO, flammable gasses sensor MQ9 breakout](https://www.solde.red/333109)
| [CO, flammable gasses sensor MQ9 breakout](https://www.solde.red/333109) |

We are surrounded by invisible gases everywhere. While we generally don’t have to worry about them, under the right circumstances, they can be very combustible and dangerous. The MQ9 breakout board detects carbon monoxide, methane, propane, and other flammable gases so the right measures can be taken in time. The sensor detects carbon monoxide at 10-1000 ppm and other combustible gasses at 100-10000 ppm.

Expand All @@ -137,8 +131,7 @@ The digital and analog outs can be found on the through-holes. They are marked a

| ![Ozone sensor MQ131 breakout](https://github.com/SolderedElectronics/Ozone-sensor-MQ131-breakout-hardware-design/blob/main/OUTPUTS/V1.1.1/333110.jpg) |
| :----------------------------------------------------------------------------------------------------------------------------------------------------: |

| [Ozone sensor MQ131 breakout](https://www.solde.red/333110)
| [Ozone sensor MQ131 breakout](https://www.solde.red/333110) |

This breakout for the MQ131 sensor responds to the presence of ozone in the air. As the ozone concentration increases, the resistance changes and the ozone concentration can be measured by measuring the analogue output voltage. The sensor is of good precision and is normally used in ozone concentration detectors. There is a 3362 potentiometer on the board with which the digital signal threshold can be set. There is a digital and analogue output via the male pins.

Expand All @@ -151,22 +144,19 @@ This breakout for the MQ131 sensor responds to the presence of ozone in the air.

| ![Air quality sensor MQ135 breakout](https://github.com/SolderedElectronics/Air-quality-sensor-MQ135-breakout-hardware-design/blob/main/OUTPUTS/V1.1.1/333111.jpg) |
| :----------------------------------------------------------------------------------------------------------------------------------------------------------------: |

| [Air quality sensor MQ135 breakout](https://www.solde.red/333111)
| [Air quality sensor MQ135 breakout](https://www.solde.red/333111) |

OPIS

| ![Hydrogen Sulfide sensor MQ136 breakout](https://upload.wikimedia.org/wikipedia/commons/8/8f/Example_image.svg) |
| :--------------------------------------------------------------------------------------------------------------: |

| [Hydrogen Sulfide sensor MQ136 breakout](https://www.solde.red/333112)
| [Hydrogen Sulfide sensor MQ136 breakout](https://www.solde.red/333112) |

OPIS

| ![Ammonia sensor MQ137 breakout](https://github.com/SolderedElectronics/Ammonia-sensor-MQ137-breakout-hardware-design/blob/main/OUTPUTS/V1.1.1/333113.jpg) |
| :--------------------------------------------------------------------------------------------------------------------------------------------------------: |

| [Ammonia sensor MQ137 breakout](https://www.solde.red/333113)
| [Ammonia sensor MQ137 breakout](https://www.solde.red/333113) |

Gas sensor registers the presence of ammonia gas (NH3). It registers gases the best while they are in the liquid form, but since we cannot find them in that state that often, it measures a good concentration of substances in a gaseous state. It takes a short time to heat up in order to work correctly.

Expand All @@ -179,8 +169,7 @@ The breakout board works with both digital (DO) and analog signals (AO). The dig

| ![VOC sensor MQ138 breakout](https://upload.wikimedia.org/wikipedia/commons/8/8f/Example_image.svg) |
| :-------------------------------------------------------------------------------------------------: |

| [VOC sensor MQ138 breakout](https://www.solde.red/333114)
| [VOC sensor MQ138 breakout](https://www.solde.red/333114) |

Gas sensor registers the presence of VOC gasses: toulen, alcohol, acetone and hydrogen. It registers gases the best while they are in the liquid form, but since we cannot find them in that state that often, it measures a good concentration of substances in a gaseous state. It takes a short time to heat up in order to work correctly.

Expand All @@ -193,106 +182,91 @@ The breakout board works with both digital (DO) and analog signals (AO). The dig

| ![Methane, Natural gas sensor MQ214 breakout](https://upload.wikimedia.org/wikipedia/commons/8/8f/Example_image.svg) |
| :------------------------------------------------------------------------------------------------------------------: |

| [Methane, Natural gas sensor MQ214 breakout](https://www.solde.red/333115)
| [Methane, Natural gas sensor MQ214 breakout](https://www.solde.red/333115) |

OPIS

| ![Butane, LPG & Smoke sensor MQ2 breakout with easyC](https://upload.wikimedia.org/wikipedia/commons/8/8f/Example_image.svg) |
| :--------------------------------------------------------------------------------------------------------------------------: |

| [Butane, LPG & Smoke sensor MQ2 breakout with easyC](https://www.solde.red/333116)
| [Butane, LPG & Smoke sensor MQ2 breakout with easyC](https://www.solde.red/333116) |

OPIS

| ![Alcohol, Ethanol sensor MQ3 breakout with easyC](https://upload.wikimedia.org/wikipedia/commons/8/8f/Example_image.svg) |
| :-----------------------------------------------------------------------------------------------------------------------: |

| [Alcohol, Ethanol sensor MQ3 breakout with easyC](https://www.solde.red/333117)
| [Alcohol, Ethanol sensor MQ3 breakout with easyC](https://www.solde.red/333117) |

OPIS

| ![Methane, CNG sensor MQ4 breakout with easyC](https://upload.wikimedia.org/wikipedia/commons/8/8f/Example_image.svg) |
| :-------------------------------------------------------------------------------------------------------------------: |

| [Methane, CNG sensor MQ4 breakout with easyC](https://www.solde.red/333118)
| [Methane, CNG sensor MQ4 breakout with easyC](https://www.solde.red/333118) |

OPIS

| ![Natural gas, LPG sensor MQ5 breakout with easyC](https://upload.wikimedia.org/wikipedia/commons/8/8f/Example_image.svg) |
| :-----------------------------------------------------------------------------------------------------------------------: |

| [Natural gas, LPG sensor MQ5 breakout with easyC](https://www.solde.red/333119)
| [Natural gas, LPG sensor MQ5 breakout with easyC](https://www.solde.red/333119) |

OPIS

| ![LPG, Butane sensor MQ6 breakout with easyC](https://upload.wikimedia.org/wikipedia/commons/8/8f/Example_image.svg) |
| :------------------------------------------------------------------------------------------------------------------: |

| [LPG, Butane sensor MQ6 breakout with easyC](https://www.solde.red/333120)
| [LPG, Butane sensor MQ6 breakout with easyC](https://www.solde.red/333120) |

OPIS

| ![CO sensor MQ7 breakout with easyC](https://upload.wikimedia.org/wikipedia/commons/8/8f/Example_image.svg) |
| :---------------------------------------------------------------------------------------------------------: |

| [CO sensor MQ7 breakout with easyC](https://www.solde.red/333121)
| :---------------------------------------------------------------------------------------------------------: |
| [CO sensor MQ7 breakout with easyC](https://www.solde.red/333121) |

OPIS

| ![Hydrogen sensor MQ8 breakout with easyC](https://upload.wikimedia.org/wikipedia/commons/8/8f/Example_image.svg) |
| :---------------------------------------------------------------------------------------------------------------: |

| [Hydrogen sensor MQ8 breakout with easyC](https://www.solde.red/333122)
| [Hydrogen sensor MQ8 breakout with easyC](https://www.solde.red/333122) |

OPIS

| ![CO, flammable gasses sensor MQ9 breakout with easyC](https://upload.wikimedia.org/wikipedia/commons/8/8f/Example_image.svg) |
| :---------------------------------------------------------------------------------------------------------------------------: |

| [CO, flammable gasses sensor MQ9 breakout with easyC](https://www.solde.red/333123)
| [CO, flammable gasses sensor MQ9 breakout with easyC](https://www.solde.red/333123) |

OPIS

| ![Ozone sensor MQ131 breakout with easyC](https://upload.wikimedia.org/wikipedia/commons/8/8f/Example_image.svg) |
| :--------------------------------------------------------------------------------------------------------------: |

| [Ozone sensor MQ131 breakout with easyC](https://www.solde.red/333124)
| [Ozone sensor MQ131 breakout with easyC](https://www.solde.red/333124) |

OPIS

| ![Air quality sensor MQ135 breakout with easyC](https://upload.wikimedia.org/wikipedia/commons/8/8f/Example_image.svg) |
| :--------------------------------------------------------------------------------------------------------------------: |

| [Air quality sensor MQ135 breakout with easyC](https://www.solde.red/333125)
| [Air quality sensor MQ135 breakout with easyC](https://www.solde.red/333125) |

OPIS

| ![Hydrogen Sulfide sensor MQ136 breakout with easyC](https://upload.wikimedia.org/wikipedia/commons/8/8f/Example_image.svg) |
| :-------------------------------------------------------------------------------------------------------------------------: |

| [Hydrogen Sulfide sensor MQ136 breakout with easyC](https://www.solde.red/333126)
| [Hydrogen Sulfide sensor MQ136 breakout with easyC](https://www.solde.red/333126) |

OPIS

| ![Ammonia sensor MQ137 breakout with easyC](https://upload.wikimedia.org/wikipedia/commons/8/8f/Example_image.svg) |
| :----------------------------------------------------------------------------------------------------------------: |

| [Ammonia sensor MQ137 breakout with easyC](https://www.solde.red/333127)
| [Ammonia sensor MQ137 breakout with easyC](https://www.solde.red/333127) |

OPIS

| ![Benzene, Toluene, Acetone, Formaldehyde sensor MQ138 breakout with easyC](https://upload.wikimedia.org/wikipedia/commons/8/8f/Example_image.svg) |
| :------------------------------------------------------------------------------------------------------------------------------------------------: |

| [Benzene, Toluene, Acetone, Formaldehyde sensor MQ138 breakout with easyC](https://www.solde.red/333128)
| [Benzene, Toluene, Acetone, Formaldehyde sensor MQ138 breakout with easyC](https://www.solde.red/333128) |

OPIS

| ![Methane, Natural gas sensor MQ214 breakout with easyC](https://upload.wikimedia.org/wikipedia/commons/8/8f/Example_image.svg) |
| :-----------------------------------------------------------------------------------------------------------------------------: |

| [Methane, Natural gas sensor MQ214 breakout with easyC](https://www.solde.red/333129)
| [Methane, Natural gas sensor MQ214 breakout with easyC](https://www.solde.red/333129) |

OPIS

Expand Down Expand Up @@ -364,7 +338,7 @@ You can find hardware design for this board in [_Methane, Natural gas sensor MQ2

Access Arduino library documentation [here](https://SolderedElectronics.github.io/Soldered-MQ-Gas-Sensor-Arduino-Library/).

- Tutorial for using the NAZIV PROIZVODA board
- Tutorial for using the MX-X board
- Installing an Arduino library

### Board compatibility
Expand All @@ -375,7 +349,7 @@ The library is compatible with board & microcontroller families shown in green b

### About Soldered

<img src="https://raw.githubusercontent.com/e-radionicacom/Soldered-MQ-Gas-Sensor-Arduino-Library/dev/extras/Soldered-logo-color.png" alt="soldered-logo" width="500"/>
<img src="https://raw.githubusercontent.com/e-radionicacom/Soldered-Generic-Arduino-Library/dev/extras/Soldered-logo-color.png" alt="soldered-logo" width="500"/>

At Soldered, we design and manufacture a wide selection of electronic products to help you turn your ideas into acts and bring you one step closer to your final project. Our products are intented for makers and crafted in-house by our experienced team in Osijek, Croatia. We believe that sharing is a crucial element for improvement and innovation, and we work hard to stay connected with all our makers regardless of their skill or experience level. Therefore, all our products are open-source. Finally, we always have your back. If you face any problem concerning either your shopping experience or your electronics project, our team will help you deal with it, offering efficient customer service and cost-free technical support anytime. Some of those might be useful for you:

Expand All @@ -384,9 +358,8 @@ At Soldered, we design and manufacture a wide selection of electronic products t
- [Community & Technical support](https://soldered.com/community)

### Original source

​
This library is possible thanks to original [arduino-mcp23017](https://github.com/blemasle/arduino-mcp23017) library. Thank you, blemasle.
This library is possible thanks to original [MQSensorsLib](https://github.com/miguel5612/MQSensorsLib) library. Thank you, miguel5612.

### Open-source license

Expand Down
2 changes: 1 addition & 1 deletion library.properties
View file
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ author=Soldered
maintainer=Soldered <soldered@soldered.com>
sentence=MQ-X Gas Sensor Library by Soldered
paragraph=MQ-X sensors are great for detecting gas. This library is a simple example how to use the MQ-X sensors.
category=Sensor
category=Sensors
url=https://sold.red/333041
repository=https://github.com/SolderedElectronics/Soldered-MQ-Gas-Sensor-Arduino-Library
architectures=*
Expand Down

0 comments on commit d699a8f

Please sign in to comment.