NI RFmx Bluetooth Trigger Attributes

Trigger Attributes

• RFMXBT_ATTR_TRIGGER_TYPE
• Digital Edge
  • RFMXBT_ATTR_DIGITAL_EDGE_TRIGGER_SOURCE
  • RFMXBT_ATTR_DIGITAL_EDGE_TRIGGER_EDGE
• IQ Power Edge
  • RFMXBT_ATTR_IQ_POWER_EDGE_TRIGGER_SOURCE
  • RFMXBT_ATTR_IQ_POWER_EDGE_TRIGGER_LEVEL
  • RFMXBT_ATTR_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE
  • RFMXBT_ATTR_IQ_POWER_EDGE_TRIGGER_SLOPE
• RFMXBT_ATTR_TRIGGER_DELAY
• Minimum Quiet Time
  • RFMXBT_ATTR_TRIGGER_MINIMUM_QUIET_TIME_MODE
  • RFMXBT_ATTR_TRIGGER_MINIMUM_QUIET_TIME_DURATION

RFMXBT_ATTR_TRIGGER_TYPE

Data Type:	int32
Access:	read/write
Functions:	RFmxBT_SetAttributeI32 RFmxBT_GetAttributeI32
Description:	Specifies the type of trigger to be used for signal acquisition. 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 RFMXBT_VAL_TRIGGER_TYPE_IQ_POWER_EDGE. Get Function: RFmxBT_GetTriggerType Set Function: RFmxBT_SetTriggerType

Values:
RFMXBT_VAL_TRIGGER_TYPE_NONE (0)	No reference trigger is used for signal acquisition.
RFMXBT_VAL_TRIGGER_TYPE_DIGITAL_EDGE (1)	A digital-edge trigger is used for signal acquisition. The source of the digital edge is specified using the RFMXBT_ATTR_DIGITAL_EDGE_TRIGGER_SOURCE attribute.
RFMXBT_VAL_TRIGGER_TYPE_IQ_POWER_EDGE (2)	An I/Q power-edge trigger is used for signal acquisition, which is configured using the RFMXBT_ATTR_IQ_POWER_EDGE_TRIGGER_SLOPE attribute.
RFMXBT_VAL_TRIGGER_TYPE_SOFTWARE (3)	A software trigger is used for signal acquisition.

Digital Edge

RFMXBT_ATTR_DIGITAL_EDGE_TRIGGER_SOURCE

Data Type:	char []
Access:	read/write
Functions:	RFmxBT_SetAttributeString RFmxBT_GetAttributeString
Description:	Specifies the source terminal for the digital edge trigger. This attribute is used only when you set the RFMXBT_ATTR_TRIGGER_TYPE attribute to RFMXBT_VAL_TRIGGER_TYPE_DIGITAL_EDGE. 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 of this attribute is hardware dependent. Get Function: RFmxBT_GetDigitalEdgeTriggerSource Set Function: RFmxBT_SetDigitalEdgeTriggerSource

Values:
RFMXBT_VAL_PFI0_STR (PFI0)	The trigger is received on PFI 0.
RFMXBT_VAL_PFI1_STR (PFI1)	The trigger is received on PFI 1.
RFMXBT_VAL_PXI_TRIG0_STR (PXI_Trig0)	The trigger is received on PXI trigger line 0.
RFMXBT_VAL_PXI_TRIG1_STR (PXI_Trig1)	The trigger is received on PXI trigger line 1.
RFMXBT_VAL_PXI_TRIG2_STR (PXI_Trig2)	The trigger is received on PXI trigger line 2.
RFMXBT_VAL_PXI_TRIG3_STR (PXI_Trig3)	The trigger is received on PXI trigger line 3.
RFMXBT_VAL_PXI_TRIG4_STR (PXI_Trig4)	The trigger is received on PXI trigger line 4.
RFMXBT_VAL_PXI_TRIG5_STR (PXI_Trig5)	The trigger is received on PXI trigger line 5.
RFMXBT_VAL_PXI_TRIG6_STR (PXI_Trig6)	The trigger is received on PXI trigger line 6.
RFMXBT_VAL_PXI_TRIG7_STR (PXI_Trig7)	The trigger is received on PXI trigger line 7.
RFMXBT_VAL_PXI_STAR_STR (PXI_STAR)	The trigger is received on PXI star trigger line.
RFMXBT_VAL_PXIE_DSTARB_STR (PXIe_DStarB)	The trigger is received on the PXIe DStar B trigger line.
RFMXBT_VAL_TIMER_EVENT_STR (TimerEvent)	The trigger is received from the timer event.

