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

Fetch Functions

Modacc Fetch

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

ACP Fetch

RFmxLTE_ACPFetchTotalAggregatedPower

int32 __stdcall RFmxLTE_ACPFetchTotalAggregatedPower (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* totalAggregatedPower);

Purpose

Returns the sum of powers in all the subblocks.

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 and the result name. 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:
"signal::sig1"
"result::r1"
"signal::sig1/result::r1"
You can use the RFmxLTE_BuildSignalString) 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
totalAggregatedPower float64* Returns the sum of powers of all the subblocks. This value includes the power in the inter-carrier gaps within a subblock, but it does not include the power in the subblock gaps.

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_ACPFetchSubblockMeasurement

int32 __stdcall RFmxLTE_ACPFetchSubblockMeasurement (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* subblockPower, float64* integrationBandwidth, float64* frequency);

Purpose

Returns the power, integration bandwidth and center frequency of 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.
Output
Name Type Description
subblockPower float64* Returns the sum of powers of all the frequency bins over the integration bandwidth of the subblock.
integrationBandwidth float64* Returns the integration bandwidth used in calculating the power of the subblock. Integration bandwidth is the span from left edge of the leftmost carrier to the right edge of the rightmost carrier within a subblock.
frequency float64* Returns the absolute center frequency of the subblock. This value is the center of the subblock integration bandwidth.

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_ACPFetchComponentCarrierMeasurement

int32 __stdcall RFmxLTE_ACPFetchComponentCarrierMeasurement (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* absolutePower, float64* relativePower);

Purpose

Fetches the ACP component carrier 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
absolutePower float64* Returns the power measured over the integration bandwidth of the carrier/subblock.
relativePower float64* Returns the component carrier power relative to its subblock power.

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_ACPFetchComponentCarrierMeasurementArray

int32 __stdcall RFmxLTE_ACPFetchComponentCarrierMeasurementArray (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64 absolutePower[], float64 relativePower[], int32 arraySize, int32* actualArraySize);

Purpose

Returns an array of the absolute and relative powers of the component carriers. The relative power is relative to the subblock power. 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
absolutePower float64[] Returns the array of powers measured over the integration bandwidths of the component carriers in a subblock.
relativePower float64[] Returns the array of component carrier powers relative to their subblock powers measured over the integration bandwidths of the component carriers in the subblock.
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_ACPFetchOffsetMeasurement

int32 __stdcall RFmxLTE_ACPFetchOffsetMeasurement (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* lowerRelativePower, float64* upperRelativePower, float64* lowerAbsolutePower, float64* upperAbsolutePower);

Purpose

Returns the absolute and relative power of the lower and upper offset channel. The relative power is relative to subblock power. Use "offset<n>" or "subblock<n>/offset<n>" as the selector string to read results from this function. Refer to the LTE Uplink Adjacent Channel Power) and LTE Downlink Adjacent Channel Power topics for more information.

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 offset 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/offset0"
"signal::sig1/subblock0/offset0"
"signal::sig1/result::r1/subblock0/offset0"
"result::r1/subblock0/offset0"
You can use the RFmxLTE_BuildOffsetString) 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
lowerRelativePower float64* Returns the power in lower (negative) offset channel relative to value returned by the RFMXLTE_ATTR_ACP_RESULTS_TOTAL_AGGREGATED_POWER) attribute. For the intra-band noncontiguous type of carrier aggregation, if this offset is not applicable, a NaN is returned. For more information about the applicability of the offset channel, refer to the 3GPP TS 36.521 specification.
upperRelativePower float64* Returns the power in upper (positive) offset channel relative to the value returned by the RFMXLTE_ATTR_ACP_RESULTS_TOTAL_AGGREGATED_POWER attribute. For the intra-band noncontiguous type of carrier aggregation, if this offset is not applicable, a NaN is returned. For more information about the applicability of the offset channel, refer to the 3GPP TS 36.521 specification.
lowerAbsolutePower float64* Returns the lower (negative) offset channel power. For the intra-band noncontiguous type of carrier aggregation, if this offset is not applicable, a NaN is returned. For more information about the applicability of an offset channel, refer to the 3GPP TS 36.521 specification.
upperAbsolutePower float64* Returns the upper (positive) offset channel power. For the intra-band noncontiguous type of carrier aggregation, if this offset is not applicable, a NaN is returned. For more information about the applicability of offset channel, refer 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_ACPFetchOffsetMeasurementArray

int32 __stdcall RFmxLTE_ACPFetchOffsetMeasurementArray (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64 lowerRelativePower[], float64 upperRelativePower[], float64 lowerAbsolutePower[], float64 upperAbsolutePower[], int32 arraySize, int32* actualArraySize);

