Data Fields
rlRunTimeCalibConf_t Struct Reference

Radar RF Run time calibration configuration. More...

#include <control/mmwavelink/include/rl_sensor.h>

Data Fields

rlUInt32_t oneTimeCalibEnMask
 Upon receiving this trigger message, one time calibration of various RF/analog
aspects are triggered if the corresponding bits in this field are set to 1. The
response is in the form of an asynchronous event sent to the host. The
calibrations, if enabled, are performed after the completion of any ongoing
calibration cycle, and the calibration results take event from the frame that
begins after the asynchronous event response is sent from the BSS.
APLL and SYNTH calibrations are done always internally irrespective of bits are
enabled or not, the time required for these calibrations must be allocated.
Bit: Calibration
0:[Reserved]
1:[Reserved]
2:[Reserved]
3:[Reserved]
4: Enable LODIST calibration
5: [Reserved]
6: [Reserved]
7: [Reserved]
8: Enable PD_CALIBRATION_EN
9: Enable TX Power calibration
10:Enable RX gain calibration
11:[Reserved]
12:[Reserved]
31:13:[Reserved]
.
 
rlUInt32_t periodicCalibEnMask
 Automatic periodic triggering of calibrations of various RF/analog aspects.
It has same bit definition as above
. More...
 
rlUInt32_t calibPeriodicity
 This field is applicable only for those calibrations which are enabled to be
done periodically in the periodicCalibEnMask field. This field indicates the
desired periodicity of calibrations. If this field is set to N, the results of
the first calibration (based on oneTimeCalibEnMask) are applicable for the first
N calibMonTimeUnits. The results of the next calibration are applicable for
the next N calibMonTimeUnits, and so on. Recommendation: Set calibPeriodicity such that frequency of calibrations is
greater than or equal to 1 second. 1 LSB = 1 calibMonTimeUnit, as specified
in rlRfSetCalMonTimeUnitConfig. If the user does not wish to receive
calibration reports when periodic calibrations are not enabled, then the user
should set calibPeriodicity to 0. Default value: 0 Valid Range: 0 (Disable), 4 to 100 (value 1 is not a valid value, this will cause
internal APLL and SYNTH calibrations to stop)
 
rlUInt8_t reportEn
 Calibration Report Enable Configuration
[b0] Enable Calibration Reports Bitmap
0 - Disable Calibration Reports
1 - Enable Calibration Reports
[b7:1] Reserved
. More...
 
rlUInt8_t reserved0
 Reserved for Future use.
 
rlUInt8_t txPowerCalMode
 TX Power Calibration Mode [b0] Enable Calibration Reports Bitmap
0 - Update TX gain setting from LUT and do a closed loop calibration
(OLPC + CLPC)
1 - Update TX gain settings from LUT only (OLPC only)
OLPC: Open Loop Power Control. In this mode the TX stage codes are set
based on a coarse measurement and a LUT generated for every temperature
and the stage codes are picked from the LUT CLPC: Closed Loop Power
Control. In this mode the TX stage codes are picked from the coarse LUT
as generated in OLPC step. Later the TX power is measured and the TX
stage codes are corrected to achieve the desired TX power accuracy.
Default value: 0
[b7:1] Reserved
.
 
rlUInt8_t CalTempIdxOverrideEn
 Calibration Temperature Index Override Enable
Enables the Host to override the use of device’s internal temperature readings for choosing front end calibration settings (e.g. bias current, Rx Gain and Tx Gain LUT).
[b0] TX_TEMP_INDEX_OVERRIDE_EN
0 - Override disable
1 - Override enable
[b1] RX_TEMP_INDEX_OVERRIDE_EN
0 - Override disable
1 - Override enable
[b2] LODIST_TEMP_INDEX_OVERRIDE_EN
0 - Override disable
1 - Override enable
. More...
 
rlUInt8_t CalTempIdxTx
 Override temperature index is used to calibrate Tx front end
Idx val Definition 0: Index for temperature < -30 deg C
1: Index for to temperature [-30, -20) deg C
2: Index for to temperature [-20, -10) deg C
3: Index for to temperature [-10, 0) deg C
4: Index for to temperature [0, 10) deg C
5: Index for to temperature [10, 20) deg C
6: Index for to temperature [20, 30) deg C
7: Index for to temperature [30, 40) deg C
8: Index for to temperature [40, 50) deg C
9: Index for to temperature [50, 60) deg C
10: Index for to temperature [60, 70) deg C
11: Index for to temperature [70, 80) deg C
12: Index for to temperature [80, 90) deg C
13: Index for to temperature [90, 100) deg C
14: Index for to temperature [100, 110) deg C
15: Index for to temperature [110, 120) deg C
16: Index for to temperature [120, 130) deg C
17: Index for to temperature [130, 140) deg C
18: Index for to temperature >= 140 deg C
.
 
