Functions
Monitoring

mmwave radar RF/Sensor Monitoring module More...

Functions

MMWL_EXPORT rlReturnVal_t rlRfDigMonEnableConfig (rlUInt8_t deviceMap, rlMonDigEnables_t *data)
 Sets the consolidated configuration of all digital monitoring. More...
 
MMWL_EXPORT rlReturnVal_t rlRfDigMonPeriodicConfig (rlUInt8_t deviceMap, rlDigMonPeriodicConf_t *data)
 Sets the consolidated configuration. More...
 
MMWL_EXPORT rlReturnVal_t rlRfAnaMonConfig (rlUInt8_t deviceMap, rlMonAnaEnables_t *data)
 This function contains the consolidated configuration of all analog monitoring. The enabled monitoring functions are executed with a periodicity of CAL_MON_TIME_UNITS (rlRfCalMonTimeUntConf_t.calibMonTimeUnit) number of logical frames. The host should ensure that all the enabled monitors can be completed in the available inter-frame times, based on the monitoring durations. The time taken for each monitoring is not defined in this document. More...
 
MMWL_EXPORT rlReturnVal_t rlRfTempMonConfig (rlUInt8_t deviceMap, rlTempMonConf_t *data)
 This API configure the on chip temperature monitors and report the soft results from the monitor. The corresponding monitors are collectively named TEMPERATURE_MONITOR. These monitors observe the temperature near various RF analog and digital modules using temperature sensors and GPADC and compare them against configurable thresholds. The report is sent as an async event RL_RF_AE_MON_TEMPERATURE_REPORT_SB. Sets information related to temperature monitoring. More...
 
MMWL_EXPORT rlReturnVal_t rlRfRxGainPhMonConfig (rlUInt8_t deviceMap, rlRxGainPhaseMonConf_t *data)
 This API is to set RX gain and phase monitoring config to device. More...
 
MMWL_EXPORT rlReturnVal_t rlRfRxNoiseMonConfig (rlUInt8_t deviceMap, rlRxNoiseMonConf_t *data)
 Sets information related to RX noise monitoring. More...
 
MMWL_EXPORT rlReturnVal_t rlRfRxIfStageMonConfig (rlUInt8_t deviceMap, rlRxIfStageMonConf_t *data)
 Sets information related to RX IF filter attenuation monitoring. More...
 
MMWL_EXPORT rlReturnVal_t rlRfTxPowrMonConfig (rlUInt8_t deviceMap, rlAllTxPowMonConf_t *data)
 Sets information related to TX power monitoring. More...
 
MMWL_EXPORT rlReturnVal_t rlRfTxBallbreakMonConfig (rlUInt8_t deviceMap, rlAllTxBallBreakMonCfg_t *data)
 Sets information related to TX ball break detection. More...
 
MMWL_EXPORT rlReturnVal_t rlRfTxGainPhaseMismatchMonConfig (rlUInt8_t deviceMap, rlTxGainPhaseMismatchMonConf_t *data)
 Sets information related to TX gain and phase mismatch monitoring. More...
 
MMWL_EXPORT rlReturnVal_t rlRfSynthFreqMonConfig (rlUInt8_t deviceMap, rlSynthFreqMonConf_t *data)
 Sets information related to synthesizer frequency. More...
 
MMWL_EXPORT rlReturnVal_t rlRfExtAnaSignalsMonConfig (rlUInt8_t deviceMap, rlExtAnaSignalsMonConf_t *data)
 Sets information related to external DC signals monitoring. More...
 
MMWL_EXPORT rlReturnVal_t rlRfTxIntAnaSignalsMonConfig (rlUInt8_t deviceMap, rlAllTxIntAnaSignalsMonConf_t *data)
 Sets information related to TX Internal Analog Signals monitoring. More...
 
MMWL_EXPORT rlReturnVal_t rlRfRxIntAnaSignalsMonConfig (rlUInt8_t deviceMap, rlRxIntAnaSignalsMonConf_t *data)
 Sets information related to RX Internal Analog Signals monitoring. More...
 
MMWL_EXPORT rlReturnVal_t rlRfPmClkLoIntAnaSignalsMonConfig (rlUInt8_t deviceMap, rlPmClkLoIntAnaSignalsMonConf_t *data)
 Sets information related to Power Management, Clock generation and LO distribution. More...
 