Purpose

Returns an array of absolute and relative powers of the lower and upper offset channels. The relative power is relative to subblock power. The order of the offsets in the result array is universal terrestrial radio access (UTRA) (1, 2, ...m) and evolved universal terrestrial radio access (E-UTRA) (1, ..., n), where m and n are the number of UTRA offsets and the number of EUTRA offsets respectively. Use "subblock<n>" as the selector string to read results from this function. Refer to the LTE Uplink Adjacent Channel Power) and LTE Downlink Adjacent Channel Power topics for more information

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
lowerRelativePower float64[] Returns the array of power in lower (negative) offset channel relative to the value returned by the RFMXLTE_ATTR_ACP_RESULTS_TOTAL_AGGREGATED_POWER) attribute. For the intra-band noncontiguous type of carrier aggregation, if this offset is not applicable, a NaN is returned. For more information about the applicability of the offset channel, refer to the 3GPP TS 36.521 specification.
upperRelativePower float64[] Returns the array of powers in upper (positive) offset channel relative to the value returned by the RFMXLTE_ATTR_ACP_RESULTS_TOTAL_AGGREGATED_POWER attribute. For the intra-band noncontiguous type of carrier aggregation, if this offset is not applicable, a NaN is returned. For more information about the applicability of the offset channel, refer to the 3GPP TS 36.521 specification.
lowerAbsolutePower float64[] Returns the array of lower (negative) offset channel power. For the intra-band noncontiguous type of carrier aggregation, if this offset is not applicable, a NaN is returned. For more information about the applicability of offset channel, refer to 3GPP TS 36.521 specification.
upperAbsolutePower float64[] Returns the array of upper (positive) offset channel powers. For the intra-band noncontiguous type of carrier aggregation, if this offset is not applicable, a NaN is returned. For more information about the applicability of offset channel, refer 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_ACPFetchSpectrum

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

Purpose

Fetches the spectrum used for the ACP measurement.

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 and the result name. 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:
"signal::sig1"
"result::r1"
"signal::sig1/result::r1"
You can use the RFmxLTE_BuildSignalString) 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 frequency bin spacing. This value is expressed in Hz.
spectrum float32[] Returns the array of averaged power measured at each frequency bin. 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_ACPFetchRelativePowersTrace

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

Purpose

Fetches the relative powers trace for ACP measurement.

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 and the result name. 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:
"signal::sig1"
"result::r1"
"signal::sig1/result::r1"
You can use the RFmxLTE_BuildSignalString) 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.
traceIndex int32 Specifies the index of the trace to fetch. The traceIndex can range from 0 to (Number of carriers + 2*Number of offsets).
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 frequency bin spacing. This value is expressed in Hz.
relativePowersTrace float32[] Returns the trace of relative powers measured relative to total aggregated power in the channel specified by the traceIndex parameter. 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_ACPFetchAbsolutePowersTrace

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

Purpose

Fetches the absolute powers trace.

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 and the result name. 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:
"signal::sig1"
"result::r1"
"signal::sig1/result::r1"
You can use the RFmxLTE_BuildSignalString) 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.
traceIndex int32 Specifies the index of the trace to fetch. The traceIndex can range from 0 to (Number of carriers + 2*Number of offsets).
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 frequency bin spacing. This value is expressed in Hz.
absolutePowersTrace float32[] Returns the trace of the measured integrated power in the channel specified by the traceIndex parameter. 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

CHP Fetch

RFmxLTE_CHPFetchTotalAggregatedPower

int32 __stdcall RFmxLTE_CHPFetchTotalAggregatedPower (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* totalAggregatedPower);

Purpose

Returns the sum of powers in all the subblocks.

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 and the result name. 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:
"signal::sig1"
"result::r1"
"signal::sig1/result::r1"
You can use the RFmxLTE_BuildSignalString) 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
totalAggregatedPower float64* Returns the sum of powers of all the subblocks. This value includes the power in the inter-carrier gaps within a subblock, but it does not include the power in the subblock gaps.

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_CHPFetchSubblockMeasurement

int32 __stdcall RFmxLTE_CHPFetchSubblockMeasurement (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* subblockPower, float64* integrationBandwidth, float64* frequency);

Purpose

Returns the power, integration bandwidth and center frequency of 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.
Output
Name Type Description
subblockPower float64* Returns the sum of powers of all the frequency bins over the integration bandwidth of the subblock.
integrationBandwidth float64* Returns the integration bandwidth used in calculating the power of the subblock. Integration bandwidth is the span from left edge of the leftmost carrier to the right edge of the rightmost carrier within a subblock.
frequency float64* Returns the absolute center frequency of the subblock. This value is the center of the subblock integration bandwidth. Integration bandwidth is the span from left edge of the integration bandwidth of the leftmost carrier to the right edge of the integration bandwidth of the rightmost carrier within a 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_CHPFetchComponentCarrierMeasurement

