Clgc Api Summary; Clgc Configuration Summary; Clgc Status - Analog Devices ADRV9029 User Manual

CLGC API SUMMARY

Table 39. CLGC API Software Overview
API Function
adi_adrv9025_ClgcConfigSet
adi_adrv9025_ClgcConfigGet
adi_adrv9025_ClgcStatusGet

CLGC CONFIGURATION SUMMARY

Table 40. Summary of CLGC parameters configurable in the data structure adi_adrv9025_ClgcConfig_t
Parameter
txChannelMask
clgcEnableGainControl
clgcMeasurementBatchTime_us
clgcExpectedLoopGain_dB
clgcTxQualifyingThreshold_dBFS
clgcOrxQualifyingThreshold_dBFS
clgcMaxGainAdjustmentStepSize_dB
clgcMinTxAttenAdjust_dB
clgcMaxTxAttenAdjust_dB
The CLGC status can be retrieved using the API adi_adrv9025_ClgcStatusGet(). The CLGC status is contained in the data structure

CLGC STATUS

adi_adrv9025_ClgcStatus_t. Table 41 contains a summary of CLGC status parameters in the data structure
adi_adrv9025_ClgcStatus_t.
Description
Configures the CLGC measurement and Tx attenuation control parameters as
described in the previous sections. This API can also be used to turn on/off
loop gain control
Retrieves the CLGC configuration currently active in the ADRV9025 device
Retrieves the CLGC status
Description
Mask consisting of 'OR'ed Tx channels for
which the CLGC config will be applied
This parameter enables the tracking and
adjustment of loop gain in CLGC.
If this is set to 0, the CLGC tracking cal only
measures the power levels and does not
execute loop gain control
Sampling period per batch of CLGC samples
Configured by the user depending on the
optimum operating point of the PA
Minimum threshold for the Tx signal required
to run CLGC tracking
Minimum threshold for the Orx signal required
to run CLGC tracking
Maximum loop gain adjustment step
size(Range 0 to 6dB) for Tx Attenuation in dB.
Minimum Tx attenuation in dB allowed to
adjust to
Maximum Tx attenuation in dB allowed to
adjust to
Rev. PrA | Page 70 of 82
Preliminary Technical
Range
0x00 – 0x0F. Bit0 to Bit3 represent
channels Tx1 to Tx4.
0 – Disable loop gain ctrl
1 – Enable loop gain ctrl
10us to 65536us
No limits imposed, the expected
loop gain depends on the
application.
The qualifying threshold must not
go below -70 dBFS for optimum
performance
The qualifying threshold must not
go below -70 dBFS for optimum
performance
The maximum step size that a user
can configure is 6dB
The minimum Tx attenuation value
that can be set on the transceiver Tx
front end is 0dB
The maximum Tx attenuation value
that can be set on the transceiver Tx
front end is 41.95dB
Data