Arduino library for Grove Multichannel Gas Sensor based on the SGX Sensortech MiCS 6814 (multichannel gas sensor)
This is a comprehensive Arduino library to obtain gas concentration in the air with the Grove Multichannel Gas Sensor developed by Seeed Studio. The Grove Multichannel Gas Sensor is an environment detecting sensor with an I2C interface and a built-in MiCS-6814 which can detect many unhealthy gases. Three gases can be measured simultaneously due to its three channels, so it can help you to monitor the concentration of more than one gas.
The detectable gases are listed below (ppm = parts per million):
- Carbon monoxide (CO) from 1 to 1000 ppm
- Nitrogen dioxide (NO2) from 0.05 to 10 ppm
- Ethanol (C2H5OH) from 10 to 500 ppm
- Hydrogen (H2) from 1 to 1000 ppm
- Ammonia (NH3) from 1 to 500 ppm
- Methane (CH4) from >1000 ppm
- Propane (C3H8) from >1000 ppm
- Iso-butane (C4H10) from >1000 ppm
The library supports the version 2 of the Grove Multichannel Gas Sensor, the warmup, the calibration, the change of the I2C address, the control of the heater (for low power consumption) and the output of values in ppm (parts per million).
- The library supports only the version 2 of the firmware of the Grove Multichannel Gas Sensor.
- The Grove Multichannel Gas Sensor works with 3.3V or 5V.
- The gas sensor MiCS6814 requires minimum 30 minutes preheat time before giving consistent results (also called "burn-in" time or warmup)
- This library is largely inspired from the original library Seed-Studio / Multichannel_Gas_Sensor from Jacky Zhang but the official library didn't work properly with the Arduino Nano 33 IoT.
- Click on Clone or download on GitHub
- Choose Download ZIP
- Open Arduino IDE
- In the menu Sketch -> Include Library -> Add .ZIP Library
- Select the downloaded file or folder (if automatically uncompress)
- Restart Arduino IDE
- Enjoy!
- GND (black) - Connect to ground
- VCC (red) - Connect to power supply (3.3V or 5V)
- SDA (white) - Connect to SDA (I2C data)
- SCL (yellow) - Connect to SCL (I2C clock)
In the folder examples, you will find various examples to test:
- ReadGasConcentration.ino : Sample the gas concentration and show the concentration of all gases supported in ppm.
- Calibrate.ino : Start the warmup and the calibration process.
- DisplayConfig.ino : Display the configuration.
- ChangeSlaveAddress.ino : Change the I2C address.
The driver has to be initialized with 1 optional parameter:
- The I2C address, if not set we are using the address 0x04 by default.
MiCS6814.begin();
or the I2C address 0x19:
MiCS6814.begin(0x19);
If it's the first time that you're using your sensor, it requires to be warmup (heating during a long period of 30 minutes) to cleanup the resistances after the factory process. During the warmup, the integrated LED will blink.
MiCS6814.warmup();
Before using the driver, it's better to calibrate the sensor. You can do that through the function calibrate(). The best is to calibrate the sensor in clean fresh air every month (according to the FAQ of SGX Sensortech). The calibration saves the R0 values directly on the EEPROM of the Grove subsystem.
MiCS6814.calibrate();
The reading of the values is done through get(). The method get() returns the values sampled by the method sample(). It means that the reading of the values is always a two steps process: sampling + getting the values you need for your project. It is not required to resample between the get(). The get() method takes the type of gas as parameter: CO, NO2, NH3, C3H8, C4H10, CH4, H2 or C2H5OH.
MiCS6814.sample();
MiCS6814.get(CO);
MiCS6814.get(NH3);
MiCS6814.get(H2);