NI RFmx WLAN Fetch DSSS Modacc Functions

Fetch DSSS ModAcc Functions

• RFmxWLAN_DSSSModAccFetchEVM
• RFmxWLAN_DSSSModAccFetchIQImpairments
• RFmxWLAN_DSSSModAccFetchPPDUInformation
• RFmxWLAN_DSSSModAccFetchAveragePowers
• RFmxWLAN_DSSSModAccFetchPeakPowers
• RFmxWLAN_DSSSModAccFetchCustomGatePowersArray
• RFmxWLAN_DSSSModAccFetchConstellationTrace
• RFmxWLAN_DSSSModAccFetchEVMPerChipMeanTrace
• RFmxWLAN_DSSSModAccFetchDecodedHeaderBitsTrace
• RFmxWLAN_DSSSModAccFetchDecodedPSDUBitsTrace

RFmxWLAN_DSSSModAccFetchEVM

int32 __stdcall RFmxWLAN_DSSSModAccFetchEVM (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* RMSEVMMean, float64* peakEVM80211_2016Maximum, float64* peakEVM80211_2007Maximum, float64* peakEVM80211_1999Maximum, float64* frequencyErrorMean, float64* chipClockErrorMean, int32* numberOfChipsUsed);

Purpose

Fetches the EVM results for the DSSSModAcc measurement.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxWLAN_Initialize function.
selectorString	char[]	Specifies a selector string comprising of the signal name and 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 RFmxWLAN_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
RMSEVMMean	float64*	Returns the RMS EVM results of the burst. When you set the RFMXWLAN_ATTR_DSSSMODACC_AVERAGING_ENABLED attribute to RFMXWLAN_VAL_DSSSMODACC_AVERAGING_ENABLED_TRUE, this result returns the mean of the RMS EVM computed for each averaging count. When you set the RFMXWLAN_ATTR_DSSSMODACC_EVM_UNIT attribute to RFMXWLAN_VAL_DSSSMODACC_EVM_UNIT_PERCENTAGE, the measurement returns this result as a percentage. When you set the RFMXWLAN_ATTR_DSSSMODACC_EVM_UNIT attribute to RFMXWLAN_VAL_DSSSMODACC_EVM_UNIT_DB, the measurement returns this result in dB.
peakEVM80211_2016Maximum	float64*	Returns the peak EVM results of the burst. This value is expressed as a percentage or in dB. This measurement is performed in accordance with section 16.3.7.9 of IEEE Standard 802.11-2016. When you set the RFMXWLAN_ATTR_DSSSMODACC_AVERAGING_ENABLED attribute to RFMXWLAN_VAL_DSSSMODACC_AVERAGING_ENABLED_TRUE, this result returns the maximum of the peak EVM computed for each averaging count.
peakEVM80211_2007Maximum	float64*	Returns the peak EVM results of the burst. This value is expressed as a percentage or in dB. This measurement is performed in accordance with section 18.4.7.8 of IEEE Standard 802.11-2007. When you set the RFMXWLAN_ATTR_DSSSMODACC_AVERAGING_ENABLED attribute to RFMXWLAN_VAL_DSSSMODACC_AVERAGING_ENABLED_TRUE, this result returns the maximum of the peak EVM computed for each averaging count.
peakEVM80211_1999Maximum	float64*	Returns the peak EVM results of the burst. When you set the RFMXWLAN_ATTR_DSSSMODACC_EVM_UNIT attribute to RFMXWLAN_VAL_DSSSMODACC_EVM_UNIT_PERCENTAGE, the measurement returns this result as a percentage. When you set the RFMXWLAN_ATTR_DSSSMODACC_EVM_UNIT attribute to RFMXWLAN_VAL_DSSSMODACC_EVM_UNIT_DB, the measurement returns this result in dB. This measurement is performed in accordance with section 16.3.7.9 of IEEE Standard 802.11-2016. When you set the RFMXWLAN_ATTR_DSSSMODACC_AVERAGING_ENABLED attribute to RFMXWLAN_VAL_DSSSMODACC_AVERAGING_ENABLED_TRUE, this result returns the maximum of the peak EVM computed for each averaging count.
frequencyErrorMean	float64*	Returns the carrier frequency error of the transmitter. This value is expressed in Hz. When you set the RFMXWLAN_ATTR_DSSSMODACC_AVERAGING_ENABLED attribute to RFMXWLAN_VAL_DSSSMODACC_AVERAGING_ENABLED_TRUE, this result returns the mean of the carrier frequency error results computed for each averaging count.
chipClockErrorMean	float64*	Returns the chip clock error result of the transmitter. This value is expressed in parts per million (ppm). When you set the RFMXWLAN_ATTR_DSSSMODACC_AVERAGING_ENABLED attribute to RFMXWLAN_VAL_DSSSMODACC_AVERAGING_ENABLED_TRUE, this result returns the mean of the chip clock error computed for each averaging count.
numberOfChipsUsed	int32*	Returns the number of chips used for the DSSSModAcc measurement.

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 RFmxWLAN_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxWLAN_DSSSModAccFetchIQImpairments

