NI RFmx SpecAn Trigger Attributes

Trigger Attributes

• RFMXSPECAN_ATTR_TRIGGER_TYPE
• Digital Edge
  • RFMXSPECAN_ATTR_DIGITAL_EDGE_TRIGGER_SOURCE
  • RFMXSPECAN_ATTR_DIGITAL_EDGE_TRIGGER_EDGE
• IQ Power Edge
  • RFMXSPECAN_ATTR_IQ_POWER_EDGE_TRIGGER_SOURCE
  • RFMXSPECAN_ATTR_IQ_POWER_EDGE_TRIGGER_LEVEL
  • RFMXSPECAN_ATTR_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE
  • RFMXSPECAN_ATTR_IQ_POWER_EDGE_TRIGGER_SLOPE
• RFMXSPECAN_ATTR_TRIGGER_DELAY
• Min Quiet Time
  • RFMXSPECAN_ATTR_TRIGGER_MINIMUM_QUIET_TIME_MODE
  • RFMXSPECAN_ATTR_TRIGGER_MINIMUM_QUIET_TIME_DURATION

RFMXSPECAN_ATTR_TRIGGER_TYPE

Data Type:	int32
Access:	read/write
Functions:	RFmxSpecAn_SetAttributeI32 RFmxSpecAn_GetAttributeI32
Description:	Specifies the trigger type. 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 None. Get Function: RFmxSpecAn_GetTriggerType Set Function: RFmxSpecAn_SetTriggerType
Values:

RFMXSPECAN_VAL_TRIGGER_TYPE_NONE (0)	No Reference Trigger is configured.
RFMXSPECAN_VAL_TRIGGER_TYPE_DIGITAL_EDGE (1)	The Reference Trigger is not asserted until a digital edge is detected. The source of the digital edge is specified using the RFMXSPECAN_ATTR_DIGITAL_EDGE_TRIGGER_SOURCE attribute.
RFMXSPECAN_VAL_TRIGGER_TYPE_IQ_POWER_EDGE (2)	The Reference Trigger is asserted when the signal changes past the level specified by the slope (rising or falling), which is configured using the RFMXSPECAN_ATTR_IQ_POWER_EDGE_TRIGGER_SLOPE attribute.
RFMXSPECAN_VAL_TRIGGER_TYPE_SOFTWARE (3)	The Reference Trigger is not asserted until a software trigger occurs.

Digital Edge

RFMXSPECAN_ATTR_DIGITAL_EDGE_TRIGGER_SOURCE

Data Type:	char []
Access:	read/write
Functions:	RFmxSpecAn_SetAttributeString RFmxSpecAn_GetAttributeString
Description:	Specifies the source terminal for the digital edge trigger. This attribute is used only when you set the RFMXSPECAN_ATTR_TRIGGER_TYPE attribute to RFMXSPECAN_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: RFmxSpecAn_GetDigitalEdgeTriggerSource Set Function: RFmxSpecAn_SetDigitalEdgeTriggerSource
Values:

RFMXSPECAN_VAL_PFI0_STR (PFI0)	The trigger is received on PFI 0.
RFMXSPECAN_VAL_PFI1_STR (PFI1)	The trigger is received on PFI 1.
RFMXSPECAN_VAL_PXI_TRIG0_STR (PXI_Trig0)	The trigger is received on PXI trigger line 0.
RFMXSPECAN_VAL_PXI_TRIG1_STR (PXI_Trig1)	The trigger is received on PXI trigger line 1.
RFMXSPECAN_VAL_PXI_TRIG2_STR (PXI_Trig2)	The trigger is received on PXI trigger line 2.
RFMXSPECAN_VAL_PXI_TRIG3_STR (PXI_Trig3)	The trigger is received on PXI trigger line 3.
RFMXSPECAN_VAL_PXI_TRIG4_STR (PXI_Trig4)	The trigger is received on PXI trigger line 4.
RFMXSPECAN_VAL_PXI_TRIG5_STR (PXI_Trig5)	The trigger is received on PXI trigger line 5.
RFMXSPECAN_VAL_PXI_TRIG6_STR (PXI_Trig6)	The trigger is received on PXI trigger line 6.
RFMXSPECAN_VAL_PXI_TRIG7_STR (PXI_Trig7)	The trigger is received on PXI trigger line 7.
RFMXSPECAN_VAL_PXI_STAR_STR (PXI_STAR)	The trigger is received on the PXI star trigger line.
RFMXSPECAN_VAL_PXIE_DSTARB_STR (PXIe_DStarB)	The trigger is received on the PXIe DStar B trigger line.
RFMXSPECAN_VAL_TIMER_EVENT_STR (TimerEvent)	The trigger is received from the timer event.