RFMXBT_ATTR_DIGITAL_EDGE_TRIGGER_EDGE

Data Type:	int32
Access:	read/write
Functions:	RFmxBT_SetAttributeI32 RFmxBT_GetAttributeI32
Description:	Specifies the active edge for the trigger. This attribute is valid only when you set the RFMXBT_ATTR_TRIGGER_TYPE attribute to RFMXBT_VAL_TRIGGER_TYPE_DIGITAL_EDGE. 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 RFMXBT_VAL_DIGITAL_EDGE_RISING_EDGE. Get Function: RFmxBT_GetDigitalEdgeTriggerEdge Set Function: RFmxBT_SetDigitalEdgeTriggerEdge

Values:
RFMXBT_VAL_DIGITAL_EDGE_RISING_EDGE (0)	The trigger asserts on the rising edge of the signal.
RFMXBT_VAL_DIGITAL_EDGE_FALLING_EDGE (1)	The trigger asserts on the falling edge of the signal.

IQ Power Edge

RFMXBT_ATTR_IQ_POWER_EDGE_TRIGGER_SOURCE

Data Type:	char []
Access:	read/write
Functions:	RFmxBT_SetAttributeString RFmxBT_GetAttributeString
Description:	Specifies the channel from which the device monitors the trigger. This attribute is valid only when you set the RFMXBT_ATTR_TRIGGER_TYPE attribute to RFMXBT_VAL_TRIGGER_TYPE_IQ_POWER_EDGE. 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_GetIQPowerEdgeTriggerSource Set Function: RFmxBT_SetIQPowerEdgeTriggerSource

RFMXBT_ATTR_IQ_POWER_EDGE_TRIGGER_LEVEL

Data Type:	float64
Access:	read/write
Functions:	RFmxBT_SetAttributeF64 RFmxBT_GetAttributeF64
Description:	Specifies the power level at which the device triggers. The device asserts the trigger when the signal exceeds the level specified by the value of this parameter, taking into consideration the specified slope. This value is expressed in dB when you set the RFMXBT_ATTR_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE attribute to RFMXBT_VAL_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE_RELATIVE and in dBm when you set the RFMXBT_ATTR_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE attribute to RFMXBT_VAL_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE_ABSOLUTE. This attribute is valid only when you set the RFMXBT_ATTR_TRIGGER_TYPE attribute to RFMXBT_VAL_TRIGGER_TYPE_IQ_POWER_EDGE. 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. Get Function: RFmxBT_GetIQPowerEdgeTriggerLevel Set Function: RFmxBT_SetIQPowerEdgeTriggerLevel

RFMXBT_ATTR_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE

Data Type:	int32
Access:	read/write
Functions:	RFmxBT_SetAttributeI32 RFmxBT_GetAttributeI32
Description:	Specifies the reference for the RFMXBT_ATTR_IQ_POWER_EDGE_TRIGGER_LEVEL attribute. The RFMXBT_ATTR_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE attribute is used only when you set the RFMXBT_ATTR_TRIGGER_TYPE attribute to RFMXBT_VAL_TRIGGER_TYPE_IQ_POWER_EDGE. 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 RFMXBT_VAL_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE_RELATIVE. Get Function: RFmxBT_GetIQPowerEdgeTriggerLevelType Set Function: RFmxBT_SetIQPowerEdgeTriggerLevelType

