Analog Devices ADRV9029 User Manual

Preliminary Technical
Data
Rev. PrA | Page 47 of 82
Table 16. Adi_adrv9025_CfrCtrlConfig_t Data Structure
Data Type Structure Member
Valid
Values
Description
uint32_t txChannelMask 0..15
Mask consisting of 'OR'ed transmitter channels for which
the CFR core config will be applied (1 bit for each
channel).
adi_adrv9010_CfrMod
eSel_e
cfrMode 1
Selects the mode in which CFR is required to operate in.
Currently, Mode 1 is the only supported mode.
uint16_t cfrTxDelay 129..511
Sets CFR delay per engine in units of samples at the CFR
input rate (JESD 204B/C transmitter rate)
float cfrPeakThreshold 0..1
Sets the target CFR peak detection and correction
threshold. The threshold is calculated as:
The peak threshold is set to 0.79 by default.
float
cfrEngine1PeakThresholdScaler
0..1
Threshold Scaler for engine CFR engine 3
float
cfrEngine2PeakThresholdScaler
0..1
Threshold Scaler for engine CFR engine 2
float
cfrEngine3PeakThresholdScaler
0..1
Threshold Scaler for engine CFR engine 1
float
cfrCorrectionThresholdScaler
0..1
Threshold Scaler for CFR correction
adi_adrv9010_CfrInter
polationSel_e
cfrInterpolationFactor 1, 2, 4
Selects the interpolation factor to be applied to CFR input
before peak detection. The CFR peak detectors can run at
a higher (interpolated) rate to enable better peak
detection.
uint8_t
cfrEngine1MaxNumOfPeaks
0..5
Sets the maximum number of peaks to remove in one
group for the respective CFR engines. Default value is 5.
User needs to set this to 0 when engine is disabled. It's
suggested to have descending order of max number of
peaks where Engine1 has the highest value.
uint8_t
cfrEngine2MaxNumOfPeaks
0..5
uint8_t cfrEngine3MaxNumOfPeaks 0..5
adi_adrv9025_CfrCtrlConfigGet(…)
int32_t adi_adrv9025_CfrCtrlConfigGet(adi_adrv9025_Device_t * device, adi_adrv9025_TxChannels_e
txChannel, adi_adrv9025_CfrCtrlConfig_t * cfrCtrlConfig)
Description
This function retrieves the core control config parameters for the CFR engine. It reads the CFR mode, peak threshold,
interpolation factor and the delay currently programmed into the device.
Precondition
This function may be called after device initialization and the ARM processor boot up is complete.
Table 17. adi_adrv9025_ CfrCtrlConfigGet(…) Parameters
Parameter
Description
*device
Pointer to the device settings structure
txChannel
Target transmitter channel whose CFR control config is required to be read back
*cfrCtrlConfig
Pointer to CFR control config struct which will be updated with the CFR control settings from the device
adi_adrv9025_CfrCorrectionPulseWrite_v2(…)
int32_t adi_adrv9025_CfrCorrectionPulseWrite_v2(adi_adrv9025_Device_t * device, uint32_t
txChannelMask, adi_adrv9025_CfrCorrectionPulse_t cfrCorrectionPulses[], uint8_t
numCorrectionPulses);
Description

Analog Devices ADRV9029 Specifications

General

Frequency Range	75 MHz to 6 GHz
Observation Receivers	2
Sniffer Receivers	1
Receive Bandwidth	Up to 450 MHz
Maximum Bandwidth	450 MHz
ADC Resolution	12-bit
Operating Temperature Range	-40°C to +85°C
Modulation Types	QPSK, 16QAM, 64QAM, 256QAM
Digital Interface	JESD204B
DAC Resolution	12-bit
Power Supply Voltage	3.3 V
Power Consumption	Varies with configuration

Summary

ADRV9029 Transceiver DPD, CLGC and CFR User Guide

SCOPE

Describes the scope of the preliminary documentation.

DIGITAL PRE-DISTORTION

DIGITAL FRONT-END SYSTEM LEVEL OVERVIEW

Provides a system level overview of the transceiver signal chain with DFE processing blocks.

DPD INTRODUCTION AND PRINCIPLE OF OPERATION

TRANSCEIVER DPD OVERVIEW

DPD Actuator Overview

Explains the programmable GMP calculator used by the DPD actuator.

DPD Half Band Filters

Describes the characteristics and bandwidth of the two DPD half band filters.

DPD ALGORITHM OVERVIEW

Indirect Learning

Explains the indirect learning mechanism using PA output data as reference.

DPD Direct Learning

Explains the direct learning approach to minimize error between observed and reference data.

DPD Coefficient Estimation

Details the maximum coefficients and sample usage for DPD coefficient calculation.

GMP Model and Look Up Table

Explains how GMP models are mapped to LUTs and their configuration.

INITIALIZING PRE-CALIBRATED COEFFICIENTS DURING START-UP

Single Frequency Band Use Case

Describes DPD model configuration for a single frequency band use case.

Dual Frequency Band Use Case

Describes DPD model configuration for dual frequency band use cases.

Unique GMP Model Per Transmit Channel

Explains initializing each transmit channel with a unique GMP model.

DPD SAMPLE CAPTURE

DPD Sample Capture Process

Details the sequence of events involved in DPD sample capture process.