RFMXSPECAN_ATTR_DIGITAL_EDGE_TRIGGER_EDGE

Data Type:	int32
Access:	read/write
Functions:	RFmxSpecAn_SetAttributeI32 RFmxSpecAn_GetAttributeI32
Description:	Specifies the active edge for the trigger. This attribute is used only when you set the RFMXSPECAN_ATTR_TRIGGER_TYPE attribute to RFMXSPECAN_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 Rising Edge. Get Function: RFmxSpecAn_GetDigitalEdgeTriggerEdge Set Function: RFmxSpecAn_SetDigitalEdgeTriggerEdge
Values:

RFMXSPECAN_VAL_DIGITAL_EDGE_RISING_EDGE (0)	The trigger asserts on the rising edge of the signal.
RFMXSPECAN_VAL_DIGITAL_EDGE_FALLING_EDGE (1)	The trigger asserts on the falling edge of the signal.

IQ Power Edge

RFMXSPECAN_ATTR_IQ_POWER_EDGE_TRIGGER_SOURCE

Data Type:	char []
Access:	read/write
Functions:	RFmxSpecAn_SetAttributeString RFmxSpecAn_GetAttributeString
Description:	Specifies the channel from which the device monitors the trigger. This attribute is used only when you set the RFMXSPECAN_ATTR_TRIGGER_TYPE attribute to RFMXSPECAN_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 of this attribute is hardware dependent. Get Function: RFmxSpecAn_GetIQPowerEdgeTriggerSource Set Function: RFmxSpecAn_SetIQPowerEdgeTriggerSource

RFMXSPECAN_ATTR_IQ_POWER_EDGE_TRIGGER_LEVEL

Data Type:	float64
Access:	read/write
Functions:	RFmxSpecAn_SetAttributeF64 RFmxSpecAn_GetAttributeF64
Description:	Specifies the power level at which the device triggers. This value is expressed in dB when you set the RFMXSPECAN_ATTR_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE attribute to RFMXSPECAN_VAL_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE_RELATIVE and is expressed in dBm when you set the RFMXSPECAN_ATTR_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE attribute to RFMXSPECAN_VAL_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE_ABSOLUTE. The device asserts the trigger when the signal exceeds the level specified by the value of this attribute, taking into consideration the specified slope. This attribute is used only when you set the RFMXSPECAN_ATTR_TRIGGER_TYPE attribute to RFMXSPECAN_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 String topic for information about the string syntax for named signals. The default of this attribute is hardware dependent. Get Function: RFmxSpecAn_GetIQPowerEdgeTriggerLevel Set Function: RFmxSpecAn_SetIQPowerEdgeTriggerLevel

RFMXSPECAN_ATTR_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE

Data Type:	int32
Access:	read/write
Functions:	RFmxSpecAn_SetAttributeI32 RFmxSpecAn_GetAttributeI32
Description:	Specifies the reference for the RFMXSPECAN_ATTR_IQ_POWER_EDGE_TRIGGER_LEVEL attribute. The RFMXSPECAN_ATTR_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE attribute is used only when you set the RFMXSPECAN_ATTR_TRIGGER_TYPE attribute to RFMXSPECAN_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 String topic for information about the string syntax for named signals. The default value is RFMXSPECAN_VAL_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE_ABSOLUTE. Get Function: RFmxSpecAn_GetIQPowerEdgeTriggerLevelType Set Function: RFmxSpecAn_SetIQPowerEdgeTriggerLevelType
Values:

