axi_dac_core.h

Go to the documentation of this file.

/***************************************************************************/
#ifndef AXI_DAC_CORE_H_
#define AXI_DAC_CORE_H_
 
/******************************************************************************/
/***************************** Include Files **********************************/
/******************************************************************************/
#include <stdint.h>
 
/******************************************************************************/
/*************************** Types Declarations *******************************/
/******************************************************************************/
enum {
    AXI_DAC_BUS_TYPE_NONE,
    AXI_DAC_BUS_TYPE_QSPI,
};
 
struct axi_dac {
    const char *name;
    uint32_t base;
    uint8_t num_channels;
    uint64_t clock_hz;
    struct axi_dac_channel *channels;
    uint32_t bus_type;
};
 
struct axi_dac_init {
    const char *name;
    uint32_t base;
    uint8_t num_channels;
    struct axi_dac_channel *channels;
    uint8_t rate;
    uint32_t bus_type;
};
 
enum axi_dac_data_sel {
    AXI_DAC_DATA_SEL_DDS,
    AXI_DAC_DATA_SEL_SED,
    AXI_DAC_DATA_SEL_DMA,
    AXI_DAC_DATA_SEL_ZERO,
    AXI_DAC_DATA_SEL_PN7,
    AXI_DAC_DATA_SEL_PN15,
    AXI_DAC_DATA_SEL_PN23,
    AXI_DAC_DATA_SEL_PN31,
    AXI_DAC_DATA_SEL_LB,
    AXI_DAC_DATA_SEL_PNXX,
};
 
struct axi_dac_channel {
    uint32_t dds_frequency_0;       // in hz (1000*1000 for MHz)
    uint32_t dds_phase_0;           // in milli(?) angles (90*1000 for 90 degrees = pi/2)
    int32_t dds_scale_0;            // in micro units (1.0*1000*1000 is 1.0)
    uint32_t dds_frequency_1;       // in hz (1000*1000 for MHz)
    uint32_t dds_phase_1;           // in milli(?) angles (90*1000 for 90 degrees = pi/2)
    int32_t dds_scale_1;            // in micro units (1.0*1000*1000 is 1.0)
    uint32_t dds_dual_tone;         // if using single tone for this channel, set to 0x0
    uint32_t pat_data;              // if using SED/debug that sort of thing
    enum axi_dac_data_sel sel;      // set to one of the enumerated type above.
};
 
extern const uint16_t sine_lut[128];
 
extern const uint32_t sine_lut_iq[1024];
 
/******************************************************************************/
/************************ Functions Declarations ******************************/
/******************************************************************************/
int32_t axi_dac_init_begin(struct axi_dac **dac_core,
               const struct axi_dac_init *init);
int32_t axi_dac_init_finish(struct axi_dac *dac);
int32_t axi_dac_init(struct axi_dac **dac_core,
             const struct axi_dac_init *init);
int32_t axi_dac_remove(struct axi_dac *dac);
int32_t axi_dac_set_datasel(struct axi_dac *dac,
                int32_t chan,
                enum axi_dac_data_sel sel);
int32_t axi_dac_dds_set_frequency(struct axi_dac *dac,
                  uint32_t chan, uint32_t freq_hz);
int32_t axi_dac_dds_get_frequency(struct axi_dac *dac,
                  uint32_t chan, uint32_t *freq);
int32_t axi_dac_dds_set_phase(struct axi_dac *dac,
                  uint32_t chan, uint32_t phase);
int32_t axi_dac_dds_get_phase(struct axi_dac *dac,
                  uint32_t chan, uint32_t *phase);
int32_t axi_dac_dds_set_scale(struct axi_dac *dac,
                  uint32_t chan,
                  int32_t scale_micro_units);
int32_t axi_dac_dds_get_scale(struct axi_dac *dac,
                  uint32_t chan,
                  int32_t *scale_micro_units);
int32_t axi_dac_set_buff(struct axi_dac *dac,
             uint32_t address,
             uint16_t *buff,
             uint32_t buff_size);
uint32_t axi_dac_set_sine_lut(struct axi_dac *dac,
                  uint32_t address);
int32_t axi_dac_dds_get_calib_scale(struct axi_dac *dac,
                    uint32_t chan,
                    int32_t *val,
                    int32_t *val2);
int32_t axi_dac_dds_get_calib_phase(struct axi_dac *dac,
                    uint32_t chan,
                    int32_t *val,
                    int32_t *val2);
int32_t axi_dac_dds_set_calib_scale(struct axi_dac *dac,
                    uint32_t chan,
                    int32_t val,
                    int32_t val2);
int32_t axi_dac_dds_set_calib_phase(struct axi_dac *dac,
                    uint32_t chan,
                    int32_t val,
                    int32_t val2);
int32_t axi_dac_load_custom_data(struct axi_dac *dac,
                 const uint32_t *custom_data_iq,
                 uint32_t custom_tx_count,
                 uint32_t address);
int32_t axi_dac_data_setup(struct axi_dac *dac);
int32_t axi_dac_bus_read(struct axi_dac *dac,
             uint32_t reg_addr,
             uint32_t *reg_data,
             uint8_t data_size);
int32_t axi_dac_bus_write(struct axi_dac *dac,
              uint32_t reg_addr,
              uint32_t reg_data,
              uint8_t data_size);
int32_t axi_dac_set_ddr(struct axi_dac *dac,
            bool enable);
int32_t axi_dac_set_data_stream(struct axi_dac *dac,
                bool enable);
int32_t axi_dac_data_transfer_addr(struct axi_dac *dac,
                   uint32_t address);
int32_t axi_dac_data_format_set(struct axi_dac *dac,
                int format);
 
#endif