int32 __stdcall RFmxWLAN_DSSSModAccFetchIQImpairments (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* IQOriginOffsetMean, float64* IQGainImbalanceMean, float64* IQQuadratureErrorMean);

Purpose

Fetches the I/Q Impairment results for the DSSSModAcc measurement.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxWLAN_Initialize function.
selectorString	char[]	Specifies a selector string comprising of the signal name and 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 RFmxWLAN_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
IQOriginOffsetMean	float64*	Returns the I/Q origin offset. This value is expressed in dB. I/Q origin offset is the ratio of the mean value of the signal to the RMS value of the signal. When you set the RFMXWLAN_ATTR_DSSSMODACC_AVERAGING_ENABLED attribute to RFMXWLAN_VAL_DSSSMODACC_AVERAGING_ENABLED_TRUE, this parameter returns the mean of the I/Q origin offset results computed for each averaging count.
IQGainImbalanceMean	float64*	Returns the I/Q gain imbalance results. This value is expressed in dB. I/Q gain imbalance is the ratio of the mean amplitude of the in-phase (I) signal to the mean amplitude of the quadrature-phase (Q) signal. When you set the RFMXWLAN_ATTR_DSSSMODACC_AVERAGING_ENABLED attribute to RFMXWLAN_VAL_DSSSMODACC_AVERAGING_ENABLED_TRUE, this parameter returns the mean of the I/Q gain imbalance results computed for each averaging count.
IQQuadratureErrorMean	float64*	Returns the I/Q quadrature error. This value is expressed in degrees. Quadrature error is the deviation in angle from 90 degrees between the in-phase (I) and quadrature-phase (Q) signals. When the RFMXWLAN_ATTR_DSSSMODACC_AVERAGING_ENABLED attribute is set to RFMXWLAN_VAL_DSSSMODACC_AVERAGING_ENABLED_TRUE, this parameter returns the mean of the I/Q quadrature error results computed for each averaging count.

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 RFmxWLAN_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxWLAN_DSSSModAccFetchPPDUInformation

int32 __stdcall RFmxWLAN_DSSSModAccFetchPPDUInformation (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, int32* dataModulationFormat, int32* payloadLength, int32* preambleType, int32* lockedClocksBit, int32* headerCRCStatus, int32* PSDUCRCStatus);

Purpose

Fetches the PPDU information.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxWLAN_Initialize function.
selectorString	char[]	Specifies a selector string comprising of the signal name and 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 RFmxWLAN_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
dataModulationFormat	int32*	Returns the data modulation format results of the analyzed waveform.

RFMXWLAN_VAL_DSSSMODACC_DATA_MODULATION_FORMAT_DSSS1MBPS (0)	Indicates that the modulation format is DSSS and the data rate is 1 Mbps.
RFMXWLAN_VAL_DSSSMODACC_DATA_MODULATION_FORMAT_DSSS2MBPS (1)	Indicates that the modulation format is DSSS and the data rate is 2 Mbps.
RFMXWLAN_VAL_DSSSMODACC_DATA_MODULATION_FORMAT_CCK5_5MBPS (2)	Indicates that the modulation format is CCK and the data rate is 5.5 Mbps.
RFMXWLAN_VAL_DSSSMODACC_DATA_MODULATION_FORMAT_CCK11MBPS (3)	Indicates that the modulation format is CCK and the data rate is 11 Mbps.
RFMXWLAN_VAL_DSSSMODACC_DATA_MODULATION_FORMAT_PBCC5_5MBPS (4)	Indicates that the modulation format is PBCC and the data rate is 5.5 Mbps.
RFMXWLAN_VAL_DSSSMODACC_DATA_MODULATION_FORMAT_PBCC11MBPS (5)	Indicates that the modulation format is PBCC and the data rate is 11 Mbps.
RFMXWLAN_VAL_DSSSMODACC_DATA_MODULATION_FORMAT_PBCC22MBPS (6)	Indicates that the modulation format is PBCC and the data rate is 22 Mbps.
RFMXWLAN_VAL_DSSSMODACC_DATA_MODULATION_FORMAT_PBCC33MBPS (7)	Indicates that the modulation format is PBCC and the data rate is 33 Mbps.

payloadLength	int32*	Returns the payload length of the acquired burst. This value is expressed in bytes.
preambleType	int32*	Returns the detected preamble type.