MMWL_EXPORT rlReturnVal_t rlRfGpadcIntAnaSignalsMonConfig (rlUInt8_t deviceMap, rlGpadcIntAnaSignalsMonConf_t *data)
 Sets information related to GPADC Internal Analog Signals monitoring. More...
 
MMWL_EXPORT rlReturnVal_t rlRfPllContrlVoltMonConfig (rlUInt8_t deviceMap, rlPllContrVoltMonConf_t *data)
 Sets information related to APLL and Synthesizer's control voltage signals monitoring. More...
 
MMWL_EXPORT rlReturnVal_t rlRfDualClkCompMonConfig (rlUInt8_t deviceMap, rlDualClkCompMonConf_t *data)
 Sets information related to the DCC based clock frequency monitoring. More...
 
MMWL_EXPORT rlReturnVal_t rlRfRxIfSatMonConfig (rlUInt8_t deviceMap, rlRxSatMonConf_t *data)
 Sets information related to RX saturation detector monitoring. More...
 
MMWL_EXPORT rlReturnVal_t rlRfRxSigImgMonConfig (rlUInt8_t deviceMap, rlSigImgMonConf_t *data)
 Sets information related to signal and image band energy. More...
 
MMWL_EXPORT rlReturnVal_t rlRfAnaFaultInjConfig (rlUInt8_t deviceMap, rlAnaFaultInj_t *data)
 Sets information related to RF fault injection. More...
 
MMWL_EXPORT rlReturnVal_t rlRfTxPhShiftMonConfig (rlUInt8_t deviceMap, rlAllTxPhShiftMonConf_t *data)
 Sets information related to TX Phase shifter monitoring. More...
 

Detailed Description

mmwave radar RF/Sensor Monitoring module

mmWave Device monitoring can be configured through a set of APIs defined in this section. Note that these APIs cover the RF/Analog related monitoring mechanisms. There are separate monitoring mechanisms for the digital logic (including the processor, memory, etc.) which are internal to the device and not explicitly enabled through these APIs.
The monitoring APIs are structured as follows:

  1. There are common configuration APIs that control the overall periodicity of monitoring, as well as, enable/disable control for each monitoring mechanism.
  2. Then, for each monitoring mechanism there is an individual API to allow the application to set an appropriate threshold for declaring failure from that monitoring.
  3. Also, for each monitoring mechanism, there is an individual API to report soft (raw) values from that monitoring.
  4. The Raw, Failure or Periodic Monitoring report are sent to application using asynchronous events.

The Monitor Total duration is consist of two components,

  1. Critical Monitor chirp time, this is fixed to 145 us. Each Monitor can have multiple critical chirps to complete the task, the total critical time captured in below table. The critical tasks are done in chunks of 145 us, refer interBurstTime for more info.
  2. Non critical setup and processing time, this is a variable component specific to each Monitor, the total Monitor duration captured in below table = total critical time + non critical time. Note that the User has to ensure the total idle time in one CAL_MON_TIME_UNIT is sufficient to fit the enabled calibrations.

Below is the list of Monitors and corresponding duration in microseconds

