NI RFmx LTE ModAcc Fetch Functions - ni/grpc-device GitHub Wiki

ModAcc Fetch Functions

RFmxLTE_ModAccFetchCompositeEVM

int32 __stdcall RFmxLTE_ModAccFetchCompositeEVM (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* meanRMSCompositeEVM, float64* maximumPeakCompositeEVM, float64* meanFrequencyError, int32* peakCompositeEVMSymbolIndex, int32* peakCompositeEVMSubcarrierIndex, int32* peakCompositeEVMSlotIndex);

Purpose

Fetches the composite EVM for ModAcc measurements. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
Output
Name Type Description
meanRMSCompositeEVM float64* Returns the mean value of the RMS EVMs calculated on all configured channels over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) attribute.
maximumPeakCompositeEVM float64* Returns the symbol index where the ModAcc maximum peak composite EVM occurs.
meanFrequencyError float64* Returns the estimated carrier frequency offset averaged over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute.
peakCompositeEVMSymbolIndex int32* Returns the symbol index where the ModAcc maximum peak composite EVM occurs.
peakCompositeEVMSubcarrierIndex int32* Returns the subcarrier index where the ModAcc maximum peak composite EVM occurs.
peakCompositeEVMSlotIndex int32* Returns the slot index where the ModAcc maximum peak composite EVM occurs.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchCompositeEVMArray

int32 __stdcall RFmxLTE_ModAccFetchCompositeEVMArray (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64 meanRMSCompositeEVM[], float64 maximumPeakCompositeEVM[], float64 meanFrequencyError[], int32 peakCompositeEVMSymbolIndex[], int32 peakCompositeEVMSubcarrierIndex[], int32 peakCompositeEVMSlotIndex[], int32 arraySize, int32* actualArraySize);

Purpose

Returns an array of the composite EVM for ModAcc measurements. Use "subblock<n>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, and subblock number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0"
"signal::sig1/subblock0"
"result::r1/subblock0"
"signal::sig1/result::r1/subblock0"
You can use the RFmxLTE_BuildSubblockString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
meanRMSCompositeEVM float64[] Returns the array of the mean value of the RMS EVMs calculated on all configured channels over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) attribute.
maximumPeakCompositeEVM float64[] Returns the array of the maximum value of peak EVMs calculated on all configured channels over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute.
meanFrequencyError float64[] Returns the array of the estimated carrier frequency offset averaged over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute.
peakCompositeEVMSymbolIndex int32[] Returns the array of the symbol index where the ModAcc maximum peak composite EVM occurs.
peakCompositeEVMSubcarrierIndex int32[] Returns the array of the subcarrier index of the Max Pk Composite EVM attribute.
peakCompositeEVMSlotIndex int32[] Returns the array of the slot index where the ModAcc maximum peak composite EVM occurs.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchCompositeMagnitudeAndPhaseError

int32 __stdcall RFmxLTE_ModAccFetchCompositeMagnitudeAndPhaseError (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* meanRMSCompositeMagnitudeError, float64* maxPeakCompositeMagnitudeError, float64* meanRMSCompositePhaseError, float64* maxPeakCompositePhaseError);

Purpose

Returns the mean RMS composite magnitude error, phase error, the maximum peak composite magnitude error, and the phase error. The function result is valid only when you set the RFMXLTE_ATTR_LINK_DIRECTION) attribute to RFMXLTE_VAL_LINK_DIRECTION_UPLINK. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
Output
Name Type Description
meanRMSCompositeMagnitudeError float64* Returns the RMS mean value of the magnitude error calculated over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) attribute on all the configured channels.
maxPeakCompositeMagnitudeError float64* Returns the peak value of magnitude error calculated over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute on all the configured channels.
meanRMSCompositePhaseError float64* Returns the RMS mean value of the phase error calculated over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute on all the configured channels. This value is expressed in degrees.
maxPeakCompositePhaseError float64* Returns the peak value of phase error calculated over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute on all thee configured channels. This value is expressed in degrees.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchCompositeMagnitudeAndPhaseErrorArray

int32 __stdcall RFmxLTE_ModAccFetchCompositeMagnitudeAndPhaseErrorArray (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64 meanRMSCompositeMagnitudeError[], float64 maximumPeakCompositeMagnitudeError[], float64 meanRMSCompositePhaseError[], float64 maximumPeakCompositePhaseError[], int32 arraySize, int32* actualArraySize);

Purpose

Returns the arrays of the mean RMS composite magnitude error and phase error, and the max peak composite magnitude error and phase error. The function result is valid only when you set the RFMXLTE_ATTR_LINK_DIRECTION) attribute to RFMXLTE_VAL_LINK_DIRECTION_UPLINK. Use "subblock<n>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, and subblock number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0"
"signal::sig1/subblock0"
"result::r1/subblock0"
"signal::sig1/result::r1/subblock0"
You can use the RFmxLTE_BuildSubblockString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
meanRMSCompositeMagnitudeError float64[] Returns the array of the RMS mean value of the magnitude error calculated over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) attribute on all the configured channels.
maximumPeakCompositeMagnitudeError float64[] Returns the array of the peak value of magnitude error calculated over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute on all the configured channels.
meanRMSCompositePhaseError float64[] Returns the array of the RMS mean value of the phase error calculated over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute on all the configured channels. This value is expressed in degrees.
maximumPeakCompositePhaseError float64[] Returns the array of the peak value of phase error calculated over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute on all thee configured channels. This value is expressed in degrees.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchIQImpairments

int32 __stdcall RFmxLTE_ModAccFetchIQImpairments (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* meanIQOriginOffset, float64* meanIQGainImbalance, float64* meanIQQuadratureError);

Purpose

Returns the mean I/Q origin offset, mean I/Q gain imbalance, and mean I/Q quadrature error. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
Output
Name Type Description
meanIQOriginOffset float64* Returns the estimated I/Q origin offset averaged over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) attribute. The modacc measurement ignores this parameter, when you set the RFMXLTE_ATTR_LINK_DIRECTION) attribute to RFMXLTE_VAL_LINK_DIRECTION_DOWNLINK.
meanIQGainImbalance float64* Returns the estimated I/Q gain imbalance averaged over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute. The I/Q gain imbalance is the ratio of the amplitude of the I component to the Q component of the I/Q signal being measured.
When you set the RFMXLTE_ATTR_COMPONENT_CARRIER_BANDWIDTH attribute to 200 kHz and the RFMXLTE_ATTR_NPUSCH_NUMBER_OF_TONES attribute to 12, this result is available. For other values of RFMXLTE_ATTR_NPUSCH_NUMBER_OF_TONES, this result will be reported as NaN.
meanIQQuadratureError float64* Returns the estimated quadrature error averaged over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute. Quadrature error is a measure of the skewness of the I component with respect to the Q component of the I/Q signal being measured. This value is expressed in degrees.
When you set the RFMXLTE_ATTR_COMPONENT_CARRIER_BANDWIDTH attribute to 200 kHz and the RFMXLTE_ATTR_NPUSCH_NUMBER_OF_TONES attribute to 12, this result is available. For other values of RFMXLTE_ATTR_NPUSCH_NUMBER_OF_TONES, this result will be reported as NaN.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchIQImpairmentsArray

int32 __stdcall RFmxLTE_ModAccFetchIQImpairmentsArray (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64 meanIQOriginOffset[], float64 meanIQGainImbalance[], float64 meanIQQuadratureError[], int32 arraySize, int32* actualArraySize);

Purpose