RFMXWLAN_VAL_DSSSMODACC_PREAMBLE_TYPE_LONG (0)	Indicates that the PPDU has a long PHY preamble and header.
RFMXWLAN_VAL_DSSSMODACC_PREAMBLE_TYPE_SHORT (1)	Indicates that the PPDU has a short PHY preamble and header.

lockedClocksBit	int32*	Returns the value of the locked clocks bit in the Long PHY SERVICE field. A value of 1 indicates that the transmit frequency and the symbol clock are derived from the same oscillator. A value of 0 indicates that the transmit frequency and the symbol clock are derived from independent oscillators.
headerCRCStatus	int32*	Returns whether the header CRC is successfully passed, as defined under section 16.2.3.7 of IEEE Standard 802.11 2016.

RFMXWLAN_VAL_DSSSMODACC_HEADER_CRC_STATUS_FAIL (0)	Indicates that the header CRC failed.
RFMXWLAN_VAL_DSSSMODACC_HEADER_CRC_STATUS_PASS (1)	Indicates that the header CRC passed.

PSDUCRCStatus	int32*	Returns whether the PLCP service data unit (PSDU) cyclic redundancy check (CRC) has successfully passed.

RFMXWLAN_VAL_DSSSMODACC_PSDU_CRC_STATUS_FAIL (0)	Indicates that the PSDU CRC failed.
RFMXWLAN_VAL_DSSSMODACC_PSDU_CRC_STATUS_PASS (1)	Indicates that the PSDU CRC 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 RFmxWLAN_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxWLAN_DSSSModAccFetchAveragePowers

int32 __stdcall RFmxWLAN_DSSSModAccFetchAveragePowers (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* preambleAveragePowerMean, float64* headerAveragePowerMean, float64* dataAveragePowerMean, float64* PPDUAveragePowerMean);

Purpose

Fetches the average power of various fields in the PPDU.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxWLAN_Initialize function.
selectorString	char[]	Specifies a selector string comprising of the signal name and 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 RFmxWLAN_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
preambleAveragePowerMean	float64*	Returns the average power of the preamble field of the PPDU. When you set the RFMXWLAN_ATTR_DSSSMODACC_AVERAGING_ENABLED attribute to RFMXWLAN_VAL_DSSSMODACC_AVERAGING_ENABLED_TRUE, this result returns the mean of the average preamble field power computed for each averaging count. This value is expressed in dBm.
headerAveragePowerMean	float64*	Returns the average power of the header field of the PPDU. When you set the RFMXWLAN_ATTR_DSSSMODACC_AVERAGING_ENABLED attribute to RFMXWLAN_VAL_DSSSMODACC_AVERAGING_ENABLED_TRUE, this result returns the mean of the average header field power computed for each averaging count. This value is expressed in dBm.
dataAveragePowerMean	float64*	Returns the average power of the data field of the PPDU. When you set the RFMXWLAN_ATTR_DSSSMODACC_AVERAGING_ENABLED attribute to RFMXWLAN_VAL_DSSSMODACC_AVERAGING_ENABLED_TRUE, this attribute returns the mean of the data field average power results computed for each averaging count. This value is expressed in dBm.
PPDUAveragePowerMean	float64*	Returns the average power of the PPDU. When you set the RFMXWLAN_ATTR_DSSSMODACC_AVERAGING_ENABLED attribute to RFMXWLAN_VAL_DSSSMODACC_AVERAGING_ENABLED_TRUE, this parameter returns the mean of the average PPDU power results computed for each averaging count. 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 RFmxWLAN_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxWLAN_DSSSModAccFetchPeakPowers

int32 __stdcall RFmxWLAN_DSSSModAccFetchPeakPowers (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* preamblePeakPowerMaximum, float64* headerPeakPowerMaximum, float64* dataPeakPowerMaximum, float64* PPDUPeakPowerMaximum);

Purpose