Analog Monitoring Duration
Monitors Total Duration(us)Total Critical Time(us)
RX gain phase (assumes 1 RF frequency)1100725
RX noise figure (assumes 1 RF frequency)250145
RX IF stage (assumes 1 RF frequency)1300725
TX power (assumes 1 TX, 1 RF frequency)220145
TX ballbreak (assumes 1 TX)250145
TX gain phase mismatch (assumes 1 TX, 1 RF frequency)350145
TX phase shifter (assumes 1 TX and 1 phase)250145
Synthesizer frequency Live 500
External analog signals (all 6 GPADC channels enabled)150100
TX Internal analog signals (assumes 1 TX)250145
TX Phase shifter DAC monitor (assumes 1 TX)22502175
RX internal analog signals19501740
PMCLKLO internal analog signals and 20G Sync550435
GPADC internal signals5030
PLL control voltage (APLL and SYNTH) 300260
Dual clock comparator (assumes 6 clock comparators)280270
RX saturation detector 500
RX signal and image band monitor500
RX mixer input power650580
Synthesizer frequency Non-live monitor (Single VCO)235145
Digital Monitoring Duration
Monitors Total Duration(us)Total Critical Time(us)
Periodic configuration register readback5030
DFE LBIST monitoring300240
Frame timing monitoring100
Analog Monitoring Duration for xWR6243 device
Monitors Total Duration(us)
RX gain phase (assumes 1 RF frequency)1250
RX noise figure (assumes 1 RF frequency)250
RX IF stage (assumes 1 RF frequency)1400
TX power (assumes 1 TX, 1 RF frequency)250
TX ballbreak (assumes 1 TX)300
TX gain phase mismatch (assumes 1 TX, 1 RF frequency)400
TX phase shifter (assumes 1 TX and 1 phase)250
Synthesizer frequency Live 50
External analog signals (all 6 GPADC channels enabled)150
TX Internal analog signals (assumes 1 TX)300
TX Phase shifter DAC monitor (assumes 1 TX)2300
RX internal analog signals1950
PMCLKLO internal analog signals and 20G Sync550
GPADC internal signals50
PLL control voltage (APLL and SYNTH) 300
Dual clock comparator (assumes 6 clock comparators)300
RX saturation detector 100
RX signal and image band monitor100
RX mixer input power700
Synthesizer frequency Non-live monitor (Single VCO)250
Digital Monitoring Duration for xWR6243
Monitors Total Duration(us)
Periodic configuration register readback70
DFE LBIST monitoring300
Frame timing monitoring10
  1. To configure CALIB_MON_TIME_UNIT, user has to calculate the total available IDLE time in the frames and please refer interBurstTime for the same. The duration for all the enabled monitors should be included and following SoftwareOverheads software overheads should be added to that number.
Software Overheads
Software Overhead Total Duration(us)Total Critical Time(us)
Periodic monitoring of stack usage2020
Minimum monitoring duration (report formation, digital energy monitor at the end of CAL_MON_TIME_UNIT, temperature read every CAL_MON_TIME_UNIT)600100
Minimum run time calibration duration (report formation, temperature read every CAL_MON_TIME_UNIT)300100
Idle time needed per FTTI for windowed watchdog (WDT) Frame period * CALIB_MON_TIME_UNIT/8 i.e. ~12.5% of Frame period * CALIB_MON_TIME_UNIT is reserved for watchdog clearing time0
 Related Files
- rl_monitoring.c

Function Documentation

◆ rlRfAnaFaultInjConfig()

rlReturnVal_t rlRfAnaFaultInjConfig ( rlUInt8_t  deviceMap,
rlAnaFaultInj_t *  data 
)

Sets information related to RF fault injection.

Parameters
[in]deviceMap- Bitmap of devices to send the message
[in]data- Fault injection config
Returns
rlReturnVal_t Success - 0, Failure - Error Code

This API is a fault injection API which the host sends to the AWR device. It can be used to inject faults in the analog circuits to test the corresponding monitors. After the faults are injected, the regular enabled monitors will indicate the faults in their associated reports.

Note
1: This API should be issued when no frames are on-going.
2: The fault injection should be tested by injecting one fault at a time.
3: It is recommended to perform device reset after enabling fault injection before moving to functional mode
4: Some of the fault injection options are de-featured, please refer latest DFP release note for more details.
5: Disable all runtime calibrations while Fault is injected.

Definition at line 1165 of file rl_monitoring.c.

◆ rlRfAnaMonConfig()

rlReturnVal_t rlRfAnaMonConfig ( rlUInt8_t  deviceMap,
rlMonAnaEnables_t data 
)

This function contains the consolidated configuration of all analog monitoring. The enabled monitoring functions are executed with a periodicity of CAL_MON_TIME_UNITS (rlRfCalMonTimeUntConf_t.calibMonTimeUnit) number of logical frames. The host should ensure that all the enabled monitors can be completed in the available inter-frame times, based on the monitoring durations. The time taken for each monitoring is not defined in this document.

Parameters
[in]deviceMap- Bitmap of devices to send the message
[in]data- Monitor analog enable configuration
Returns
rlReturnVal_t Success - 0, Failure - Error Code

Sets the consolidated configuration of all analog monitoring.

