Add HDC302x

Author: tyeth

platformio.ini

@@ -34,6 +34,7 @@ lib_deps =
     adafruit/Adafruit HTS221
     adafruit/Adafruit HTU21DF Library
     adafruit/Adafruit HTU31D Library
+    adafruit/Adafruit HDC302x
     adafruit/Adafruit LTR390 Library
     adafruit/Adafruit LTR329 and LTR303
     adafruit/Adafruit PCT2075

src/components/i2c/controller.cpp

@@ -128,6 +128,11 @@ static const std::map<std::string, FnCreateI2CDriver> I2cFactory = {
         const char *driver_name) -> drvBase * {
        return new drvHtu31d(i2c, addr, mux_channel, driver_name);
      }},
+    {"hdc302x",
+     [](TwoWire *i2c, uint16_t addr, uint32_t mux_channel,
+        const char *driver_name) -> drvBase * {
+       return new drvHdc302x(i2c, addr, mux_channel, driver_name);
+     }},
     {"ina219",
      [](TwoWire *i2c, uint16_t addr, uint32_t mux_channel,
         const char *driver_name) -> drvBase * {

src/components/i2c/controller.h

@@ -29,6 +29,7 @@
 #include "drivers/drvDps310.h"
 #include "drivers/drvDs2484.h"
 #include "drivers/drvEns160.h"
+#include "drivers/drvHdc302x.h"
 #include "drivers/drvHts221.h"
 #include "drivers/drvHtu31d.h"
 #include "drivers/drvHtu21d.h"

src/components/i2c/drivers/drvHdc302x.h

@@ -0,0 +1,133 @@
+/*!
+ * @file drvHdc302x.h
+ *
+ * Device driver for an HDC302X Humidity and Temperature sensor.
+ */
+
+#ifndef DRV_HDC302X_H
+#define DRV_HDC302X_H
+
+#include "drvBase.h"
+#include <Adafruit_HDC302x.h>
+
+/**************************************************************************/
+/*!
+    @brief  Class that provides a sensor driver for the HDC302X humidity and
+            temperature sensor. This implementation uses the 1 Hz data rate.
+*/
+/**************************************************************************/
+class drvHdc302x : public drvBase {
+
+public:
+  /*******************************************************************************/
+  /*!
+      @brief    Constructor for an HDC302X sensor.
+      @param    i2c
+                The I2C interface.
+      @param    sensorAddress
+                7-bit device address.
+      @param    mux_channel
+                The I2C multiplexer channel.
+      @param    driver_name
+                The name of the driver.
+  */
+  /*******************************************************************************/
+  drvHdc302x(TwoWire *i2c, uint16_t sensorAddress, uint32_t mux_channel,
+             const char *driver_name)
+      : drvBase(i2c, sensorAddress, mux_channel, driver_name) {
+    // Initialization handled by drvBase constructor
+  }
+
+  /*******************************************************************************/
+  /*!
+      @brief    Destructor for an HDC302X sensor.
+  */
+  /*******************************************************************************/
+  ~drvHdc302x() { delete _hdc302x; }
+
+  /*******************************************************************************/
+  /*!
+      @brief    Initializes the HDC302X sensor and begins I2C.
+      @returns  True if initialized successfully, False otherwise.
+
+  */
+  /*******************************************************************************/
+  bool begin() {
+    // attempt to initialize the HDC302X using the I2C interface
+    _hdc302x = new Adafruit_HDC302x();
+    if (!_hdc302x->begin(_address, _i2c))
+      return false;
+
+    // set the HDC302X's data rate to 1 Hz lowest noise
+    _hdc302x->setAutoMode(EXIT_AUTO_MODE);
+    // discard first reading (It returned -45c for me once)
+    _hdc302x->readTemperatureHumidityOnDemand(_temp, _humidity,
+                                              TRIGGERMODE_LP0);
+    return true;
+  }
+
+  /*******************************************************************************/
+  /*!
+      @brief    Reads the HDC302X's temperature and humidity data.
+      @returns  True if the data was read successfully, False otherwise.
+  */
+  /*******************************************************************************/
+  bool ReadSensorData() {
+    uint16_t status = _hdc302x->readStatus();
+    if (status & 0x0010) {
+      WS_DEBUG_PRINTLN(F("Device Reset Detected"));
+      return false;
+    }
+
+    if (status & 0x0001) {
+      WS_DEBUG_PRINTLN(
+          F("Checksum Verification Fail (incorrect checksum received)"));
+      return false;
+    }
+
+    if (!_hdc302x->readTemperatureHumidityOnDemand(_temp, _humidity,
+                                                   TRIGGERMODE_LP0)) {
+      WS_DEBUG_PRINTLN(F("Failed to read temperature and humidity."));
+      return false;
+    }
+    return true;
+  }
+
+  /*******************************************************************************/
+  /*!
+      @brief    Gets the HDC302X's current temperature.
+      @param    tempEvent
+                Pointer to an Adafruit_Sensor event.
+      @returns  True if the temperature was obtained successfully, False
+                otherwise.
+  */
+  /*******************************************************************************/
+  bool getEventAmbientTemp(sensors_event_t *tempEvent) {
+    if (ReadSensorData() == false)
+      return false;
+    tempEvent->temperature = _temp;
+    return true;
+  }
+
+  /*******************************************************************************/
+  /*!
+      @brief    Gets the HDC302X's current humidity.
+      @param    humidEvent
+                Pointer to an Adafruit_Sensor event.
+      @returns  True if the humidity was obtained successfully, False
+                otherwise.
+  */
+  /*******************************************************************************/
+  bool getEventRelativeHumidity(sensors_event_t *humidEvent) {
+    if (ReadSensorData() == false)
+      return false;
+    humidEvent->relative_humidity = _humidity;
+    return true;
+  }
+
+protected:
+  Adafruit_HDC302x *_hdc302x; ///< Pointer to an HDC302X object
+  double _temp = 0.0;     ///< Holds data for the HDC302X's temperature sensor
+  double _humidity = 0.0; ///< Holds data for the HDC302X's humidity sensor
+};
+#endif // DRV_HDC302X_H