Returns an array of the mean I/Q origin offset, mean I/Q gain imbalance, and mean I/Q quadrature error. Use "subblock<n>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, and subblock number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0"
"signal::sig1/subblock0"
"result::r1/subblock0"
"signal::sig1/result::r1/subblock0"
You can use the RFmxLTE_BuildSubblockString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
meanIQOriginOffset float64[] Returns the array of the estimated I/Q origin offset averaged over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) attribute. The modacc measurement ignores this parameter, when you set the RFMXLTE_ATTR_LINK_DIRECTION) attribute to RFMXLTE_VAL_LINK_DIRECTION_DOWNLINK.
meanIQGainImbalance float64[] Returns the array of the estimated I/Q gain imbalance averaged over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute. The I/Q gain imbalance is the ratio of the amplitude of the I component to the Q component of the I/Q signal being measured.
When you set the RFMXLTE_ATTR_COMPONENT_CARRIER_BANDWIDTH attribute to 200 kHz and the RFMXLTE_ATTR_NPUSCH_NUMBER_OF_TONES attribute to 12, this result is available. For other values of RFMXLTE_ATTR_NPUSCH_NUMBER_OF_TONES, this result will be reported as NaN.
meanIQQuadratureError float64[] Returns the array of the estimated quadrature error averaged over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute. Quadrature error is a measure of the skewness of the I component with respect to the Q component of the I/Q signal being measured. This value is expressed in degrees.
When you set the RFMXLTE_ATTR_COMPONENT_CARRIER_BANDWIDTH attribute to 200 kHz and the RFMXLTE_ATTR_NPUSCH_NUMBER_OF_TONES attribute to 12, this result is available. For other values of RFMXLTE_ATTR_NPUSCH_NUMBER_OF_TONES, this result will be reported as NaN.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchSubblockIQImpairments

int32 __stdcall RFmxLTE_ModAccFetchSubblockIQImpairments (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* subblockMeanIQOriginOffset, float64* subblockMeanIQGainImbalance, float64* subblockMeanIQQuadratureError);

Purpose

Returns the mean I/Q origin offset, the mean I/Q gain imbalance, and the mean I/Q quadrature error of a subblock. This function is valid only when you set the RFMXLTE_ATTR_LINK_DIRECTION) attribute to RFMXLTE_VAL_LINK_DIRECTION_UPLINK and the RFMXLTE_ATTR_TRANSMITTER_ARCHITECTURE) attribute to RFMXLTE_VAL_TRANSMITTER_ARCHITECTURE_LO_PER_SUBBLOCK. Otherwise, the function returns NaN, as measurements of this result are currently not supported. Use "subblock<n>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, and subblock number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0"
"signal::sig1/subblock0"
"result::r1/subblock0"
"signal::sig1/result::r1/subblock0"
You can use the RFmxLTE_BuildSubblockString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
Output
Name Type Description
subblockMeanIQOriginOffset float64* Returns the estimated I/Q origin offset averaged over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) attribute in a subblock. This value is expressed in dBc.
subblockMeanIQGainImbalance float64* Returns the estimated I/Q gain imbalance averaged over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute. This value is expressed in dB. The I/Q gain imbalance is the ratio of the amplitude of the I component to the Q component of the I/Q signal being measured in the subblock.
subblockMeanIQQuadratureError float64* Returns the estimated quadrature error averaged over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute. This value is expressed in degrees. Quadrature error is a measure of the skewness of the I component with respect to the Q component of the I/Q signal being measured in the subblock.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchPDSCHEVM

int32 __stdcall RFmxLTE_ModAccFetchPDSCHEVM (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* meanRMSEVM, float64* meanRMSQPSKEVM, float64* meanRMS16QAMEVM, float64* meanRMS64QAMEVM, float64* meanRMS256QAMEVM);

Purpose

Fetches the physical downlink shared channel (PDSCH) EVMs. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
Output
Name Type Description
meanRMSEVM float64* Returns the mean value of RMS EVMs calculated on PDSCH data symbols over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) attribute. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT) attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_PERCENTAGE, the measurement is returned in percentage. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_DB, the measurement is returned in dB.
meanRMSQPSKEVM float64* Returns the mean value of RMS EVMs calculated on all QPSK modulated PDSCH resource blocks over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_PERCENTAGE, the measurement is returned in percentage. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_DB, the measurement is returned in dB.
meanRMS16QAMEVM float64* Returns the mean value of RMS EVMs calculated on all 16QAM modulated PDSCH resource blocks over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_PERCENTAGE, the measurement is returned in percentage. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_DB, the measurement is returned in dB.
meanRMS64QAMEVM float64* Returns the mean value of RMS EVMs calculated on all 64QAM modulated PDSCH resource blocks over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_PERCENTAGE, the measurement is returned in percentage. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_DB, the measurement is returned in dB.
meanRMS256QAMEVM float64* Returns the mean value of RMS EVMs calculated on all 256QAM modulated PDSCH resource blocks over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_PERCENTAGE, the measurement is returned in percentage. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_DB, the measurement is returned in dB.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchPDSCHEVMArray

int32 __stdcall RFmxLTE_ModAccFetchPDSCHEVMArray (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64 meanRMSEVM[], float64 meanRMSQPSKEVM[], float64 meanRMS16QAMEVM[], float64 meanRMS64QAMEVM[], float64 meanRMS256QAMEVM[], int32 arraySize, int32* actualArraySize);

Purpose

Fetches the array of physical downlink shared channel (PDSCH) EVM for all the component carriers within the subblock. Use "subblock<n>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, and subblock number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0"
"signal::sig1/subblock0"
"result::r1/subblock0"
"signal::sig1/result::r1/subblock0"
You can use the RFmxLTE_BuildSubblockString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
meanRMSEVM float64[] Returns the array of mean values of RMS EVMs calculated on the PDSCH data symbols over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) attribute. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT) attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_PERCENTAGE, the measurement is returned in percentage. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_DB, the measurement is returned in dB.
meanRMSQPSKEVM float64[] Returns the array of mean values of RMS EVMs calculated on all QPSK modulated PDSCH resource blocks over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_PERCENTAGE, the measurement is returned in percentage. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_DB, the measurement is returned in dB.
meanRMS16QAMEVM float64[] Returns the array of mean values of RMS EVMs calculated on all 16 QAM modulated PDSCH resource blocks over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_PERCENTAGE, the measurement is returned in percentage. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_DB, the measurement is returned in dB.
meanRMS64QAMEVM float64[] Returns the array of mean values of RMS EVMs calculated on all 64 QAM modulated PDSCH resource blocks over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_PERCENTAGE, the measurement is returned in percentage. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_DB, the measurement is returned in dB.
meanRMS256QAMEVM float64[] Returns the array of mean values of RMS EVMs calculated on all 256 QAM modulated PDSCH resource blocks over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_PERCENTAGE, the measurement is returned in percentage. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_DB, the measurement is returned in dB.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchPDSCH1024QAMEVM

int32 __stdcall RFmxLTE_ModAccFetchPDSCH1024QAMEVM (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* meanRMS1024QAMEVM);

Purpose

Fetches the physical downlink shared channel (PDSCH) 1024QAM EVMs. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
Output
Name Type Description
meanRMS1024QAMEVM float64* Returns a mean value of the calculated RMS EVMs on all 1024QAM modulated PDSCH resource blocks over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) attribute. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT) attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_PERCENTAGE, the measurement is returned in percentage. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_DB, the measurement is returned in dB.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchPDSCH1024QAMEVMArray

int32 __stdcall RFmxLTE_ModAccFetchPDSCH1024QAMEVMArray (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64 meanRMS1024QAMEVM[], int32 arraySize, int32* actualArraySize);

Purpose

Fetches an array of physical downlink shared channel (PDSCH) 1024QAM EVMs for all the component carriers within the subblock. Use "subblock<n>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, and subblock number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0"
"signal::sig1/subblock0"
"result::r1/subblock0"
"signal::sig1/result::r1/subblock0"
You can use the RFmxLTE_BuildSubblockString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
meanRMS1024QAMEVM float64[] Returns an array of mean values of the calculated RMS EVMs on all 1024QAM modulated PDSCH resource blocks over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) attribute. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT) attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_PERCENTAGE, the result is returned in percentage. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_DB, the measurement is returned in dB.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchCSRSEVM

int32 __stdcall RFmxLTE_ModAccFetchCSRSEVM (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* meanRMSCSRSEVM);

Purpose

Fetches the cell-specific reference signal EVM. Use "offset<k>" or "subblock<n>/offset<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
Output
Name Type Description
meanRMSCSRSEVM float64* Returns the mean value of RMS EVMs calculated on Reference Signal (RS) resource elements over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) attribute. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT) attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_PERCENTAGE, the measurement is returned in percentage. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_DB, the measurement is returned in dB.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchCSRSEVMArray

int32 __stdcall RFmxLTE_ModAccFetchCSRSEVMArray (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64 meanRMSCSRSEVM[], int32 arraySize, int32* actualArraySize);