Note
1: None of the Safety Monitoring are supported in QM devices except Rx saturation and signal image monitor. The monitoring configurations defined below from sub-block ID 0x01C0 to 0x01DF are not valid in QM devices.
2: All Monitoring configurations and enable control APIs shall be issues before triggering the frames. The run time programming or configuration update for monitors are not supported while frames are running.
3: None of the Monitoring features are supported for VCO3.

Definition at line 174 of file rl_monitoring.c.

◆ rlRfDigMonEnableConfig()

rlReturnVal_t rlRfDigMonEnableConfig ( rlUInt8_t  deviceMap,
rlMonDigEnables_t data 
)

Sets the consolidated configuration of all digital monitoring.

Parameters
[in]deviceMap- Bitmap of devices to send the message
[in]data- Monitor digital enable configuration
Returns
rlReturnVal_t Success - 0, Failure - Error Code

This API SB sets the consolidated configuration of all digital monitoring. This API should be issued only when frames are not running, these are destructive tests. The scheduling of these monitoring should be handled in the external application. Report of these monitoring will be available in the async event RL_RF_AE_DIG_LATENTFAULT_REPORT_AE_SB.

Definition at line 93 of file rl_monitoring.c.

◆ rlRfDigMonPeriodicConfig()

rlReturnVal_t rlRfDigMonPeriodicConfig ( rlUInt8_t  deviceMap,
rlDigMonPeriodicConf_t data 
)

Sets the consolidated configuration.

Parameters
[in]deviceMap- Bitmap of devices to send the message
[in]data- Digital monitor periodic configuration
Returns
rlReturnVal_t Success - 0, Failure - Error Code

Sets the consolidated configuration of all periodic digital monitoring within radar sub-system.

Definition at line 127 of file rl_monitoring.c.

◆ rlRfDualClkCompMonConfig()

rlReturnVal_t rlRfDualClkCompMonConfig ( rlUInt8_t  deviceMap,
rlDualClkCompMonConf_t data 
)

Sets information related to the DCC based clock frequency monitoring.

Parameters
[in]deviceMap- Bitmap of devices to send the message
[in]data- Dual clock comp monitoring config
Returns
rlReturnVal_t Success - 0, Failure - Error Code

This API is a Monitoring Configuration API, containing information related to the DCC based clock frequency monitoring. Once configured, radarSS will send Async event (RL_RF_AE_MON_DCC_CLK_FREQ_REPORT) to report monitoring data

Definition at line 980 of file rl_monitoring.c.

◆ rlRfExtAnaSignalsMonConfig()

rlReturnVal_t rlRfExtAnaSignalsMonConfig ( rlUInt8_t  deviceMap,
rlExtAnaSignalsMonConf_t data 
)

Sets information related to external DC signals monitoring.

Parameters
[in]deviceMap- Bitmap of devices to send the message
[in]data- External anlog signal monitor config
Returns
rlReturnVal_t Success - 0, Failure - Error Code

This API is a Monitoring Configuration API, containing information related to external DC signals monitoring. Once configured, radarSS will send Async event (RL_RF_AE_MON_EXT_ANALOG_SIG_REPORT) to report monitoring data

Definition at line 681 of file rl_monitoring.c.

◆ rlRfGpadcIntAnaSignalsMonConfig()

rlReturnVal_t rlRfGpadcIntAnaSignalsMonConfig ( rlUInt8_t  deviceMap,
rlGpadcIntAnaSignalsMonConf_t data 
)

Sets information related to GPADC Internal Analog Signals monitoring.

Parameters
[in]deviceMap- Bitmap of devices to send the message
[in]data- GPADC internal analog signal monitoring config
Returns
rlReturnVal_t Success - 0, Failure - Error Code

This API is a Monitoring Configuration API, containing information related to GPADC Internal Analog Signals monitoring. Once configured, radarSS will send Async event (RL_RF_AE_MON_GPADC_INT_ANA_SIG_REPORT) to report monitoring data.

Definition at line 901 of file rl_monitoring.c.

◆ rlRfPllContrlVoltMonConfig()

rlReturnVal_t rlRfPllContrlVoltMonConfig ( rlUInt8_t  deviceMap,
rlPllContrVoltMonConf_t data 
)

