0.3.1 DHT12

Author: RobTillaart

libraries/DHT12/.arduino-ci.yml

@@ -2,6 +2,10 @@ compile:
   # Choosing to run compilation tests on 2 different Arduino platforms
   platforms:
     - uno
-    - leonardo
-    - due
-    - zero
+    # - due
+    # - zero
+    # - leonardo
+    - m4
+    - esp32
+    # - esp8266
+    # - mega2560

libraries/DHT12/.github/workflows/arduino_test_runner.yml

@@ -4,10 +4,14 @@ name: Arduino CI
 on: [push, pull_request]
 
 jobs:
-  arduino_ci:
+  runTest:
     runs-on: ubuntu-latest
 
     steps:
       - uses: actions/checkout@v2
-      - uses: Arduino-CI/action@master
-          #   Arduino-CI/[email protected]
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 2.6
+      - run: |
+          gem install arduino_ci
+          arduino_ci.rb

libraries/DHT12/DHT12.cpp

@@ -5,15 +5,16 @@
 // PURPOSE: I2C library for DHT12 for Arduino.
 //
 // HISTORY:
-//   0.1.0: 2017-12-11  initial version
-//   0.1.1: 2017-12-19  added ESP8266 - issue #86
+//  0.1.0   2017-12-11  initial version
+//  0.1.1   2017-12-19  added ESP8266 - issue #86
 //                      Verified by Viktor Balint
-//   0.1.2: 2018-09-02  fix negative temperature DHT12 - issue #111
-//   0.2.0  2020-04-11  explicit constructors, select other Wire interface, #pragma once
-//   0.2.1  2020-06-07  fix library.json
-//   0.3.0  2020-12-19  add arduino-CI + unit test
+//  0.1.2   2018-09-02  fix negative temperature DHT12 - issue #111
+//  0.2.0   2020-04-11  explicit constructors, select other Wire interface, 
+//                      #pragma once
+//  0.2.1   2020-06-07  fix library.json
+//  0.3.0   2020-12-19  add Arduino-CI + unit test
 //                      temperature and humidity made private
-//
+//  0.3.1   2021-10-25  add lastRead, update Arduino-CI, badges
 
 
 #include "DHT12.h"
@@ -68,6 +69,8 @@ int8_t DHT12::read()
   uint8_t checksum = _bits[0] + _bits[1] + _bits[2] + _bits[3];
   if (_bits[4] != checksum) return DHT12_ERROR_CHECKSUM;
 
+  _lastRead = millis();
+  
   return DHT12_OK;
 }
 
@@ -95,4 +98,5 @@ int DHT12::_readSensor()
   return bytes;
 }
 
+
 // -- END OF FILE --

libraries/DHT12/DHT12.h

@@ -3,21 +3,23 @@
 //    FILE: DHT12.h
 //  AUTHOR: Rob Tillaart
 // PURPOSE: DHT_I2C library for Arduino .
-// VERSION: 0.3.0
+// VERSION: 0.3.1
 // HISTORY: See DHT12.cpp
 //     URL: https://github.com/RobTillaart/DHT12
 //
 
+
 #include "Arduino.h"
 #include "Wire.h"
 
-#define DHT12_LIB_VERSION      "0.3.0"
+#define DHT12_LIB_VERSION      "0.3.1"
 
 #define DHT12_OK               0
 #define DHT12_ERROR_CHECKSUM  -10
 #define DHT12_ERROR_CONNECT   -11
 #define DHT12_MISSING_BYTES   -12
 
+
 class DHT12
 {
 public:
@@ -37,16 +39,19 @@ class DHT12
   void     setTempOffset(float offset) { _tempOffset = offset; };
   float    getHumOffset()              { return _humOffset; };
   float    getTempOffset()             { return _tempOffset; };
+  uint32_t lastRead()                  { return _lastRead; };
 
 private:
   float    _humidity;
   float    _temperature;
   float    _humOffset;
   float    _tempOffset;
   uint8_t  _bits[5];
+  uint32_t _lastRead;
 
   int      _readSensor();
   TwoWire* _wire;
 };
 
+
 // -- END OF FILE --

libraries/DHT12/README.md

