Mlx90632

library.properties

@@ -1,10 +1,10 @@
 name=Adafruit WipperSnapper
-version=1.0.0-beta.110
+version=1.0.0-beta.111
 author=Adafruit
 maintainer=Adafruit <[email protected]>
 sentence=Arduino application for Adafruit.io WipperSnapper
 paragraph=Arduino application for Adafruit.io WipperSnapper
 category=Communication
 url=https://github.com/adafruit/Adafruit_Wippersnapper_Arduino
 architectures=*
-depends=OmronD6T - Community Fork, SdFat - Adafruit Fork, Adafruit NeoPixel, Adafruit SPIFlash, ArduinoJson, Adafruit DotStar, Adafruit HDC302x, Adafruit INA219, Adafruit INA260 Library, Adafruit INA237 and INA238 Library, Adafruit LTR329 and LTR303, Adafruit LTR390 Library, Adafruit MCP3421, Adafruit NAU7802 Library, Adafruit SleepyDog Library, Adafruit TMP117, Adafruit TinyUSB Library, Adafruit AHTX0, Adafruit BME280 Library, Adafruit BMP280 Library, Adafruit BMP3XX Library, Adafruit DPS310, Adafruit DS248x, Adafruit SCD30, Adafruit SGP30 Sensor, Adafruit SGP40 Sensor, Sensirion I2C SCD4x, Sensirion I2C SEN5X, Sensirion I2C SEN66, arduino-sht, Adafruit Si7021 Library, Adafruit MQTT Library, Adafruit MS8607, Adafruit MCP9808 Library, Adafruit MCP9600 Library, Adafruit MPL115A2, Adafruit MPRLS Library, Adafruit TSL2591 Library, Adafruit_VL53L0X, Adafruit VL53L1X, STM32duino VL53L4CD, STM32duino VL53L4CX, Adafruit_VL6180X, Adafruit PM25 AQI Sensor, Adafruit VCNL4020 Library, Adafruit VCNL4040, Adafruit VCNL4200 Library, Adafruit VEML7700 Library, Adafruit LC709203F, Adafruit LPS2X, Adafruit LPS28, Adafruit LPS35HW, Adafruit seesaw Library, Adafruit BME680 Library, Adafruit MAX1704X, Adafruit ADT7410 Library, Adafruit HTS221, Adafruit HTU21DF Library, Adafruit HTU31D Library, Adafruit PCT2075, hp_BH1750, ENS160 - Adafruit Fork, Adafruit BusIO, Adafruit Unified Sensor, Sensirion Core, Adafruit GFX Library, Adafruit LED Backpack Library, Adafruit LiquidCrystal, Adafruit SH110X, Adafruit SSD1306
+depends=OmronD6T - Community Fork, SdFat - Adafruit Fork, Adafruit NeoPixel, Adafruit SPIFlash, ArduinoJson, Adafruit DotStar, Adafruit HDC302x, Adafruit INA219, Adafruit INA260 Library, Adafruit INA237 and INA238 Library, Adafruit LTR329 and LTR303, Adafruit LTR390 Library, Adafruit MCP3421, Adafruit MLX90632 Library, Adafruit NAU7802 Library, Adafruit SleepyDog Library, Adafruit TMP117, Adafruit TinyUSB Library, Adafruit AHTX0, Adafruit BME280 Library, Adafruit BMP280 Library, Adafruit BMP3XX Library, Adafruit DPS310, Adafruit DS248x, Adafruit SCD30, Adafruit SGP30 Sensor, Adafruit SGP40 Sensor, Sensirion I2C SCD4x, Sensirion I2C SEN5X, Sensirion I2C SEN66, arduino-sht, Adafruit Si7021 Library, Adafruit MQTT Library, Adafruit MS8607, Adafruit MCP9808 Library, Adafruit MCP9600 Library, Adafruit MPL115A2, Adafruit MPRLS Library, Adafruit TSL2591 Library, Adafruit_VL53L0X, Adafruit VL53L1X, STM32duino VL53L4CD, STM32duino VL53L4CX, Adafruit_VL6180X, Adafruit PM25 AQI Sensor, Adafruit VCNL4020 Library, Adafruit VCNL4040, Adafruit VCNL4200 Library, Adafruit VEML7700 Library, Adafruit LC709203F, Adafruit LPS2X, Adafruit LPS28, Adafruit LPS35HW, Adafruit seesaw Library, Adafruit BME680 Library, Adafruit MAX1704X, Adafruit ADT7410 Library, Adafruit HTS221, Adafruit HTU21DF Library, Adafruit HTU31D Library, Adafruit PCT2075, hp_BH1750, ENS160 - Adafruit Fork, Adafruit BusIO, Adafruit Unified Sensor, Sensirion Core, Adafruit GFX Library, Adafruit LED Backpack Library, Adafruit LiquidCrystal, Adafruit SH110X, Adafruit SSD1306