rlUInt8_t CalTempIdxRx
 Override temperature index is used to calibrate Rx front end
Idx val Definition 0: Index for temperature < -30 deg C
1: Index for to temperature [-30, -20) deg C
2: Index for to temperature [-20, -10) deg C
3: Index for to temperature [-10, 0) deg C
4: Index for to temperature [0, 10) deg C
5: Index for to temperature [10, 20) deg C
6: Index for to temperature [20, 30) deg C
7: Index for to temperature [30, 40) deg C
8: Index for to temperature [40, 50) deg C
9: Index for to temperature [50, 60) deg C
10: Index for to temperature [60, 70) deg C
11: Index for to temperature [70, 80) deg C
12: Index for to temperature [80, 90) deg C
13: Index for to temperature [90, 100) deg C
14: Index for to temperature [100, 110) deg C
15: Index for to temperature [110, 120) deg C
16: Index for to temperature [120, 130) deg C
17: Index for to temperature [130, 140) deg C
18: Index for to temperature >= 140 deg C
.
 
rlUInt8_t CalTempIdxLodist
 Override temperature index is used to calibrate LO distribution of front end
Idx val Definition 0: Index for temperature < -30 deg C
1: Index for to temperature [-30, -20) deg C
2: Index for to temperature [-20, -10) deg C
3: Index for to temperature [-10, 0) deg C
4: Index for to temperature [0, 10) deg C
5: Index for to temperature [10, 20) deg C
6: Index for to temperature [20, 30) deg C
7: Index for to temperature [30, 40) deg C
8: Index for to temperature [40, 50) deg C
9: Index for to temperature [50, 60) deg C
10: Index for to temperature [60, 70) deg C
11: Index for to temperature [70, 80) deg C
12: Index for to temperature [80, 90) deg C
13: Index for to temperature [90, 100) deg C
14: Index for to temperature [100, 110) deg C
15: Index for to temperature [110, 120) deg C
16: Index for to temperature [120, 130) deg C
17: Index for to temperature [130, 140) deg C
18: Index for to temperature >= 140 deg C
.
 
rlUInt8_t reserved1
 Reserved for Future use.
 

Detailed Description

Radar RF Run time calibration configuration.

Definition at line 2891 of file rl_sensor.h.

Field Documentation

◆ CalTempIdxOverrideEn

rlUInt8_t rlRunTimeCalibConf_t::CalTempIdxOverrideEn

Calibration Temperature Index Override Enable
Enables the Host to override the use of device’s internal temperature readings for choosing front end calibration settings (e.g. bias current, Rx Gain and Tx Gain LUT).
[b0] TX_TEMP_INDEX_OVERRIDE_EN
0 - Override disable
1 - Override enable
[b1] RX_TEMP_INDEX_OVERRIDE_EN
0 - Override disable
1 - Override enable
[b2] LODIST_TEMP_INDEX_OVERRIDE_EN
0 - Override disable
1 - Override enable
.

[b7:3] Reserved
Default value: 0 (Override disable, use device temperature)

Note
: This feature is supported only on AWR2243 device.
: If any of the override bits are enabled, AWR_RF_INIT_SB should not be invoked again.

Definition at line 2999 of file rl_sensor.h.

◆ periodicCalibEnMask

rlUInt32_t rlRunTimeCalibConf_t::periodicCalibEnMask

Automatic periodic triggering of calibrations of various RF/analog aspects.
It has same bit definition as above
.

Note
: In cascade mode it is recommended to disable (set value 0 in this field) automated periodic calibration for phase synchronization.

Definition at line 2925 of file rl_sensor.h.

◆ reportEn

rlUInt8_t rlRunTimeCalibConf_t::reportEn

Calibration Report Enable Configuration
[b0] Enable Calibration Reports Bitmap
0 - Disable Calibration Reports
1 - Enable Calibration Reports
[b7:1] Reserved
.

Note
1: If calibration reports are enabled, the reports will be sent every 1 second whenever internal calibrations (APLL and SYNTH) are triggered
and at every CALIBRATION PERIODICITY when the user enabled calibrations are triggered.
2: If user has not enabled any one time calibrations, but if calibration report is enabled, then after issuing this API, the firmware will
attempt to run the APLL and SYNTH calibrations and the calibration report will be immediately sent out.

Definition at line 2959 of file rl_sensor.h.


The documentation for this struct was generated from the following file:

Copyright 2021, Texas Instruments Incorporated