Values:
RFMXBT_VAL_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE_RELATIVE (0)	The IQ Power Edge Level attribute is relative to the value of the RFMXBT_ATTR_REFERENCE_LEVEL attribute.
RFMXBT_VAL_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE_ABSOLUTE (1)	The IQ Power Edge Level attribute specifies the absolute power.

RFMXBT_ATTR_IQ_POWER_EDGE_TRIGGER_SLOPE

Data Type:	int32
Access:	read/write
Functions:	RFmxBT_SetAttributeI32 RFmxBT_GetAttributeI32
Description:	Specifies whether the device asserts the trigger when the signal power is rising or when it is falling. The device asserts the trigger when the signal power exceeds the specified level with the slope you specify. This attribute is used only when you set the RFMXBT_ATTR_TRIGGER_TYPE attribute to RFMXBT_VAL_TRIGGER_TYPE_IQ_POWER_EDGE. 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 RFMXBT_VAL_IQ_POWER_EDGE_RISING_SLOPE. Get Function: RFmxBT_GetIQPowerEdgeTriggerSlope Set Function: RFmxBT_SetIQPowerEdgeTriggerSlope

Values:
RFMXBT_VAL_IQ_POWER_EDGE_RISING_SLOPE (0)	The trigger asserts when the signal power is rising.
RFMXBT_VAL_IQ_POWER_EDGE_FALLING_SLOPE (1)	The trigger asserts when the signal power is falling.

RFMXBT_ATTR_TRIGGER_DELAY

Data Type:	float64
Access:	read/write
Functions:	RFmxBT_SetAttributeF64 RFmxBT_GetAttributeF64
Description:	Specifies the trigger delay time. This value is expressed in seconds. If the delay is negative, the measurement acquires pretrigger samples. If the delay is positive, the measurement acquires posttrigger samples. 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_GetTriggerDelay Set Function: RFmxBT_SetTriggerDelay

Minimum Quiet Time

RFMXBT_ATTR_TRIGGER_MINIMUM_QUIET_TIME_MODE

Data Type:	int32
Access:	read/write
Functions:	RFmxBT_SetAttributeI32 RFmxBT_GetAttributeI32
Description:	Specifies whether the measurement computes the minimum quiet time used for triggering. 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 RFMXBT_VAL_TRIGGER_MINIMUM_QUIET_TIME_MODE_AUTO. Get Function: RFmxBT_GetTriggerMinimumQuietTimeMode Set Function: RFmxBT_SetTriggerMinimumQuietTimeMode

Values:
RFMXBT_VAL_TRIGGER_MINIMUM_QUIET_TIME_MODE_MANUAL (0)	The minimum quiet time for triggering is the value of the Trigger Min Quiet Time attribute.
RFMXBT_VAL_TRIGGER_MINIMUM_QUIET_TIME_MODE_AUTO (1)	The measurement computes the minimum quiet time used for triggering.

RFMXBT_ATTR_TRIGGER_MINIMUM_QUIET_TIME_DURATION

Data Type:	float64
Access:	read/write
Functions:	RFmxBT_SetAttributeF64 RFmxBT_GetAttributeF64
Description:	Specifies the time duration for which the signal must be quiet before the signal analyzer arms the I/Q power edge trigger. This value is expressed in seconds. If you set the RFMXBT_ATTR_IQ_POWER_EDGE_TRIGGER_SLOPE attribute to RFMXBT_VAL_IQ_POWER_EDGE_RISING_SLOPE, the signal is quiet below the trigger level. If you set the RFMXBT_ATTR_IQ_POWER_EDGE_TRIGGER_SLOPE attribute to RFMXBT_VAL_IQ_POWER_EDGE_FALLING_SLOPE, the signal is quiet above the trigger level. 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_GetTriggerMinimumQuietTimeDuration Set Function: RFmxBT_SetTriggerMinimumQuietTimeDuration