0.1.3 SHT85

Author: RobTillaart

libraries/SHT85/README.md

@@ -27,8 +27,8 @@ not be used for more than 10% of the time.
 ```
 
 The SHT85 sensors should work up to 1000 KHz, however during tests 
-with an Arduino UNO it stopped at ~500 KHz so to be safe I recommend
-not to use it above 400 KHz. Also the differences in readtime becomes
+with an Arduino UNO it stopped between 500 - 550 KHz so to be safe I recommend
+not to use it above 400 KHz. Also the differences in read time becomes
 quite small. (max 15% gain). See output example sketch.
 
 | I2C speed | read ms | notes |
@@ -51,11 +51,11 @@ This library should also work for SHT30, SHT31 and SHT35 but
 this is not verified yet.
 
 | SENSOR | Temperature accuracy | Humidity accuracy |
-|:----:|:----:|:----:|
-| SHT30 | ~0.3 | 2.0 |
-| SHT31 | ~0.3 | 1.5 |
-| SHT35 | ~0.2 | 1.5 |
-| SHT85 | ~0.2 | 1.5 |
+|:------:|:------:|:-----:|
+| SHT30  |  ~0.3  |  2.0  |
+| SHT31  |  ~0.3  |  1.5  |
+| SHT35  |  ~0.2  |  1.5  |
+| SHT85  |  ~0.2  |  1.5  |
 
 Need to investigate if the interface is identical?
 If so the libraries might  be merged.
@@ -75,15 +75,18 @@ Does read both the temperature and humidity.
 - **uint16_t readStatus()** details see datasheet and **Status fields** below
 - **uint32_t lastRead()** in milliSeconds since start of program.
 - **reset(bool hard = false)** resets the sensor, soft reset by default. Returns false if fails.
-- **getHumidity()** returns relative humidity in %. Needs a **read()** to update.
-- **getTemperature()** returns temperature in °C. Needs a **read()** to update.
+- **getHumidity()** computes the relative humidity in % based off the latest raw reading, and returns it
+- **getTemperature()** computes the temperature in °C based off the latest raw reading, and returns it
+- **getRawHumidity()** returns the raw two-byte representation of humidity directly from the sensor
+- **getRawTemperature()** returns the raw two-byte representation of temperature directly from the sensor
+
+Note that the temperature and humidity values are recalculated on every call to getHumidity() and getTemperature(). If you're worried about the extra cycles, you should make sure to cache these values or only request them after you've performed a new reading.
 
 
 #### Error interface
 
 - **getError()** returns last set error flag and clear it. 
-Be sure to clear the error flag by calling **getError()** before calling 
-any command as the error flag could be from a previous command.
+Be sure to clear the error flag by calling **getError()** before calling any command as the error flag could be from a previous command.
 
 | Error | Symbolic | Description |
 |:----:|:----|:----|
@@ -97,7 +100,6 @@ any command as the error flag could be from a previous command.
 | 0x87 | SHT_ERR_CRC_STATUS  | CRC error in statusfield    |
 
 
-
 #### Heater interface
 
 Use the heater for max **180** seconds, and let it cool down an equal period of time.
@@ -121,16 +123,16 @@ Will switch heat off if max heating time has passed.
 See async example for usage
 
 - **requestData()** requests a new measurement. Returns false if this fails.
-- **dataReady()** checks if enough time has passed to read the data. (typical 15 millis)
+- **dataReady()** checks if enough time has passed to read the data. (15 milliseconds)
 - **readData(bool fast = true)** fast skips CRC check. Returns false if reading fails or in case of a CRC fail. 
 
 
 ## Status fields
 
 | BIT | Description | values |
 |:----:|:----|:----|
-| 15  | Alert pending status       | '0': no pending alerts|
-|     |                            | '1': at least one pending alert - default |
+| 15  | Alert pending status       | '0' : no pending alerts|
+|     |                            | '1' : at least one pending alert - default |
 | 14  | Reserved                   | '0' |
 | 13  | Heater status              | '0’ : Heater OFF - default |
 |     |                            | '1’ : Heater ON |
@@ -140,22 +142,22 @@ See async example for usage
 | 10  | Temperature tracking alert | '0’ : no alert - default |
 |     |                            | '1’ : alert |
 | 9-5 | Reserved                   | '00000' |
-|  4  | System reset detected      | '0': no reset since last ‘clear status register’ command |
-|     |                            | '1': reset detected (hard or soft reset command or supply fail) - default |
+|  4  | System reset detected      | '0' : no reset since last ‘clear status register’ command |
+|     |                            | '1' : reset detected (hard or soft reset command or supply fail) - default |
 | 3-2 | Reserved                   | '00' |
-|  1  | Command status             | '0': last cmd executed successfully |
-|     |                            | '1': last cmd not processed. Invalid or failed checksum |
-| 0   | Write data checksum status | '0': checksum of last write correct |
-|     |                            | '1': checksum of last write transfer failed |
+|  1  | Command status             | '0' : last command executed successfully |
+|     |                            | '1' : last command not processed. Invalid or failed checksum |
+| 0   | Write data checksum status | '0' : checksum of last write correct |
+|     |                            | '1' : checksum of last write transfer failed |
 
 
 ## Future
 
 - verify working with ESP32
 - merge with other SHT sensors if possible
+- SHT_BASE class ?
 - investigate command ART (auto sampling at 4 Hz)
 - investigate command BREAK (stop auto sampling)
-- direct Fahrenheit formula 
 
 
 ## Operation

libraries/SHT85/SHT85.cpp

@@ -1,7 +1,7 @@
 //
 //    FILE: SHT85.cpp
 //  AUTHOR: Rob Tillaart
-// VERSION: 0.1.2
+// VERSION: 0.1.3
 //    DATE: 2021-02-10
 // PURPOSE: Arduino library for the SHT85 temperature and humidity sensor
 //          https://nl.rs-online.com/web/p/temperature-humidity-sensor-ics/1826530
@@ -11,7 +11,8 @@
 //  HISTORY:
 //  0.1.0   2021-02-10  initial version
 //  0.1.1   2021-03-13  initial release
-//  0.1.2   2021-05-27  fix arduino-lint
+//  0.1.2   2021-05-27  fix Arduino-lint
+//  0.1.3   2021-08-06  expose raw data from sensor
 
 
 #include "SHT85.h"
@@ -33,12 +34,12 @@
 
 SHT85::SHT85()
 {
-  _addr        = 0;
-  _lastRead    = 0;
-  temperature  = 0;
-  humidity     = 0;
-  _heaterStart = 0;
-  _error       = SHT_OK;
+  _addr           = 0;
+  _lastRead       = 0;
+  _rawTemperature = 0;
+  _rawHumidity    = 0;
+  _heaterStart    = 0;
+  _error          = SHT_OK;
 }
 
 
@@ -118,8 +119,8 @@ bool SHT85::isConnected()
 //    '1': reset detected (hard or soft reset command or supply fail) - default
 // 3:2 Reserved ‘00’
 // 1 Command status
-//    '0': last cmd executed successfully
-//    '1': last cmd not processed. Invalid or failed checksum
+//    '0': last command executed successfully
+//    '1': last command not processed. Invalid or failed checksum
 // 0 Write data checksum status
 //    '0': checksum of last write correct
 //    '1': checksum of last write transfer failed
@@ -247,10 +248,8 @@ bool SHT85::readData(bool fast)
     }
   }
 
-  uint16_t raw = (buffer[0] << 8) + buffer[1];
-  temperature = raw * (175.0 / 65535) - 45;
-  raw = (buffer[3] << 8) + buffer[4];
-  humidity = raw * (100.0 / 65535);
+  _rawTemperature = (buffer[0] << 8) + buffer[1];
+  _rawHumidity    = (buffer[3] << 8) + buffer[4];
 
   _lastRead = millis();
 

libraries/SHT85/SHT85.h

@@ -2,7 +2,7 @@
 //
 //    FILE: SHT85.h
 //  AUTHOR: Rob Tillaart
-// VERSION: 0.1.2
+// VERSION: 0.1.3
 //    DATE: 2021-02-10
 // PURPOSE: Arduino library for the SHT85 temperature and humidity sensor
 //          https://nl.rs-online.com/web/p/temperature-humidity-sensor-ics/1826530
@@ -12,7 +12,7 @@
 // keep lib in sync with https://github.com/RobTillaart/SHT31
 
 
-// TOPVIEW
+// TOPVIEW      SHT85
 //            +-------+
 // +-----\    | SDA 4 -----
 // | +-+  ----+ VCC 3 -----
@@ -25,7 +25,7 @@
 #include "Wire.h"
 
 
-#define SHT85_LIB_VERSION           (F("0.1.2"))
+#define SHT85_LIB_VERSION           (F("0.1.3"))
 
 
 // fields readStatus
@@ -61,7 +61,7 @@ class SHT85
   // blocks 15 milliseconds + actual read + math
   bool read(bool fast = true);
 
-  // check senosr is reachable over I2C
+  // check sensor is reachable over I2C
   bool isConnected();
 
   // details see datasheet; summary in SHT31.cpp file
@@ -80,8 +80,11 @@ class SHT85
   bool heatOff();
   bool isHeaterOn();  // is the sensor still heating up?
 
-  float getHumidity() { return humidity; };
-  float getTemperature() { return temperature; };
+  float getHumidity() { return _rawHumidity * (100.0 / 65535); };
+  float getTemperature() { return _rawTemperature * (175.0 / 65535) - 45; };
+  // float getFahrenheit() { return _rawTemperature * (63.0 /13107.0) - 49; };
+  uint16_t getRawHumidity() {return _rawHumidity; };
+  uint16_t getRawTemperature() {return _rawTemperature; };
 
   // ASYNC INTERFACE
   bool requestData();
@@ -90,20 +93,21 @@ class SHT85
 
   int getError(); // clears error flag
 
+
 private:
-  uint8_t crc8(const uint8_t *data, uint8_t len);
-  bool writeCmd(uint16_t cmd);
-  bool readBytes(uint8_t n, uint8_t *val);
+  uint8_t  crc8(const uint8_t *data, uint8_t len);
+  bool     writeCmd(uint16_t cmd);
+  bool     readBytes(uint8_t n, uint8_t *val);
   TwoWire* _wire;
 
-  uint8_t   _addr;
-  uint8_t   _heatTimeOut;   // seconds
-  uint32_t  _lastRead;
-  uint32_t  _lastRequest;   // for async interface
-  uint32_t  _heaterStart;
+  uint8_t  _addr;
+  uint8_t  _heatTimeOut;   // seconds
+  uint32_t _lastRead;
+  uint32_t _lastRequest;   // for async interface
+  uint32_t _heaterStart;
 
-  float humidity;
-  float temperature;
+  uint16_t _rawHumidity;
+  uint16_t _rawTemperature;
 
   uint8_t _error;
 };

libraries/SHT85/keywords.txt

@@ -24,6 +24,8 @@ requestData	KEYWORD2
 dataReady	KEYWORD2
 readData	KEYWORD2
 
+getRawHumidity	KEYWORD2
+getRawTemperature	KEYWORD2
 
 # Instances (KEYWORD2)
 

libraries/SHT85/library.json

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

libraries/SHT85/library.properties

@@ -1,5 +1,5 @@
 name=SHT85
-version=0.1.2
+version=0.1.3
 author=Rob Tillaart <[email protected]>
 maintainer=Rob Tillaart <[email protected]>
 sentence=Arduino library for the SHT85 temperature and humidity sensor

libraries/SHT85/test/unit_test_001.cpp

@@ -29,7 +29,6 @@
   It appears that Wire.write does not fail without sensor...
 */
 
-
 #include <ArduinoUnitTests.h>
 
 #include "Arduino.h"
@@ -39,7 +38,6 @@ int expect;  // TODO needed as there seems a problem with 8 bit comparisons (cha
 
 uint32_t start, stop;
 
-
 unittest_setup()
 {
 }
@@ -63,10 +61,14 @@ unittest(test_begin)
 
   Serial.println(sht.getTemperature());
   Serial.println(sht.getHumidity());
+  Serial.println(sht.getRawTemperature());
+  Serial.println(sht.getRawHumidity());
 
   // default value == 0
-  assertEqual(0, sht.getTemperature());
+  assertEqual(-45, sht.getTemperature());
   assertEqual(0, sht.getHumidity());
+  assertEqual(0, sht.getRawTemperature());
+  assertEqual(0, sht.getRawHumidity());
 }
 
 
@@ -162,5 +164,4 @@ unittest(test_async)
 
 unittest_main()
 
-
-// --------
+// --------