#pragma once

//    FILE: Max44007.h
//  AUTHOR: Rob Tillaart
// VERSION: 0.2.1
//    DATE: 2022-01-04
// PURPOSE: library for Max44007 lux sensor Arduino
//     URL: https://github.com/RobTillaart/MAX44007


//      breakout MAX44007
//
//          +--------+
//      VCC |o       |
//      GND |o       |
//      SCL |o      o| ADDRESS
//      SDA |o      o| -INT
//          +--------+
//
//  ADDRESS:
//  0 = 0x5A
//  1 = 0x5B
//
//  INT:
//  Connect the INT pin to an pull up resistor
//  0 = interrupt
//  1 = no interrupt
//  connect to an LED or an interrupt pin of an Arduino
//


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


#define MAX44007_LIB_VERSION                  (F("0.2.1"))

#define MAX44007_DEFAULT_ADDRESS              0x5A
#define MAX44007_ALT_ADDRESS                  0x5B


//  REGISTERS
#define MAX44007_INTERRUPT_STATUS             0x00
#define MAX44007_INTERRUPT_ENABLE             0x01
#define MAX44007_CONFIGURATION                0x02
#define MAX44007_LUX_READING_HIGH             0x03
#define MAX44007_LUX_READING_LOW              0x04
#define MAX44007_THRESHOLD_HIGH               0x05
#define MAX44007_THRESHOLD_LOW                0x06
#define MAX44007_THRESHOLD_TIMER              0x07


//  CONFIGURATION MASKS
#define MAX44007_CFG_CONTINUOUS               0x80
#define MAX44007_CFG_MANUAL                   0x40
#define MAX44007_CFG_CDR                      0x08
#define MAX44007_CFG_TIMER                    0x07


//  ERROR CODES
#define MAX44007_OK                           0
#define MAX44007_ERROR_WIRE_REQUEST           -10
#define MAX44007_ERROR_OVERFLOW               -20
#define MAX44007_ERROR_HIGH_BYTE              -30
#define MAX44007_ERROR_LOW_BYTE               -31



class Max44007
{
public:
  Max44007(const uint8_t address = MAX44007_DEFAULT_ADDRESS, TwoWire *wire = &Wire);

  bool    isConnected();
  uint8_t getAddress();


  float   getLux();
  int     getError();


  //      threshold must be between 0 and 188006
  bool    setHighThreshold(const float value);       //  returns false if value out of range
  float   getHighThreshold(void);
  bool    setLowThreshold(const float value);        //  returns false if value out of range
  float   getLowThreshold(void);
  void    setThresholdTimer(const uint8_t value);    //  2 seems practical minimum
  uint8_t getThresholdTimer();


  void    enableInterrupt()    { write(MAX44007_INTERRUPT_ENABLE, 1); };
  void    disableInterrupt()   { write(MAX44007_INTERRUPT_ENABLE, 0); };
  bool    interruptEnabled()   { return read(MAX44007_INTERRUPT_ENABLE) & 0x01; };
  uint8_t getInterruptStatus() { return read(MAX44007_INTERRUPT_STATUS) & 0x01; };


  //  check datasheet for detailed behaviour
  void    setConfiguration(uint8_t);
  uint8_t getConfiguration();
  void    setAutomaticMode();
  void    setContinuousMode();    //  uses more power
  void    clrContinuousMode();    //  uses less power
  //      CDR = Current Divisor Ratio
  //      CDR = 1 ==> only 1/8th is measured
  //      TIM = Time Integration Measurement (table)
  //      000   800ms
  //      001   400ms
  //      010   200ms
  //      011   100ms
  //      100    50ms       manual only
  //      101    25ms       manual only
  //      110    12.5ms     manual only
  //      111     6.25ms    manual only
  void    setManualMode(uint8_t CDR, uint8_t TIM);
  int     getCurrentDivisorRatio();  //  CDR 0/1
  int     getIntegrationTime();      //  TIM in ms (rounded)


  //  TEST the math
  float   convertToLux(uint8_t datahigh, uint8_t datalow);


protected:
  bool    setThreshold(uint8_t reg, float value);
  float   getThreshold(uint8_t reg);

  uint8_t read(uint8_t reg);
  void    write(uint8_t reg, uint8_t value);

  uint8_t _address;
  uint8_t _data;
  int     _error;

  TwoWire* _wire;
};


//  -- END OF FILE --