ltc268x.h

Go to the documentation of this file.

/***************************************************************************/
#ifndef __LTC268X_H__
#define __LTC268X_H__
 
#include "no_os_spi.h"
#include "no_os_util.h"
#include "no_os_delay.h"
#include "errno.h"
 
/******************************************************************************/
/******************* Macros and Constants Definitions *************************/
/******************************************************************************/
#define LTC268X_CHANNEL_SEL(x, id)          (id ? x : (x << 1))
 
#define LTC268X_CMD_CH_CODE(x, id)          (0x00 + LTC268X_CHANNEL_SEL(x, id))
#define LTC268X_CMD_CH_SETTING(x, id)       (0x10 + LTC268X_CHANNEL_SEL(x, id))
#define LTC268X_CMD_CH_OFFSET(x, id)        (0X20 + LTC268X_CHANNEL_SEL(x, id))
#define LTC268X_CMD_CH_GAIN(x, id)          (0x30 + LTC268X_CHANNEL_SEL(x, id))
#define LTC268X_CMD_CH_CODE_UPDATE(x, id)       (0x40 + LTC268X_CHANNEL_SEL(x, id))
#define LTC268X_CMD_CH_CODE_UPDATE_ALL(x, id)   (0x50 + LTC268X_CHANNEL_SEL(x, id))
#define LTC268X_CMD_CH_UPDATE(x, id)        (0x60 + LTC268X_CHANNEL_SEL(x, id))
 
#define LTC268X_CMD_CONFIG_REG          0x70
#define LTC268X_CMD_POWERDOWN_REG       0x71
#define LTC268X_CMD_A_B_SELECT_REG      0x72
#define LTC268X_CMD_SW_TOGGLE_REG       0x73
#define LTC268X_CMD_TOGGLE_DITHER_EN_REG    0x74
#define LTC268X_CMD_MUX_CTRL_REG        0x75
#define LTC268X_CMD_FAULT_REG           0x76
#define LTC268X_CMD_CODE_ALL            0x78
#define LTC268X_CMD_CODE_UPDATE_ALL     0x79
#define LTC268X_CMD_SETTING_ALL         0x7A
#define LTC268X_CMD_SETTING_UPDATE_ALL      0x7B
#define LTC268X_CMD_UPDATE_ALL          0x7C
#define LTC268X_CMD_NOOP            0xFF
 
#define LTC268X_READ_OPERATION          0x80
 
/* Channel Settings */
#define LTC268X_CH_SPAN_MSK         NO_OS_GENMASK(3, 0)
#define LTC268X_CH_SPAN(x)          no_os_field_prep(LTC268X_CH_SPAN_MSK, x)
#define LTC268X_CH_TD_SEL_MSK           NO_OS_GENMASK(5, 4)
#define LTC268X_CH_TD_SEL(x)            no_os_field_prep(LTC268X_CH_TD_SEL_MSK, x)
#define LTC268X_CH_DIT_PER_MSK          NO_OS_GENMASK(8, 6)
#define LTC268X_CH_DIT_PER(x)           no_os_field_prep(LTC268X_CH_DIT_PER_MSK, x)
#define LTC268X_CH_DIT_PH_MSK           NO_OS_GENMASK(10, 9)
#define LTC268X_CH_DIT_PH(x)            no_os_field_prep(LTC268X_CH_DIT_PH_MSK, x)
#define LTC268X_CH_MODE             NO_OS_BIT(11)
 
/* Configuration register */
#define LTC268X_CONFIG_RST          NO_OS_BIT(15)
 
#define LTC268X_PWDN(x)             (1 << ((x) & 0xF))
#define LTC268X_DITH_EN(x)          (1 << ((x) & 0xF))
 
/******************************************************************************/
/*************************** Types Declarations *******************************/
/******************************************************************************/
enum ltc268x_voltage_range {
    LTC268X_VOLTAGE_RANGE_0V_5V,
    LTC268X_VOLTAGE_RANGE_0V_10V,
    LTC268X_VOLTAGE_RANGE_M5V_5V,
    LTC268X_VOLTAGE_RANGE_M10V_10V,
    LTC268X_VOLTAGE_RANGE_M15V_15V,
};
 