Purpose

Fetches the array of CSRS EVMs for all the component carriers within the subblock. Use "subblock<n>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, and subblock number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0"
"signal::sig1/subblock0"
"result::r1/subblock0"
"signal::sig1/result::r1/subblock0"
You can use the RFmxLTE_BuildSubblockString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
meanRMSCSRSEVM float64[] Returns the array of mean values of RMS EVMs calculated on Reference Signal (RS) resource elements over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) attribute. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT) attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_PERCENTAGE, the measurement is returned in percentage. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_DB, the measurement is returned in dB.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchSynchronizationSignalEVM

int32 __stdcall RFmxLTE_ModAccFetchSynchronizationSignalEVM (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* meanRMSPSSEVM, float64* meanRMSSSSEVM);

Purpose

Fetches the primary synchronization signal (PSS) EVM and secondary synchronization signal (SSS) EVM. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
Output
Name Type Description
meanRMSPSSEVM float64* Returns the mean value of RMS EVMs calculated on PSS channel over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) attribute. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT) attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_PERCENTAGE, the measurement is returned in percentage. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_DB, the measurement is returned in dB.
meanRMSSSSEVM float64* Returns the mean value of RMS EVMs calculated on SSS channel over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_PERCENTAGE, the measurement is returned in percentage. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_DB, the measurement is returned in dB.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchSynchronizationSignalEVMArray

int32 __stdcall RFmxLTE_ModAccFetchSynchronizationSignalEVMArray (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64 meanRMSPSSEVM[], float64 meanRMSSSSEVM[], int32 arraySize, int32* actualArraySize);

Purpose

Returns the array of primary synchronization signal (PSS) EVMs and secondary synchronization signal (SSS) EVMS for all the component carriers within a subblock. Use "subblock<n>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, and subblock number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0"
"signal::sig1/subblock0"
"result::r1/subblock0"
"signal::sig1/result::r1/subblock0"
You can use the RFmxLTE_BuildSubblockString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
meanRMSPSSEVM float64[] Returns the array of mean values of RMS EVMs calculated on PSS channel over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) attribute. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT) attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_PERCENTAGE, the measurement is returned in percentage. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_DB, the measurement is returned in dB.
meanRMSSSSEVM float64[] Returns the array of mean values of RMS EVMs calculated on SSS channel over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_PERCENTAGE, the measurement is returned in percentage. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_DB, the measurement is returned in dB.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchDownlinkTransmitPower

int32 __stdcall RFmxLTE_ModAccFetchDownlinkTransmitPower (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* RSTransmitPower, float64* OFDMSymbolTransmitPower, float64* reserved1, float64* reserved2);

Purpose

Fetches the reference signal power and the OFDM symbol transmit power. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
Output
Name Type Description
RSTransmitPower float64* Returns the mean value of power calculated on cell-specific reference signal (CSRS) resource elements over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) attribute. This value is expressed in dBm.
OFDMSymbolTransmitPower float64* Returns the mean power value calculated in one OFDM symbol over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute. This value is expressed in dBm.
reserved1 float64* This result is not supported in this release and it is reserved for future enhancements.
reserved2 float64* This result is not supported in this release and it is reserved for future enhancements.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchDownlinkTransmitPowerArray

int32 __stdcall RFmxLTE_ModAccFetchDownlinkTransmitPowerArray (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64 RSTransmitPower[], float64 OFDMSymbolTransmitPower[], float64 reserved1[], float64 reserved2[], int32 arraySize, int32* actualArraySize);

Purpose

Fetches the array of reference signal powers and the OFDM symbol transmit powers for all the component carriers within the subblock. Use "subblock<n>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, and subblock number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0"
"signal::sig1/subblock0"
"result::r1/subblock0"
"signal::sig1/result::r1/subblock0"
You can use the RFmxLTE_BuildSubblockString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
RSTransmitPower float64[] Returns the array of mean values of power calculated on cell-specific reference signal (CSRS) resource elements over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) attribute. This value is expressed in dBm.
OFDMSymbolTransmitPower float64[] Returns the array the mean value of power calculated in one OFDM symbol over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute. This value is expressed in dBm.
reserved1 float64[] This result is not supported in this release and it is reserved for future enhancements.
reserved2 float64[] This result is not supported in this release and it is reserved for future enhancements.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchDownlinkDetectedCellID

int32 __stdcall RFmxLTE_ModAccFetchDownlinkDetectedCellID (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, int32* detectedCellID);

Purpose

Fetches the detected cell ID. This function is valid only when the measured signal contains primary synchronization signal (PSS) and secondary synchronization signal (SSS). Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
Output
Name Type Description
detectedCellID int32* Returns the detected cell ID value.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchDownlinkDetectedCellIDArray

int32 __stdcall RFmxLTE_ModAccFetchDownlinkDetectedCellIDArray (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, int32 detectedCellID[], int32 arraySize, int32* actualArraySize);

Purpose

Fetches the array of detected cell IDs for all the component carriers within the subblock. Use "subblock<n>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, and subblock number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0"
"signal::sig1/subblock0"
"result::r1/subblock0"
"signal::sig1/result::r1/subblock0"
You can use the RFmxLTE_BuildSubblockString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
detectedCellID int32[] Returns the array of the detected cell ID values.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchPDSCHQPSKConstellation

int32 __stdcall RFmxLTE_ModAccFetchPDSCHQPSKConstellation (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, NIComplexSingle QPSKConstellation[], int32 arraySize, int32* actualArraySize);

Purpose

Fetches the physical downlink shared channel (PDSCH) QPSK trace. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
QPSKConstellation NIComplexSingle[] Returns the QPSK constellation trace.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchPDSCH16QAMConstellation

int32 __stdcall RFmxLTE_ModAccFetchPDSCH16QAMConstellation (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, NIComplexSingle QAM16Constellation[], int32 arraySize, int32* actualArraySize);

Purpose

Fetches the physical downlink shared channel (PDSCH) 16 QAM trace. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
QAM16Constellation NIComplexSingle[] Returns the 16 QAM constellation trace.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchPDSCH64QAMConstellation

int32 __stdcall RFmxLTE_ModAccFetchPDSCH64QAMConstellation (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, NIComplexSingle QAM64Constellation[], int32 arraySize, int32* actualArraySize);

Purpose

Fetches the physical downlink shared channel (PDSCH) 64 QAM trace. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
QAM64Constellation NIComplexSingle[] Returns the 64 QAM constellation trace.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchPDSCH256QAMConstellation

int32 __stdcall RFmxLTE_ModAccFetchPDSCH256QAMConstellation (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, NIComplexSingle QAM256Constellation[], int32 arraySize, int32* actualArraySize);

Purpose

Fetches the physical downlink shared channel (PDSCH) 256 QAM trace. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
QAM256Constellation NIComplexSingle[] Returns the 256 QAM constellation trace.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchPDSCH1024QAMConstellation

int32 __stdcall RFmxLTE_ModAccFetchPDSCH1024QAMConstellation (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, NIComplexSingle QAM1024Constellation[], int32 arraySize, int32* actualArraySize);

Purpose

Fetches the physical downlink shared channel (PDSCH) 1024 QAM trace. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
QAM1024Constellation NIComplexSingle[] Returns the 1024 QAM constellation trace.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchCSRSConstellation

int32 __stdcall RFmxLTE_ModAccFetchCSRSConstellation (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, NIComplexSingle CSRSConstellation[], int32 arraySize, int32* actualArraySize);

Purpose

Fetches the constellation trace for a cell-specific reference signal. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
CSRSConstellation NIComplexSingle[] Returns CSRS constellation trace.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchSynchronizationSignalConstellation

int32 __stdcall RFmxLTE_ModAccFetchSynchronizationSignalConstellation (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, NIComplexSingle SSSConstellation[], NIComplexSingle PSSConstellation[], int32 arraySize, int32* actualArraySize);

Purpose

Fetches the constellations traces for PSS and SSS. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
SSSConstellation NIComplexSingle[] Returns SSS constellation trace.
PSSConstellation NIComplexSingle[] Returns PSS constellation trace.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchDownlinkPBCHConstellation

int32 __stdcall RFmxLTE_ModAccFetchDownlinkPBCHConstellation (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, NIComplexSingle PBCHConstellation[], int32 arraySize, int32* actualArraySize);

