Diff: th02.h

Revision:

0:7ebf4813882d

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/th02.h	Tue May 01 13:59:00 2018 +0000
@@ -0,0 +1,122 @@
+// **********************************************************************************
+// Driver definition for HopeRF TH02 temperature and humidity sensor
+// **********************************************************************************
+// Creative Commons Attrib Share-Alike License
+// You are free to use/extend this library but please abide with the CC-BY-SA license:
+// http://creativecommons.org/licenses/by-sa/4.0/
+//
+// For any explanation see TH02 sensor information at
+// http://www.hoperf.com/sensor/app/TH02.htm
+//
+// Code based on following datasheet
+// http://www.hoperf.com/upload/sensor/TH02_V1.1.pdf 
+//
+// Written by Charles-Henri Hallard (http://hallard.me)
+//ported to mbed env by Philippe LAURENT (IUT de NICE France)
+//
+// History : V1.00 2014-07-14 - First release
+//           V1.10 2015-04-13 - changed to Wire library instead of I2C
+//
+// All text above must be included in any redistribution.
+//
+// **********************************************************************************
+#ifndef TH02_H
+#define TH02_H
+
+#include <mbed.h>            //
+
+// TH02 I2C Device address
+#define TH02_I2C_ADDR 0x40
+
+// TH02 Registers addresses
+#define TH02_STATUS 0
+#define TH02_DATAh  1
+#define TH02_DATAl  2
+#define TH02_CONFIG 3
+#define TH02_ID     17
+
+// TH02 custom error code return function
+#define TH02_I2C_ERR 0xFF
+
+// Unititialized values (arbitrary)
+#define TH02_UNINITIALIZED_TEMP 55555 // int32_t internal value 
+#define TH02_UNINITIALIZED_RH   1111  // int32_t internal value
+#define TH02_UNDEFINED_VALUE    12345 // int16_t returned value
+
+// we decide error if conversion is >= 50ms 
+#define TH02_CONVERSION_TIME_OUT  50
+
+// Bit definition of TH02 registers values
+#define TH02_STATUS_RDY    0x01
+
+#define TH02_CONFIG_START  0x01
+#define TH02_CONFIG_HEAT   0x02
+#define TH02_CONFIG_TEMP   0x10
+#define TH02_CONFIG_HUMI   0x00
+#define TH02_CONFIG_FAST   0x20
+
+// THO2 Linearization Coefficients
+#define TH02_A0   -4.7844
+#define TH02_A1    0.4008
+#define TH02_A2   -0.00393
+
+// TH02 Temperature compensation Linearization Coefficients
+#define TH02_Q0   0.1973
+#define TH02_Q1   0.00237
+
+
+
+
+
+class TH02 { 
+  public:
+            TH02(uint8_t address);
+    uint8_t getId(uint8_t * pvalue);
+    uint8_t getId(void);
+    uint8_t getStatus(uint8_t * pvalue);
+    bool isConverting(void);
+    uint8_t waitEndConversion(void);
+    uint8_t getConfig(uint8_t * pvalue);
+    uint8_t setConfig(uint8_t config);
+    uint8_t startTempConv(bool fastmode = false, bool heater = false);
+    uint8_t startRHConv(bool fastmode = false, bool heater = false);
+    int16_t roundInt(float value);
+    int16_t getConversionValue(void);
+    int16_t getConpensatedRH(bool round);
+    int32_t getLastRawRH(void);
+    int32_t getLastRawTemp(void);
+
+/**
+  * TH02 constructor
+  *
+  * @param sda  I2C data pin
+  * @param scl  I2C clock pin
+  * @param address I2C slave sensor address
+
+  */
+  TH02(PinName sda, PinName scl, uint8_t address);
+
+  /**
+  * MFRC522 destructor
+  */
+  ~TH02();
+
+
+
+  private:
+I2C             m_I2C;
+    uint8_t writeCommand(uint8_t command, bool release=true);
+    uint8_t writeRegister(uint8_t reg, uint8_t value);
+    uint8_t readRegister(uint8_t reg, uint8_t * value);
+
+    int32_t _last_temp; // Last measured temperature (for linearization)
+    int32_t _last_rh;   // Last measured RH
+    uint8_t _address;   // I2C Module Address
+
+
+
+};
+
+  
+
+#endif
\ No newline at end of file