Skip to content

NI RFmx Bluetooth General Attributes

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

General Attributes

RFMXBT_ATTR_SELECTED_PORTS

Data Type: char []
Access: read/write
Functions: RFmxBT_SetAttributeString
RFmxBT_GetAttributeString
Description: Specifies the instrument port to be configured to acquire a signal. Use RFmxInstr_GetAvailablePorts function to get the valid port names.

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.

Valid values

PXIe-5830 if0, if1

PXIe-5831/5832 if0, if1, rf(0-1)/port(x), where 0-1 indicates one (0) or two (1) mmRH-5582 connections and x is the port number on the mmRH-5582 front panel

Other devices '' (empty string)


Default values

PXIe-5830/5831/5832 if1

Other devices '' (empty string)


Get Function: RFmxBT_GetSelectedPorts
Set Function: RFmxBT_SetSelectedPorts

RFMXBT_ATTR_CENTER_FREQUENCY

Data Type: float64
Access: read/write
Functions: RFmxBT_SetAttributeF64
RFmxBT_GetAttributeF64
Description: Specifies the expected carrier frequency of the RF signal that needs to be acquired. This value is expressed in Hz. The signal analyzer tunes to this frequency.

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 hardware dependent. The default value for the devices PXIe-5645/5820 is 0 Hz. The default value for devices PXIe-5644/5646/5840/5663/5663E/5665/5668R is 2.402 GHz.

Get Function: RFmxBT_GetCenterFrequency
Set Function: RFmxBT_SetCenterFrequency

RFMXBT_ATTR_REFERENCE_LEVEL

Data Type: float64
Access: read/write
Functions: RFmxBT_SetAttributeF64
RFmxBT_GetAttributeF64
Description: Specifies the reference level that represents the maximum expected power of the RF input signal. This value is expressed in dBm for RF devices and Vpk-pk for baseband devices.

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 of this attribute is hardware dependent.

Get Function: RFmxBT_GetReferenceLevel
Set Function: RFmxBT_SetReferenceLevel

RFMXBT_ATTR_EXTERNAL_ATTENUATION

Data Type: float64
Access: read/write
Functions: RFmxBT_SetAttributeF64
RFmxBT_GetAttributeF64
Description: Specifies the attenuation of a switch (or cable) connected to the RF IN connector of the signal analyzer. This value is expressed in dB.

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.

For more information about attenuation, refer to the Attenuation and Signal Levels topic for your device in the NI RF Vector Signal Analyzers Help.

The default value is 0.

Get Function: RFmxBT_GetExternalAttenuation
Set Function: RFmxBT_SetExternalAttenuation

RFMXBT_ATTR_REFERENCE_LEVEL_HEADROOM

Data Type: float64
Access: read/write
Functions: RFmxBT_SetAttributeF64
RFmxBT_GetAttributeF64
Description: Specifies the margin RFmx adds to the RFMXBT_ATTR_REFERENCE_LEVEL attribute. The margin avoids clipping and overflow warnings if the input signal exceeds the configured reference level.

RFmx configures the input gain to avoid clipping and associated overflow warnings provided the instantaneous power of the input signal remains within the RFMXBT_ATTR_REFERENCE_LEVEL plus the RFMXBT_ATTR_REFERENCE_LEVEL_HEADROOM. If you know the input power of the signal precisely or previously included the margin in the RFMXBT_ATTR_REFERENCE_LEVEL, you could improve the signal-to-noise ratio by reducing the RFMXBT_ATTR_REFERENCE_LEVEL_HEADROOM.

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.

Supported devices: PXIe-5668R, PXIe-5830/5831/5832/5840/5841.

Default values

PXIe-5668 6 dB

PXIe-5830/5831/5832/5841 1 dB

PXIe-5840 0 dB


Get Function: RFmxBT_GetReferenceLevelHeadroom
Set Function: RFmxBT_SetReferenceLevelHeadroom

RFMXBT_ATTR_CHANNEL_NUMBER

Data Type: int32
Access: read/write
Functions: RFmxBT_SetAttributeI32
RFmxBT_GetAttributeI32
Description: Specifies the RF channel number of the signal generated by the device under test (DUT), as defined in the bluetooth specification. This attribute is applicable when you enable the ACP measurement and when you set the RFMXBT_ATTR_ACP_OFFSET_CHANNEL_MODE attribute to RFMXBT_VAL_ACP_OFFSET_CHANNEL_MODE_INBAND.

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 0.

Get Function: RFmxBT_GetChannelNumber
Set Function: RFmxBT_SetChannelNumber

RFMXBT_ATTR_RESULT_FETCH_TIMEOUT

Data Type: float64
Access: read/write
Functions: RFmxBT_SetAttributeF64
RFmxBT_GetAttributeF64
Description: Specifies the time, in seconds, to wait before results are available in the RFmxBT_AttributeNode. Set this value to a time longer than expected for fetching the measurement. A value of -1 specifies that the RFmxBT Attribute Node waits until the measurement is complete.

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: RFmxBT_GetResultFetchTimeout
Set Function: RFmxBT_SetResultFetchTimeout

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