Purpose

Fetches the PBCH constellation trace for the control channels. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
PBCHConstellation NIComplexSingle[] Returns the PBCH constellation trace.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchDownlinkPCFICHConstellation

int32 __stdcall RFmxLTE_ModAccFetchDownlinkPCFICHConstellation (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, NIComplexSingle PCFICHConstellation[], int32 arraySize, int32* actualArraySize);

Purpose

Fetches the PCFICH constellation trace for the control channels. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
PCFICHConstellation NIComplexSingle[] Returns the PCFICH constellation trace.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchDownlinkPDCCHConstellation

int32 __stdcall RFmxLTE_ModAccFetchDownlinkPDCCHConstellation (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, NIComplexSingle PDCCHConstellation[], int32 arraySize, int32* actualArraySize);

Purpose

Fetches the PDCCH constellation trace for the control channels. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
PDCCHConstellation NIComplexSingle[] Returns the PDCCH constellation trace.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchDownlinkPHICHConstellation

int32 __stdcall RFmxLTE_ModAccFetchDownlinkPHICHConstellation (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, NIComplexSingle PHICHConstellation[], int32 arraySize, int32* actualArraySize);

Purpose

Fetches the PHICH constellation trace for the control channels. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
PHICHConstellation NIComplexSingle[] Returns the PHICH constellation trace.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchInBandEmissionMargin

int32 __stdcall RFmxLTE_ModAccFetchInBandEmissionMargin (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* inBandEmissionMargin);

Purpose

Returns the in-band emission margin on non allocated resource blocks (RBs) in the uplink signal. This value is expressed in dB. The function result is valid only when you set the RFMXLTE_ATTR_LINK_DIRECTION) attribute to RFMXLTE_VAL_LINK_DIRECTION_UPLINK. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
Output
Name Type Description
inBandEmissionMargin float64* Returns the in-band emission margin. The margin is the least difference between the in-band emission measurement trace and limit trace. The limit is defined in section 6.5.2.3.5 of the 3GPP TS 36.521 specification. The in-band emissions are a measure of the interference falling into the non-allocated resources blocks.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchInBandEmissionMarginArray

int32 __stdcall RFmxLTE_ModAccFetchInBandEmissionMarginArray (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64 inBandEmissionMargin[], int32 arraySize, int32* actualArraySize);

Purpose

Returns an array of margins on non allocated resource blocks (RBs) in the uplink signal for all component carriers within the subblock. The function result is valid only when you set the RFMXLTE_ATTR_LINK_DIRECTION) attribute to RFMXLTE_VAL_LINK_DIRECTION_UPLINK. Use "subblock<n>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, and subblock number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0"
"signal::sig1/subblock0"
"result::r1/subblock0"
"signal::sig1/result::r1/subblock0"
You can use the RFmxLTE_BuildSubblockString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
inBandEmissionMargin float64[] Returns the array of the in-band emission margins. The margin is the least difference between the in-band emission measurement trace and limit trace. The limit is defined in section 6.5.2.3.5 of the 3GPP TS 36.521 specification. The in-band emissions are a measure of the interference falling into the non-allocated resources blocks.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchSpectralFlatness

int32 __stdcall RFmxLTE_ModAccFetchSpectralFlatness (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* range1MaximumToRange1Minimum, float64* range2MaximumToRange2Minimum, float64* range1MaximumToRange2Minimum, float64* range2MaximumToRange1Minimum);

Purpose

Returns the spectral flatness measurements of the component carrier. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
Output
Name Type Description
range1MaximumToRange1Minimum float64* Returns the peak-to-peak ripple of the EVM equalizer coefficients within the frequency Range1. The frequency Range1 is as defined in section 6.5.2.4.5 of the 3GPP TS 36.521 specification.
range2MaximumToRange2Minimum float64* Returns the peak-to-peak ripple of the EVM equalizer coefficients within the frequency Range2. The frequency Range2 is defined in section 6.5.2.4.5 of the 3GPP TS 36.521 specification.
range1MaximumToRange2Minimum float64* Returns the peak-to-peak ripple of the EVM equalizer coefficients from the frequency Range1 to the frequency Range2. The frequency Range1 and 2 are defined in the section 6.5.2.4.5 of the 3GPP TS 36.521 specification.
range2MaximumToRange1Minimum float64* Returns the peak-to-peak ripple of the EVM equalizer coefficients from frequency Range2 to frequency Range1. The frequency Range1 and 2 are defined in section 6.5.2.4.5 of the 3GPP TS 36.521 specification.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchSpectralFlatnessArray

int32 __stdcall RFmxLTE_ModAccFetchSpectralFlatnessArray (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64 range1MaximumToRange1Minimum[], float64 range2MaximumToRange2Minimum[], float64 range1MaximumToRange2Minimum[], float64 range2MaximumToRange1Minimum[], int32 arraySize, int32* actualArraySize);

Purpose

Returns arrays of spectral flatness measurements of all component carriers within the subblock. Use "subblock<n>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, and subblock number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0"
"signal::sig1/subblock0"
"result::r1/subblock0"
"signal::sig1/result::r1/subblock0"
You can use the RFmxLTE_BuildSubblockString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
range1MaximumToRange1Minimum float64[] Returns the array of the peak-to-peak ripple of the EVM equalizer coefficients within the frequency Range1. The frequency Range1 is as defined in section 6.5.2.4.5 of the 3GPP TS 36.521 specification.
range2MaximumToRange2Minimum float64[] Returns the array of the peak-to-peak ripple of the EVM equalizer coefficients within the frequency Range2. The frequency Range2 is defined in section 6.5.2.4.5 of the 3GPP TS 36.521 specification.
range1MaximumToRange2Minimum float64[] Returns the array of the peak-to-peak ripple of the EVM equalizer coefficients from the frequency Range1 to the frequency Range2. The frequency Range1 and 2 are defined in the section 6.5.2.4.5 of the 3GPP TS 36.521 specification.
range2MaximumToRange1Minimum float64[] Returns the array of the peak-to-peak ripple of the EVM equalizer coefficients from frequency Range2 to frequency Range1. The frequency Range1 and 2 are defined in section 6.5.2.4.5 of the 3GPP TS 36.521 specification.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchInBandEmissionTrace

int32 __stdcall RFmxLTE_ModAccFetchInBandEmissionTrace (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* x0, float64* dx, float32 inBandEmission[], float32 inBandEmissionMask[], int32 arraySize, int32* actualArraySize);

Purpose

Returns the in-band emission (IBE) and limit traces. In-band emission is the interference falling into non allocated resource blocks. The IBE for various spectral regions (general, carrier leakage, and I/Q image) are evaluated according to section 6.5.2.3.5 of the 3GPP 36.521 specification and concatenated to form a composite trace. The limit trace is derived from the limits in the section 6.5.2.3.5 of the 3GPP 36.521 specification. The function result is valid only when you set the RFMXLTE_ATTR_LINK_DIRECTION) attribute to RFMXLTE_VAL_LINK_DIRECTION_UPLINK. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
x0 float64* Returns the start point of the of the resource block.
dx float64* Returns 1 as the value.
inBandEmission float32[] Returns the in-band emission value as an array for each of the resource blocks. In-band emission is the interference falling into non-allocated resource blocks. This value is expressed in dB.
inBandEmissionMask float32[] Returns the in-band emission limit value as an array for each of the resource blocks. The in-band emission limit for regions such as General, Carrier Leakage and IQ Image, are evaluated according to the method defined in the 3GPP TS 36.521 specification and concatenated to form a composite limit trace.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchSpectralFlatnessTrace

int32 __stdcall RFmxLTE_ModAccFetchSpectralFlatnessTrace (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* x0, float64* dx, float32 spectralFlatness[], float32 spectralFlatnessLowerMask[], float32 spectralFlatnessUpperMask[], int32 arraySize, int32* actualArraySize);

Purpose