Fetches the peak power of various fields in the PPDU.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxWLAN_Initialize function.
selectorString	char[]	Specifies a selector string comprising of the signal name and 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 RFmxWLAN_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
preamblePeakPowerMaximum	float64*	Returns the peak power of the preamble field of the PPDU. When you set the RFMXWLAN_ATTR_DSSSMODACC_AVERAGING_ENABLED attribute to RFMXWLAN_VAL_DSSSMODACC_AVERAGING_ENABLED_TRUE, this result returns the maximum of the peak preamble field power results computed for each averaging count. This value is expressed in dBm.
headerPeakPowerMaximum	float64*	Returns the peak power of the header field of the PPDU. When you set the RFMXWLAN_ATTR_DSSSMODACC_AVERAGING_ENABLED attribute to RFMXWLAN_VAL_DSSSMODACC_AVERAGING_ENABLED_TRUE, this result returns the maximum of the peak header field power results computed for each averaging count. This value is expressed in dBm.
dataPeakPowerMaximum	float64*	Returns the peak power of the data field of the PPDU. When you set the RFMXWLAN_ATTR_DSSSMODACC_AVERAGING_ENABLED attribute to RFMXWLAN_VAL_DSSSMODACC_AVERAGING_ENABLED_TRUE, this result returns the maximum of the peak data field power results computed for each averaging count. This value is expressed in dBm.
PPDUPeakPowerMaximum	float64*	Returns the peak power of the PPDU. When you set the RFMXWLAN_ATTR_DSSSMODACC_AVERAGING_ENABLED attribute to RFMXWLAN_VAL_DSSSMODACC_AVERAGING_ENABLED_TRUE, this parameter returns the maximum of the peak PPDU power results computed for each averaging count. 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 RFmxWLAN_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxWLAN_DSSSModAccFetchCustomGatePowersArray

int32 __stdcall RFmxWLAN_DSSSModAccFetchCustomGatePowersArray (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64 averagePowerMean[], float64 peakPowerMaximum[], int32 arraySize, int32* actualArraySize);

Purpose

Fetches the average and peak power of custom gates.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxWLAN_Initialize function.
selectorString	char[]	Specifies a selector string comprising of the signal name and 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 RFmxWLAN_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
averagePowerMean	float64[]	Returns an array of average powers of the custom gates. This value is expressed in dBm. When you set the RFMXWLAN_ATTR_DSSSMODACC_AVERAGING_ENABLED attribute to RFMXWLAN_VAL_DSSSMODACC_AVERAGING_ENABLED_TRUE, this parameter returns an array of the mean of the average custom gate power results computed for each averaging count.
peakPowerMaximum	float64[]	Returns an array of peak powers of the custom gates. This value is expressed in dBm. When you set the RFMXWLAN_ATTR_DSSSMODACC_AVERAGING_ENABLED attribute to RFMXWLAN_VAL_DSSSMODACC_AVERAGING_ENABLED_TRUE, this parameter returns an array of the maximum of the peak custom gate power results computed for each averaging count.
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 RFmxWLAN_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxWLAN_DSSSModAccFetchConstellationTrace

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

Purpose

Fetches the constellation trace for the data field.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxWLAN_Initialize function.
selectorString	char[]	Specifies a selector string comprising of the signal name and 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 RFmxWLAN_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
constellation	NIComplexSingle[]	Returns the constellation of the received symbols.
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 RFmxWLAN_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxWLAN_DSSSModAccFetchEVMPerChipMeanTrace

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

Purpose

Fetches the EVM per chip in the data field. When you set the RFMXWLAN_ATTR_DSSSMODACC_AVERAGING_ENABLED attribute to RFMXWLAN_VAL_DSSSMODACC_AVERAGING_ENABLED_TRUE, this function returns the mean of the EVM per chip computed for each averaging count.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxWLAN_Initialize function.
selectorString	char[]	Specifies a selector string comprising of the signal name and 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 RFmxWLAN_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 index of the first chip.
dx	float64*	Returns the trace increment interval in number of chips. This value is always equal to 1.
EVMPerChipMean	float32[]	Returns an array of EVM per chip. When you set the RFMXWLAN_ATTR_DSSSMODACC_EVM_UNIT attribute to RFMXWLAN_VAL_DSSSMODACC_EVM_UNIT_PERCENTAGE, the measurement returns this result as a percentage. When you set the RFMXWLAN_ATTR_DSSSMODACC_EVM_UNIT attribute to RFMXWLAN_VAL_DSSSMODACC_EVM_UNIT_DB, the measurement returns this result 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 RFmxWLAN_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxWLAN_DSSSModAccFetchDecodedHeaderBitsTrace

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

Purpose

Fetches the decoded Header bits.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxWLAN_Initialize function.
selectorString	char[]	Specifies a selector string comprising of the signal name and 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 RFmxWLAN_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
decodedHeaderBits	int32[]	Returns an array of bits in the Header field.
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 RFmxWLAN_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

RFmxWLAN_DSSSModAccFetchDecodedPSDUBitsTrace

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

Purpose

Fetches the decoded PLCP service data unit (PSDU) bits.

Parameters

Input
Name	Type	Description
instrumentHandle	niRFmxInstrHandle	Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxWLAN_Initialize function.
selectorString	char[]	Specifies a selector string comprising of the signal name and 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 RFmxWLAN_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
decodedPSDUBits	int32[]	Returns an array of PSDU bits obtained after demodulation and decoding.
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 RFmxWLAN_GetError function. The general meaning of the status code is as follows:

Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors