![]() |
![]() |
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. . | |
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. The LB power might be bad/corrupted under interference conditions. . | |
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. . | |
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. . | |
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) . | |
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 2937 of file mmwavelink.h.
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 3097 of file mmwavelink.h.
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 3120 of file mmwavelink.h.
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.
.
Definition at line 3074 of file mmwavelink.h.