Returns the spectral flatness, upper mask, and lower mask traces. Spectral flatness is the magnitude of equalizer coefficients at each allocated subcarrier. Lower and upper masks are derived from section 6.5.2.4.5 of the 3GPP TS 36.521 specification. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
x0 float64* Returns the start frequency of the channel. This value is expressed in Hz.
dx float64* Returns the subcarrier spacing.
spectralFlatness float32[] Returns the spectral flatness values as an array at each allocated subcarrier. Spectral flatness is the magnitude of equalizer coefficients.
spectralFlatnessLowerMask float32[] Returns the lower mask as an array for the spectral flatness derived from section 6.5.2.4.5 of the 3GPP 36.521 specification.
spectralFlatnessUpperMask float32[] Returns the upper mask as an array for the spectral flatness derived from section 6.5.2.4.5 of the 3GPP 36.521 specification.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchPUSCHDataEVM

int32 __stdcall RFmxLTE_ModAccFetchPUSCHDataEVM (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* meanRMSDataEVM, float64* maximumPeakDataEVM);

Purpose

Fetches the physical uplink shared channel (PUSCH) data EVM for ModAcc measurements. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
Output
Name Type Description
meanRMSDataEVM float64* Returns the mean value of the RMS EVMs calculated on PUSCH data symbols over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) attribute.
maximumPeakDataEVM float64* Returns the maximum value of the peak EVMs calculated on PUSCH data symbols over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchPUSCHDataEVMArray

int32 __stdcall RFmxLTE_ModAccFetchPUSCHDataEVMArray (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64 meanRMSDataEVM[], float64 maximumPeakDataEVM[], int32 arraySize, int32* actualArraySize);

Purpose

Returns an array of the Mean RMS PUSCH data EVM and the maximum peak PUSCH data EVM. Use "subblock<n>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, and subblock number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0"
"signal::sig1/subblock0"
"result::r1/subblock0"
"signal::sig1/result::r1/subblock0"
You can use the RFmxLTE_BuildSubblockString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
meanRMSDataEVM float64[] Returns the array of the mean value of the RMS EVMs calculated on PUSCH data symbols over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) attribute.
maximumPeakDataEVM float64[] Returns the array of the maximum value of the peak EVMs calculated on PUSCH data symbols over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchPUSCHDMRSEVM

int32 __stdcall RFmxLTE_ModAccFetchPUSCHDMRSEVM (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* meanRMSDMRSEVM, float64* maximumPeakDMRSEVM);

Purpose

Fetches the EVM values calculated on PUSCH DMRS calculated over the length of the measurement. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
Output
Name Type Description
meanRMSDMRSEVM float64* Returns the mean value of RMS EVMs calculated on PUSCH DMRS over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) attribute. This value is expressed in dB or in percentage.
maximumPeakDMRSEVM float64* Returns the maximum value of peak EVMs calculated on PUSCH DMRS over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute. This value is expressed in dB or in percentage.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchPUSCHDMRSEVMArray

int32 __stdcall RFmxLTE_ModAccFetchPUSCHDMRSEVMArray (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64 meanRMSDMRSEVM[], float64 maximumPeakDMRSEVM[], int32 arraySize, int32* actualArraySize);

Purpose

Returns an array of the PUSCH mean RMS DMRS EVM and the PUSCH maximum peak DMRS EVM of all the component carriers within the subblock. Use "subblock<n>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, and subblock number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0"
"signal::sig1/subblock0"
"result::r1/subblock0"
"signal::sig1/result::r1/subblock0"
You can use the RFmxLTE_BuildSubblockString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
meanRMSDMRSEVM float64[] Returns the array of the mean value of RMS EVMs calculated on PUSCH DMRS over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) attribute.
maximumPeakDMRSEVM float64[] Returns the array of the maximum value of peak EVMs calculated on PUSCH DMRS over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute. This value is expressed in dB or in percentage.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchPUSCHSymbolPower

int32 __stdcall RFmxLTE_ModAccFetchPUSCHSymbolPower (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* PUSCHMeanDataPower, float64* PUSCHMeanDMRSPower);

Purpose

Fetches the physical uplink shared channel (PUSCH) symbol power measurement. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
Output
Name Type Description
PUSCHMeanDataPower float64* Returns the mean value of the power calculated on PUSCH data symbols over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) attribute.
PUSCHMeanDMRSPower float64* Returns the mean value of the power calculated on PUSCH DMRS over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchPUSCHSymbolPowerArray

int32 __stdcall RFmxLTE_ModAccFetchPUSCHSymbolPowerArray (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64 PUSCHMeanDataPower[], float64 PUSCHMeanDMRSPower[], int32 arraySize, int32* actualArraySize);

Purpose

Returns an array of powers of the physical uplink shared channel (PUSCH) data symbols and DMRS of all the component carriers in the subblock. Use "subblock<n>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, and subblock number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0"
"signal::sig1/subblock0"
"result::r1/subblock0"
"signal::sig1/result::r1/subblock0"
You can use the RFmxLTE_BuildSubblockString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
PUSCHMeanDataPower float64[] Returns the array of the mean value of the power calculated on PUSCH data symbols over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) attribute.
PUSCHMeanDMRSPower float64[] Returns the array of the mean value of the power calculated on PUSCH DMRS over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchPUSCHDemodulatedBits

int32 __stdcall RFmxLTE_ModAccFetchPUSCHDemodulatedBits (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, int8 bits[], int32 arraySize, int32* actualArraySize);

Purpose

Fetches the recovered bits during EVM calculation. The bits of different slots in the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) attribute are concatenated. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
bits int8[] Returns the array of the recovered bits during EVM calculation.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchNPUSCHDataEVM

int32 __stdcall RFmxLTE_ModAccFetchNPUSCHDataEVM (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* NPUSCHMeanRMSDataEVM, float64* NPUSCHMaximumPeakDataEVM);

Purpose

Fetches the narrowband physical uplink shared channel (NPUSCH) data EVM for ModAcc measurements. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to configure this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
Output
Name Type Description
NPUSCHMeanRMSDataEVM float64* Returns the mean value of the RMS EVMs calculated on the NPUSCH data symbols over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) attribute. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT) attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_PERCENTAGE, the result is returned as a percentage, and when you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_DB, the result is returned in dB.
NPUSCHMaximumPeakDataEVM float64* Returns the maximum value of the peak EVMs calculated on the NPUSCH data symbols over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_PERCENTAGE, the result is returned as a percentage. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_DB, the result is returned in dB.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchNPUSCHDMRSEVM

int32 __stdcall RFmxLTE_ModAccFetchNPUSCHDMRSEVM (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* NPUSCHMeanRMSDMRSEVM, float64* NPUSCHMaximumPeakDMRSEVM);

Purpose

Fetches the EVM values calculated on NPUSCH DMRS over the length of the measurement. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to configure this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
Output
Name Type Description
NPUSCHMeanRMSDMRSEVM float64* Returns the mean value of the RMS EVMs calculated on the NPUSCH DMRS over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) attribute.
When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT) attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_PERCENTAGE, the result is returned as a percentage, and when you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_DB, the result is returned in dB.
NPUSCHMaximumPeakDMRSEVM float64* Returns the maximum value of the peak EVMs calculated on NPUSCHDMRS over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute.
When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_PERCENTAGE, the result is returned as a percentage, and when you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_DB, the result is returned in dB.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchNPUSCHSymbolPower

int32 __stdcall RFmxLTE_ModAccFetchNPUSCHSymbolPower (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* NPUSCHMeanDataPower, float64* NPUSCHMeanDMRSPower);

Purpose

Fetches the narrowband physical uplink shared channel (NPUSCH) symbol powers. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
Output
Name Type Description
NPUSCHMeanDataPower float64* Returns the mean value of the power calculated on the narrowband physical uplink shared channel (NPUSCH) data symbols over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) attribute.
This value is expressed in dBm.
NPUSCHMeanDMRSPower float64* Returns the mean value of the power calculated on the NPUSCH DMRS over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute.
This value is expressed in dBm.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchSubblockInBandEmissionMargin

int32 __stdcall RFmxLTE_ModAccFetchSubblockInBandEmissionMargin (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* subblockInBandEmissionMargin);

Purpose

