Data Fields
rlMonRxGainPhRep_t Struct Reference

This API is a Monitoring report which RadarSS sends to the host, containing the measured RX gain and phase values,Loopback Power and Noise Power. Noise Power can be used by the Host to detect the presence of interference. RadarSS sends this to host at the
programmed periodicity or when failure occurs, as programmed by the configuration API SB. Event: RL_RF_AE_MON_RX_GAIN_PHASE_REPORT. More...

#include <control/mmwavelink/mmwavelink.h>

Data Fields

rlUInt16_t statusFlags
 Status flags indicating pass fail results corresponding
to various threshold checks under this monitor.
Bit STATUS_FLAG for monitor
[0] STATUS_RX_GAIN_ABS
[1] STATUS_RX_GAIN_MISMATCH
[2] STATUS_RX_GAIN_FLATNESS
[3] STATUS_RX_PHASE_MISMATCH
[15:4]RESERVED
0 - FAIL or check wasn't done, 1 - PASS
.
 
rlUInt16_t errorCode
 Indicates any error reported during monitoring Value of 0 indicates no error.
 
rlUInt8_t profIndex
 Profile Index for which this monitoring report applies.
 
rlUInt8_t loopbackPowerRF1
 The measured average loop-back power across RX channels at each enabled RF1 frequency (i.e. Lowest, center and highest with 60MHz dither in the profile's RF band) at LNA input is reported here.
b4:b0 RF1
b7-b5: reserved
1LSB = -2 dBm
Valid range = -62dBm to 0dBm.
Only the entries of enabled RF frequencies are valid.
. More...
 
rlUInt8_t loopbackPowerRF2
 The measured average loop-back power across RX channels at each enabled RF2 frequency (i.e. Lowest, center and highest with 60MHz dither in the profile's RF band) at LNA input is reported here.
b4:b0 RF2
b7-b5: reserved
1LSB = -2 dBm
Valid range = -62dBm to 0dBm.
Only the entries of enabled RF frequencies are valid.
. More...
 
rlUInt8_t loopbackPowerRF3
 The measured average loop-back power across RX channels at each enabled RF3 frequency (i.e. Lowest, center and highest with 60MHz dither in the profile's RF band) at LNA input is reported here.
b4:b0 RF3
b7-b5: reserved
1LSB = -2 dBm
Valid range = -62dBm to 0dBm.
Only the entries of enabled RF frequencies are valid.
. More...
 
rlUInt16_t rxGainVal [12U]
 The measured RX gain for each enabled channel, at each enabled RF frequency
(i.e., lowest, center and highest in the profile's RF band) is reported
here. Byte numbers corresponding to different RX and RF, in this field
are here:
RF1 RF2 RF3
RX0 1:0 9:8 17:16
RX1 3:2 11:10 19:18
RX2 5:4 13:12 21:20
RX3 7:6 15:14 23:22
1 LSB = 0.1 dB
Only the entries of enabled RF Frequencies and enabled RX channels are
valid.
The RX gain is measured using only ADC power and under assumption of fixed LB power of -39dBm for all RF1, RF2 and RF3 frequencies (this is irrespective of LB power measured using power detectors at LNA input, which can potentially be interference-affected). Due to such assumptions, RX_GAIN_VALUE will be approximate and can have ~7 dB deviation from programmed RX gain across temperature.
In interference-free condition, one may calculate the actual Rx gain of the device in dB as RX = RX GAIN VALUE(Rf freq, Rx) + (-39dBm) – LOOPBACK_POWER_TEMP_dBm(Temp[C])
Where LOOPBACK_POWER_TEMP_dBm (Temp[C]) = -0.05*Temp[C] – 37, is the nominal loopback signal strength for nominal process corner. It may deviate by up to ~5 dB due to process variation and the process variation can be mitigated by using LOOPBACK_POWER field and/or a reference customer factory measurement for each sensor.
.
 
rlUInt16_t rxPhaseVal [12U]
 The measured RX phase for each enabled channel, at each enabled RF frequency is
reported here. Byte numbers corresponding to different RX and RF,
in this field are here:
RF1 RF2 RF3
RX0 1:0 9:8 17:16
RX1 3:2 11:10 19:18
RX2 5:4 13:12 21:20
RX3 7:6 15:14 23:22
LSB = 360 (degree)/2^16.
Only the entries of enabled RF Frequencies and enabled RX channels are
valid.
. More...
 
rlUInt32_t rxNoisePower1
 The measured RX noise power for each enabled channel, at RF1 & RF2 frequencies
(i.e., lowest and center in the profile's RF band) are reported here. Bit
numbers corresponding to different RX and RF, in this field are here:
. More...
 
rlUInt32_t rxNoisePower2
 The measured RX noise power for each enabled channel, at RF2 & RF3 frequencies
(i.e., center and highest in the profile's RF band) are reported here. Bit
numbers corresponding to different RX and RF, in this field are here:
. More...
 
rlUInt32_t timeStamp
 This field indicates when the last monitoring in the enabled set was performed.
1 LSB = 1 millisecond (the stamp rolls over upon exceeding allotted bit
width)
.
 

Detailed Description

This API is a Monitoring report which RadarSS sends to the host, containing the measured RX gain and phase values,Loopback Power and Noise Power. Noise Power can be used by the Host to detect the presence of interference. RadarSS sends this to host at the
programmed periodicity or when failure occurs, as programmed by the configuration API SB. Event: RL_RF_AE_MON_RX_GAIN_PHASE_REPORT.

Definition at line 3031 of file mmwavelink.h.

Field Documentation

◆ loopbackPowerRF1

rlUInt8_t rlMonRxGainPhRep_t::loopbackPowerRF1

The measured average loop-back power across RX channels at each enabled RF1 frequency (i.e. Lowest, center and highest with 60MHz dither in the profile's RF band) at LNA input is reported here.
b4:b0 RF1
b7-b5: reserved
1LSB = -2 dBm
Valid range = -62dBm to 0dBm.
Only the entries of enabled RF frequencies are valid.
.

Note
: The Loopback power can optionally be used to improve the RX gain estimation accuracy. But time domain filtering across many successive monitoring reports is recommended to mitigate their corruption by external interference.

Definition at line 3067 of file mmwavelink.h.

◆ loopbackPowerRF2

rlUInt8_t rlMonRxGainPhRep_t::loopbackPowerRF2

The measured average loop-back power across RX channels at each enabled RF2 frequency (i.e. Lowest, center and highest with 60MHz dither in the profile's RF band) at LNA input is reported here.
b4:b0 RF2
b7-b5: reserved
1LSB = -2 dBm
Valid range = -62dBm to 0dBm.
Only the entries of enabled RF frequencies are valid.
.

Note
: The Loopback power can optionally be used to improve the RX gain estimation accuracy. But time domain filtering across many successive monitoring reports is recommended to mitigate their corruption by external interference.

Definition at line 3081 of file mmwavelink.h.

◆ loopbackPowerRF3

rlUInt8_t rlMonRxGainPhRep_t::loopbackPowerRF3

The measured average loop-back power across RX channels at each enabled RF3 frequency (i.e. Lowest, center and highest with 60MHz dither in the profile's RF band) at LNA input is reported here.
b4:b0 RF3
b7-b5: reserved
1LSB = -2 dBm
Valid range = -62dBm to 0dBm.
Only the entries of enabled RF frequencies are valid.
.

Note
: The Loopback power can optionally be used to improve the RX gain estimation accuracy. But time domain filtering across many successive monitoring reports is recommended to mitigate their corruption by external interference.

Definition at line 3095 of file mmwavelink.h.

◆ rxNoisePower1

rlUInt32_t rlMonRxGainPhRep_t::rxNoisePower1

The measured RX noise power for each enabled channel, at RF1 & RF2 frequencies
(i.e., lowest and center in the profile's RF band) are reported here. Bit
numbers corresponding to different RX and RF, in this field are here:
.

Bit 4:0 9:5 14:10 19:15 24:20 29:25
RX & RF RX0.RF1 RX1.RF1 RX2.RF1 RX3.RF1 RX0.RF2 RX1.RF2

bit 31:30 - Reserved
1 LSB = -2 dBm.
Range: 0 to -62dBm
Noise Power is nominally around -56 dBm, in interference-free condition. This field can enable the host in detecting if the corresponding gain/phase measurement was potentially corrupted by interference or not.
For example, if the reported noise power exceeds significantly from typical values (e.g. based on median of the reported values in the past few 100 mili-seconds), it can indicate that the gain/phase measurement is potentially corrupted by interference. Such gain/phase measurement reports may be discarded and the results from the next monitoring interval or from other RF frequencies may be used instead.

Definition at line 3210 of file mmwavelink.h.

◆ rxNoisePower2

rlUInt32_t rlMonRxGainPhRep_t::rxNoisePower2

The measured RX noise power for each enabled channel, at RF2 & RF3 frequencies
(i.e., center and highest in the profile's RF band) are reported here. Bit
numbers corresponding to different RX and RF, in this field are here:
.

Bit 4:0 9:5 14:10 19:15 24:20 29:25
RX & RF RX2.RF2 RX3.RF2 RX0.RF3 RX1.RF3 RX2.RF3 RX3.RF3

bit 31:30 - Reserved
1 LSB = -2 dBm.
Range: 0 to -62dBm
Noise Power is nominally around -56 dBm, in interference-free condition. This field can enable the host in detecting if the corresponding gain/phase measurement was potentially corrupted by interference or not.
For example, if the reported noise power exceeds significantly from typical values (e.g. based on median of the reported values in the past few 100 mili-seconds), it can indicate that the gain/phase measurement is potentially corrupted by interference. Such gain/phase measurement reports may be discarded and the results from the next monitoring interval or from other RF frequencies may be used instead.

Definition at line 3233 of file mmwavelink.h.

◆ rxPhaseVal

rlUInt16_t rlMonRxGainPhRep_t::rxPhaseVal[12U]

The measured RX phase for each enabled channel, at each enabled RF frequency is
reported here. Byte numbers corresponding to different RX and RF,
in this field are here:
RF1 RF2 RF3
RX0 1:0 9:8 17:16
RX1 3:2 11:10 19:18
RX2 5:4 13:12 21:20
RX3 7:6 15:14 23:22
LSB = 360 (degree)/2^16.
Only the entries of enabled RF Frequencies and enabled RX channels are
valid.
.

Note
: these phases include an unknown bias common to all RX channels.

Definition at line 3187 of file mmwavelink.h.


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

Copyright 2020, Texas Instruments Incorporated