Merge pull request #14 from sciosense/2.0.4

- updated README.md
- added SPI examples for ENS160/ENS161

Author: TRScioSense

README.md

@@ -1,5 +1,5 @@
 # ScioSense ENS16x Arduino Library
-Arduino library for the ENS16x digital four channel MOX gas sensors with I2C interface from ScioSense.
+Arduino library for the ENS16x digital four channel MOX gas sensors with I2C/SPI interface from ScioSense.
 
 <img src="images/ens16x.png" width="400">
 
@@ -43,9 +43,9 @@ For the installation of the ESP32 in the Arduino IDE, see [Arduino ESP32 Install
 Please make sure that you use the correct supply voltage:
 - The ENS16x runs at VDD = 1.8 V. If you are using the Sciosense ENS16x breakout board, you can use VDD = 3.3 V thanks
 to the onboard LDO. 
-- The I2C communication is 3.3 V tolerant.
+- The I2C/SPI communication is 3.3 V tolerant.
 
-### Example with ESP32
+### I²C example with ESP32
 This example shows how to wire a [ESP32DevKitC](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/hw-reference/esp32/get-started-devkitc.html#get-started-esp32-devkitc-board-front) 
 with the ENS16x breakout board for I2C communication.
 
@@ -56,7 +56,22 @@ with the ENS16x breakout board for I2C communication.
 |          SDA          |  G21  |
 |          SCL          |  G22  |
 
-<img src="images/ens16x_pin_out_esp32.png" width="1000">
+<img src="images/ESP32_I2C.png" width="1000">
+
+### SPI example with ESP32
+This example shows how to wire a [ESP32DevKitC](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/hw-reference/esp32/get-started-devkitc.html#get-started-esp32-devkitc-board-front) 
+with the ENS16x breakout board for SPI communication. Make sure you modify the evaluation board by opening solderbridge J3 according application note [SC-002530-AN](www.sciosense.com/wp-content/uploads/2025/02/ENS160-ENS161-Evaluation-Board-Application-Note.pdf).
+
+| ENS16x breakout board | ESP32 |
+|:---------------------:|:-----:|
+|          VDD          |  3V3  |
+|          GND          |  GND  |
+|          MOSI         |  G23  |
+|          MISO         |  G19  |
+|          SCK          |  G18  |
+|          CS           |  G05  |
+
+<img src="images/ESP32_SPI.png" width="1000">
 
 ## Build an example
 To build an example sketch
@@ -69,5 +84,3 @@ To build an example sketch
 This library is developed for ScioSense by [at² GmbH](https://www.at2-software.com/en/) 
 
 @at2software
-
-### ScioSense is a Joint Venture of ams AG

examples/03_Basic_SPI/ENS160_SPI/ENS160_SPI.ino

@@ -0,0 +1,68 @@
+/*
+    Basic example for ScioSense ENS160 using SPI Interface on ESP32 DevMod
+*/
+
+#include <Arduino.h>
+#include <ScioSense_ENS16x.h>
+
+
+//#define USE_INTERRUPT
+#define PIN_INTN  2  // define pin for interrupt
+#define PIN_CS    5  // define pin for chip select
+
+ENS160 ens160;
+
+void setup()
+{
+    Serial.begin(9600);
+    ens160.enableDebugging(Serial);
+
+    SPI.begin();
+    ens160.begin(&SPI, PIN_CS);
+
+    Serial.println("begin..");
+    while (ens160.init() != true)
+    {
+        Serial.print(".");
+        delay(1000);
+    }
+    Serial.println("success");
+
+#ifdef USE_INTERRUPT
+    ens160.setInterruptPin(INTN);
+    ens160.writeConfiguration
+    (
+          ENS16X_CONFIGURATION_INTERRUPT_ENABLE
+        | ENS16X_CONFIGURATION_NEW_GENERAL_PURPOSE_DATA
+        | ENS16X_CONFIGURATION_NEW_DATA
+    );
+#endif
+
+    ens160.startStandardMeasure();
+}
+
+void loop()
+{
+     ens160.wait();
+
+     // Enable Tools->Serial Plotter to see the sensor output as a graph
+
+     if (ens160.update() == RESULT_OK)
+     {
+        if (ens160.hasNewData())
+        {
+            Serial.print("AQI UBA:"); Serial.print((uint8_t)ens160.getAirQualityIndex_UBA());
+
+            Serial.print("\tTVOC:"); Serial.print(ens160.getTvoc());
+            Serial.print("\tECO2:"); Serial.println(ens160.getEco2());
+        }
+
+        if (ens160.hasNewGeneralPurposeData())
+        {
+            Serial.print("RS0:"); Serial.print(ens160.getRs0());
+            Serial.print("\tRS1:"); Serial.print(ens160.getRs1());
+            Serial.print("\tRS2:"); Serial.print(ens160.getRs2());
+            Serial.print("\tRS3:"); Serial.println(ens160.getRs3());
+        }
+     }
+}

examples/03_Basic_SPI/ENS161_SPI/ENS161_SPI.ino

@@ -0,0 +1,66 @@
+/*
+    Basic example for ScioSense ENS161 using SPI Interface on ESP32 DevMod
+*/
+
+#include <Arduino.h>
+#include <ScioSense_ENS16x.h>
+
+//#define USE_INTERRUPT
+#define PIN_INTN  2  // define pin for interrupt
+#define PIN_CS    5  // define pin for chip select
+
+ENS161 ens161;
+
+void setup() {
+    Serial.begin(9600);
+    ens161.enableDebugging(Serial);
+
+    SPI.begin();
+    ens161.begin(&SPI, PIN_CS);
+
+    Serial.println("begin..");
+    while (ens161.init() != true) {
+        Serial.print(".");
+        delay(1000);
+    }
+    Serial.println("success");
+
+#ifdef USE_INTERRUPT
+    ens161.setInterruptPin(PIN_INTN);
+    ens161.writeConfiguration(
+      ENS16X_CONFIGURATION_INTERRUPT_ENABLE
+      | ENS16X_CONFIGURATION_NEW_GENERAL_PURPOSE_DATA
+      | ENS16X_CONFIGURATION_NEW_DATA);
+#endif
+
+    ens161.startStandardMeasure();
+}
+
+void loop() {
+    ens161.wait();
+
+    // Enable Tools->Serial Plotter to see the sensor output as a graph
+
+    if (ens161.update() == RESULT_OK) {
+        if (ens161.hasNewData()) {
+            Serial.print("AQI UBA:");
+            Serial.print((uint8_t)ens161.getAirQualityIndex_UBA());
+
+            Serial.print("\tTVOC:");
+            Serial.print(ens161.getTvoc());
+            Serial.print("\tECO2:");
+            Serial.println(ens161.getEco2());
+        }
+
+        if (ens161.hasNewGeneralPurposeData()) {
+            Serial.print("RS0:");
+            Serial.print(ens161.getRs0());
+            Serial.print("\tRS1:");
+            Serial.print(ens161.getRs1());
+            Serial.print("\tRS2:");
+            Serial.print(ens161.getRs2());
+            Serial.print("\tRS3:");
+            Serial.println(ens161.getRs3());
+        }
+    }
+}

images/ESP32_I2C.png

@@ -1,5 +1,5 @@
 name=ScioSense_ENS16x
-version=2.0.3
+version=2.0.4
 author=ScioSense
 maintainer=ScioSense
 sentence=Arduino library for the ENS16x digital four channel MOX gas sensor family with I2C interface from ScioSense