Adafruit_EMC2101.h

Go to the documentation of this file.

#ifndef _ADAFRUIT_EMC2101_H
#define _ADAFRUIT_EMC2101_H

#include "Arduino.h"
#include <Adafruit_BusIO_Register.h>
#include <Adafruit_I2CDevice.h>
#include <Wire.h>

#define EMC2101_I2CADDR_DEFAULT 0x4C 
#define EMC2101_CHIP_ID 0x16         
#define EMC2101_ALT_CHIP_ID 0x28 
#define EMC2101_WHOAMI 0xFD      

#define EMC2101_INTERNAL_TEMP 0x00 
#define EMC2101_EXTERNAL_TEMP_MSB                                              \
  0x01 
#define EMC2101_EXTERNAL_TEMP_LSB                                              \
  0x10 

#define EMC2101_STATUS 0x02        
#define EMC2101_REG_CONFIG 0x03    
#define EMC2101_REG_DATA_RATE 0x04 
#define EMC2101_TEMP_FORCE 0x0C    
#define EMC2101_TACH_LSB 0x46      
#define EMC2101_TACH_MSB 0x47      
#define EMC2101_TACH_LIMIT_LSB                                                 \
  0x48 
#define EMC2101_TACH_LIMIT_MSB                                                 \
  0x49 
#define EMC2101_FAN_CONFIG 0x4A 
#define EMC2101_FAN_SPINUP 0x4B 
#define EMC2101_REG_FAN_SETTING                                                \
  0x4C 
#define EMC2101_PWM_FREQ 0x4D 
#define EMC2101_PWM_DIV 0x4E  
#define EMC2101_LUT_HYSTERESIS                                                 \
  0x4F 

#define EMC2101_LUT_START 0x50 

#define EMC2101_TEMP_FILTER                                                    \
  0xBF 
#define EMC2101_REG_PARTID 0xFD 
#define EMC2101_REG_MFGID 0xFE  

#define MAX_LUT_SPEED 0x3F 
#define MAX_LUT_TEMP 0x7F  

#define EMC2101_I2C_ADDR 0x4C 
#define EMC2101_FAN_RPM_NUMERATOR                                              \
  5400000               
#define _TEMP_LSB 0.125 


typedef enum {
  EMC2101_RATE_1_16_HZ, 
  EMC2101_RATE_1_8_HZ,  
  EMC2101_RATE_1_4_HZ,  
  EMC2101_RATE_1_2_HZ,  
  EMC2101_RATE_1_HZ,    
  EMC2101_RATE_2_HZ,    
  EMC2101_RATE_4_HZ,    
  EMC2101_RATE_8_HZ,    
  EMC2101_RATE_16_HZ,   
  EMC2101_RATE_32_HZ,   
} emc2101_rate_t;

class Adafruit_EMC2101 {
public:
  Adafruit_EMC2101();
  ~Adafruit_EMC2101();

  bool begin(uint8_t i2c_addr = EMC2101_I2CADDR_DEFAULT, TwoWire *wire = &Wire);

  // Enable/disable & status functions:
  bool LUTEnabled(void);
  bool LUTEnabled(bool enable_lut);

  bool DACOutEnabled(bool enable_dac_out);
  bool DACOutEnabled(void);

  // Accessors:
  float getExternalTemperature(void);
  int8_t getInternalTemperature(void);
  uint16_t getFanRPM(void);

  uint8_t getDutyCycle(void);
  bool setDutyCycle(uint8_t pwm_duty_cycle);

  uint16_t getFanMinRPM(void);
  bool setFanMinRPM(uint16_t min_rpm);

  emc2101_rate_t getDataRate(void);
  bool setDataRate(emc2101_rate_t data_rate);

  bool setLUT(uint8_t index, uint8_t temp_thresh, uint8_t fan_pwm);

  uint8_t getPWMFrequency(void);
  bool setPWMFrequency(uint8_t pwm_freq);

  uint8_t getPWMDivisor(void);
  bool setPWMDivisor(uint8_t pwm_divisor);

  bool configPWMClock(bool clksel, bool clkovr);

  bool setLUTHysteresis(uint8_t hysteresis);
  uint8_t getLUTHysteresis(void);

  bool configFanSpinup(uint8_t spinup_drive, uint8_t spinup_time);
  bool configFanSpinup(bool tach_spinup);

  bool enableForcedTemperature(bool enable_forced);
  bool setForcedTemperature(int8_t forced_temperature);
  int8_t getForcedTemperature(void);

  bool enableTachInput(bool tach_enable);
  bool invertFanSpeed(bool invert_speed);

private:
  bool _init(void);

  Adafruit_I2CDevice *i2c_dev = NULL; 
};

#endif