Returns the margin on non-allocated resource blocks (RBs) within the subblock aggregated bandwidth. This value is expressed in dB. The function result is valid only when you set the RFMXLTE_ATTR_LINK_DIRECTION) attribute to RFMXLTE_VAL_LINK_DIRECTION_UPLINK and the RFMXLTE_ATTR_TRANSMITTER_ARCHITECTURE) attribute to RFMXLTE_VAL_TRANSMITTER_ARCHITECTURE_LO_PER_SUBBLOCK. Refer to section 6.5.2A.3 of the 3GPP TS 36.521 specification for more information about in-band emission margin. Use "subblock<n>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, and subblock number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0"
"signal::sig1/subblock0"
"result::r1/subblock0"
"signal::sig1/result::r1/subblock0"
You can use the RFmxLTE_BuildSubblockString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
Output
Name Type Description
subblockInBandEmissionMargin float64* Returns the in-band emission margin of a subblock aggregated bandwidth. This value is expressed in dB.
The margin is the lowest difference between the in-band emission measurement trace and the limit trace. The limit is defined in section 6.5.2A.3 of the 3GPP TS 36.521 specification.
The in-band emissions are a measure of the interference in the non-allocated resources blocks. This result is valid only when you set the RFMXLTE_ATTR_TRANSMITTER_ARCHITECTURE) attribute to RFMXLTE_VAL_TRANSMITTER_ARCHITECTURE_LO_PER_SUBBLOCK.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchSRSEVM

int32 __stdcall RFmxLTE_ModAccFetchSRSEVM (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* meanRMSSRSEVM, float64* meanSRSPower);

Purpose

Fetches the mean RMS EVM and the mean power for the SRS channel. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
Output
Name Type Description
meanRMSSRSEVM float64* Returns the mean value of RMS EVMs calculated on the SRS symbols over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) attribute. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT) attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_PERCENTAGE, the measurement is returned in percentage. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_DB, the measurement is returned in dB.
meanSRSPower float64* Returns the mean value of power calculated on SRS over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute. This value is expressed in dB.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchSRSEVMArray

int32 __stdcall RFmxLTE_ModAccFetchSRSEVMArray (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64 meanRMSSRSEVM[], float64 meanSRSPower[], int32 arraySize, int32* actualArraySize);

Purpose

Fetches the array of SRS EVMs for all the component carriers within the subblock. This value is expressed in percentage or dB. Use "subblock<n>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, and subblock number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0"
"signal::sig1/subblock0"
"result::r1/subblock0"
"signal::sig1/result::r1/subblock0"
You can use the RFmxLTE_BuildSubblockString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
meanRMSSRSEVM float64[] Returns the array of mean values of RMS EVMs calculated on the SRS symbols over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) attribute. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT) attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_PERCENTAGE, the measurement is returned in percentage. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_DB, the measurement is returned in dB.
meanSRSPower float64[] Returns the array of mean values of power calculated on SRS over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute. This value is expressed in dB.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchPUSCHConstellationTrace

int32 __stdcall RFmxLTE_ModAccFetchPUSCHConstellationTrace (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, NIComplexSingle dataConstellation[], int32 dataConstellationArraySize, int32* dataConstellationActualArraySize, NIComplexSingle DMRSConstellation[], int32 DMRSConstellationArraySize, int32* DMRSConstellationActualArraySize);

Purpose

Returns the recovered physical uplink shared channel (PUSCH) constellation points. The constellation points of different slots in the measurement length are concatenated. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
dataConstellationArraySize int32 Specifies the size of dataConstellationI and dataConstellationQ array. Set the dataConstellationArraySize parameter to 0 to get the size of dataConstellationI and dataConstellationQ array in the dataConstellationActualArraySize parameter.
DMRSConstellationArraySize int32 Specifies the size of DMRSConstellationI and DMRSConstellationQ array. Set the DMRSConstellationArraySize parameter to 0 to get the size of DMRSConstellationI and DMRSConstellationQ array in the DMRSConstellationActualArraySize parameter.
Output
Name Type Description
dataConstellation NIComplexSingle[] Returns the data constellation trace.
dataConstellationActualArraySize int32* Returns the actual size of dataConstellationI and dataConstellationQ array, if you pass NULL to all output array parameters, and set the dataConstellationArraySize parameter to 0.
DMRSConstellation NIComplexSingle[] Returns the demodulation reference signal (DMRS) constellation trace.
DMRSConstellationActualArraySize int32* Returns the actual size of DMRSConstellationI and DMRSConstellationQ array, if you pass NULL to all output array parameters, and set the DMRSConstellationArraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchNPUSCHConstellationTrace

int32 __stdcall RFmxLTE_ModAccFetchNPUSCHConstellationTrace (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, NIComplexSingle dataConstellation[], int32 dataConstellationArraySize, int32* dataConstellationActualArraySize, NIComplexSingle DMRSConstellation[], int32 DMRSConstellationArraySize, int32* DMRSConstellationActualArraySize);

Purpose

Returns the recovered narrowband physical uplink shared channel (NPUSCH) constellation points. The constellation points of different slots in the measurement length are concatenated. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
dataConstellationArraySize int32 Specifies the size of dataConstellationI and dataConstellationQ array. Set the dataConstellationArraySize parameter to 0 to get the size of dataConstellationI and dataConstellationQ array in the dataConstellationActualArraySize parameter.
DMRSConstellationArraySize int32 Specifies the size of DMRSConstellationI and DMRSConstellationQ array. Set the DMRSConstellationArraySize parameter to 0 to get the size of DMRSConstellationI and DMRSConstellationQ array in the DMRSConstellationActualArraySize parameter.
Output
Name Type Description
dataConstellation NIComplexSingle[] Returns the data constellation trace.
dataConstellationActualArraySize int32* Returns the actual size of dataConstellationI and dataConstellationQ array, if you pass NULL to all output array parameters, and set the dataConstellationArraySize parameter to 0.
DMRSConstellation NIComplexSingle[] Returns the demodulation reference signal (DMRS) constellation trace.
DMRSConstellationActualArraySize int32* Returns the actual size of DMRSConstellationI and DMRSConstellationQ array, if you pass NULL to all output array parameters, and set the DMRSConstellationArraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchSubblockInBandEmissionTrace

int32 __stdcall RFmxLTE_ModAccFetchSubblockInBandEmissionTrace (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64 subblockInBandEmission[], float64 subblockInBandEmissionMask[], float64 subblockInBandEmissionRBIndices[], int32 arraySize, int32* actualArraySize);

Purpose

Returns the in-band emission trace and the limit trace within the subblock aggregated bandwidth. The in-band emissions are a measure of the interference in the non-allocated resources blocks. The in-band emissions for various regions, such as general, carrier leakage, and I/Q image, are evaluated according to the method defined in the 3GPP 36.521 specification, and concatenated to form a composite trace. Limit trace is derived from the limits defined in section 6.5.2A.3 of the 3GPP TS 36.521 specification. The function result is valid only when you set the RFMXLTE_ATTR_LINK_DIRECTION) attribute to RFMXLTE_VAL_LINK_DIRECTION_UPLINK and the RFMXLTE_ATTR_TRANSMITTER_ARCHITECTURE) attribute to RFMXLTE_VAL_TRANSMITTER_ARCHITECTURE_LO_PER_SUBBLOCK. Use "subblock<n>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, and subblock number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0"
"signal::sig1/subblock0"
"result::r1/subblock0"
"signal::sig1/result::r1/subblock0"
You can use the RFmxLTE_BuildSubblockString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
subblockInBandEmission float64[] Returns the array of the subblock in-band emission measurement trace.
subblockInBandEmissionMask float64[] Returns the array of the subblock in-band emission mask trace.
subblockInBandEmissionRBIndices float64[] Returns the array of the resource block indices for the subblock in-band emission trace. It can have non integer values depending upon the spacing between carriers.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchSRSConstellation

int32 __stdcall RFmxLTE_ModAccFetchSRSConstellation (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, NIComplexSingle SRSConstellation[], int32 arraySize, int32* actualArraySize);

Purpose

Fetches the constellation trace for the SRS channel. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
SRSConstellation NIComplexSingle[] Returns the SRS constellation trace.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchPSSCHDataEVM

int32 __stdcall RFmxLTE_ModAccFetchPSSCHDataEVM (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* PSSCHMeanRMSDataEVM, float64* PSSCHMaximumPeakDataEVM);

Purpose