int32 __stdcall RFmxLTE_CHPFetchComponentCarrierMeasurement (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* absolutePower, float64* relativePower);

Purpose

Returns the absolute and relative powers measured in the component carriers. The relative power is relative to subblock 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
absolutePower float64* Returns the power measured over the integration bandwidth of the carrier/subblock.
relativePower float64* Returns the component carrier power relative to its subblock power.

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_CHPFetchComponentCarrierMeasurementArray

int32 __stdcall RFmxLTE_CHPFetchComponentCarrierMeasurementArray (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64 absolutePower[], float64 relativePower[], int32 arraySize, int32* actualArraySize);

Purpose

Returns an array of the absolute and relative powers measured in the component carriers. The relative power is relative to subblock power. 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
absolutePower float64[] Returns the array of powers measured over the integration bandwidths of the component carriers in a subblock.
relativePower float64[] Returns the array of component carrier powers relative to their subblock powers measured over the integration bandwidths of the component carriers in the subblock.
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_CHPFetchSpectrum

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

Purpose

Fetches the spectrum used for CHP measurements.

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 and the result name. 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:
"signal::sig1"
"result::r1"
"signal::sig1/result::r1"
You can use the RFmxLTE_BuildSignalString) 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 frequency bin spacing. This value is expressed in Hz.
spectrum float32[] Returns the array of averaged power measured at each frequency bin. 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

OBW Fetch

RFmxLTE_OBWFetchMeasurement

int32 __stdcall RFmxLTE_OBWFetchMeasurement (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* occupiedBandwidth, float64* absolutePower, float64* startFrequency, float64* stopFrequency);

Purpose

Returns the occupied bandwidth, absolute power, start frequency, and stop frequency of a component carrier or subblock. Use "subblock<n>" as the selector string to read results from this function. Refer to the LTE Occupied Bandwidth) topic for more information about OBW measurements.

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
occupiedBandwidth float64* Returns the bandwidth that occupies 99 percentage of the total power of the signal within a carrier/subblock.
absolutePower float64* Returns the power measured over the integration bandwidth of the carrier/subblock.
startFrequency float64* Returns the start frequency of the subblock. The occupied bandwidth of a carrier/subblock is calculated using the following equation:
Stop frequency - Start frequency = Occupied bandwidth.
stopFrequency float64* Returns the stop frequency of the subblock. The occupied bandwidth of a carrier/subblock is calculated using the following equation:
Stop frequency - Start frequency = Occupied bandwidth.

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_OBWFetchSpectrum

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

Purpose

Fetches the spectrum used for OBW measurements.

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 and the result name. 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:
"signal::sig1"
"result::r1"
"signal::sig1/result::r1"
You can use the RFmxLTE_BuildSignalString) 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 frequency bin spacing. This value is expressed in Hz.
spectrum float32[] Returns the array of averaged power measured at each frequency bin. 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

SEM Fetch

RFmxLTE_SEMFetchTotalAggregatedPower

int32 __stdcall RFmxLTE_SEMFetchTotalAggregatedPower (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* totalAggregatedPower);

Purpose

Returns the sum of powers of all subblocks.

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 and the result name. 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:
"signal::sig1"
"result::r1"
"signal::sig1/result::r1"
You can use the RFmxLTE_BuildSignalString) 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
totalAggregatedPower float64* Returns the sum of powers of all the subblocks. This value includes the power in the inter-carrier gaps within a subblock, but it does not include the power in the subblock gaps.

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_SEMFetchMeasurementStatus

int32 __stdcall RFmxLTE_SEMFetchMeasurementStatus (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, int32* measurementStatus);

Purpose

Returns the overall measurement status based on the standard mask type that you configure.

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 and the result name. 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:
"signal::sig1"
"result::r1"
"signal::sig1/result::r1"
You can use the RFmxLTE_BuildSignalString) 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
measurementStatus int32* Returns the measurement status indicating whether the power before and after the burst is within the standard defined limit.
RFMXLTE_VAL_SEM_MEASUREMENT_STATUS_FAIL (0) Indicates that the measurement has failed.
RFMXLTE_VAL_SEM_MEASUREMENT_STATUS_PASS (1) Indicates that the measurement has passed.

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_SEMFetchSubblockMeasurement

int32 __stdcall RFmxLTE_SEMFetchSubblockMeasurement (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* subblockPower, float64* integrationBandwidth, float64* frequency);