Sets information related to APLL and Synthesizer's control voltage signals monitoring.

Parameters
[in]deviceMap- Bitmap of devices to send the message
[in]data- PLL control voltage monitoring config
Returns
rlReturnVal_t Success - 0, Failure - Error Code

This API is a Monitoring Configuration API, containing information related to APLL and Synthesizer's control voltage signals monitoring Once configured, radarSS will send Async event (RL_RF_AE_MON_PLL_CONTROL_VOLT_REPORT) to report monitoring data

Definition at line 941 of file rl_monitoring.c.

◆ rlRfPmClkLoIntAnaSignalsMonConfig()

rlReturnVal_t rlRfPmClkLoIntAnaSignalsMonConfig ( rlUInt8_t  deviceMap,
rlPmClkLoIntAnaSignalsMonConf_t data 
)

Sets information related to Power Management, Clock generation and LO distribution.

Parameters
[in]deviceMap- Bitmap of devices to send the message
[in]data- PMCLK internal analog signal monitoring config
Returns
rlReturnVal_t Success - 0, Failure - Error Code

This API is a Monitoring Configuration API, containing information related to Power Management,Clock generation and LO distribution circuits' Internal Analog Signals monitoring. The 20GHz SYNC IN/OUT monitor is supported only in cascade master and slave modes. If 20G SYNC monitor is enabled in slaves, it is recommended to enable this monitor in master as well, since slave devices are dependent on master 20GHz SYNC settings to operate properly. Once configured, radarSS will send Async event (RL_RF_AE_MON_PMCLKLO_INT_ANA_SIG_REPORT) to report monitoring data

Definition at line 861 of file rl_monitoring.c.

◆ rlRfRxGainPhMonConfig()

rlReturnVal_t rlRfRxGainPhMonConfig ( rlUInt8_t  deviceMap,
rlRxGainPhaseMonConf_t data 
)

This API is to set RX gain and phase monitoring config to device.

Parameters
[in]deviceMap- Bitmap of devices to send the message
[in]data- Rx gain phase monitoring configuration
Returns
rlReturnVal_t Success - 0, Failure - Error Code

This is a monitoring configuration API, containing information related to RX gain and phase monitoring. Once configured, radarSS will send Async event (RL_RF_AE_MON_RX_GAIN_PHASE_REPORT) to report monitoring data.

Note
1: It is recommended for the user to configure this monitor in verbose mode (Mode 0), so that Host can compute actual RX gain through temperature compensation and detect presence of interference using Noise Power.
2: In quiet mode, the user may consider programming broad thresholds for Absolute Gain Error, taking into account the temperature variation of reported RX gain value.

Definition at line 260 of file rl_monitoring.c.

◆ rlRfRxIfSatMonConfig()

rlReturnVal_t rlRfRxIfSatMonConfig ( rlUInt8_t  deviceMap,
rlRxSatMonConf_t data 
)

Sets information related to RX saturation detector monitoring.

Parameters
[in]deviceMap- Bitmap of devices to send the message
[in]data- Rx saturation monitoring config
Returns
rlReturnVal_t Success - 0, Failure - Error Code

This API is a Monitoring Configuration API, containing information related to RX saturation detector monitoring. It is recommended to re-issue these RX saturation monitor configuration APIs each time before enabling these monitor and frame trigger. The right sequence is as below:

  1. Issue RX saturation monitor configuration API.
  2. Enable RX saturation monitor.
  3. Frame start.
  4. Frame stop.
  5. Frame start (Optional in case of multiple frames).
  6. Frame stop (Optional in case of multiple frames).
  7. Disable RX saturation monitor (in case disabled for some reason).
  8. Issue RX saturation monitor configuration API.
  9. Enable RX saturation monitor.
  10. Frame start.

Definition at line 1029 of file rl_monitoring.c.

◆ rlRfRxIfStageMonConfig()

rlReturnVal_t rlRfRxIfStageMonConfig ( rlUInt8_t  deviceMap,
rlRxIfStageMonConf_t data 
)

Sets information related to RX IF filter attenuation monitoring.

Parameters
[in]deviceMap- Bitmap of devices to send the message
[in]data- Rx IF stage monitoring configuration
Returns
rlReturnVal_t Success - 0, Failure - Error Code

