NI RFmx WLAN Fetch DSSS Modacc Functions - ni/grpc-device GitHub Wiki
- RFmxWLAN_DSSSModAccFetchEVM
- RFmxWLAN_DSSSModAccFetchIQImpairments
- RFmxWLAN_DSSSModAccFetchPPDUInformation
- RFmxWLAN_DSSSModAccFetchAveragePowers
- RFmxWLAN_DSSSModAccFetchPeakPowers
- RFmxWLAN_DSSSModAccFetchCustomGatePowersArray
- RFmxWLAN_DSSSModAccFetchConstellationTrace
- RFmxWLAN_DSSSModAccFetchEVMPerChipMeanTrace
- RFmxWLAN_DSSSModAccFetchDecodedHeaderBitsTrace
- RFmxWLAN_DSSSModAccFetchDecodedPSDUBitsTrace
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);
Fetches the EVM results for the DSSSModAcc measurement.
| 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. |
| 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 |
int32 __stdcall RFmxWLAN_DSSSModAccFetchIQImpairments (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* IQOriginOffsetMean, float64* IQGainImbalanceMean, float64* IQQuadratureErrorMean);
Fetches the I/Q Impairment results for the DSSSModAcc measurement.
| 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. |
| 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 |
int32 __stdcall RFmxWLAN_DSSSModAccFetchPPDUInformation (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, int32* dataModulationFormat, int32* payloadLength, int32* preambleType, int32* lockedClocksBit, int32* headerCRCStatus, int32* PSDUCRCStatus);
Fetches the PPDU information.
| 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. |
| 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 |
int32 __stdcall RFmxWLAN_DSSSModAccFetchAveragePowers (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* preambleAveragePowerMean, float64* headerAveragePowerMean, float64* dataAveragePowerMean, float64* PPDUAveragePowerMean);
Fetches the average power of various fields in the PPDU.
| 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. |
| 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 |
int32 __stdcall RFmxWLAN_DSSSModAccFetchPeakPowers (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* preamblePeakPowerMaximum, float64* headerPeakPowerMaximum, float64* dataPeakPowerMaximum, float64* PPDUPeakPowerMaximum);
Fetches the peak power of various fields in the PPDU.
| 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. |
| 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 |
int32 __stdcall RFmxWLAN_DSSSModAccFetchCustomGatePowersArray (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64 averagePowerMean[], float64 peakPowerMaximum[], int32 arraySize, int32* actualArraySize);
Fetches the average and peak power of custom gates.
| 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. |
| 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 |
int32 __stdcall RFmxWLAN_DSSSModAccFetchConstellationTrace (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, NIComplexSingle constellation[], int32 arraySize, int32* actualArraySize);
Fetches the constellation trace for the data field.
| 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. |
| 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 |
int32 __stdcall RFmxWLAN_DSSSModAccFetchEVMPerChipMeanTrace (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, float64* x0, float64* dx, float32 EVMPerChipMean[], int32 arraySize, int32* actualArraySize);
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.
| 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. |
| 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 |
int32 __stdcall RFmxWLAN_DSSSModAccFetchDecodedHeaderBitsTrace (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, int32 decodedHeaderBits[], int32 arraySize, int32* actualArraySize);
Fetches the decoded Header bits.
| 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. |
| 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 |
int32 __stdcall RFmxWLAN_DSSSModAccFetchDecodedPSDUBitsTrace (niRFmxInstrHandle instrumentHandle, char selectorString[], float64 timeout, int32 decodedPSDUBits[], int32 arraySize, int32* actualArraySize);
Fetches the decoded PLCP service data unit (PSDU) bits.
| 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. |
| 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 |