RFMXSPECAN_VAL_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE_RELATIVE (0)	The IQ Power Edge Level attribute is relative to the value of the RFMXSPECAN_ATTR_REFERENCE_LEVEL attribute.
RFMXSPECAN_VAL_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE_ABSOLUTE (1)	The IQ Power Edge Level attribute specifies the absolute power.

RFMXSPECAN_ATTR_IQ_POWER_EDGE_TRIGGER_SLOPE

Data Type:	int32
Access:	read/write
Functions:	RFmxSpecAn_SetAttributeI32 RFmxSpecAn_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 RFMXSPECAN_ATTR_TRIGGER_TYPE attribute to RFMXSPECAN_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 Rising Slope. Get Function: RFmxSpecAn_GetIQPowerEdgeTriggerSlope Set Function: RFmxSpecAn_SetIQPowerEdgeTriggerSlope
Values:

RFMXSPECAN_VAL_IQ_POWER_EDGE_RISING_SLOPE (0)	The trigger asserts when the signal power is rising.
RFMXSPECAN_VAL_IQ_POWER_EDGE_FALLING_SLOPE (1)	The trigger asserts when the signal power is falling.

RFMXSPECAN_ATTR_TRIGGER_DELAY

Data Type:	float64
Access:	read/write
Functions:	RFmxSpecAn_SetAttributeF64 RFmxSpecAn_GetAttributeF64
Description:	Specifies the trigger delay time. This value is expressed in seconds. If the delay is negative, the measurement acquires pre-trigger samples. If the delay is positive, the measurement acquires post-trigger 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: RFmxSpecAn_GetTriggerDelay Set Function: RFmxSpecAn_SetTriggerDelay

Min Quiet Time

RFMXSPECAN_ATTR_TRIGGER_MINIMUM_QUIET_TIME_MODE

Data Type:	int32
Access:	read/write
Functions:	RFmxSpecAn_SetAttributeI32 RFmxSpecAn_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 RFMXSPECAN_VAL_TRIGGER_MINIMUM_QUIET_TIME_MODE_MANUAL. Get Function: RFmxSpecAn_GetTriggerMinimumQuietTimeMode Set Function: RFmxSpecAn_SetTriggerMinimumQuietTimeMode
Values:

RFMXSPECAN_VAL_TRIGGER_MINIMUM_QUIET_TIME_MODE_MANUAL (0)	The minimum quiet time for triggering is the value of the RFMXSPECAN_ATTR_TRIGGER_MINIMUM_QUIET_TIME_DURATION attribute.
RFMXSPECAN_VAL_TRIGGER_MINIMUM_QUIET_TIME_MODE_AUTO (1)	The measurement computes the minimum quiet time used for triggering.

RFMXSPECAN_ATTR_TRIGGER_MINIMUM_QUIET_TIME_DURATION

Data Type:	float64
Access:	read/write
Functions:	RFmxSpecAn_SetAttributeF64 RFmxSpecAn_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 RFMXSPECAN_ATTR_IQ_POWER_EDGE_TRIGGER_SLOPE attribute to RFMXSPECAN_VAL_IQ_POWER_EDGE_RISING_SLOPE, the signal is quiet below the trigger level. If you set the RFMXSPECAN_ATTR_IQ_POWER_EDGE_TRIGGER_SLOPE attribute to RFMXSPECAN_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 of this attribute is hardware dependent. Get Function: RFmxSpecAn_GetTriggerMinimumQuietTimeDuration Set Function: RFmxSpecAn_SetTriggerMinimumQuietTimeDuration