dma_example.c File Reference

DMA example for the ADRV903X project. More...

#include "dma_example.h"
#include "common_data.h"
#include "parameters.h"
#include "app_config.h"
#include "initdata.h"
#include "adrv903x.h"
#include "adi_adrv903x_radioctrl.h"
#include "adi_adrv903x_tx.h"
#include "adi_adrv903x_rx.h"
#include "clkgen_routines.h"
#include "no_os_print_log.h"
#include "no_os_error.h"
#include "no_os_gpio.h"
#include "no_os_util.h"
#include "ad9528.h"
#include "axi_jesd204_rx.h"
#include "axi_jesd204_tx.h"
#include "axi_adxcvr.h"
#include "axi_adc_core.h"
#include "axi_dac_core.h"
#include "axi_dmac.h"
#include "jesd204.h"
#include <string.h>
#include "no_os_axi_io.h"
#include <xil_cache.h>

Include dependency graph for dma_example.c:

Macros
#define	DMA_NUM_CHANNELS   8
#define	AXI_DO_REG_MEMORY_SIZE_LSB   0x0014
#define	AXI_DO_REG_TRANSFER_LENGTH   0x001C
#define	AXI_DO_REG_RESETN_OFFLOAD   0x0084
#define	AXI_DO_REG_CONTROL   0x0088

Functions
int	example_main ()
	DMA example main function.

Variables
uint32_t	dac_buffer_dma [DAC_BUFFER_SAMPLES]
uint16_t	adc_buffer_dma [ADC_BUFFER_SAMPLES *DMA_NUM_CHANNELS]

Detailed Description

DMA example for the ADRV903X project.

Author

Analog Devices Inc.

Copyright 2026(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:

• Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
• 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.
• 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.
• The use of this software may or may not infringe the patent rights of one or more patent holders. This license does not release you from the requirement that you obtain separate licenses from these patent holders to use this software.
• Use of the software either in source or binary form, must be run on or directly connected to an Analog Devices Inc. component.

THIS SOFTWARE IS PROVIDED BY ANALOG DEVICES "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL ANALOG DEVICES 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.

Macro Definition Documentation

AXI_DO_REG_CONTROL

#define AXI_DO_REG_CONTROL   0x0088

AXI_DO_REG_MEMORY_SIZE_LSB

#define AXI_DO_REG_MEMORY_SIZE_LSB   0x0014

AXI_DO_REG_RESETN_OFFLOAD

#define AXI_DO_REG_RESETN_OFFLOAD   0x0084

AXI_DO_REG_TRANSFER_LENGTH

#define AXI_DO_REG_TRANSFER_LENGTH   0x001C

DMA_NUM_CHANNELS

#define DMA_NUM_CHANNELS   8

Function Documentation

example_main()

int example_main

(

void

)

DMA example main function.

Basic example main execution.

Basic example main executiont.

Brings up the full JESD204 link and demonstrates DMA data transfer:

1. AD9528 clock synthesizer setup (DEVCLK + SYSREF)
2. SYSREF_REQ GPIO configuration
3. ADXCVR initialization (TX and RX)
4. AXI JESD204 TX and RX controller initialization
5. ADRV903X initialization (firmware load up to PreMcsInit_NonBroadcast)
6. AXI clkgen setup (lane_rate / 66 for JESD204C)
7. AXI DAC core init — load sine wave LUT into TX DMA buffer
8. AXI ADC core init — reset TPL ADC core + IQ correction
9. TX and RX DMAC initialization
10. JESD204 topology initialization and FSM start FSM drives: MCS (LINK_SETUP/OPT_SETUP_STAGE1/2) + link enable
11. Start TX DMA (continuous sine wave to DAC)
12. Wait 1 s then capture RX DMA samples
13. Print buffer addresses for inspection

Returns

0 on success, negative error code on failure.

IIO descriptor and initialization parameter.

IIO app.

Declaring iio_devices structure

Initializing IIO app init param.

Initializing IIO app.

Running the IIO app (use iio_info or osc in terminal).

Set the threshold voltage to 5V

The comparator output will be available on the GPO_A pin

Set the DAC output on channel C to 5V

Measure input current on channel D

Initialize the ADC_RDY GPIO and associated IRQ event

Returns

0 if success, negative error code otherwise

Variable Documentation

adc_buffer_dma

uint16_t adc_buffer_dma[ADC_BUFFER_SAMPLES * DMA_NUM_CHANNELS]

dac_buffer_dma

uint32_t dac_buffer_dma[DAC_BUFFER_SAMPLES]