struct ltc268x_span_tbl {
    int min;
    int max;
};
 
enum ltc268x_dither_period {
    LTC268X_DITH_PERIOD_4,
    LTC268X_DITH_PERIOD_8,
    LTC268X_DITH_PERIOD_16,
    LTC268X_DITH_PERIOD_32,
    LTC268X_DITH_PERIOD_64
};
 
enum ltc268x_dither_phase {
    LTC268X_DITH_PHASE_0,
    LTC268X_DITH_PHASE_90,
    LTC268X_DITH_PHASE_180,
    LTC268X_DITH_PHASE_270
};
 
enum ltc268x_a_b_register {
    LTC268X_SELECT_A_REG,
    LTC268X_SELECT_B_REG
};
 
enum  ltc268x_clk_input {
    LTC268X_SOFT_TGL,
    LTC268X_TGP0,
    LTC268X_TGP1,
    LTC268X_TGP2
};
 
enum ltc268x_device_id {
    LTC2686 = 0,
    LTC2688 = 1
};
 
struct ltc268x_dev {
    struct no_os_spi_desc           *spi_desc;
    enum ltc268x_device_id   dev_id;
    uint16_t            pwd_dac_setting;
    uint16_t            dither_toggle_en;
    bool                dither_mode[16];
    uint16_t            dac_code[16];
    uint8_t             num_channels;
    enum ltc268x_voltage_range  crt_range[16];
    enum ltc268x_dither_phase   dither_phase[16];
    enum ltc268x_dither_period  dither_period[16];
    enum ltc268x_clk_input      clk_input[16];
    enum ltc268x_a_b_register   reg_select[16];
};
 
struct ltc268x_init_param {
    /* SPI */
    struct no_os_spi_init_param             spi_init;
    enum ltc268x_device_id          dev_id;
    uint16_t            pwd_dac_setting;
    uint16_t            dither_toggle_en;
    bool                dither_mode[16];
    enum ltc268x_voltage_range  crt_range[16];
    enum ltc268x_dither_phase   dither_phase[16];
    enum ltc268x_dither_period  dither_period[16];
    enum ltc268x_clk_input      clk_input[16];
    enum ltc268x_a_b_register   reg_select[16];
};
/******************************************************************************/
/******************************** LTC268X *************************************/
/******************************************************************************/
int32_t ltc268x_set_pwr_dac(struct ltc268x_dev *dev, uint16_t setting);
int32_t ltc268x_set_dither_toggle(struct ltc268x_dev *dev, uint16_t setting);
int32_t ltc268x_set_dither_mode(struct ltc268x_dev *dev, uint8_t channel,
                bool en);
int32_t ltc268x_set_span(struct ltc268x_dev *dev, uint8_t channel,
             enum ltc268x_voltage_range range);
int32_t ltc268x_set_dither_phase(struct ltc268x_dev *dev, uint8_t channel,
                 enum  ltc268x_dither_phase phase);
int32_t ltc268x_set_dither_period(struct ltc268x_dev *dev, uint8_t channel,
                  enum  ltc268x_dither_period period);
int32_t ltc268x_select_tg_dith_clk(struct ltc268x_dev *dev, uint8_t channel,
                   enum  ltc268x_clk_input clk_input);
int32_t ltc268x_select_reg(struct ltc268x_dev *dev, uint8_t channel,
               enum  ltc268x_a_b_register sel_reg);
int32_t ltc268x_software_reset(struct ltc268x_dev *dev);
int32_t ltc268x_set_voltage(struct ltc268x_dev *dev, uint8_t channel,
                float voltage);
int32_t ltc268x_software_toggle(struct ltc268x_dev *dev, uint8_t channel);
int32_t ltc268x_init(struct ltc268x_dev **device,
             struct ltc268x_init_param init_param);
int32_t ltc268x_remove(struct ltc268x_dev *dev);
 
#endif // __LTC268X_H__