GY-63_MS5611/libraries/BH1750FVI_RT/BH1750FVI.h

#pragma once
//
//    FILE: BH1750FVI.h
//  AUTHOR: Rob dot Tillaart at gmail dot com
// VERSION: 0.2.9
// PURPOSE: Arduino library for BH1750FVI (GY-30) lux sensor
// HISTORY: See BH1750FVI.cpp
//


//  breakout BH1750FVI / GY-30
//
//      +-----------------------+
//  GND |o                      |
//  ADD |o                      |
//  SDA |o            +         |  + = sensor
//  SCL |o                      |
//  VCC |o                      |
//      +-----------------------+
//
// ADD = ADDRESS:
//   0 = 0x23
//   1 = 0x5C
//


#include "Wire.h"
#include "Arduino.h"


#define BH1750FVI_LIB_VERSION                 (F("0.2.9"))


#define BH1750FVI_DEFAULT_ADDRESS             0x23
#define BH1750FVI_ALT_ADDRESS                 0x5C


// COMMANDS P5          
#define BH1750FVI_POWER_ON                    0x00
#define BH1750FVI_POWER_OFF                   0x01
#define BH1750FVI_RESET                       0x07
#define BH1750FVI_CONT_HIGH                   0x10
#define BH1750FVI_CONT_HIGH2                  0x11
#define BH1750FVI_CONT_LOW                    0x13
#define BH1750FVI_ONCE_HIGH                   0x20
#define BH1750FVI_ONCE_HIGH2                  0x21
#define BH1750FVI_ONCE_LOW                    0x23

#define BH1750FVI_REFERENCE_TIME              0x45   // 69

#define BH1750FVI_MODE_LOW                    0x00
#define BH1750FVI_MODE_HIGH                   0x01
#define BH1750FVI_MODE_HIGH2                  0x02


// ERROR CODES
#define BH1750FVI_OK                          0
#define BH1750FVI_ERROR_WIRE_REQUEST          -10


class BH1750FVI
{
public:

#if defined(ESP8266) || defined(ESP32)
  // dataPin and clockPin can be used for ESP8266
  BH1750FVI(const uint8_t address , const uint8_t dataPin, const uint8_t clockPin);
#endif

  BH1750FVI(const uint8_t address, TwoWire *wire = &Wire);
  // returns true if isConnected()
  bool    begin();       // resets to constructor defaults. (use with care)

  bool    isConnected(); // returns true if address is on I2C bus


  float   getRaw();      // no HIGH2 mode + no sensitivity factor.
  float   getLux();
  int     getError();


  void    powerOn()          { command(BH1750FVI_POWER_ON); };
  void    powerOff()         { command(BH1750FVI_POWER_OFF); };
  void    reset()            { command(BH1750FVI_RESET); };


  //      MODE        TIME        RESOLUTION
  //   2  HIGH2       120 ms      0.5 lux        // recommended max * 1.5 = 180 ms
  //   1  HIGH        120 ms      1.0 lux
  //   0  LOW          16 ms      4.0 lux
  uint8_t getMode()          { return _mode; };


  void    setContHighRes();
  void    setContHigh2Res();
  void    setContLowRes();


  void    setOnceHighRes();
  void    setOnceHigh2Res();
  void    setOnceLowRes();
  bool    isReady();          // only after setOnce...Res();


  // read datasheet P11 about details of the correction or sensitivity factor
  // to be used for very high and very low brightness
  // or to correct for e.g. transparency
  void    changeTiming(uint8_t time = BH1750FVI_REFERENCE_TIME);   // 69 is default
  // returns changeTiming() parameter


  uint8_t setCorrectionFactor(float factor = 1);  // 0.45 .. 3.68
  // returns percentage set.
  float   getCorrectionFactor();


  // read datasheet P3 and check figure 4 and 5.
  // setAngle is constrained to -89..+89
  // returns the angle correction factor
  float   setAngle(int degrees = 0);
  int     getAngle() { return _angle; };


  // datasheet P3 figure 7
  // Effect of temperature is about 3% / 60<36>C ~~ 1% / 20<32>C
  // to be used if temp is really hot or cold.
  // returns the temperature correction factor
  float   setTemperature(int temp = 20);
  int     getTemperature() { return _temp; };


  // datasheet Page 3 figure 1  (experimental correction)
  // Effect of wavelength can be substantial, 
  // correction is calculated by multiple linear approximations.
  // wavelength of 580 ==> correction == 1
  // returns the wavelength correction factor
  float   setWaveLength(int waveLength = 580);
  int     getWaveLength() { return _waveLength; };


private:
  uint16_t  readData();
  void      command(uint8_t value);

  uint8_t   _address;
  uint16_t  _data;
  int       _error;
  uint8_t   _sensitivityFactor;
  uint8_t   _mode;

  uint32_t  _requestTime        = 0;
  float     _angleFactor        = 1;
  int       _angle              = 0;
  float     _tempFactor         = 1;
  int       _temp               = 20;
  float     _waveLengthFactor   = 1;
  int       _waveLength         = 580;

  TwoWire*  _wire;
};


// -- END OF FILE --