Peak Search Window and Peak Detection Based Capture

Explains the peak detector and capture trigger mechanism.

DPD Sample Capture in TDD Mode

Discusses considerations for DPD sample capture in TDD mode.

DPD DYNAMICS

DPD Models Explained

Defines the four DPD models based on power levels for dynamic performance.

DPD Modes of Operation

Explains the three modes of operation for the DPD functionality.

Transmitter Low Power Threshold

Describes how DPD switches models based on baseband input power level.

Transmitter M-Threshold

Details the M-Threshold for DPD mode 2, affecting model switching.

Observation receiver Low Power Threshold

Explains the threshold for comparing observation samples to avoid DPD updates.

DPD REGULARIZATION

Comparison of Underfitting, Overfitting and Balanced Fitting

Illustrates the impact of regularization on DPD fitting and stability.

DPD Regularization in DPD Mode 2

Describes separate regularization for low and high power models in DPD Mode 2.

DPD ROBUSTNESS

Calculation of Metrics

Explains how to compute error metrics to determine DPD performance.

Defining Fault Conditions

Describes how to define fault conditions using the DPD fault condition structure.

DPD ACTUATOR GAIN MONITORING FOR ROBUSTNESS

Principle of Operation

Explains how DPD gain monitoring determines model switching based on actuator gain.

DPD Actuator Gain Monitoring Configurations

Lists adjustments for configuring the DPD actuator gain monitoring feature.

DPD Actuator Gain Monitoring API

Lists API functions for controlling DPD actuator gain monitoring.

DPD Actuator Gain Monitoring + Model Switching State Machine Representation

Describes the DPD gain monitoring state machine and its operations.

DPD ACTUATOR BYPASS

DPD STATUS

RECOMMENDED SEQUENCE FOR ENABLING THE DPD TRACKING CALIBRATION

DPD STABILITY METRICS CHARACTERIZATION

Measuring DPD Adaptation Performance through Direct EVM and Indirect Error

Compares stability metrics like direct EVM and indirect error for ACLR performance.

Observation Receiver Attenuation vs Stability Metrics

Shows the trend of EVM and error metrics with observation receiver channel attenuation.

Transmit Signal vs Stability Metrics

Shows the degradation of stability metrics with decreasing transmitter signal power.

DPD CHARACTERIZATION FOR OPTIMIZING M-THRESHOLD

TYPICAL PROCEDURE TO SET UP DPD USING GUI

DPD Tracking Config

Details the configuration parameters for DPD tracking.

CREST FACTOR REDUCTION (CFR)

CFR ALGORITHM OVERVIEW

Provides an overview of the CFR algorithm and its implementation.

OVERVIEW OF BLOCKS USED IN CFR

Summarizes the major blocks used in each CFR engine.

API SOFTWARE INTEGRATION

Outlines API functions and procedures for setting up the CFR block.

Procedure for Updating Correction Pulses On-the-Fly

Describes changing CFR correction pulses without re-running initialization.

Procedure for Modifying CFR Thresholds On-the-Fly

Explains modifying CFR thresholds without running initialization calibration.

Impact on EVM

Studies the impact of CFR engines on EVM performance.

TYPICAL PROCEDURE TO SET UP CFR USING THE GUI

CLOSED LOOP GAIN CONTROL (CLGC)

CLGC OVERVIEW

Explains CLGC's function to adjust Tx attenuations for constant desired gain.

CLGC ALGORITHM OVERVIEW

Describes the CLGC algorithm for maintaining constant loop gain.

ENABLE THE CLGC TRACKING CALIBRATION

Details how to enable CLGC tracking calibration using API.

CLGC MODES OF OPERATION

Explains the two modes of CLGC operation: passive and active loop gain control.

CLGC MEASUREMENT

Explains the CLGC measurement cycle based on batch size, power, and SNR.

CLGC TX ATTENUATION CONTROL

Details how CLGC tunes Tx front end attenuation to converge to loop gain.

CLGC API SUMMARY

Summarizes the CLGC API functions and configurable parameters.

CLGC STATUS

Explains how to retrieve CLGC status and parameters.

CLGC ERRORS

Details CLGC runtime errors and recommended recovery actions.

CLGC CAPTURE ERRORS

Lists CLGC capture errors and corresponding recovery actions.

SEQUENCE FOR ENABLING CLGC TRACKING CALIBRATION

CASE STUDY FOR CONFIGURING CLGC BATCH SAMPLING PERIOD

Signal Under Test

Describes the 5G NR TM2 signal used for testing CLGC batch sampling period.

Time-Frequency Resource Block Allocations

Illustrates time-frequency resource block allocation for the 5GNR signal.

Frequency Spectrum of the Signal

Shows the frequency spectrum of the 5GNR signal.

Time Domain Analysis of the Signal

Provides a time domain view of the signal, showing active resource blocks.

PA Characteristics

Describes the gain vs Pout characteristics of the SKY66397 PA.

CLGC Loop Gain Estimation

Provides an overview of CLGC loop gain estimation.

Analysis of Results With 10us Batch Sampling Period

Analyzes CLGC loop gain variation with a 10us batch sampling period.

Results With Increased CLGC Samspling Period

Compares CLGC loop gain stability with increased sampling period.

CLGC RECOMMENDATIONS