Purpose

Returns the power, integration bandwidth and center frequency of 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.
Output
Name Type Description
subblockPower float64* Returns the sum of powers of all the frequency bins over the integration bandwidth of the subblock.
integrationBandwidth float64* Returns the integration bandwidth of the subblock. Integration bandwidth is the span from left edge of the leftmost carrier to the right edge of the rightmost carrier within a subblock
frequency float64* Returns the absolute center frequency of the subblock. This value is the center of the subblock integration bandwidth.

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_SEMFetchComponentCarrierMeasurement

int32 __stdcall RFmxLTE_SEMFetchComponentCarrierMeasurement (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* absoluteIntegratedPower, float64* relativeIntegratedPower);

Purpose

Returns the absolute power and relative power measured in the component carrier. The relative power is relative to subblock 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
absoluteIntegratedPower float64* Returns the power measured over the integration bandwidth of the carrier.
relativeIntegratedPower float64* Returns the component carrier power relative to its subblock power.

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_SEMFetchLowerOffsetMargin

int32 __stdcall RFmxLTE_SEMFetchLowerOffsetMargin (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, int32* measurementStatus, float64* margin, float64* marginFrequency, float64* marginAbsolutePower, float64* marginRelativePower);

Purpose

Returns the measurement status, margin, frequency at margin, and the absolute and relative powers at the margin for lower offset segments. The relative power is relative to the total aggregated power. Use "offset<n>" or "subblock<n>/offset<n>" as the selector string to read results from this function. Refer to the LTE Uplink Spectral Emission Mask) and LTE Downlink Spectral Emission Mask topics for more information.

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 offset 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/offset0"
"signal::sig1/subblock0/offset0"
"signal::sig1/result::r1/subblock0/offset0"
"result::r1/subblock0/offset0"
You can use the RFmxLTE_BuildOffsetString) 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
measurementStatus int32* Returns the measurement status indicating whether the power before and after the burst is within the standard defined limit.
RFMXLTE_VAL_SEM_MEASUREMENT_STATUS_FAIL (0) Indicates that the measurement has failed.
RFMXLTE_VAL_SEM_MEASUREMENT_STATUS_PASS (1) Indicates that the measurement has passed.
margin float64* Returns the margin from the standard-defined absolute limit mask for the lower (negative) offset. Margin is defined as the minimum difference between the spectrum and the limit mask. For the intra-band noncontiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated, the SEM results lower offset start frequency and SEM results lower offset stop frequency are updated, and the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.
marginFrequency float64* Returns the frequency at which the margin occurs in the lower (negative) offset. For the intra-band noncontiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated, the SEM results lower offset start frequency and SEM results lower offset stop frequency are updated, and the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.
marginAbsolutePower float64* Returns the power at which the margin occurs in the upper (positive) offset segment. For the intra-band noncontiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated, the SEM results lower offset start frequency and SEM results lower offset stop frequency are updated, and the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.
marginRelativePower float64* Returns the power at which the margin occurs in the upper (positive) offset segment relative to the value returned by the RFMXLTE_ATTR_SEM_RESULTS_TOTAL_AGGREGATED_POWER) attribute. For the intra-band noncontiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.

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_SEMFetchLowerOffsetPower

int32 __stdcall RFmxLTE_SEMFetchLowerOffsetPower (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* absoluteIntegratedPower, float64* relativeIntegratedPower, float64* absolutePeakPower, float64* peakFrequency, float64* relativePeakPower);

Purpose

Returns the total absolute and relative powers, peak, absolute, and relative powers, and the frequency at the peak absolute power of the lower offset segment. The relative power is relative to the total aggregated power. Use "offset<n>" or "subblock<n>/offset<n>" as the selector string to read results from this function. Refer to the LTE Uplink Spectral Emission Mask) and LTE Downlink Spectral Emission Mask topics for more information.

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 offset 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/offset0"
"signal::sig1/subblock0/offset0"
"signal::sig1/result::r1/subblock0/offset0"
"result::r1/subblock0/offset0"
You can use the RFmxLTE_BuildOffsetString) 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
absoluteIntegratedPower float64* Returns the lower (negative) offset segment power. For the intra-band noncontiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.
relativeIntegratedPower float64* Returns the power in the lower (negative) offset segment relative to the value returned by the RFMXLTE_ATTR_SEM_RESULTS_TOTAL_AGGREGATED_POWER) attribute. For the intra-band noncontiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.
absolutePeakPower float64* Returns the peak power in the lower (negative) offset segment. For the intra-band noncontiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.
peakFrequency float64* Returns the frequency at which the peak power occurs in the upper (positive) offset segment. For the intra-band noncontiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.
relativePeakPower float64* Returns the peak power in the upper (positive) offset segment relative to the value returned by the RFMXLTE_ATTR_SEM_RESULTS_TOTAL_AGGREGATED_POWER attribute. For the intra-band noncontiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.

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_SEMFetchUpperOffsetMargin