Fetches the physical sidelink shared channel (PSSCH) data EVM for ModAcc measurements. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT) attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_PERCENTAGE, the function returns the results as a percentage. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_DB, the function returns the results in dB.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
Output
Name Type Description
PSSCHMeanRMSDataEVM float64* Returns the mean value of the RMS EVMs calculated on the PSSCH data symbols over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) attribute.
PSSCHMaximumPeakDataEVM float64* Returns the maximum value of the peak EVMs calculated on the PSSCH data symbols over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchPSSCHDataEVMArray

int32 __stdcall RFmxLTE_ModAccFetchPSSCHDataEVMArray (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64 PSSCHMeanRMSDataEVM[], float64 PSSCHMaximumPeakDataEVM[], int32 arraySize, int32* actualArraySize);

Purpose

Fetches the array of the physical sidelink shared channel (PSSCH) data EVM for ModAcc measurements. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT) attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_PERCENTAGE, the function returns the results as a percentage. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_DB, the function returns the results in dB.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
PSSCHMeanRMSDataEVM float64[] Returns the array of the mean value of the RMS EVMs calculated on the PSSCH data symbols over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) attribute.
PSSCHMaximumPeakDataEVM float64[] Returns the array of the maximum value of the peak EVMs calculated on the PSSCH data symbols over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchPSSCHDMRSEVM

int32 __stdcall RFmxLTE_ModAccFetchPSSCHDMRSEVM (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* PSSCHMeanRMSDMRSEVM, float64* PSSCHMaximumPeakDMRSEVM);

Purpose

Fetches the EVM values calculated on PSSCH DMRS over the length of the measurement. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT) attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_PERCENTAGE, the function returns the results as a percentage. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_DB, the function returns the results in dB.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
Output
Name Type Description
PSSCHMeanRMSDMRSEVM float64* Returns the mean value of the RMS EVMs calculated on the PSSCH DMRS symbols over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) attribute.
PSSCHMaximumPeakDMRSEVM float64* Returns the maximum value of the peak EVMs calculated on PSSCH DMRS symbols over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchPSSCHDMRSEVMArray

int32 __stdcall RFmxLTE_ModAccFetchPSSCHDMRSEVMArray (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64 PSSCHMeanRMSDMRSEVM[], float64 PSSCHMaximumPeakDMRSEVM[], int32 arraySize, int32* actualArraySize);

Purpose

Fetches the array of the EVM values calculated on PSSCH DMRS over the length of the measurement. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT) attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_PERCENTAGE, the function returns the results as a percentage. When you set the RFMXLTE_ATTR_MODACC_EVM_UNIT attribute to RFMXLTE_VAL_MODACC_EVM_UNIT_DB, the function returns the results in dB.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
PSSCHMeanRMSDMRSEVM float64[] Returns the array of the mean value of the RMS EVMs calculated on the PSSCH DMRS symbols over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) attribute.
PSSCHMaximumPeakDMRSEVM float64[] Returns the array of the maximum value of the peak EVMs calculated on PSSCH DMRS symbols over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchPSSCHSymbolPower

int32 __stdcall RFmxLTE_ModAccFetchPSSCHSymbolPower (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* PSSCHMeanDataPower, float64* PSSCHMeanDMRSPower);

Purpose

Fetches the physical sidelink shared channel (PSSCH) data symbols power and DMRS symbols power. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
Output
Name Type Description
PSSCHMeanDataPower float64* Returns the mean value of the power calculated on the PSSCH data symbols over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) attribute. This value is expressed in dBm.
PSSCHMeanDMRSPower float64* Returns the mean value of the power calculated on the PSSCH DMRS symbols over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute. This value is expressed in dBm.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchPSSCHSymbolPowerArray

int32 __stdcall RFmxLTE_ModAccFetchPSSCHSymbolPowerArray (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64 PSSCHMeanDataPower[], float64 PSSCHMeanDMRSPower[], int32 arraySize, int32* actualArraySize);

Purpose

Fetches the array of the physical sidelink shared channel (PSSCH) data symbols power and DMRS symbols power. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
PSSCHMeanDataPower float64[] Returns the array of the mean value of the power calculated on the PSSCH data symbols over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) attribute. This value is expressed in dBm.
PSSCHMeanDMRSPower float64[] Returns the array of the mean value of the power calculated on the PSSCH DMRS symbols over the slots specified by the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute. This value is expressed in dBm.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchPSSCHConstellationTrace

int32 __stdcall RFmxLTE_ModAccFetchPSSCHConstellationTrace (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, NIComplexSingle dataConstellation[], int32 dataConstellationArraySize, int32* dataConstellationActualArraySize, NIComplexSingle DMRSConstellation[], int32 DMRSConstellationArraySize, int32* DMRSConstellationActualArraySize);

Purpose

Returns the recovered physical sidelink shared channel (PSSCH) constellation points. The constellation points of different slots in the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) are concatenated. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
dataConstellationArraySize int32 Specifies the size of dataConstellationI and dataConstellationQ array. Set the dataConstellationArraySize parameter to 0 to get the size of dataConstellationI and dataConstellationQ array in the dataConstellationActualArraySize parameter.
DMRSConstellationArraySize int32 Specifies the size of DMRSConstellation array. Set the DMRSConstellationArraySize parameter to 0 to get the size of DMRSConstellation array in the DMRSConstellationActualArraySize parameter.
Output
Name Type Description
dataConstellation NIComplexSingle[] Returns the PSSCH data constellation trace.
dataConstellationActualArraySize int32* Returns the actual size of dataConstellation array, if you pass NULL to all output array parameters, and set the dataConstellationArraySize parameter to 0.
DMRSConstellation NIComplexSingle[] Returns the PSSCH demodulation reference signal (DMRS) constellation trace.
DMRSConstellationActualArraySize int32* Returns the actual size of DMRSConstellation array, if you pass NULL to all output array parameters, and set the DMRSConstellationArraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchEVMPerSubcarrierTrace

int32 __stdcall RFmxLTE_ModAccFetchEVMPerSubcarrierTrace (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* x0, float64* dx, float32 meanRMSEVMPerSubcarrier[], int32 arraySize, int32* actualArraySize);

Purpose

Returns the EVM of each allocated subcarrier averaged across all the symbols within the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) attribute. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
x0 float64* Returns the starting subcarrier position corresponding to the RB offset of the signal being measured.
dx float64* Returns 1 as the value.
meanRMSEVMPerSubcarrier float32[] Returns the EVM of each allocated subcarrier averaged across all the symbols within the measurement length.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchMaximumEVMPerSubcarrierTrace

int32 __stdcall RFmxLTE_ModAccFetchMaximumEVMPerSubcarrierTrace (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* x0, float64* dx, float32 maximumEVMPerSubcarrier[], int32 arraySize, int32* actualArraySize);

Purpose

Returns the peak value of an EVM for each allocated subcarrier computed across all the symbols within the value of the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH). The function result is valid only when you set the RFMXLTE_ATTR_LINK_DIRECTION) attribute to RFMXLTE_VAL_LINK_DIRECTION_UPLINK. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
x0 float64* Returns the starting subcarrier position corresponding to the RB offset of the signal being measured.
dx float64* Returns 1 as the value.
maximumEVMPerSubcarrier float32[] Returns the peak value of an EVM for each allocated subcarrier computed across all the symbols within the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchEVMPerSlotTrace

int32 __stdcall RFmxLTE_ModAccFetchEVMPerSlotTrace (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* x0, float64* dx, float32 RMSEVMPerSlot[], int32 arraySize, int32* actualArraySize);

Purpose

Returns the EVM of each slot averaged across all the symbols within the slots and all the allocated subcarriers. Use "carrier<k>" or "subblock<k>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
x0 float64* Returns the starting OFDM slot position corresponding to the ModAcc Meas Offset attribute.
dx float64* Returns 1 as the value.
RMSEVMPerSlot float32[] Returns the EVM of each slot averaged across all the symbols within the slots and all the allocated subcarriers.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchMaximumEVMPerSlotTrace

int32 __stdcall RFmxLTE_ModAccFetchMaximumEVMPerSlotTrace (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* x0, float64* dx, float32 maximumEVMPerSlot[], int32 arraySize, int32* actualArraySize);

Purpose