platformio.ini

@@ -57,6 +57,7 @@ lib_deps =
     adafruit/Adafruit MCP3421
     adafruit/Adafruit MCP9808 Library
     adafruit/Adafruit MCP9600 Library
+    adafruit/Adafruit MLX90632 Library
     adafruit/Adafruit MPL115A2
     adafruit/Adafruit MPRLS Library
     adafruit/Adafruit MS8607
@@ -203,23 +204,23 @@ board_build.partitions = min_spiffs.csv
 extends = common:esp32
 board = featheresp32-s2
 build_flags = -DARDUINO_ADAFRUIT_FEATHER_ESP32S2 -DBOARD_HAS_PSRAM
-board_build.partitions = tinyuf2-partitions-4MB.csv
+board_build.partitions = tinyuf2-partitions-4MB-noota.csv
 extra_scripts = pre:rename_usb_config.py
 
 ; Adafruit Feather ESP32-S2 TFT
 [env:adafruit_feather_esp32s2_tft]
 extends = common:esp32
 board = adafruit_feather_esp32s2_tft
 build_flags = -DARDUINO_ADAFRUIT_FEATHER_ESP32S2_TFT -DBOARD_HAS_PSRAM
-board_build.partitions = tinyuf2-partitions-4MB.csv
+board_build.partitions = tinyuf2-partitions-4MB-noota.csv
 extra_scripts = pre:rename_usb_config.py
 
 ; Adafruit Feather ESP32-S2 Reverse TFT
 [env:adafruit_feather_esp32s2_reversetft]
 extends = common:esp32
 board = adafruit_feather_esp32s2_reversetft
 build_flags = -DARDUINO_ADAFRUIT_FEATHER_ESP32S2_REVTFT -DBOARD_HAS_PSRAM
-board_build.partitions = tinyuf2-partitions-4MB.csv
+board_build.partitions = tinyuf2-partitions-4MB-noota.csv
 extra_scripts = pre:rename_usb_config.py
 
 ; Adafruit Feather ESP32-S3 2MB PSRAM
@@ -228,7 +229,7 @@ extends = common:esp32
 board = adafruit_feather_esp32s3
 build_flags = -DARDUINO_ADAFRUIT_FEATHER_ESP32S3 -DBOARD_HAS_PSRAM
 ;set partition to tinyuf2-partitions-4MB.csv as of idf 5.1
-board_build.partitions = tinyuf2-partitions-4MB.csv
+board_build.partitions = tinyuf2-partitions-4MB-noota.csv
 extra_scripts = pre:rename_usb_config.py
 
 ; Adafruit Feather ESP32-S3 NO PSRAM
@@ -247,7 +248,7 @@ debug_tool = esp-builtin
 board = adafruit_feather_esp32s3_tft
 build_flags = -DARDUINO_ADAFRUIT_FEATHER_ESP32S3_TFT -DBOARD_HAS_PSRAM
 ;set partition to tinyuf2-partitions-4MB.csv as of idf 5.1
