Skip to content

NI RFmx WLAN TXP Attributes

Dane Stull edited this page Feb 22, 2022 · 1 revision

TXP Attributes

RFMXWLAN_ATTR_TXP_MEASUREMENT_ENABLED

Data Type: int32
Access: read/write
Functions: RFmxWLAN_SetAttributeI32
RFmxWLAN_GetAttributeI32
Description: Specifies whether to enable the transmit power (TXP) measurement.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals.

The default value is RFMXWLAN_VAL_FALSE.

Get Function: RFmxWLAN_TXPGetMeasurementEnabled
Set Function: RFmxWLAN_TXPSetMeasurementEnabled

RFMXWLAN_ATTR_TXP_MAXIMUM_MEASUREMENT_INTERVAL

Data Type: float64
Access: read/write
Functions: RFmxWLAN_SetAttributeF64
RFmxWLAN_GetAttributeF64
Description: Specifies the maximum measurement interval. This value is expressed in seconds.

When you set the RFMXWLAN_ATTR_TXP_BURST_DETECTION_ENABLED attribute to RFMXWLAN_VAL_TXP_BURST_DETECTION_ENABLED_TRUE, the measurement interval used is equal to the smaller of the duration of the WLAN packet under analysis or the value you set for this attribute.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals.

The default value is 1 millisecond.

Get Function: RFmxWLAN_TXPGetMaximumMeasurementInterval
Set Function: RFmxWLAN_TXPSetMaximumMeasurementInterval

RFMXWLAN_ATTR_TXP_BURST_DETECTION_ENABLED

Data Type: int32
Access: read/write
Functions: RFmxWLAN_SetAttributeI32
RFmxWLAN_GetAttributeI32
Description: Specifies whether the measurement detects the start and the end of a WLAN packet automatically.

When you set this attribute to True, the measurement interval used is equal to the smaller of the duration of the WLAN packet under analysis or the value you set for the RFMXWLAN_ATTR_TXP_MAXIMUM_MEASUREMENT_INTERVAL attribute.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals.

The default value is RFMXWLAN_VAL_TXP_BURST_DETECTION_ENABLED_TRUE.

Get Function: RFmxWLAN_TXPGetBurstDetectionEnabled
Set Function: RFmxWLAN_TXPSetBurstDetectionEnabled
Values:
RFMXWLAN_VAL_TXP_BURST_DETECTION_ENABLED_FALSE (0) Disables burst detection.
RFMXWLAN_VAL_TXP_BURST_DETECTION_ENABLED_TRUE (1) Enables burst detection.

| :- | :- |

TXP Averaging

RFMXWLAN_ATTR_TXP_AVERAGING_ENABLED

Data Type: int32
Access: read/write
Functions: RFmxWLAN_SetAttributeI32
RFmxWLAN_GetAttributeI32
Description: Specifies whether to enable averaging for the TXP measurement.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals.

The default value is RFMXWLAN_VAL_TXP_AVERAGING_ENABLED_FALSE.

Get Function: RFmxWLAN_TXPGetAveragingEnabled
Set Function: RFmxWLAN_TXPSetAveragingEnabled
Values:
RFMXWLAN_VAL_TXP_AVERAGING_ENABLED_FALSE (0) The measurement is performed on a single acquisition.
RFMXWLAN_VAL_TXP_AVERAGING_ENABLED_TRUE (1) The TXP measurement uses the RFMXWLAN_ATTR_TXP_AVERAGING_COUNT attribute as the number of acquisitions over which the TXP measurement is averaged.

| :- | :- |

RFMXWLAN_ATTR_TXP_AVERAGING_COUNT

Data Type: int32
Access: read/write
Functions: RFmxWLAN_SetAttributeI32
RFmxWLAN_GetAttributeI32
Description: Specifies the number of acquisitions used for averaging when you set the RFMXWLAN_ATTR_TXP_AVERAGING_ENABLED attribute to RFMXWLAN_VAL_TXP_AVERAGING_ENABLED_TRUE.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals.

The default value is 10.

Get Function: RFmxWLAN_TXPGetAveragingCount
Set Function: RFmxWLAN_TXPSetAveragingCount

RFMXWLAN_ATTR_TXP_ALL_TRACES_ENABLED

Data Type: int32
Access: read/write
Functions: RFmxWLAN_SetAttributeI32
RFmxWLAN_GetAttributeI32
Description: Specifies whether to enable the traces to be stored and retrieved after performing the TXP measurement.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals.

The default value is RFMXWLAN_VAL_FALSE.

Get Function: RFmxWLAN_TXPGetAllTracesEnabled
Set Function: RFmxWLAN_TXPSetAllTracesEnabled

RFMXWLAN_ATTR_TXP_NUMBER_OF_ANALYSIS_THREADS

Data Type: int32
Access: read/write
Functions: RFmxWLAN_SetAttributeI32
RFmxWLAN_GetAttributeI32
Description: Specifies the maximum number of threads used for parallelism for TXP measurement.

The number of threads can range from 1 to the number of physical cores. The number of threads you set may not be used in calculations. The actual number of threads used depends on the problem size, system resources, data availability, and other considerations.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals.

The default value is 1.

Get Function: RFmxWLAN_TXPGetNumberOfAnalysisThreads
Set Function: RFmxWLAN_TXPSetNumberOfAnalysisThreads

TXP Results

RFMXWLAN_ATTR_TXP_RESULTS_AVERAGE_POWER_MEAN

Data Type: float64
Access: read only
Functions: RFmxWLAN_GetAttributeF64
Description: Returns the average power of the acquired signal. This value is expressed in dBm.

When you set the RFMXWLAN_ATTR_TXP_AVERAGING_ENABLED attribute to RFMXWLAN_VAL_TXP_AVERAGING_ENABLED_TRUE, this attribute returns the mean of the average power computed for each averaging count.

You do not need to use a selector string to read this result for default signal and result instance. Refer to the Selector Strings topic for information about the string syntax for named signals and results.

Get Function: RFmxWLAN_TXPGetResultsAveragePowerMean

RFMXWLAN_ATTR_TXP_RESULTS_PEAK_POWER_MAXIMUM

Data Type: float64
Access: read only
Functions: RFmxWLAN_GetAttributeF64
Description: Returns the peak power of the acquired signal. This value is expressed in dBm.

When you set the RFMXWLAN_ATTR_TXP_AVERAGING_ENABLED attribute to RFMXWLAN_VAL_TXP_AVERAGING_ENABLED_TRUE, this attribute returns the maximum value of the peak power computed for each averaging count.

You do not need to use a selector string to read this result for default signal and result instance. Refer to the Selector Strings topic for information about the string syntax for named signals and results.

Get Function: RFmxWLAN_TXPGetResultsPeakPowerMaximum

Table of Contents

Internal Development

Creating and Setting Up a gRPC Server

Server Security Support

Creating a gRPC Client

gRPC Client Examples

Session Utilities API Reference

Driver Documentation

gRPC API Differences From C API

Sharing Driver Sessions Between Clients

C API Docs
NI-DAQmx
NI-DCPOWER
NI-DIGITAL PATTERN DRIVER
NI-DMM
NI-FGEN
NI-FPGA
NI-RFmx Bluetooth
NI-RFmx NR
NI-RFmx WCDMA
NI-RFmx GSM
NI-RFmx CDMA2k
NI-RFmx Instr
NI-RFmx LTE
NI-RFmx SpecAn
NI-RFmx TD-SCDMA
NI-RFmx WLAN
NI-RFSA
NI-RFSG
NI-SCOPE
NI-SWITCH
NI-TCLK
NI-XNET
Clone this wiki locally