Returns the peak value of an EVM for each slot computed across all the symbols and all the allocated subcarriers. The function result is valid only when you set the RFMXLTE_ATTR_LINK_DIRECTION) attribute to RFMXLTE_VAL_LINK_DIRECTION_UPLINK. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
x0 float64* Returns the starting OFDM slot position corresponding to the RFMXLTE_ATTR_MODACC_MEASUREMENT_OFFSET) attribute.
dx float64* Returns 1 as the value.
maximumEVMPerSlot float32[] Returns the peak value of an EVM for each slot computed across all the symbols and all the allocated subcarriers.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchEVMPerSymbolTrace

int32 __stdcall RFmxLTE_ModAccFetchEVMPerSymbolTrace (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* x0, float64* dx, float32 RMSEVMPerSymbol[], int32 arraySize, int32* actualArraySize);

Purpose

Returns the EVM on each symbol within the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH) attribute averaged across all the allocated subcarriers. Use "carrier<k>" or "subblock<k>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
x0 float64* Returns the starting OFDM symbol position corresponding to the value of the RFMXLTE_ATTR_MODACC_MEASUREMENT_LENGTH attribute.
dx float64* Returns 1 as the value.
RMSEVMPerSymbol float32[] Returns the EVM of each symbol within the measurement length averaged across all the allocated subcarriers.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchMaximumEVMPerSymbolTrace

int32 __stdcall RFmxLTE_ModAccFetchMaximumEVMPerSymbolTrace (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* x0, float64* dx, float32 maximumEVMPerSymbol[], int32 arraySize, int32* actualArraySize);

Purpose

Returns the peak value of an EVM for each symbol computed across all the allocated subcarriers. The function result is valid only when you set the RFMXLTE_ATTR_LINK_DIRECTION) attribute to RFMXLTE_VAL_LINK_DIRECTION_UPLINK. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
x0 float64* Returns the starting OFDM symbol position corresponding to the RFMXLTE_ATTR_MODACC_MEASUREMENT_OFFSET) attribute.
dx float64* Returns 1 as the value.
maximumEVMPerSymbol float32[] Returns the peak value of an EVM for each symbol computed across all the allocated subcarriers.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchEVMHighPerSymbolTrace

int32 __stdcall RFmxLTE_ModAccFetchEVMHighPerSymbolTrace (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* x0, float64* dx, float32 EVMHighPerSymbol[], int32 arraySize, int32* actualArraySize);

Purpose

Returns the EVM per symbol trace for all the configured slots. The EVM is obtained by using the FFT window position, Delta_C+W/2. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
x0 float64* Returns the starting OFDM symbol position corresponding to the RFMXLTE_ATTR_MODACC_MEASUREMENT_OFFSET) attribute.
dx float64* Returns 1 as the value.
EVMHighPerSymbol float32[] Returns the array of the EVM per symbol trace for all the configured slots. The EVM is obtained by using FFT window position, Delta_C+W/2.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchEVMLowPerSymbolTrace

int32 __stdcall RFmxLTE_ModAccFetchEVMLowPerSymbolTrace (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* x0, float64* dx, float32 EVMLowPerSymbol[], int32 arraySize, int32* actualArraySize);

Purpose

Returns the EVM per symbol trace for all the configured slots. The EVM is obtained by using FFT window position, Delta_C-W/2. Refer to the LTE Modulation Accuracy (ModAcc)) topic for more information. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
x0 float64* Returns the starting OFDM symbol position corresponding to the RFMXLTE_ATTR_MODACC_MEASUREMENT_OFFSET) attribute.
dx float64* Returns 1 as the value.
EVMLowPerSymbol float32[] Returns the array of the EVM per symbol trace for all the configured slots. The EVM is obtained by using FFT window position, Delta_C-W/2.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchRMSMagnitudeErrorPerSymbolTrace

int32 __stdcall RFmxLTE_ModAccFetchRMSMagnitudeErrorPerSymbolTrace (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* x0, float64* dx, float32 RMSMagnitudeErrorPerSymbol[], int32 arraySize, int32* actualArraySize);

Purpose

Returns the RMS mean value of the magnitude error for each symbol computed over all the allocated subcarriers and within the measurement length. The function result is valid only when you set the RFMXLTE_ATTR_LINK_DIRECTION) attribute to RFMXLTE_VAL_LINK_DIRECTION_UPLINK. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
x0 float64* Returns the starting OFDM symbol position corresponding to the RFMXLTE_ATTR_MODACC_MEASUREMENT_OFFSET) attribute.
dx float64* Returns 1 as the value.
RMSMagnitudeErrorPerSymbol float32[] Returns the RMS mean value of the magnitude error for each symbol computed over all the allocated subcarriers and within the measurement length.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchMaximumMagnitudeErrorPerSymbolTrace

int32 __stdcall RFmxLTE_ModAccFetchMaximumMagnitudeErrorPerSymbolTrace (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* x0, float64* dx, float32 maximumMagnitudeErrorPerSymbol[], int32 arraySize, int32* actualArraySize);

Purpose

Returns the peak value of the magnitude error for each symbol computed across all the allocated subcarriers. The function result is valid only when you set the RFMXLTE_ATTR_LINK_DIRECTION) attribute to RFMXLTE_VAL_LINK_DIRECTION_UPLINK. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
x0 float64* Returns the starting OFDM symbol position corresponding to the RFMXLTE_ATTR_MODACC_MEASUREMENT_OFFSET) attribute.
dx float64* Returns 1 as the value.
maximumMagnitudeErrorPerSymbol float32[] Returns the array of the peak value of the magnitude error for each symbol computed across all the allocated subcarriers.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchRMSPhaseErrorPerSymbolTrace

int32 __stdcall RFmxLTE_ModAccFetchRMSPhaseErrorPerSymbolTrace (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* x0, float64* dx, float32 RMSPhaseErrorPerSymbol[], int32 arraySize, int32* actualArraySize);

Purpose

Returns the RMS mean value of the phase error for each symbol computed over all the allocated subcarriers and within the measurement length. The function result is valid only when you set the RFMXLTE_ATTR_LINK_DIRECTION) attribute to RFMXLTE_VAL_LINK_DIRECTION_UPLINK. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
x0 float64* Returns the starting OFDM symbol position corresponding to the RFMXLTE_ATTR_MODACC_MEASUREMENT_OFFSET) attribute.
dx float64* Returns 1 as the value.
RMSPhaseErrorPerSymbol float32[] Returns the results of the phase error for each symbol computed over all the allocated subcarriers and within the measurement length.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

RFmxLTE_ModAccFetchMaximumPhaseErrorPerSymbolTrace

int32 __stdcall RFmxLTE_ModAccFetchMaximumPhaseErrorPerSymbolTrace (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* x0, float64* dx, float32 maximumPhaseErrorPerSymbol[], int32 arraySize, int32* actualArraySize);

Purpose

Returns the peak value of the phase error for each symbol computed across all the allocated subcarriers. The function result is valid only when you set the RFMXLTE_ATTR_LINK_DIRECTION) attribute to RFMXLTE_VAL_LINK_DIRECTION_UPLINK. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read results from this function.

Parameters

Input
Name Type Description
instrumentHandle niRFmxInstrHandle Specifies the instrument session. The RFmx obtains this parameter from the RFmxLTE_Initialize) function.
selectorString char[] Specifies a selector string) comprising of the signal name, result name, subblock number, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.
Example:
"subblock0/carrier0"
"signal::sig1/subblock0/carrier0"
"result::r1/subblock0/carrier0"
"signal::sig1/result::r1/subblock0/carrier0"
You can use the RFmxLTE_BuildCarrierString) function to build the selector string.
timeout float64 Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the function waits until the measurement is complete.
arraySize int32 Specifies the size of the array. Set the arraySize parameter to 0 to get the size of all the arrays in the actualArraySize parameter.
Output
Name Type Description
x0 float64* Returns the starting OFDM symbol position corresponding to the RFMXLTE_ATTR_MODACC_MEASUREMENT_OFFSET) attribute.
dx float64* Returns 1 as the value.
maximumPhaseErrorPerSymbol float32[] Returns the peak value of the phase error for each symbol computed across all the allocated subcarriers.
actualArraySize int32* Returns the actual size of the array, if you pass NULL to all output array parameters, and set the arraySize parameter to 0.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxLTE_GetError) function.

The general meaning of the status code is as follows:
Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors
⚠️ **GitHub.com Fallback** ⚠️