-board_build.partitions = tinyuf2-partitions-4MB.csv
+board_build.partitions = tinyuf2-partitions-4MB-noota.csv
 extra_scripts = pre:rename_usb_config.py
 
 ; Adafruit Feather ESP32-S3 Reverse TFT
@@ -256,7 +257,7 @@ extends = common:esp32
 board = adafruit_feather_esp32s3_reversetft
 build_flags = -DARDUINO_ADAFRUIT_FEATHER_ESP32S3_REVTFT -DBOARD_HAS_PSRAM
 ;set partition to tinyuf2-partitions-4MB.csv as of idf 5.1
-board_build.partitions = tinyuf2-partitions-4MB.csv
+board_build.partitions = tinyuf2-partitions-4MB-noota.csv
 extra_scripts = pre:rename_usb_config.py
 
 ; Adafruit Magtag ESP32-S2
@@ -265,7 +266,7 @@ extends = common:esp32
 board = adafruit_magtag29_esp32s2
 build_flags = -DARDUINO_MAGTAG29_ESP32S2 -DBOARD_HAS_PSRAM
 ;set partition to tinyuf2-partitions-4MB.csv as of idf 5.1
-board_build.partitions = tinyuf2-partitions-4MB.csv
+board_build.partitions = tinyuf2-partitions-4MB-noota.csv
 extra_scripts = pre:rename_usb_config.py
 
 ; Adafruit Metro ESP32-S2
@@ -274,7 +275,7 @@ extends = common:esp32
 board = adafruit_metro_esp32s2
 build_flags = -DARDUINO_METRO_ESP32S2 -DBOARD_HAS_PSRAM
 ;set partition to tinyuf2-partitions-4MB.csv as of idf 5.1
-board_build.partitions = tinyuf2-partitions-4MB.csv
+board_build.partitions = tinyuf2-partitions-4MB-noota.csv
 extra_scripts =  pre:rename_usb_config.py
 
 ; Adafruit Metro ESP32-S3
@@ -363,7 +364,7 @@ extends = common:esp32
 board = adafruit_qtpy_esp32s2
 build_flags = -DARDUINO_ADAFRUIT_QTPY_ESP32S2 -DBOARD_HAS_PSRAM
 ;set partition to tinyuf2-partitions-4MB.csv as of idf 5.1
-board_build.partitions = tinyuf2-partitions-4MB.csv
+board_build.partitions = tinyuf2-partitions-4MB-noota.csv
 extra_scripts =  pre:rename_usb_config.py
 
 ; Adafruit QT Py ESP32-S3 NO PSRAM

src/Wippersnapper.h

@@ -142,7 +142,7 @@
 #endif
 
 #define WS_VERSION                                                             \
-  "1.0.0-beta.110" ///< WipperSnapper app. version (semver-formatted)
+  "1.0.0-beta.111" ///< WipperSnapper app. version (semver-formatted)
 
 // Reserved Adafruit IO MQTT topics
 #define TOPIC_IO_THROTTLE "/throttle" ///< Adafruit IO Throttle MQTT Topic

src/components/i2c/WipperSnapper_I2C.cpp

