Analog Devices ADRV9029 User Manual

Preliminary Technical
Data
Rev. PrA | Page 63 of 82
Parameter
Data Type
Description
Value
enableMask
uint64_t
The 64 bit ‘OR’ed mask that consists of
tracking calibrations to enable/ disable
(ADI_ADRV9025_TRACK_TX1_CLGC |
ADI_ADRV9025_TRACK_TX2_CLGC |
ADI_ADRV9025_TRACK_TX3_CLGC |
ADI_ADRV9025_TRACK_TX4_CLGC)
enableDisableFlag
Enumeration
Indicates whether the mask value passed
in enableMask parameter is to be used for
enabling or disabling the tracking
calibration
ADI_ADRV9025_TRACKING_CAL_ENABLE
Similarly, to disable the CLGC tracking calibration, the user can set the argument enableDisableFlag to an enumeration valud
ADI_ADRV9025_TRACKING_CAL_DISABLE in order to disable the CLGC tracking calibration on the requested channels.
Please note that when the CLGC tracking calibration is enabled, the CLGC doesn’t actively control the loop gain. The user has to
explicitly configure the loop gain control enable via adi_adrv9025_ClgcConfigSet() API in order to enable actively control the
CLGC loop gain. Details regarding the CLGC modes of operation are captured in the CLGC Modes Of Operation
NOTE: The CLGC tracking calibration works in synchronization with the DPD algorithm, and the CLGC is scheduled once per
second by the firmware.
CLGC MODES OF OPERATION
The CLGC functionality can operate in two modes
1. Passive loop gain measurement: This mode of operation is typically activated to determine initial operating point of the
PA. When a transmitter is activated, the user determines the PA operating point by sending traffic and measuring the overall
loop gain from ORx to Tx. During this stage, the user can take advantage of the passive loop gain measurement mode, in
which the CLGC algorithm simply measures the loop gain without actively adjusting the Tx front end attenuation. Once the
ideal operating point is determined, the user can then enable active loop gain control mode.
2. Active Loop Gain Control: In this mode, the CLGC measures the loop gain from ORx to Tx baseband, and adjusts the Tx front
end gain to maintain the loop gain. This mode of operation is typically activated during runtime once the initial operating
points are determined, and the initial ORx gain, Tx attenuation settings are configured. For the active loop gain control mode,
the user is required to configure the expected loop gain using the API adi_adrv9025_ClgcConfigSet() through the
parameter clgcExpectedLoopGain_dB in the data structure adi_adrv9025_ClgcConfig_t.
The user can select the CLGC mode of operation through the adi_adrv9025_ClgcConfigSet() API, using the parameter
clgcEnableGainControl in adi_adrv9025_ClgcConfig_t data structure as shown in Table 3
Table 36. CLGC Mode of operation configuration
clgcEnableGainControl
CLGC Mode Activated
0
Passive loop gain measurement
1
Active loop gain control
Figure 65 captures a typical CLGC bring up sequence during which the passive and active loop gain control modes are active at
various stages.
In the passive loop gain measurement mode, the user can retrieve the ORx RMS power and Tx RMS power as well as the loop gain
estimated by the CLGC algorithm using the API adi_adrv9025_ClgcStatusGet(). The structure adi_adrv9025_ClgcStatus_t has
members clgcLoopGain, clgcTxRmsPower, clgcOrxRmsPower which can be monitored to adjust the initial operating point of
the PA, and determine the desired loop gain.
The passive loop gain measurement mode is mostly used in a factory calibration setting. The optimal operating point for the PA is
determined, the loop gain, Tx attenuation and ORx gain values are noted, and the values are used in the field.

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