int32 __stdcall RFmxLTE_SEMFetchUpperOffsetMargin (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, int32* measurementStatus, float64* margin, float64* marginFrequency, float64* marginAbsolutePower, float64* marginRelativePower);

Purpose

Returns the measurement status, margin, frequency at margin, and absolute and relative powers at margin for upper offset segments. The relative power is relative to total aggregated power. Use "offset<n>" or "subblock<n>/offset<n>" as the selector string to read results from this function. Refer to the LTE Uplink Spectral Emission Mask) and LTE Downlink Spectral Emission Mask topics for more information.

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 offset 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/offset0"
"signal::sig1/subblock0/offset0"
"signal::sig1/result::r1/subblock0/offset0"
"result::r1/subblock0/offset0"
You can use the RFmxLTE_BuildOffsetString) 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
measurementStatus int32* Returns the measurement status indicating whether the power before and after the burst is within the standard defined limit.
RFMXLTE_VAL_SEM_MEASUREMENT_STATUS_FAIL (0) Indicates that the measurement has failed.
RFMXLTE_VAL_SEM_MEASUREMENT_STATUS_PASS (1) Indicates that the measurement has passed.
margin float64* Returns the margin from the standard defined absolute limit mask for upper offset. Margin is defined as the minimum difference between the spectrum and the limit mask. For the intra-band noncontiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.
marginFrequency float64* Returns the frequency at which the margin occurs in the upper offset. For the intra-band noncontiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.
marginAbsolutePower float64* Returns the power at which the margin occurs in the upper (positive) offset segment. For the intra-band noncontiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated, the SEM results lower offset start frequency and SEM results lower offset stop frequency are updated, and the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.
marginRelativePower float64* Returns the power at which the margin occurs in the upper (positive) offset segment relative to the value returned by the RFMXLTE_ATTR_SEM_RESULTS_TOTAL_AGGREGATED_POWER) attribute. For the intra-band noncontiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.

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_SEMFetchUpperOffsetPower

int32 __stdcall RFmxLTE_SEMFetchUpperOffsetPower (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* absoluteIntegratedPower, float64* relativeIntegratedPower, float64* absolutePeakPower, float64* peakFrequency, float64* relativePeakPower);

Purpose

Returns the total absolute and relative powers, peak, absolute, and relative powers, and frequency at peak absolute power of upper offset segment. The relative power is relative to total aggregated power. Use "offset<n>" or "subblock<n>/offset<n>" as the selector string to read results from this function. Refer to the LTE Uplink Spectral Emission Mask) and LTE Downlink Spectral Emission Mask topics for more information.

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 offset 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/offset0"
"signal::sig1/subblock0/offset0"
"signal::sig1/result::r1/subblock0/offset0"
"result::r1/subblock0/offset0"
You can use the RFmxLTE_BuildOffsetString) 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
absoluteIntegratedPower float64* Returns the upper offset segment power. For the intra-band noncontiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.
relativeIntegratedPower float64* Returns the power in the upper offset segment relative to the value returned by the RFMXLTE_ATTR_SEM_RESULTS_TOTAL_AGGREGATED_POWER) attribute. For the intra-band noncontiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.
absolutePeakPower float64* Returns the peak power in the upper offset segment. For the intra-band noncontiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.
peakFrequency float64* Returns the frequency at which the peak power occurs in the upper (positive) offset segment. For the intra-band noncontiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.
relativePeakPower float64* Returns the peak power in the upper (positive) offset segment relative to the value returned by the RFMXLTE_ATTR_SEM_RESULTS_TOTAL_AGGREGATED_POWER attribute. For the intra-band noncontiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.

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_SEMFetchComponentCarrierMeasurementArray

int32 __stdcall RFmxLTE_SEMFetchComponentCarrierMeasurementArray (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64 absoluteIntegratedPower[], float64 relativeIntegratedPower[], int32 arraySize, int32* actualArraySize);

Purpose

Returns an array of the absolute powers and relative powers measured in the component carriers. The relative power is relative to subblock power. 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
absoluteIntegratedPower float64[] Returns the array of power measured in the subblock.
relativeIntegratedPower float64[] Returns the array of the sum of powers of all the frequency bins over the integration bandwidth of the component carrier power relative to its subblock power.
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_SEMFetchLowerOffsetMarginArray

