ad5143.h

Go to the documentation of this file.

/*******************************************************************************
 *   @file   ad5143.h
 *   @brief  Header file for the AD5143 digital potentiometer drivers
********************************************************************************
Copyright 2025(c) Analog Devices, Inc.
 
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
 
1. Redistributions of source code must retain the above copyright notice,
   this list of conditions and the following disclaimer.
 
2. Redistributions in binary form must reproduce the above copyright notice,
   this list of conditions and the following disclaimer in the documentation
   and/or other materials provided with the distribution.
 
3. Neither the name of Analog Devices, Inc. nor the names of its
   contributors may be used to endorse or promote products derived from this
   software without specific prior written permission.
 
THIS SOFTWARE IS PROVIDED BY ANALOG DEVICES, INC. “AS IS” AND ANY EXPRESS OR
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
EVENT SHALL ANALOG DEVICES, INC. BE LIABLE FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*******************************************************************************/
#ifndef AD5143_H_
#define AD5143_H_
 
#include "../common/dpot.h"
#include "no_os_i2c.h"
#include "no_os_util.h"
#include "ad51xx_cmd.h"

struct ad5143_dpot_init_param {
    /* I2C init parameters */
    struct no_os_i2c_init_param *i2c_init;
    /* Shutdown enable flag for  potentiometer mode */
    bool shutdown_enable_pt[4];
    /* Shutdown enable flag for  potentiometer mode */
    bool shutdown_enable_lg[8];
 
    /* Operating mode */
    enum dpot_operating_mode eoperating_mode;
};

struct ad5143_dpot_dev {
    /* I2C descriptor */
    struct no_os_i2c_desc *i2c_desc;
    /* Shutdown enable flag */
    bool shutdown_enable[4];
    /* Operating mode */
    enum dpot_operating_mode operating_mode;
};
 
/* AD5143 digital potentiometer ops */
extern const struct dpot_ops ad5143_dpot_ops;
 
int ad5143_dpot_init(struct dpot_init_param *init_params,
             struct dpot_dev **desc);
int ad5143_dpot_remove(struct dpot_dev *desc);
int ad5143_dpot_reset(struct dpot_dev *desc);
int ad5143_dpot_shutdown(struct dpot_dev *desc,
             enum dpot_chn_type chn, bool shutdown_enable);
int ad5143_dpot_set_operating_mode(struct dpot_dev *desc,
                   enum dpot_operating_mode operating_mode);
int ad5143_dpot_input_reg_read(struct dpot_dev *desc,
                   enum dpot_chn_type chn, uint8_t *data);
int ad5143_dpot_input_reg_write(struct dpot_dev *desc,
                enum dpot_chn_type chn, uint8_t data);
int ad5143_dpot_sw_lrdac_update(struct dpot_dev *desc, enum dpot_chn_type chn);
int ad5143_dpot_chn_read(struct dpot_dev *desc,
             enum dpot_chn_type chn, uint8_t *data);
int ad5143_dpot_chn_write(struct dpot_dev *desc,
              enum dpot_chn_type chn, uint8_t data);
int ad5143_dpot_nvm_read(struct dpot_dev *desc,
             enum dpot_chn_type chn, uint8_t *data);
int ad5143_dpot_nvm_write(struct dpot_dev *desc,
              enum dpot_chn_type chn, uint8_t data);
int ad5143_dpot_copy_rdac_to_nvm(struct dpot_dev *desc, enum dpot_chn_type chn);
int ad5143_dpot_copy_nvm_to_rdac(struct dpot_dev *desc, enum dpot_chn_type chn);
int ad5143_dpot_rdac_linear_update(struct dpot_dev *desc,
                   enum dpot_chn_type chn,
                   enum dpot_rdac_linear_status status);
int ad5143_dpot_rdac_6db_update(struct dpot_dev *desc, enum dpot_chn_type chn,
                enum dpot_rdac_6db_status status);
int ad5143_dpot_send_cmd(struct dpot_dev *desc,
             struct dpot_command *cmd);
 
#endif  // AD5143_H_