This API is a Monitoring Configuration API, containing information related to RX IF filter attenuation monitoring. Once configured, radarSS will send Async event (RL_RF_AE_MON_RX_IF_STAGE_REPORT) to report monitoring data

Definition at line 342 of file rl_monitoring.c.

◆ rlRfRxIntAnaSignalsMonConfig()

rlReturnVal_t rlRfRxIntAnaSignalsMonConfig ( rlUInt8_t  deviceMap,
rlRxIntAnaSignalsMonConf_t *  data 
)

Sets information related to RX Internal Analog Signals monitoring.

Parameters
[in]deviceMap- Bitmap of devices to send the message
[in]data- Rx internal analog signal monitoring config
Returns
rlReturnVal_t Success - 0, Failure - Error Code

This API is a Monitoring Configuration API, containing information related to RX Internal Analog Signals monitoring. Once configured, radarSS will send Async event (RL_RF_AE_MON_RX_INT_ANALOG_SIG_REPORT) to report monitoring data

Definition at line 818 of file rl_monitoring.c.

◆ rlRfRxNoiseMonConfig()

rlReturnVal_t rlRfRxNoiseMonConfig ( rlUInt8_t  deviceMap,
rlRxNoiseMonConf_t data 
)

Sets information related to RX noise monitoring.

Parameters
[in]deviceMap- Bitmap of devices to send the message
[in]data- Rx noise monitor configuration
Returns
rlReturnVal_t Success - 0, Failure - Error Code

This is a monitoring configuration API, containing information related to RX noise monitoring of a profile. Once configured, radarSS will send Async event (RL_RF_AE_MON_RX_NOISE_FIG_REPORT) to report monitoring data.

Note
1: The noise monitor reports the real baseband receivers noise figure with LNA disabled. In complex receiver modes (i.e., complex 1x, complex 2x and pseudo real), the system noise figure is 3dB lower (better) than the reported number.
2: The Rx gain and phase monitoring shall be enabled when enabling Rx noise figure Monitoring. This monitors only baseband noise figure.
3: The RX Noise figure monitor API is not supported in production, it can be used only for debug. Please refer latest DFP release note for more info.

Definition at line 305 of file rl_monitoring.c.

◆ rlRfRxSigImgMonConfig()

rlReturnVal_t rlRfRxSigImgMonConfig ( rlUInt8_t  deviceMap,
rlSigImgMonConf_t data 
)

Sets information related to signal and image band energy.

Parameters
[in]deviceMap- Bitmap of devices to send the message
[in]data- Signal img monitoring config
Returns
rlReturnVal_t Success - 0, Failure - Error Code

This API is a Monitoring Configuration API, containing information related to signal and image band energy. The Monitoring report is available as CQ1 (part of CQ) in CQ RAM. The application should transfer the report every chirp.
It is recommended to re-issue these RX signal image monitor configuration APIs each time before enabling these monitor and frame trigger. The right sequence is as below:

  1. Issue RX signal image monitor configuration API.
  2. Enable RX signal image monitor.
  3. Frame start.
  4. Frame stop.
  5. Frame start (Optional in case of multiple frames).
  6. Frame stop (Optional in case of multiple frames).
  7. Disable RX signal image monitor (in case disabled for some reason).
  8. Issue RX signal image monitor configuration API.
  9. Enable RX signal image monitor.
  10. Frame start.

Definition at line 1079 of file rl_monitoring.c.

◆ rlRfSynthFreqMonConfig()

rlReturnVal_t rlRfSynthFreqMonConfig ( rlUInt8_t  deviceMap,
rlSynthFreqMonConf_t data 
)

Sets information related to synthesizer frequency.

Parameters
[in]deviceMap- Bitmap of devices to send the message
[in]data-Synthesizer frequency monitor configuration
Returns
rlReturnVal_t Success - 0, Failure - Error Code

This API is a Monitoring Configuration API, containing information related to synthesizer frequency monitoring during non functional chirps (non-live), the live monitor during functional chirps can be used only for debug (only in master/single-chip mode). Once configured, radarSS will send Async event (RL_RF_AE_MON_SYNTHESIZER_FREQ_REPORT) to report monitoring data.

Note
1: (Live mode) It is recommended to re-issue this configuration API each time before enabling this monitor and frame trigger. The right sequence is as below:
  1. Issue Synth frequency monitor configuration API.
  2. Enable Synth frequency monitor.
  3. Frame start.
  4. Frame stop.
  5. Frame start (Optional in case of multiple frames).
  6. Frame stop (Optional in case of multiple frames).
  7. Disable Synth frequency monitor (in case disabled for some reason).
  8. Issue Synth frequency monitor configuration API.
  9. Enable Synth frequency monitor.
  10. Frame start.
2: In non live mode, this API can be issued twice with MONITOR_CONFIG_MODE value set to 1 and 2 respectively for two different VCOs configured in two different profiles. The consolidated report for two VCO's in non-live mode and consolidated report is sent in a separate AE AWR_MONITOR_SYNTHESIZER_FREQUENCY_NONLIVE_REPORT_AE_SB
3: In non live mode, the reporting mode and VCO_MON_EN for two VCO configurations should be same.
4: The synth non-live mode monitor internally generates a test chirp based on the profile associated with it. In order to limit its execution time, if the profile's ramp time exceeds 60us, the test chirp's ramp time is limited to 60us and the chirp slope is scaled to cover the profile's intended RF bandwidth.

Definition at line 644 of file rl_monitoring.c.

◆ rlRfTempMonConfig()

rlReturnVal_t rlRfTempMonConfig ( rlUInt8_t  deviceMap,
rlTempMonConf_t data 
)

This API configure the on chip temperature monitors and report the soft results from the monitor. The corresponding monitors are collectively named TEMPERATURE_MONITOR. These monitors observe the temperature near various RF analog and digital modules using temperature sensors and GPADC and compare them against configurable thresholds. The report is sent as an async event RL_RF_AE_MON_TEMPERATURE_REPORT_SB. Sets information related to temperature monitoring.

Parameters
[in]deviceMap- Bitmap of devices to send the message
[in]data- Temperature monitor configuration
Returns
rlReturnVal_t Success - 0, Failure - Error Code

Sets information related to temperature monitoring. Once configured, radarSS will send Async event (RL_RF_AE_MON_TEMPERATURE_REPORT_SB) to report monitoring data

Note
: The digital temperature sensor monitor threshold checks (Min, Max and Delta) can be disabled by programming DIG_TEMP_THRESH_MIN and DIG_TEMP_THRESH_MAX to value zero.

Definition at line 218 of file rl_monitoring.c.

◆ rlRfTxBallbreakMonConfig()

rlReturnVal_t rlRfTxBallbreakMonConfig ( rlUInt8_t  deviceMap,
rlAllTxBallBreakMonCfg_t data 
)

Sets information related to TX ball break detection.

Parameters
[in]deviceMap- Bitmap of devices to send the message
[in]data- Tx ballbreak monitor config
Returns
rlReturnVal_t Success - 0, Failure - Error Code

This API is a Monitoring Configuration API, containing information related to TX ball break detection. Once configured, radarSS will send Async event (RL_RF_AE_MON_TX0_BALLBREAK_REPORT, RL_RF_AE_MON_TX1_BALLBREAK_REPORT, RL_RF_AE_MON_TX2_BALLBREAK_REPORT) to report monitoring data

Definition at line 479 of file rl_monitoring.c.

◆ rlRfTxGainPhaseMismatchMonConfig()

rlReturnVal_t rlRfTxGainPhaseMismatchMonConfig ( rlUInt8_t  deviceMap,
rlTxGainPhaseMismatchMonConf_t data 
)

Sets information related to TX gain and phase mismatch monitoring.

Parameters
[in]deviceMap- Bitmap of devices to send the message
[in]data- Tx gain phase mismatch monitor configuration
Returns
rlReturnVal_t Success - 0, Failure - Error Code

This API is a Monitoring Configuration API, containing information related to TX gain and phase mismatch monitoring. Once configured, radarSS will send Async event (RL_RF_AE_MON_TX_GAIN_MISMATCH_REPORT) to report monitoring data