int32 __stdcall RFmxLTE_SEMFetchLowerOffsetMarginArray (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, int32 measurementStatus[], float64 margin[], float64 marginFrequency[], float64 marginAbsolutePower[], float64 marginRelativePower[], int32 arraySize, int32* actualArraySize);

Purpose

Returns an array of measurement statuses, margins, frequencies at margins, and absolute and relative powers at margins for lower offset segments. The relative power is relative to the total aggregated power. Use "subblock<n>" as the selector string to read results from this function. Refer to the LTE Uplink Spectral Emission Mask) and LTE Downlink Spectral Emission Mask topics for more information.

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
measurementStatus int32[] Returns the array of the measurement status indicating whether the power before and after the burst is within the standard defined limit.
RFMXLTE_VAL_SEM_MEASUREMENT_STATUS_FAIL (0) Indicates that the measurement has failed.
RFMXLTE_VAL_SEM_MEASUREMENT_STATUS_PASS (1) Indicates that the measurement has passed.
margin float64[] Returns the array of margins from the standard-defined absolute limit mask for the lower (negative) offset. Margin is defined as the minimum difference between the spectrum and the limit mask. For the intra-band noncontiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated, the SEM results lower offset start frequency and SEM results lower offset stop frequency are updated, and the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.
marginFrequency float64[] Returns the array of frequency at which the margin occurs in the lower (negative) offset. For the intra-band noncontiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated, the SEM results lower offset start frequency and SEM results lower offset stop frequency are updated, and the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.
marginAbsolutePower float64[] Returns the array of power at which the margin occurs in the upper (positive) offset segment. For the intra-band noncontiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated, the SEM results lower offset start frequency and SEM results lower offset stop frequency are updated, and the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.
marginRelativePower float64[] Returns the array of powers at which the margin occurs in the upper (positive) offset segment relative to the value returned by the RFMXLTE_ATTR_SEM_RESULTS_TOTAL_AGGREGATED_POWER) attribute. For the intra-band noncontiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.
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_SEMFetchLowerOffsetPowerArray

int32 __stdcall RFmxLTE_SEMFetchLowerOffsetPowerArray (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64 absoluteIntegratedPower[], float64 relativeIntegratedPower[], float64 absolutePeakPower[], float64 peakFrequency[], float64 relativePeakPower[], int32 arraySize, int32* actualArraySize);

Purpose

Returns an array of total absolute and relative powers, peak, absolute, and relative powers, and frequencies at peak absolute powers of lower offset segments. The relative power is relative to total aggregated power. Use "subblock<n>" as the selector string to read results from this function. Refer to the LTE Uplink Spectral Emission Mask) and LTE Downlink Spectral Emission Mask topics for more information.

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
absoluteIntegratedPower float64[] Returns the array of lower (negative) offset segment powers. For the intra-band noncontiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.
relativeIntegratedPower float64[] Returns the array of powers in the lower (negative) offset segment relative to the value returned by the RFMXLTE_ATTR_SEM_RESULTS_TOTAL_AGGREGATED_POWER) attribute. For the intra-band noncontiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.
absolutePeakPower float64[] Returns the array of peak powers in the lower (negative) offset segment. For the intra-band noncontiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.
peakFrequency float64[] Returns the array of frequency at which the peak power occurs in the upper (positive) offset segment. For the intra-band noncontiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.
relativePeakPower float64[] Returns the array of peak power in the upper (positive) offset segment relative to the value returned by the RFMXLTE_ATTR_SEM_RESULTS_TOTAL_AGGREGATED_POWER attribute. For the intra-band noncontiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.
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_SEMFetchUpperOffsetMarginArray

int32 __stdcall RFmxLTE_SEMFetchUpperOffsetMarginArray (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, int32 measurementStatus[], float64 margin[], float64 marginFrequency[], float64 marginAbsolutePower[], float64 marginRelativePower[], int32 arraySize, int32* actualArraySize);

Purpose

Returns an array of measurement statuses, margins, frequencies at margins, and absolute and relative powers at margins for upper offset segments. The relative power is relative to total aggregated power. Use "subblock<n>" as the selector string to read results from this function. Refer to the LTE Uplink Spectral Emission Mask) and LTE Downlink Spectral Emission Mask topics for more information.

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
measurementStatus int32[] Returns the array of the measurement status indicating whether the power before and after the burst is within the standard defined limit.
RFMXLTE_VAL_SEM_MEASUREMENT_STATUS_FAIL (0) Indicates that the measurement has failed.
RFMXLTE_VAL_SEM_MEASUREMENT_STATUS_PASS (1) Indicates that the measurement has passed.
margin float64[] Returns the array of margins from the standard defined absolute limit mask for upper offset. The margin is defined as the minimum difference between the spectrum and the limit mask. For the intra-band noncontiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.
marginFrequency float64[] Returns the array of frequency at which the margin occurs in the upper offset. For the intra-band noncontiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.
marginAbsolutePower float64[] Returns the array of power at which the margin occurs in the upper (positive) offset segment. For the intra-band noncontiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated, the SEM results lower offset start frequency and SEM results lower offset stop frequency are updated, and the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.
marginRelativePower float64[] Returns the array of powers at which the margin occurs in the upper (positive) offset segment relative to the value returned by the RFMXLTE_ATTR_SEM_RESULTS_TOTAL_AGGREGATED_POWER) attribute. For the intra-band noncontiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.
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_SEMFetchUpperOffsetPowerArray