@@ -1,5 +1,7 @@
 
 [![Arduino CI](https://github.com/RobTillaart/DHT12/workflows/Arduino%20CI/badge.svg)](https://github.com/marketplace/actions/arduino_ci)
+[![Arduino-lint](https://github.com/RobTillaart/DHT12/actions/workflows/arduino-lint.yml/badge.svg)](https://github.com/RobTillaart/DHT12/actions/workflows/arduino-lint.yml)
+[![JSON check](https://github.com/RobTillaart/DHT12/actions/workflows/jsoncheck.yml/badge.svg)](https://github.com/RobTillaart/DHT12/actions/workflows/jsoncheck.yml)
 [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/RobTillaart/DHT12/blob/master/LICENSE)
 [![GitHub release](https://img.shields.io/github/release/RobTillaart/DHT12.svg?maxAge=3600)](https://github.com/RobTillaart/DHT12/releases)
 
@@ -8,38 +10,46 @@
 
 Arduino library for I2C DHT12 temperature and humidity sensor.
 
+
 ## Description
 
 The library should be initiated by calling the **begin()** function, 
-optionally **begin(datapin, clockpin)** for **ESP32** and similar platforms.
+optionally **begin(dataPin, clockPin)** for **ESP32** and similar platforms.
 
 Thereafter one has to call the **read()** function to do the actual reading,
 and with **getTemperature()** and **getHumidity()** to get the read values.
 Calling these latter again will return the same values until a new **read()** is called.
 
+
 ## Interface
 
+
 ### Constructor
 - **DHT12(TwoWire \*wire)** constructor, using a specific Wire (I2C bus).
-- **begin(dataPin, clockPin)** begin for ESP32 et al, to set I2C bus pins
+- **begin(uint8_t dataPin, uint8_t clockPin)** begin for ESP32 et al, to set I2C bus pins
 - **begin()** initializer for non ESP32.
 
+
 ### Core
-- **read()** read the sensor and store the values intenally. It returns the status of the read which should be 0.
-- **getHumidity()** returns last Humidity read, or -999 in case of error.
-- **getTemperature()** returns last Temperature read, or -999 in case of error.
+- **int8_t read()** read the sensor and store the values internally. It returns the status of the read which should be 0.
+- **float getHumidity()** returns last Humidity read, or -999 in case of error.
+- **float getTemperature()** returns last Temperature read, or -999 in case of error.
+- **uint32_t lastRead()** returns the timestamp in milliseconds since startup of the last successful read. (added in 0.3.1)
+
 
 ### Offset
 - **void setHumOffset(float offset)** set an offset to calibrate (1st order) the sensor.
 - **float getHumOffset()** return current offset, default 0.
 - **void setTempOffset(float offset)** set an offset to calibrate (1st order) the sensor
 - **float getTempOffset()** return current offset, default 0.
-  
+
+
 ### version 0.3.0
 
 - The members **temperature** and **humidity** became private in 0.3.0.
 - added offset for temperature and humidity.
 
+
 ## Operation
 
 See examples

libraries/DHT12/examples/DHT12/DHT12.ino

@@ -1,18 +1,21 @@
 //
 //    FILE: DHT12.ino
 //  AUTHOR: Rob Tillaart
-// VERSION: 0.3.0
+// VERSION: 0.3.1
 // PURPOSE: Demo for DHT12 I2C humidity & temperature sensor
 //
-// HISTORY:
-// 0.1.0    2017-12-11  initial version
-// 0.1.1    2020-04-11  minor changes
-// 0.3.0    2020-12-19  compatible new version
+//  HISTORY:
+//  0.1.0  2017-12-11  initial version
+//  0.1.1  2020-04-11  minor changes
+//  0.3.0  2020-12-19  compatible new version
+//  0.3.1  2021-10-25  add lastRead
+
 
 #include "DHT12.h"
 
 DHT12 DHT(&Wire);
 
+
 void setup()
 {
   DHT.begin();
@@ -28,35 +31,38 @@ void setup()
   Serial.println("Type,\tStatus,\tHumidity (%),\tTemperature (C)");
 }
 
+
 void loop()
 {
-  // READ DATA
-  Serial.print("DHT12, \t");
-  int status = DHT.read();
-  switch (status)
+  if (millis() - DHT.lastRead() >= 2000)
   {
-  case DHT12_OK:
-    Serial.print("OK,\t");
-    break;
-  case DHT12_ERROR_CHECKSUM:
-    Serial.print("Checksum error,\t");
-    break;
-  case DHT12_ERROR_CONNECT:
-    Serial.print("Connect error,\t");
-    break;
-  case DHT12_MISSING_BYTES:
-    Serial.print("Missing bytes,\t");
-    break;
-  default:
-    Serial.print("Unknown error,\t");
-    break;
+    // READ DATA
+    Serial.print("DHT12, \t");
+    int status = DHT.read();
+    switch (status)
+    {
+    case DHT12_OK:
+      Serial.print("OK,\t");
+      break;
+    case DHT12_ERROR_CHECKSUM:
+      Serial.print("Checksum error,\t");
+      break;
+    case DHT12_ERROR_CONNECT:
+      Serial.print("Connect error,\t");
+      break;
+    case DHT12_MISSING_BYTES:
+      Serial.print("Missing bytes,\t");
+      break;
+    default:
+      Serial.print("Unknown error,\t");
+      break;
+    }
+    // DISPLAY DATA, sensor has only one decimal.
+    Serial.print(DHT.getHumidity(), 1);
+    Serial.print(",\t");
+    Serial.println(DHT.getTemperature(), 1);
   }
-  // DISPLAY DATA, sensor has only one decimal.
-  Serial.print(DHT.getHumidity(), 1);
-  Serial.print(",\t");
-  Serial.println(DHT.getTemperature(), 1);
-
-  delay(2000);
 }
 
-// -- END OF FILE --
+
+// -- END OF FILE --

libraries/DHT12/examples/DHT12_plotter/DHT12_plotter.ino

@@ -1,32 +1,38 @@
 //
 //    FILE: DHT12 _plotter.ino
 //  AUTHOR: Rob Tillaart
-// VERSION: 0.3.0
+// VERSION: 0.3.1
 // PURPOSE: Demo for DHT12 I2C humidity & temperature sensor
 //
-// HISTORY:
-// 0.1.0    2020-04-11  initial version
-// 0.3.0    2020-12-19  compatible new version
+//  HISTORY:
+//  0.1.0  2020-04-11  initial version
+//  0.3.0  2020-12-19  compatible new version
+//  0.3.1  2021-10-25  add lastRead
+
 
 #include "DHT12.h"
 
 DHT12 DHT(&Wire);
 
+
 void setup()
 {
   DHT.begin();
   Serial.begin(115200);
   Serial.println("Humidity, Temperature");
 }
 
+
 void loop()
 {
-  // note no error checking
-  DHT.read();
-  Serial.print(DHT.getHumidity(), 1);
-  Serial.print(", ");
-  Serial.println(DHT.getTemperature(), 1);
-  delay(1000);
+  if (millis() - DHT.lastRead() >= 1000)
+  {
+    // note no error checking
+    DHT.read();
+    Serial.print(DHT.getHumidity(), 1);
+    Serial.print(", ");
+    Serial.println(DHT.getTemperature(), 1);
+  }
 }
 
 // -- END OF FILE --

libraries/DHT12/examples/DHT12_test_esp/DHT12_test_esp.ino

@@ -1,12 +1,13 @@
 //
 //    FILE: DHT12_test_esp.ino
 //  AUTHOR: Rob Tillaart
-// VERSION: 0.3.0
+// VERSION: 0.3.1
 // PURPOSE: Demo for DHT12 I2C humidity & temperature sensor
 //
-// HISTORY:
-// 0.1.0    2020-04-11 initial version
-// 0.3.0    2020-12-19  compatible new version
+//  HISTORY:
+//  0.1.0  2020-04-11  initial version
+//  0.3.0  2020-12-19  compatible new version
+//  0.3.1  2021-10-25  add lastRead
 
 
 #include "DHT12.h"
@@ -34,6 +35,7 @@ void setup()
   Serial.println("Type,\tStatus,\tHumidity (%),\tTemperature (C)");
 }
 
+
 void loop()
 {
   // READ DATA

libraries/DHT12/keywords.txt

@@ -12,6 +12,8 @@ setHumOffset	KEYWORD2
 setTempOffset	KEYWORD2
 getHumOffset	KEYWORD2
 getTempOffset	KEYWORD2
+lastRead	KEYWORD2
+
 
 # Constants (LITERAL1)
 DHT12_VERSION	LITERAL2

libraries/DHT12/library.json

@@ -15,7 +15,7 @@
     "type": "git",
     "url": "https://github.com/RobTillaart/DHT12.git"
   },
-  "version": "0.3.0",
+  "version": "0.3.1",
   "license": "MIT",
   "frameworks": "arduino",
   "platforms": "*"