NI RFmx Bluetooth General Attributes

General Attributes

• RFMXBT_ATTR_SELECTED_PORTS
• RFMXBT_ATTR_CENTER_FREQUENCY
• RFMXBT_ATTR_REFERENCE_LEVEL
• RFMXBT_ATTR_EXTERNAL_ATTENUATION
• RFMXBT_ATTR_REFERENCE_LEVEL_HEADROOM
• RFMXBT_ATTR_CHANNEL_NUMBER
• RFMXBT_ATTR_RESULT_FETCH_TIMEOUT

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