int32 __stdcall RFmxLTE_SEMFetchUpperOffsetPowerArray (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64 absoluteIntegratedPower[], float64 relativeIntegratedPower[], float64 absolutePeakPower[], float64 peakFrequency[], float64 relativePeakPower[], int32 arraySize, int32* actualArraySize);

Purpose

Returns an array of total absolute and relative powers, peak, absolute, and relative powers, and frequencies at peak absolute powers of upper offset segments. The relative power is relative to total aggregated power. Use "subblock<n>" as the selector string to read results from this function. Refer to the LTE Uplink Spectral Emission Mask) and LTE Downlink Spectral Emission Mask topics for more information.

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
absoluteIntegratedPower float64[] Returns the array of upper offset segment powers. For the intra-band noncontiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.
relativeIntegratedPower float64[] Returns the array of powers in the upper offset segment relative to the value returned by the RFMXLTE_ATTR_SEM_RESULTS_TOTAL_AGGREGATED_POWER) attribute. For the intra-band noncontiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.
absolutePeakPower float64[] Returns the array of peak powers in the upper offset segment. For the intra-band noncontiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.
peakFrequency float64[] Returns the array of frequency at which the peak power occurs in the upper (positive) offset segment. For the intra-band noncontiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.
relativePeakPower float64[] Returns the array of peak power in the upper (positive) offset segment relative to the value returned by the RFMXLTE_ATTR_SEM_RESULTS_TOTAL_AGGREGATED_POWER attribute. For the intra-band noncontiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.
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_SEMFetchSpectrum

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

Purpose

Fetches the spectrum used for the SEM measurement.

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 and the result name. 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:
"signal::sig1"
"result::r1"
"signal::sig1/result::r1"
You can use the RFmxLTE_BuildSignalString) 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 frequency bin spacing. This value is expressed in Hz.
spectrum float32[] Returns the array of averaged power measured at each frequency bin. This value is expressed in dBm.
compositeMask float32[] Returns the array of composite mask used for the channel.
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

PVT Fetch

RFmxLTE_PVTFetchMeasurement

int32 __stdcall RFmxLTE_PVTFetchMeasurement (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, int32* measurementStatus, float64* meanAbsoluteOFFPowerBefore, float64* meanAbsoluteOFFPowerAfter, float64* meanAbsoluteONPower, float64* burstWidth);

Purpose

Returns the measurement. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read this result.

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
measurementStatus int32* Returns the measurement status indicating whether the power before and after the burst is within the standard defined limit.
meanAbsoluteOFFPowerBefore float64* Returns the mean power in the segment before the captured burst. The segment is defined as one subframe prior to the burst for the FDD mode and 10 SCFDMA symbols prior to the burst for the TDD mode. This value is expressed in dBm.
meanAbsoluteOFFPowerAfter float64* Returns the mean power in the segment after the captured burst. This value is expressed in dBm.
The segment is defined as one subframe long excluding a transient period of 20 μs at the beginning. This value is expressed in dBm.
meanAbsoluteONPower float64* Returns the average power of the subframes within the captured burst, excluding a transient period of 20 μs at the beginning. This value is expressed in dBm.
burstWidth float64* Returns the width of the captured burst.

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_PVTFetchMeasurementArray

int32 __stdcall RFmxLTE_PVTFetchMeasurementArray (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, int32 measurementStatus[], float64 meanAbsoluteOFFPowerBefore[], float64 meanAbsoluteOFFPowerAfter[], float64 meanAbsoluteONPower[], float64 burstWidth[], int32 arraySize, int32* actualArraySize);

Purpose

