2.0.0

Implements the ScioSense core libraries, separates C drivers and Arduino wrappers

Author: GuidoStefanutoScioSense

README.md

@@ -1,80 +1,80 @@
-# ScioSense ENS21x Arduino Library
-Arduino library for the ENS21x temperature & humidity sensor family with I2C interface from ScioSense.
-
-<img src="images/ens21x.png" width="400">
-
-The ENS21x is a family of high-performance digital temperature and humidity sensors produced by
-[ScioSense](http://www.sciosense.com). With industry leading accuracies down to 0.1°C temperature and 0.8% relative 
-humidity, their rapid response and reliable, long-term performance the ENS21x family addresses the fields of home 
-appliances, building and automotive HVAC, cold chain management, personal health and wellness monitoring, industrial 
-automation and instrumentation.
-
-The ENS21x family includes the ENS210, ENS211, ENS212, ENS213A and the ENS215.
-
-## Links
-* [Further information about the ENS21x](https://www.sciosense.com/ens21x-family-of-high-performance-digital-temperature-and-humidity-sensors/)
-* [Datasheet](https://www.sciosense.com/wp-content/uploads/2023/12/ENS21x-Datasheet.pdf)
-* Buy the ENS210 on [Mouser](https://mou.sr/3P3DWmK) or [Digikey](https://www.digikey.nl/en/products/detail/sciosense/ENS210-LQFM/6490747)
-* Buy the ENS210 evaluation kit on [Mouser](https://mou.sr/44GNQAi)
-
- 
-## Prerequisites
-It is assumed that
- - The Arduino IDE has been installed.
-   If not, refer to "Install the Arduino Desktop IDE" on the
-   [Arduino site](https://www.arduino.cc/en/Guide/HomePage).
-- The library directory is at its default location. Normally this is `C:\Users\[your_username]\Documents\Arduino\libraries`.
-
-You might need to add your board to the Arduino IDE. This library was tested with the [Espressif ESP32](https://www.espressif.com/en/products/socs/esp32). 
-For the installation of the ESP32 in the Arduino IDE, see [Arduino ESP32 Installation](https://docs.espressif.com/projects/arduino-esp32/en/latest/installing.html)
-
-
-## Installation
-
-### Installation via Arduino Library Manager (coming soon)
-- In the Arduino IDE, navigate to the Arduino Library Manager on the left side (or, alternatively, select Sketch > 
-Include Library > Manage Libraries...)
-- Search for `ScioSense_ENS21x`
-- Select the library from the search results and press `Install`
-
-### Manual installation
-- Download the code from this repository via "Download ZIP".
-- In Arduino IDE, select Sketch > Include Library > Add .ZIP library... and browse to the just downloaded ZIP file.
-- When the IDE is ready this README.md should be located at `C:\Users\[your_username]\Documents\Arduino\libraries\ScioSense_ENS21x\README.md`.
-
-
-## Wiring
-
-### General
-Please make sure that you use the correct supply voltage: The ENS21x runs at VDD = 1.71...3.60 V.
-
-### Example with ESP32 (I2C)
-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 ENS21x flex foil for I2C communication.
-
-| ENS21x flex foil | ESP32 |
-|:----------------:|:-----:|
-|       VDD        |  3V3  |
-|       GND        |  GND  |
-|       SDA        |  G21  |
-|       SCL        |  G22  |
-
-<img src="images/i2c_pinout_esp32.png" width="1000">
-
-## Build an example
-To build an example sketch
- - (Re)start Arduino.
- - Open File > Examples > Examples from Custom Libraries > ScioSense_ENS21x > 01_Basic (or any other of the provided 
-examples you wish to run)
- - Make sure Tools > Board lists the correct board.
- - Select Sketch > Verify/Compile.
-
-## Contributing
-Contributions in the form of issue opening or creating pull requests are very welcome!
-
-## Acknowledgements
-This library is developed for ScioSense by [at² GmbH](https://www.at2-software.com/en/) 
-
-@at2software
-
-### ScioSense is a Joint Venture of ams AG 
+# ScioSense ENS21x Arduino Library
+Arduino library for the ENS21x temperature & humidity sensor family with I2C interface from ScioSense.
+
+<img src="images/ens21x.png" width="400">
+
+The ENS21x is a family of high-performance digital temperature and humidity sensors produced by
+[ScioSense](http://www.sciosense.com). With industry leading accuracies down to 0.1°C temperature and 0.8% relative 
+humidity, their rapid response and reliable, long-term performance the ENS21x family addresses the fields of home 
+appliances, building and automotive HVAC, cold chain management, personal health and wellness monitoring, industrial 
+automation and instrumentation.
+
+The ENS21x family includes the ENS210, ENS211, ENS212, ENS213A and the ENS215.
+
+## Links
+* [Further information about the ENS21x](https://www.sciosense.com/ens21x-family-of-high-performance-digital-temperature-and-humidity-sensors/)
+* [Datasheet](https://www.sciosense.com/wp-content/uploads/2024/04/ENS21x-Datasheet.pdf)
+* Buy the ENS210 on [Mouser](https://mou.sr/3P3DWmK) or [Digikey](https://www.digikey.nl/en/products/detail/sciosense/ENS210-LQFM/6490747)
+* Buy the ENS210 evaluation kit on [Mouser](https://mou.sr/44GNQAi)
+
+ 
+## Prerequisites
+It is assumed that
+ - The Arduino IDE has been installed.
+   If not, refer to "Install the Arduino Desktop IDE" on the
+   [Arduino site](https://www.arduino.cc/en/Guide/HomePage).
+- The library directory is at its default location. Normally this is `C:\Users\[your_username]\Documents\Arduino\libraries`.
+
+You might need to add your board to the Arduino IDE. This library was tested with the [Espressif ESP32](https://www.espressif.com/en/products/socs/esp32). 
+For the installation of the ESP32 in the Arduino IDE, see [Arduino ESP32 Installation](https://docs.espressif.com/projects/arduino-esp32/en/latest/installing.html)
+
+
+## Installation
+
+### Installation via Arduino Library Manager (coming soon)
+- In the Arduino IDE, navigate to the Arduino Library Manager on the left side (or, alternatively, select Sketch > 
+Include Library > Manage Libraries...)
+- Search for `ScioSense_ENS21x`
+- Select the library from the search results and press `Install`
+
+### Manual installation
+- Download the code from this repository via "Download ZIP".
+- In Arduino IDE, select Sketch > Include Library > Add .ZIP library... and browse to the just downloaded ZIP file.
+- When the IDE is ready this README.md should be located at `C:\Users\[your_username]\Documents\Arduino\libraries\ScioSense_ENS21x\README.md`.
+
+
+## Wiring
+
+### General
+Please make sure that you use the correct supply voltage: The ENS21x runs at VDD = 1.71...3.60 V.
+
+### Example with ESP32 (I2C)
+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 ENS21x flex foil for I2C communication.
+
+| ENS21x flex foil | ESP32 |
+|:----------------:|:-----:|
+|       VDD        |  3V3  |
+|       GND        |  GND  |
+|       SDA        |  G21  |
+|       SCL        |  G22  |
+
+<img src="images/i2c_pinout_esp32.png" width="1000">
+
+## Build an example
+To build an example sketch
+ - (Re)start Arduino.
+ - Open File > Examples > Examples from Custom Libraries > ScioSense_ENS21x > 01_Basic (or any other of the provided 
+examples you wish to run)
+ - Make sure Tools > Board lists the correct board.
+ - Select Sketch > Verify/Compile.
+
+## Contributing
+Contributions in the form of issue opening or creating pull requests are very welcome!
+
+## Acknowledgements
+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/01_Basic/ENS210/ENS210.ino

@@ -3,8 +3,6 @@
 
 #include "ens210.h"
 
-using namespace ScioSense;
-
 ENS210 ens210;
 
 void setup()
@@ -14,6 +12,7 @@ void setup()
 
     Wire.begin();
     ens210.begin();
+    ens210.init();
 
     if (ens210.isConnected() == false)
     {
@@ -24,7 +23,7 @@ void setup()
 
 void loop()
 {
-    if (ens210.singleShotMeasure() == ENS210::Result::STATUS_OK)
+    if (ens210.singleShotMeasure() == RESULT_OK)
     {
         float temperatureCelsius = ens210.getTempCelsius();
         float humidityPercent    = ens210.getHumidityPercent();

examples/01_Basic/ENS211/ENS211.ino

@@ -3,8 +3,6 @@
 
 #include "ens211.h"
 
-using namespace ScioSense;
-
 ENS211 ens211;
 
 void setup()
@@ -14,6 +12,7 @@ void setup()
 
     Wire.begin();
     ens211.begin();
+    ens211.init();
 
     if (ens211.isConnected() == false)
     {
@@ -24,7 +23,7 @@ void setup()
 
 void loop()
 {
-    if (ens211.singleShotMeasure() == ENS211::Result::STATUS_OK)
+    if (ens211.singleShotMeasure() == RESULT_OK)
     {
         float temperatureCelsius = ens211.getTempCelsius();
         float humidityPercent    = ens211.getHumidityPercent();

examples/01_Basic/ENS212/ENS212.ino

@@ -3,8 +3,6 @@
 
 #include "ens212.h"
 
-using namespace ScioSense;
-
 ENS212 ens212;
 
 void setup()
@@ -14,6 +12,7 @@ void setup()
 
     Wire.begin();
     ens212.begin();
+    ens212.init();
 
     if (ens212.isConnected() == false)
     {
@@ -24,7 +23,7 @@ void setup()
 
 void loop()
 {
-    if (ens212.singleShotMeasure() == ENS212::Result::STATUS_OK)
+    if (ens212.singleShotMeasure() == RESULT_OK)
     {
         float temperatureCelsius = ens212.getTempCelsius();
         float humidityPercent    = ens212.getHumidityPercent();

examples/01_Basic/ENS213A/ENS213A.ino

@@ -3,8 +3,6 @@
 
 #include "ens213a.h"
 
-using namespace ScioSense;
-
 ENS213A ens213a;
 
 void setup()
@@ -14,6 +12,7 @@ void setup()
 
     Wire.begin();
     ens213a.begin();
+    ens213a.init();
 
     if (ens213a.isConnected() == false)
     {
@@ -24,7 +23,7 @@ void setup()
 
 void loop()
 {
-    if (ens213a.singleShotMeasure() == ENS213A::Result::STATUS_OK)
+    if (ens213a.singleShotMeasure() == RESULT_OK)
     {
         float temperatureCelsius = ens213a.getTempCelsius();
         float humidityPercent    = ens213a.getHumidityPercent();

examples/01_Basic/ENS215/ENS215.ino

@@ -3,8 +3,6 @@
 
 #include "ens215.h"
 
-using namespace ScioSense;
-
 ENS215 ens215;
 
 void setup()
@@ -14,6 +12,7 @@ void setup()
 
     Wire.begin();
     ens215.begin();
+    ens215.init();
 
     if (ens215.isConnected() == false)
     {
@@ -24,7 +23,7 @@ void setup()
 
 void loop()
 {
-    if (ens215.singleShotMeasure() == ENS215::Result::STATUS_OK)
+    if (ens215.singleShotMeasure() == RESULT_OK)
     {
         float temperatureCelsius = ens215.getTempCelsius();
         float humidityPercent    = ens215.getHumidityPercent();

examples/02_Continuous_Mode/ENS210/ENS210.ino

@@ -3,8 +3,6 @@
 
 #include "ens210.h"
 
-using namespace ScioSense;
-
 ENS210 ens210;
 
 void setup()
@@ -14,20 +12,19 @@ void setup()
 
     Wire.begin();
     ens210.begin();
+    ens210.init();
 
     if (ens210.isConnected() == false)
     {
         Serial.println("Error -- The ENS210 is not connected.");
         while(1);
     }
 
-    ens210.reset();
-
     Serial.print("Starting continous mode..");
-    while (ens210.startContinuousMeasure() != ENS210::Result::STATUS_OK)
+    while (ens210.startContinuousMeasure() != RESULT_OK)
     {
         Serial.print(".");
-        delay(ENS210::SystemTiming::BOOTING);
+        delay(ENS21X_SYSTEM_TIMING_BOOTING);
     }
     Serial.println(" Done!");
 
@@ -37,7 +34,9 @@ void setup()
 
 void loop()
 {
-    if (ens210.update() == ENS210::Result::STATUS_OK)
+    ens210.wait();
+
+    if (ens210.update() == RESULT_OK)
     {
         float temperatureCelsius = ens210.getTempCelsius();
         float humidityPercent    = ens210.getHumidityPercent();
@@ -49,6 +48,5 @@ void loop()
         Serial.print("Humidity:");
         Serial.print(humidityPercent);
         Serial.println("%");
-        ens210.getStatusH();
     }
 }

examples/02_Continuous_Mode/ENS211/ENS211.ino

@@ -3,8 +3,6 @@
 
 #include "ens211.h"
 
-using namespace ScioSense;
-
 ENS211 ens211;
 
 void setup()
@@ -14,20 +12,19 @@ void setup()
 
     Wire.begin();
     ens211.begin();
+    ens211.init();
 
     if (ens211.isConnected() == false)
     {
         Serial.println("Error -- The ENS211 is not connected.");
         while(1);
     }
 
-    ens211.reset();
-
     Serial.print("Starting continous mode..");
-    while (ens211.startContinuousMeasure() != ENS211::Result::STATUS_OK)
+    while (ens211.startContinuousMeasure() != RESULT_OK)
     {
         Serial.print(".");
-        delay(ENS211::SystemTiming::BOOTING);
+        delay(ENS21X_SYSTEM_TIMING_BOOTING);
     }
     Serial.println(" Done!");
 
@@ -37,7 +34,9 @@ void setup()
 
 void loop()
 {
-    if (ens211.update() == ENS211::Result::STATUS_OK)
+    ens211.wait();
+
+    if (ens211.update() == RESULT_OK)
     {
         float temperatureCelsius = ens211.getTempCelsius();
         float humidityPercent    = ens211.getHumidityPercent();
@@ -49,6 +48,5 @@ void loop()
         Serial.print("Humidity:");
         Serial.print(humidityPercent);
         Serial.println("%");
-        ens211.getStatusH();
     }
 }