Note
1: Even when the TXs are matched, TX3 loopback path has gain and phase offsets wrt TX1 (and TX2), which get reported as mismatches in this API. These deterministic offsets can be compensated either through the OFFSET_VALUE fields (quiet mode) or through post processing by the host (verbose mode).
Nominally, when the TXs are matched, TX3 - TX1 gain (i.e. loopback amplitude) is reported as -8dB. Nominally, when the TXs are matched, the reported TX3 - TX1 phase difference varies linearly with RF and it is reported as -5degree (76GHz) and 15degree (81GHz).

Definition at line 582 of file rl_monitoring.c.

◆ rlRfTxIntAnaSignalsMonConfig()

rlReturnVal_t rlRfTxIntAnaSignalsMonConfig ( rlUInt8_t  deviceMap,
rlAllTxIntAnaSignalsMonConf_t data 
)

Sets information related to TX Internal Analog Signals monitoring.

Parameters
[in]deviceMap- Bitmap of devices to send the message
[in]data- Tx internal analog signal monitoring configuration
Returns
rlReturnVal_t Success - 0, Failure - Error Code

This API is a Monitoring Configuration API, containing information related to TX Internal Analog Signals monitoring including Tx Phase shifter DAC monitor. Once configured, radarSS will send Async event (RL_RF_AE_MON_TX0_INT_ANA_SIG_REPORT RL_RF_AE_MON_TX1_INT_ANA_SIG_REPORT, RL_RF_AE_MON_TX2_INT_ANA_SIG_REPORT) to report monitoring data

Definition at line 723 of file rl_monitoring.c.

◆ rlRfTxPhShiftMonConfig()

rlReturnVal_t rlRfTxPhShiftMonConfig ( rlUInt8_t  deviceMap,
rlAllTxPhShiftMonConf_t data 
)

Sets information related to TX Phase shifter monitoring.

Parameters
[in]deviceMap- Bitmap of devices to send the message
[in]data- Tx Phase shifter monitor configuration
Returns
rlReturnVal_t Success - 0, Failure - Error Code

This API configures the monitors of transmitter phase shifter and report the soft results from the monitor for various TX channels using TX loop-back. The corresponding monitors are collectively named TX0_PHASE_SHIFTER_MONITOR, TX1_PHASE_SHIFTER_MONITOR and TX2_PHASE_SHIFTER_MONITOR for the respective TX channels.

The phase shifter monitor will report the measured phase values in order to enable calibration of phase shifter codes at HOST. It will report tone power amplitude to provide check for amplitude stability across phase shifter codes. It will also report noise power in order to detect the chirps affected by interference. The maximum four phases can be monitored at a time in one FTTI interval for each TX, there is an option to increment the phase by PH_SHIFTER_INC_VAL to cover all 360 degree phase over the time.

Note
: The absolute gain/phase values reported by PHASE_SHIFTER_MON can exhibit smooth drifts across monitoring intervals due to slow temperature drifts. The absolute phase/gain can also exhibit abrupt jumps across temperature calibration boundaries. One way to mitigate the effects of such jumps across monitoring intervals is to rely on relative gain/phase values within the same monitoring report (e.g. assign one of the 4 phase settings in the monitoring configuration as a reference phase setting).

Definition at line 1221 of file rl_monitoring.c.

◆ rlRfTxPowrMonConfig()

rlReturnVal_t rlRfTxPowrMonConfig ( rlUInt8_t  deviceMap,
rlAllTxPowMonConf_t data 
)

Sets information related to TX power monitoring.

Parameters
[in]deviceMap- Bitmap of devices to send the message
[in]data- Tx power monitor configuration
Returns
rlReturnVal_t Success - 0, Failure - Error Code

This API is a Monitoring Configuration API, containing information related to TX0/1/2 power monitoring. Once configured, radarSS will send Async event (RL_RF_AE_MON_TX0_POWER_REPORT, RL_RF_AE_MON_TX1_POWER_REPORT, RL_RF_AE_MON_TX2_POWER_REPORT) to report monitoring data

Note
1: The TX[0:2] power monitoring accuracy degrades at high TX backoffs and is unreliable for backoffs higher than 20dB on AWR2243 and 26dB on xWR6x43.
2: The 0dB back-off corresponds to typically 13dBm power level in AWR2243/xWR6x43 device.

Definition at line 384 of file rl_monitoring.c.


Copyright 2021, Texas Instruments Incorporated