@@ -537,6 +537,33 @@ bool WipperSnapper_Component_I2C::initI2CDevice(
     _mcp9808->configureDriver(msgDeviceInitReq);
     drivers.push_back(_mcp9808);
     WS_DEBUG_PRINTLN("MCP9808 Initialized Successfully!");
+  } else if (strcmp("mlx90632b", msgDeviceInitReq->i2c_device_name) == 0 ||
+             strcmp("mlx90632d_med", msgDeviceInitReq->i2c_device_name) == 0) {
+    _mlx90632d = new WipperSnapper_I2C_Driver_MLX90632D(this->_i2c, i2cAddress);
+    if (!_mlx90632d->begin()) {
+      WS_DEBUG_PRINTLN("ERROR: Failed to initialize MLX90632!");
+      _busStatusResponse =
+          wippersnapper_i2c_v1_BusResponse_BUS_RESPONSE_DEVICE_INIT_FAIL;
+      return false;
+    }
+    _mlx90632d->configureDriver(msgDeviceInitReq);
+    drivers.push_back(_mlx90632d);
+    WS_DEBUG_PRINTLN("MLX90632 Initialized Successfully!");
+  } else if (strcmp("mlx90632d_ext", msgDeviceInitReq->i2c_device_name) == 0) {
+    _mlx90632d_ext =
+        new WipperSnapper_I2C_Driver_MLX90632D(this->_i2c, i2cAddress);
+    // set extended range
+    if (!_mlx90632d_ext->begin() ||
+        !_mlx90632d_ext->ConfigureAndPrintSensorInfo(true)) {
+      WS_DEBUG_PRINTLN(
+          "ERROR: Failed to initialize MLX90632D with extended range!");
+      _busStatusResponse =
+          wippersnapper_i2c_v1_BusResponse_BUS_RESPONSE_DEVICE_INIT_FAIL;
+      return false;
+    }
+    _mlx90632d_ext->configureDriver(msgDeviceInitReq);
+    drivers.push_back(_mlx90632d_ext);
+    WS_DEBUG_PRINTLN("MLX90632D_EXT Initialized Successfully!");
   } else if (strcmp("mpl115a2", msgDeviceInitReq->i2c_device_name) == 0) {
     _mpl115a2 = new WipperSnapper_I2C_Driver_MPL115A2(this->_i2c, i2cAddress);
     if (!_mpl115a2->begin()) {

src/components/i2c/WipperSnapper_I2C.h

@@ -50,6 +50,7 @@
 #include "drivers/WipperSnapper_I2C_Driver_MAX17048.h"
 #include "drivers/WipperSnapper_I2C_Driver_MCP3421.h"
 #include "drivers/WipperSnapper_I2C_Driver_MCP9808.h"
+#include "drivers/WipperSnapper_I2C_Driver_MLX90632D.h"
 #include "drivers/WipperSnapper_I2C_Driver_MPL115A2.h"
 #include "drivers/WipperSnapper_I2C_Driver_MPRLS.h"
 #include "drivers/WipperSnapper_I2C_Driver_MS8607.h"
@@ -180,6 +181,8 @@ class WipperSnapper_Component_I2C {
   WipperSnapper_I2C_Driver_LTR390 *_ltr390 = nullptr;
   WipperSnapper_I2C_Driver_MCP3421 *_mcp3421 = nullptr;
   WipperSnapper_I2C_Driver_MCP9808 *_mcp9808 = nullptr;
+  WipperSnapper_I2C_Driver_MLX90632D *_mlx90632d = nullptr;
+  WipperSnapper_I2C_Driver_MLX90632D *_mlx90632d_ext = nullptr;
   WipperSnapper_I2C_Driver_MPL115A2 *_mpl115a2 = nullptr;
   WipperSnapper_I2C_Driver_MPRLS *_mprls = nullptr;
   WipperSnapper_I2C_Driver_MS8607 *_ms8607 = nullptr;

src/components/i2c/drivers/WipperSnapper_I2C_Driver_MLX90632D.h

@@ -0,0 +1,233 @@
+/*!
+ * @file WipperSnapper_I2C_Driver_MLX90632D.h
+ *
+ * Device driver for a Melexis MLX90632-D (medical) thermal FIR sensor.
+ *
+ * Adafruit invests time and resources providing this open source code,
+ * please support Adafruit and open-source hardware by purchasing
+ * products from Adafruit!
+ *
+ * Copyright (c) Tyeth Gundry 2025 for Adafruit Industries.
+ *
+ * MIT license, all text here must be included in any redistribution.
+ *
+ */
+
+#ifndef WipperSnapper_I2C_Driver_MLX90632D_H
+#define WipperSnapper_I2C_Driver_MLX90632D_H
+
+#include <Adafruit_MLX90632.h>
+
+#include "WipperSnapper_I2C_Driver.h"
+
+/**************************************************************************/
+/*!
+    @brief  Sensor driver for the Melexis MLX90632-D temperature sensor.
+*/
+/**************************************************************************/
+class WipperSnapper_I2C_Driver_MLX90632D : public WipperSnapper_I2C_Driver {
+public:
+  /*******************************************************************************/
+  /*!
+      @brief    Constructor for an MLX90632 sensor.
+      @param    i2c
+                The I2C interface.
+      @param    sensorAddress
+                7-bit device address.
+  */
+  /*******************************************************************************/
+  WipperSnapper_I2C_Driver_MLX90632D(TwoWire *i2c, uint16_t sensorAddress)
+      : WipperSnapper_I2C_Driver(i2c, sensorAddress) {
+    _i2c = i2c;
+    _sensorAddress = sensorAddress;
+    _mlx90632 = nullptr;
+    _deviceTemp = NAN;
+    _objectTemp = NAN;
+    _lastRead = 0;
+  }
+
+  /*******************************************************************************/
+  /*!
+      @brief    Destructor for an MLX90632 sensor.
+  */
+  /*******************************************************************************/
+  ~WipperSnapper_I2C_Driver_MLX90632D() {
+    if (_mlx90632) {
+      delete _mlx90632;
+      _mlx90632 = nullptr;
+    }
+  }
+
+  /*******************************************************************************/
+  /*!
+      @brief    Initializes the MLX90632 sensor and begins I2C.
+      @returns  True if initialized successfully, False otherwise.
+  */
+  /*******************************************************************************/
+  bool begin() {
+    if (_mlx90632) {
+      delete _mlx90632;
+      _mlx90632 = nullptr;
+    }
+    _mlx90632 = new Adafruit_MLX90632();
+    // attempt to initialize MLX90632
+    if (!_mlx90632->begin(_sensorAddress, _i2c))
+      return false;
+
+    return ConfigureAndPrintSensorInfo();
+  }
+
+  /*******************************************************************************/
+  /*!
+      @brief    Configures the MLX90632 sensor and prints its information.
+      @param    extendedInsteadOfMedicalRange
+                If true, configures the sensor for extended temperature
+     range/acc.
+      @returns  True if configuration fetching and setting were successful.
+  */
+  /*******************************************************************************/
+  bool ConfigureAndPrintSensorInfo(bool extendedInsteadOfMedicalRange = false) {
+    // Reset the device
+    if (!_mlx90632->reset()) {
+      WS_DEBUG_PRINTLN(F("Device reset failed"));
+      return false;
+    }
+
+    uint16_t productCode = _mlx90632->getProductCode();
+    // Decode product code bits
+    uint8_t fov = (productCode >> 8) & 0x3;
+    uint8_t package = (productCode >> 5) & 0x7;
+    uint8_t accuracy = productCode & 0x1F;
+
+    if (!_mlx90632->setMode(MLX90632_MODE_CONTINUOUS)) {
+      WS_DEBUG_PRINTLN(F("Failed to set mode"));
+      return false;
+    }
+
+    // set accuracy mode based on medical if detected
+    if (accuracy == 1) {
+      // Set and get measurement select (medical)
+      if (!extendedInsteadOfMedicalRange &&
+          !_mlx90632->setMeasurementSelect(MLX90632_MEAS_MEDICAL)) {
+        WS_DEBUG_PRINTLN(F("Failed to set measurement select to Medical"));
+        return false;
+      } else if (extendedInsteadOfMedicalRange &&
+                 !_mlx90632->setMeasurementSelect(
+                     MLX90632_MEAS_EXTENDED_RANGE)) {
+        WS_DEBUG_PRINTLN(
+            F("Failed to set measurement select to Extended Range"));
+        return false;
+      }
+    }
+
+    // Set and get refresh rate (default to 2Hz)
+    if (!_mlx90632->setRefreshRate(MLX90632_REFRESH_2HZ)) {
+      WS_DEBUG_PRINTLN(F("Failed to set refresh rate to 2Hz"));
+      return false;
+    }
+
+    if (!_mlx90632->resetNewData()) {
+      WS_DEBUG_PRINTLN(F("Failed to reset new data flag"));
+      return false;
+    }
+    return true;
+  }
+
+  /*******************************************************************************/
+  /*!
+      @brief    Checks if sensor was read within last 1s, or is the first read.
+      @returns  True if the sensor was recently read, False otherwise.
+  */
+  /*******************************************************************************/
+  bool HasBeenReadInLast200ms() {
+    return _lastRead != 0 && millis() - _lastRead < 200;
+  }
+
+  /*******************************************************************************/
+  /*!
+      @brief    Reads the sensor.
+      @returns  True if the sensor was read successfully, False otherwise.
+  */
+  /*******************************************************************************/
+  bool ReadSensorData() {
+    bool result = false;
+    if (HasBeenReadInLast200ms()) {
+      WS_DEBUG_PRINTLN(F("Sensor was read recently, using cached data"));
+      return true;
+    }
+
+    // Check if we need to trigger a new measurement for step modes
+    mlx90632_mode_t currentMode = _mlx90632->getMode();
+    if (currentMode == MLX90632_MODE_STEP ||
+        currentMode == MLX90632_MODE_SLEEPING_STEP) {
+      // Trigger single measurement (SOC bit) for step modes
+      if (!_mlx90632->startSingleMeasurement()) {
+        WS_DEBUG_PRINTLN(F("Failed to start single measurement"));
+        return false;
+      }
+      delay(510); // Wait for measurement to complete @ 2Hz
+    }
+
+    // Only check new data flag - much more efficient for continuous mode
+    if (_mlx90632->isNewData()) {
+      _deviceTemp = _mlx90632->getAmbientTemperature();
+      _objectTemp = _mlx90632->getObjectTemperature();
+      if (isnan(_objectTemp)) {
+        WS_DEBUG_PRINTLN(F("NaN (invalid cycle position)"));
+        return false;
+      }
+      result = true;
+      _lastRead = millis();
+      // Reset new data flag after reading
+      if (!_mlx90632->resetNewData()) {
+        WS_DEBUG_PRINTLN(F("Failed to reset new data flag"));
+      }
+    } else {
+      WS_DEBUG_PRINTLN(F("No new data available, skipping read"));
+    }
+
+    return result;
+  }
+
+  /*******************************************************************************/
+  /*!
+      @brief    Gets the MLX90632'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() && _deviceTemp != NAN) {
+      tempEvent->temperature = _deviceTemp;
+      return true;
+    }
+    return false; // sensor not read recently, return false
+  }
+
+  /*******************************************************************************/
+  /*!
+      @brief    Gets the MLX90632's object temperature.
+      @param    tempEvent
+                Pointer to an Adafruit_Sensor event.
+      @returns  True if the temperature was obtained successfully, False
+                otherwise.
+  */
+  /*******************************************************************************/
+  bool getEventObjectTemp(sensors_event_t *tempEvent) {
+    if (ReadSensorData() && _objectTemp != NAN) {
+      tempEvent->temperature = _objectTemp;
+      return true;
+    }
+    return false; // sensor not read recently, return false
+  }
+
+protected:
+  double _deviceTemp; ///< Device temperature in Celsius
+  double _objectTemp; ///< Object temperature in Celsius
+  uint32_t _lastRead; ///< Last time the sensor was read in milliseconds
+  Adafruit_MLX90632 *_mlx90632 = nullptr; ///< MLX90632 object
+};
+
+#endif // WipperSnapper_I2C_Driver_MLX90632D_H