Returns the measurement array. Use "subblock<n>" as the selector string to read this result.

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
measurementStatus int32[] Returns the array of the measurement status indicating whether the power before and after the burst is within the standard defined limit.
meanAbsoluteOFFPowerBefore float64[] Returns the array of the mean power in the segment before the captured burst. The segment is defined as one subframe prior to the burst for the FDD mode and 10 SCFDMA symbols prior to the burst for the TDD mode. This value is expressed in dBm.
meanAbsoluteOFFPowerAfter float64[] Returns the array of the mean power in the segment after the captured burst. This value is expressed in dBm.
The segment is defined as one subframe long excluding a transient period of 20 μs at the beginning.
meanAbsoluteONPower float64[] Returns the array of the average power of the subframes within the captured burst, excluding a transient period of 20 μs at the beginning. This value is expressed in dBm.
burstWidth float64[] Returns the array of the width of the captured burst.
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_PVTFetchSignalPowerTrace

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

Purpose

Returns the instantaneous signal power trace along with absolute limit for each segment in the trace as specified by section 6.5.2.4.5 of the 3GPP 36.521. This value is expressed in dBm. Use "carrier<k>" or "subblock<n>/carrier<k>" as the selector string to read this result.

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 start time of the signal. This value is expressed in seconds.
dx float64* Returns the time bin spacing. This value is expressed in seconds.
signalPower float32[] Returns the instantaneous signal power trace. This value is expressed in dBm.
absoluteLimit float32[] Returns absolute limit for each segment in the trace as specified by 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

Slotphase Fetch

RFmxLTE_SlotPhaseFetchPhaseDiscontinuities

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

Purpose

Fetches the array of phase differences at slot boundaries within measurement interval.

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 and the result name. 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:
"signal::sig1"
"result::r1"
"signal::sig1/result::r1"
You can use the RFmxLTE_BuildSignalString) 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
slotPhaseDiscontinuity float64[] Returns the array of phase differences at the slot boundaries within the RFMXLTE_ATTR_SLOTPHASE_MEASUREMENT_LENGTH). 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_SlotPhaseFetchMaximumPhaseDiscontinuity

int32 __stdcall RFmxLTE_SlotPhaseFetchMaximumPhaseDiscontinuity (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* maximumPhaseDiscontinuity);

Purpose

Fetches the maximum value of phase differences at slot boundaries within the measurement interval. 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
maximumPhaseDiscontinuity float64* Returns the maximum value of phase difference at the slot boundaries within the RFMXLTE_ATTR_SLOTPHASE_MEASUREMENT_LENGTH).

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_SlotPhaseFetchMaximumPhaseDiscontinuityArray

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

Purpose

Fetches the array of maximum values of phase differences at slot boundaries within the measurement interval. 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
maximumPhaseDiscontinuity float64[] Returns the array of maximum values of phase difference at the slot boundaries within the RFMXLTE_ATTR_SLOTPHASE_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_SlotPhaseFetchSamplePhaseError

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

Purpose

Fetches the sample phase error trace for the SlotPhase measurement. At each sample, this is the phase difference between received signal and locally generated reference signal.

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 and the result name. 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:
"signal::sig1"
"result::r1"
"signal::sig1/result::r1"
You can use the RFmxLTE_BuildSignalString) 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 sample phase error linear fit trace value.
dx float64* Returns the spacing between the sample phase error linear fit trace values.
samplePhaseError float32[] Returns the array of sample phase error traces.
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_SlotPhaseFetchSamplePhaseErrorLinearFitTrace

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

Purpose

Fetches the sample phase error linear fit trace for the SlotPhase measurement. The linear fit is over the array of phase differences at each sample between the received signal and the locally generated reference signal.

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 and the result name. 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:
"signal::sig1"
"result::r1"
"signal::sig1/result::r1"
You can use the RFmxLTE_BuildSignalString) 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 sample phase error linear fit trace value. This value is expressed in degrees.
dx float64* Returns the spacing between the sample phase error linear fit trace values.
samplePhaseErrorLinearFit float32[] Returns the array of sample phase error linear fit traces.
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

Slotpower Fetch

RFmxLTE_SlotPowerFetchPowers

int32 __stdcall RFmxLTE_SlotPowerFetchPowers (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64 subframePower[], float64 subframePowerDelta[], int32 arraySize, int32* actualArraySize);

Purpose

Fetches the array of Subframe Power and the Subframe Power Delta parameters over the measurement interval. A NaN is returned as subframe power delta, when the preceding slot is not occupied.

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 and the result name. 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:
"signal::sig1"
"result::r1"
"signal::sig1/result::r1"
You can use the RFmxLTE_BuildSignalString) 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
subframePower float64[] Returns the array of subframe power values over the measurement interval. The values are expressed in dBm.
subframePowerDelta float64[] Returns the array of subframe power delta values over the measurement interval. Subframe power delta values are the power difference between the two consecutive subframes. The values are 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
⚠️ **GitHub.com Fallback** ⚠️