added support for air sensor api

Added support for BME68x's air quality measure functionalities

Author: Rocketct

src/AirQaulityClass.cpp

@@ -0,0 +1,145 @@
+/*
+  This file is part of the Arduino_LSM6DSOX library.
+  Copyright (c) 2021 Arduino SA. All rights reserved.
+
+  This library is free software; you can redistribute it and/or
+  modify it under the terms of the GNU Lesser General Public
+  License as published by the Free Software Foundation; either
+  version 2.1 of the License, or (at your option) any later version.
+
+  This library is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+  Lesser General Public License for more details.
+
+  You should have received a copy of the GNU Lesser General Public
+  License along with this library; if not, write to the Free Software
+  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+*/
+
+#include "AirQaulityClass.h"
+
+// sets function called on slave write
+AirQaulityClass::AirQaulityClass( getRev_t getRevision)
+{
+  //If board_revision = 1, IMU module is LSM6DSOX, otherwise is LSM6DS3
+  board_revision = getRevision;
+}
+
+AirQaulityClass::~AirQaulityClass()
+{
+}
+
+int AirQaulityClass::begin()
+{
+  _revision = board_revision();
+  if (_revision == BOARD_REVISION_2) {
+    if (iaqSensor == nullptr) {
+      iaqSensor = new Bsec();
+    }
+    iaqSensor->begin(BME680_I2C_ADDR_PRIMARY, Wire);
+	  if (checkIaqSensorStatus() == STATUS_ERROR){
+      return 0;
+    }
+
+    bsec_virtual_sensor_t sensorList[10] = {
+      BSEC_OUTPUT_RAW_TEMPERATURE,
+      BSEC_OUTPUT_RAW_PRESSURE,
+      BSEC_OUTPUT_RAW_HUMIDITY,
+      BSEC_OUTPUT_RAW_GAS,
+      BSEC_OUTPUT_IAQ,
+      BSEC_OUTPUT_STATIC_IAQ,
+      BSEC_OUTPUT_CO2_EQUIVALENT,
+      BSEC_OUTPUT_BREATH_VOC_EQUIVALENT,
+      BSEC_OUTPUT_SENSOR_HEAT_COMPENSATED_TEMPERATURE,
+      BSEC_OUTPUT_SENSOR_HEAT_COMPENSATED_HUMIDITY,
+    };
+
+    iaqSensor->updateSubscription(sensorList, 10, BSEC_SAMPLE_RATE_CONTINUOUS);
+	  if (checkIaqSensorStatus() == STATUS_ERROR){
+      return 0;
+    }
+    return 1;
+  }
+  return 0;
+}
+
+int AirQaulityClass::checkIaqSensorStatus(void)
+{
+  if (iaqSensor->status != BSEC_OK) {
+    if (iaqSensor->status < BSEC_OK) {
+     return STATUS_ERROR;
+    }
+  }
+
+  if (iaqSensor->bme680Status != BME680_OK) {
+    if (iaqSensor->bme680Status < BME680_OK) {
+     return STATUS_ERROR;
+    }
+  }
+  return STATUS_OK;
+}
+
+void AirQaulityClass::end()
+{
+  if (_revision == BOARD_REVISION_2) {
+    delete iaqSensor;
+    iaqSensor = nullptr;
+  }
+}
+
+float AirQaulityClass::readVOC()
+{
+  if (_revision == BOARD_REVISION_2) {
+    while(!iaqSensor->run()){ }
+    float reading = iaqSensor->breathVocEquivalent;
+    return reading;
+  }
+}
+
+float AirQaulityClass::readGasResistor()
+{
+  if (_revision == BOARD_REVISION_2) {
+    while(!iaqSensor->run()){ }
+    float reading = iaqSensor->gasResistance;
+    return reading;
+  }
+}
+
+float AirQaulityClass::readIAQ()
+{
+  if (_revision == BOARD_REVISION_2) {
+    while(!iaqSensor->run()){ }
+    float reading = iaqSensor->iaq;
+    return reading;
+  }
+}
+
+float AirQaulityClass::readIAQAccuracy()
+{
+  if (_revision == BOARD_REVISION_2) {
+    while(!iaqSensor->run()){ }
+    float reading = iaqSensor->iaqAccuracy;
+    return reading;
+  }
+}
+
+float AirQaulityClass::readStaticIAQ()
+{
+  if (_revision == BOARD_REVISION_2) {
+    while(!iaqSensor->run()){ }
+    float reading = iaqSensor->staticIaq;
+    return reading;
+  }
+}
+
+
+float AirQaulityClass::readCO2()
+{
+  if (_revision == BOARD_REVISION_2) {
+    while(!iaqSensor->run()){ }
+    float reading = iaqSensor->co2Equivalent;
+    return reading;
+  }
+}
+

src/AirQaulityClass.h

@@ -0,0 +1,36 @@
+#ifndef _AIRQUALITYCLASS_H_INCLUDED
+#define _AIRQUALITYCLASS_H_INCLUDED
+
+#include <Arduino.h>
+#include <MKRIoTCarrierDefines.h>
+
+class AirQaulityClass {
+  public:
+    AirQaulityClass(int (*)(void));
+    ~AirQaulityClass();
+
+    int begin();
+    void end();
+
+    float readCO2();
+    float readStaticIAQ();
+    float readIAQAccuracy();
+    float readIAQ();
+    float readGasResistor();
+    float readVOC();
+
+  private:
+  // Helper functions declarations
+    int checkIaqSensorStatus(void);
+
+    Bsec *iaqSensor;
+    //LSM6DS3Class& LSM6DS3 = IMU;
+    //LSM6DSOXClass& LSM6DSOX = IMU;
+
+  private:
+
+    int (*board_revision)(void);
+    int _revision;
+};
+
+#endif  //_AIRQUALITYCLASS_H_INCLUDED

src/Arduino_MKRIoTCarrier.cpp

@@ -73,7 +73,7 @@ int MKRIoTCarrier::begin() {
   Relay2.begin();
 
   //Sensors
-  uint8_t  sensorsOK = !Light.begin() << 0 |  !Pressure.begin() << 1 | !IMUmodule.begin() << 2  | !Env.begin() << 3;
+  uint8_t  sensorsOK = !Light.begin() << 0 |  !Pressure.begin() << 1 | !IMUmodule.begin() << 2  | !Env.begin() << 3 | !AirQuality.begin() << 4;
 
 
   //If some of the sensors are not connected

src/Arduino_MKRIoTCarrier.h

@@ -27,6 +27,7 @@
 #include <IMUClass.h>    //IMU
 #include <PressureClass.h>    //IMU
 #include <EnvClass.h>    //IMU
+#include "AirQaulityClass.h"
 
 //RGB LEDs
 #include <Adafruit_DotStar.h>
@@ -82,6 +83,7 @@ class MKRIoTCarrier{
     PressureClass Pressure{MKRIoTCarrier::getBoardRevision};
     IMUClass IMUmodule{MKRIoTCarrier::getBoardRevision};
     EnvClass Env{MKRIoTCarrier::getBoardRevision};
+    AirQaulityClass AirQuality{MKRIoTCarrier::getBoardRevision};
 
     //Misc
     //Relays