ad7156.h

Go to the documentation of this file.

/***************************************************************************/
#ifndef __AD7156_H__
#define __AD7156_H__
 
/******************************************************************************/
/***************************** Include Files **********************************/
/******************************************************************************/
#include <stdint.h>
#include "no_os_i2c.h"
 
/******************************************************************************/
/*************************** AD7156 Definitions *******************************/
/******************************************************************************/
#define AD7156_ADDRESS                  0x48
 
#define AD7156_REG_STATUS               0x00
#define AD7156_REG_CH1_DATA_H           0x01
#define AD7156_REG_CH1_DATA_L           0x02
#define AD7156_REG_CH2_DATA_H           0x03
#define AD7156_REG_CH2_DATA_L           0x04
#define AD7156_REG_CH1_AVG_H            0x05
#define AD7156_REG_CH1_AVG_L            0x06
#define AD7156_REG_CH2_AVG_H            0x07
#define AD7156_REG_CH2_AVG_L            0x08
#define AD7156_REG_CH1_SENS_THRSH_H     0x09
#define AD7156_REG_CH1_TMO_THRSH_L      0x0A
#define AD7156_REG_CH1_SETUP            0x0B
#define AD7156_REG_CH2_SENS_THRSH_H     0x0C
#define AD7156_REG_CH2_TMO_THRSH_L      0x0D
#define AD7156_REG_CH2_SETUP            0x0E
#define AD7156_REG_CONFIG               0x0F
#define AD7156_REG_PWR_DWN_TMR          0x10
#define AD7156_REG_CH1_CAPDAC           0x11
#define AD7156_REG_CH2_CAPDAC           0x12
#define AD7156_REG_SERIAL_N3            0x13
#define AD7156_REG_SERIAL_N2            0x14
#define AD7156_REG_SERIAL_N1            0x15
#define AD7156_REG_SERIAL_N0            0x16
#define AD7156_REG_CHIP_ID              0x17
 
#define AD7156_STATUS_PWR_DWN           (1 << 7)
#define AD7156_STATUS_DAC_STEP2         (1 << 6)
#define AD7156_STATUS_OUT2              (1 << 5)
#define AD7156_STATUS_DAC_STEP1         (1 << 4)
#define AD7156_STATUS_OUT1              (1 << 3)
#define AD7156_STATUS_C1_C2             (1 << 2)
#define AD7156_STATUS_RDY2              (1 << 1)
#define AD7156_STATUS_RDY1              (1 << 0)
 
#define AD7156_CH1_SETUP_RANGE(x)       (((x) & 0x3) << 6)
#define AD7156_CH1_SETUP_HYST1          (1 << 4)
#define AD7156_CH1_SETUP_THR1(x)        ((x) & 0xF)
 
#define AD7156_CH2_SETUP_RANGE(x)       (((x) & 0x3) << 6)
#define AD7156_CH2_SETUP_HYST2          (1 << 4)
#define AD7156_CH2_SETUP_THR2(x)        ((x) & 0xF)
 
#define AD7156_CDC_RANGE_2_PF           0
#define AD7156_CDC_RANGE_0_5_PF         1
#define AD7156_CDC_RANGE_1_PF           2
#define AD7156_CDC_RANGE_4_PF           3
 
#define AD7156_CONFIG_THR_FIXED         (1 << 7)
#define AD7156_CONFIG_THR_MD(x)         (((x) & 0x3) << 5)
#define AD7156_CONFIG_EN_CH1            (1 << 4)
#define AD7156_CONFIG_EN_CH2            (1 << 3)
#define AD7156_CONFIG_MD(x)             ((x) & 0x7)
 
#define AD7156_ADAPTIVE_THRESHOLD       0
#define AD7156_FIXED_THRESHOLD          1
 
#define AD7156_THR_MODE_NEGATIVE        0
#define AD7156_THR_MODE_POSITIVE        1
#define AD7156_THR_MODE_IN_WINDOW       2
#define AD7156_THR_MODE_OU_WINDOW       3
 
#define AD7156_CONV_MODE_IDLE            0
#define AD7156_CONV_MODE_CONT_CONV       1
#define AD7156_CONV_MODE_SINGLE_CONV     2
#define AD7156_CONV_MODE_PWR_DWN         3
 
#define AD7156_PWR_DWN_TMR_TIMEOUT(x)   (((x) & 0x3F) | (1 << 6))
 
#define AD7156_CH1_CAPDAC_DAC_EN1       (1 << 7)
#define AD7156_CH1_CAPDAC_DAC_AUTO1     (1 << 6)
#define AD7156_CH1_CAPDAC_DAC_VAL1(x)   ((x) & 0x3F)
 
#define AD7156_CH2_CAPDAC_DAC_EN2       (1 << 7)
#define AD7156_CH2_CAPDAC_DAC_AUTO2     (1 << 6)
#define AD7156_CH2_CAPDAC_DAC_VAL2(x)   ((x) & 0x3F)
 
#define AD7156_DEFAULT_ID               0x88
 
#define AD7156_RESET_CMD                0xBF
 
#define AD7156_CHANNEL1                 1
#define AD7156_CHANNEL2                 2
 
/******************************************************************************/
/*************************** Types Declarations *******************************/
/******************************************************************************/
 
struct ad7156_dev {
    /* I2C */
    struct no_os_i2c_desc   *i2c_desc;
    /* Device Settings */
    float ad7156_channel1_range;
    float ad7156_channel2_range;
};
 
struct ad7156_init_param {
    /* I2C */
    struct no_os_i2c_init_param i2c_init;
    /* Device Settings */
    float ad7156_channel1_range;
    float ad7156_channel2_range;
};
 
/******************************************************************************/
/************************ Functions Declarations ******************************/
/******************************************************************************/
 
void ad7156_get_register_value(struct ad7156_dev *dev,
                   uint8_t* p_read_data,
                   uint8_t register_address,
                   uint8_t bytes_number);
 
void ad7156_set_register_value(struct ad7156_dev *dev,
                   uint16_t register_value,
                   uint8_t  register_address,
                   uint8_t  bytes_number);
int8_t ad7156_init(struct ad7156_dev **device,
           struct ad7156_init_param init_param);
 
int32_t ad7156_remove(struct ad7156_dev *dev);
 
void ad7156_reset(struct ad7156_dev *dev);
 
void ad7156_set_power_mode(struct ad7156_dev *dev,
               uint8_t pwr_mode);
 
void ad7156_channel_state(struct ad7156_dev *dev,
              uint8_t channel,
              uint8_t enable_conv);
 
void ad7156_set_range(struct ad7156_dev *dev,
              uint32_t channel,
              uint8_t range);
 
float ad7156_get_range(struct ad7156_dev *dev,
               uint32_t channel);
 
void ad7156_set_threshold_mode(struct ad7156_dev *dev,
                   uint8_t thr_mode,
                   uint8_t thr_fixed);
 
void ad7156_set_threshold(struct ad7156_dev *dev,
              uint8_t channel,
              float p_fthr);
 
void ad7156_set_sensitivity(struct ad7156_dev *dev,
                uint8_t channel,
                float p_fsensitivity);
 
uint16_t ad7156_read_channel_data(struct ad7156_dev *dev,
                  uint8_t channel);
 
uint16_t ad7156_wait_read_channel_data(struct ad7156_dev *dev,
                       uint8_t channel);
 
float ad7156_read_channel_capacitance(struct ad7156_dev *dev,
                      uint8_t channel);
 
float ad7156_wait_read_channel_capacitance(struct ad7156_dev *dev,
        uint8_t channel);
 
#endif  /* __AD7156_H__ */