adt7420.h

Go to the documentation of this file.

/***************************************************************************/
#ifndef __ADT7420_H__
#define __ADT7420_H__
 
/******************************************************************************/
/***************************** Include Files **********************************/
/******************************************************************************/
 
#include "no_os_spi.h"
#include "no_os_i2c.h"
#include "no_os_util.h"
#include <stdbool.h>
 
/******************************************************************************/
/************************** ADT7420 Definitions *******************************/
/******************************************************************************/
 
/* ADT7420 address */
#define ADT7420_A0_PIN(x)       (((x) & 0x1) << 0) // I2C Serial Bus Address Selection Pin
#define ADT7420_A1_PIN(x)       (((x) & 0x1) << 1) // I2C Serial Bus Address Selection Pin
#define ADT7420_ADDRESS(x,y)        (0x48 + ADT7420_A1_PIN(x) + ADT7420_A0_PIN(y))
 
/* ADT7320  (SPI) registers */
#define ADT7320_REG_STATUS      0x00 // Status
#define ADT7320_REG_CONFIG      0x01 // Configuration
#define ADT7320_REG_TEMP            0x02 // Temperature value
#define ADT7320_REG_ID          0x03 // ID
#define ADT7320_REG_T_CRIT      0x04 // Temperature CRIT setpoint (147'C)
#define ADT7320_REG_HIST        0x05 // Temperature HYST setpoint (5'C)
#define ADT7320_REG_T_HIGH          0x06 // Temperature HIGH setpoint (64'C)
#define ADT7320_REG_T_LOW           0x07 // Temperature LOW setpoint (10'C)
 
/* ADT7320 SPI command byte */
#define ADT7320_WRITE_MASK_CMD      0b00111000 // SPI write command
#define ADT7320_READ_CMD        0b01000000 // SPI read command
 
/* ADT7420 (I2C) registers */
#define ADT7420_REG_TEMP_MSB        0x00 // Temperature value MSB
#define ADT7420_REG_TEMP_LSB        0x01 // Temperature value LSB
#define ADT7420_REG_STATUS      0x02 // Status
#define ADT7420_REG_CONFIG      0x03 // Configuration
#define ADT7420_REG_T_HIGH_MSB      0x04 // Temperature HIGH setpoint MSB
#define ADT7420_REG_T_HIGH_LSB      0x05 // Temperature HIGH setpoint LSB
#define ADT7420_REG_T_LOW_MSB       0x06 // Temperature LOW setpoint MSB
#define ADT7420_REG_T_LOW_LSB       0x07 // Temperature LOW setpoint LSB
#define ADT7420_REG_T_CRIT_MSB      0x08 // Temperature CRIT setpoint MSB
#define ADT7420_REG_T_CRIT_LSB      0x09 // Temperature CRIT setpoint LSB
#define ADT7420_REG_HIST        0x0A // Temperature HYST setpoint
#define ADT7420_REG_ID          0x0B // ID
#define ADT7420_REG_RESET       0x2F // Software reset
 
/* ADT7420_REG_STATUS definition */
#define ADT7420_STATUS_T_LOW        NO_OS_BIT(4)
#define ADT7420_STATUS_T_HIGH       NO_OS_BIT(5)
#define ADT7420_STATUS_T_CRIT       NO_OS_BIT(6)
#define ADT7420_STATUS_RDY      NO_OS_BIT(7)
 
/* ADT7420_REG_CONFIG definition */
#define ADT7420_CONFIG_OP_MODE(x)   ((x) << 5) & (NO_OS_GENMASK(6,5))
#define ADT7420_CONFIG_RESOLUTION   NO_OS_BIT(7)
 
/* ADT7420_CONFIG_OP_MODE(x) options */
#define ADT7420_OP_MODE_CONT_CONV   0
#define ADT7420_OP_MODE_ONE_SHOT    1
#define ADT7420_OP_MODE_1_SPS       2
#define ADT7420_OP_MODE_SHUTDOWN    3
 
/* ADT7420 default ID */
#define ADT7xxx_ID          0xC
 
 
/******************************************************************************/
/*************************** Types Declarations *******************************/
/******************************************************************************/
 
enum dev_interface {
    SPI,
    I2C,
};
 
struct adt7420_chip_info {
    uint8_t         resolution;
    enum dev_interface  communication;
};
 
enum adt7420_type {
    ID_ADT7410,
    ID_ADT7420,
    ID_ADT7422,
    ID_ADT7310,
    ID_ADT7311,
    ID_ADT7312,
    ID_ADT7320
};
 
struct adt7420_dev {
    /* I2C */
    no_os_i2c_desc  *i2c_desc;
    /* SPI */
    no_os_spi_desc  *spi_desc;
    /* Device Settings */
    enum adt7420_type active_device;
    /* Device Settings */
    uint8_t     resolution_setting;
 
};
 
struct adt7420_init_param {
    union interface_type {
        /* I2C */
        no_os_i2c_init_param    i2c_init;
        /* SPI */
        no_os_spi_init_param    spi_init;
    } interface_init;
    /* Device Settings */
    uint8_t     resolution_setting;
    /* Device Settings */
    enum adt7420_type   active_device;
};
 
extern const struct adt7420_chip_info chip_info[];
 
/******************************************************************************/
/************************ Functions Declarations ******************************/
/******************************************************************************/
 
uint16_t adt7420_get_register_value(struct adt7420_dev *dev,
                    uint8_t register_address);
uint16_t set_shift_reg(struct adt7420_dev *dev,
               uint8_t register_address,
               uint8_t *data) ;
 
int32_t set_register_value(struct adt7420_dev *dev,
               uint8_t register_address,
               uint8_t num_data_bytes,
               uint8_t *data, uint8_t mask, uint8_t value);
 
int32_t adt7420_init(struct adt7420_dev **device,
             struct adt7420_init_param init_param);
 
/* Free the resources allocated by adt7420_init(). */
int32_t adt7420_remove(struct adt7420_dev *dev);
 
void adt7420_set_operation_mode(struct adt7420_dev *dev,
                uint8_t mode);
 
void adt7420_set_resolution(struct adt7420_dev *dev,
                uint8_t resolution);
 
int32_t adt7420_reset(struct adt7420_dev *dev);
 
float adt7420_get_temperature(struct adt7420_dev *dev);
 
uint16_t adt7420_i2c_get_register_value(struct adt7420_dev *dev,
                    uint8_t register_address);
 
uint16_t adt7420_spi_get_register_value(struct adt7420_dev *dev,
                    uint8_t register_address);
 
bool adt7420_is_spi(struct adt7420_dev *dev);
 
#endif  /* __ADT7420_H__ */