NI RFmx NR Trigger Attributes

Trigger Attributes

• RFMXNR_ATTR_TRIGGER_TYPE
• Digital Edge
  • RFMXNR_ATTR_DIGITAL_EDGE_TRIGGER_SOURCE
  • RFMXNR_ATTR_DIGITAL_EDGE_TRIGGER_EDGE
• IQ Power Edge
  • RFMXNR_ATTR_IQ_POWER_EDGE_TRIGGER_SOURCE
  • RFMXNR_ATTR_IQ_POWER_EDGE_TRIGGER_LEVEL
  • RFMXNR_ATTR_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE
  • RFMXNR_ATTR_IQ_POWER_EDGE_TRIGGER_SLOPE
• RFMXNR_ATTR_TRIGGER_DELAY
• Minimum Quiet Time
  • RFMXNR_ATTR_TRIGGER_MINIMUM_QUIET_TIME_MODE
  • RFMXNR_ATTR_TRIGGER_MINIMUM_QUIET_TIME_DURATION

RFMXNR_ATTR_TRIGGER_TYPE

Data Type:	int32
Access:	read/write
Functions:	RFmxNR_SetAttributeI32 RFmxNR_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 RFMXNR_VAL_TRIGGER_TYPE_NONE. Get Function: RFmxNR_GetTriggerType Set Function: RFmxNR_SetTriggerType
Values:

RFMXNR_VAL_TRIGGER_TYPE_NONE (0)	No Reference Trigger is configured.
RFMXNR_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 RFMXNR_ATTR_DIGITAL_EDGE_TRIGGER_SOURCE attribute.
RFMXNR_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 RFMXNR_ATTR_IQ_POWER_EDGE_TRIGGER_SLOPE attribute.
RFMXNR_VAL_TRIGGER_TYPE_SOFTWARE (3)	The Reference Trigger is not asserted until a software trigger occurs.

Digital Edge

RFMXNR_ATTR_DIGITAL_EDGE_TRIGGER_SOURCE

Data Type:	char []
Access:	read/write
Functions:	RFmxNR_SetAttributeString RFmxNR_GetAttributeString
Description:	Specifies the source terminal for the digital edge trigger. This attribute is used only when you set the RFMXNR_ATTR_TRIGGER_TYPE attribute to RFMXNR_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 oof this attribute is hardware dependent. Get Function: RFmxNR_GetDigitalEdgeTriggerSource Set Function: RFmxNR_SetDigitalEdgeTriggerSource
Values:

RFMXNR_VAL_PFI0_STR (PFI0)	The trigger is received on PFI 0.
RFMXNR_VAL_PFI1_STR (PFI1)	The trigger is received on PFI 1.
RFMXNR_VAL_PXI_TRIG0_STR (PXI_Trig0)	The trigger is received on PXI trigger line 0.
RFMXNR_VAL_PXI_TRIG1_STR (PXI_Trig1)	The trigger is received on PXI trigger line 1.
RFMXNR_VAL_PXI_TRIG2_STR (PXI_Trig2)	The trigger is received on PXI trigger line 2.
RFMXNR_VAL_PXI_TRIG3_STR (PXI_Trig3)	The trigger is received on PXI trigger line 3.
RFMXNR_VAL_PXI_TRIG4_STR (PXI_Trig4)	The trigger is received on PXI trigger line 4.
RFMXNR_VAL_PXI_TRIG5_STR (PXI_Trig5)	The trigger is received on PXI trigger line 5.
RFMXNR_VAL_PXI_TRIG6_STR (PXI_Trig6)	The trigger is received on PXI trigger line 6.
RFMXNR_VAL_PXI_TRIG7_STR (PXI_Trig7)	The trigger is received on PXI trigger line 7.
RFMXNR_VAL_PXI_STAR_STR (PXI_STAR)	The trigger is received on the PXI star trigger line.
RFMXNR_VAL_PXIE_DSTARB_STR (PXIe_DStarB)	The trigger is received on the PXIe DStar B trigger line.
RFMXNR_VAL_TIMER_EVENT_STR (TimerEvent)	The trigger is received from the timer event.

RFMXNR_ATTR_DIGITAL_EDGE_TRIGGER_EDGE

Data Type:	int32
Access:	read/write
Functions:	RFmxNR_SetAttributeI32 RFmxNR_GetAttributeI32
Description:	Specifies the active edge for the trigger. This attribute is used only when you set the RFMXNR_ATTR_TRIGGER_TYPE attribute to RFMXNR_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 RFMXNR_VAL_DIGITAL_EDGE_RISING_EDGE. Get Function: RFmxNR_GetDigitalEdgeTriggerEdge Set Function: RFmxNR_SetDigitalEdgeTriggerEdge
Values:

RFMXNR_VAL_DIGITAL_EDGE_RISING_EDGE (0)	The trigger asserts on the rising edge of the signal.
RFMXNR_VAL_DIGITAL_EDGE_FALLING_EDGE (1)	The trigger asserts on the falling edge of the signal.

IQ Power Edge

RFMXNR_ATTR_IQ_POWER_EDGE_TRIGGER_SOURCE

Data Type:	char []
Access:	read/write
Functions:	RFmxNR_SetAttributeString RFmxNR_GetAttributeString
Description:	Specifies the channel from which the device monitors the trigger. 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: RFmxNR_GetIQPowerEdgeTriggerSource Set Function: RFmxNR_SetIQPowerEdgeTriggerSource

RFMXNR_ATTR_IQ_POWER_EDGE_TRIGGER_LEVEL

Data Type:	float64
Access:	read/write
Functions:	RFmxNR_SetAttributeF64 RFmxNR_GetAttributeF64
Description:	Specifies the power level at which the device triggers. This value is expressed in dB when you set the RFMXNR_ATTR_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE attribute to RFMXNR_VAL_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE_RELATIVE; and in dBm when you set the RFMXNR_ATTR_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE attribute to RFMXNR_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 RFMXNR_ATTR_TRIGGER_TYPE attribute to RFMXNR_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 of this attribute is hardware dependent. Get Function: RFmxNR_GetIQPowerEdgeTriggerLevel Set Function: RFmxNR_SetIQPowerEdgeTriggerLevel

RFMXNR_ATTR_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE

Data Type:	int32
Access:	read/write
Functions:	RFmxNR_SetAttributeI32 RFmxNR_GetAttributeI32
Description:	Specifies the reference for the RFMXNR_ATTR_IQ_POWER_EDGE_TRIGGER_LEVEL attribute. The RFMXNR_ATTR_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE attribute is used only when you set the RFMXNR_ATTR_TRIGGER_TYPE attribute to RFMXNR_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 RFMXNR_VAL_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE_RELATIVE. Get Function: RFmxNR_GetIQPowerEdgeTriggerLevelType Set Function: RFmxNR_SetIQPowerEdgeTriggerLevelType
Values:

RFMXNR_VAL_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE_RELATIVE (0)	The IQ Power Edge Level attribute is relative to the value of the RFMXNR_ATTR_REFERENCE_LEVEL attribute.
RFMXNR_VAL_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE_ABSOLUTE (1)	The IQ Power Edge Level attribute specifies the absolute power.

RFMXNR_ATTR_IQ_POWER_EDGE_TRIGGER_SLOPE

Data Type:	int32
Access:	read/write
Functions:	RFmxNR_SetAttributeI32 RFmxNR_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. 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 RFMXNR_VAL_IQ_POWER_EDGE_RISING_SLOPE. Get Function: RFmxNR_GetIQPowerEdgeTriggerSlope Set Function: RFmxNR_SetIQPowerEdgeTriggerSlope
Values:

RFMXNR_VAL_IQ_POWER_EDGE_RISING_SLOPE (0)	The trigger asserts when the signal power is rising.
RFMXNR_VAL_IQ_POWER_EDGE_FALLING_SLOPE (1)	The trigger asserts when the signal power is falling.

RFMXNR_ATTR_TRIGGER_DELAY

Data Type:	float64
Access:	read/write
Functions:	RFmxNR_SetAttributeF64 RFmxNR_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: RFmxNR_GetTriggerDelay Set Function: RFmxNR_SetTriggerDelay

Minimum Quiet Time

RFMXNR_ATTR_TRIGGER_MINIMUM_QUIET_TIME_MODE

Data Type:	int32
Access:	read/write
Functions:	RFmxNR_SetAttributeI32 RFmxNR_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 RFMXNR_VAL_TRIGGER_MINIMUM_QUIET_TIME_MODE_AUTO. Get Function: RFmxNR_GetTriggerMinimumQuietTimeMode Set Function: RFmxNR_SetTriggerMinimumQuietTimeMode
Values:

RFMXNR_VAL_TRIGGER_MINIMUM_QUIET_TIME_MODE_MANUAL (0)	The minimum quiet time for triggering is the value of the RFMXNR_ATTR_TRIGGER_MINIMUM_QUIET_TIME_DURATION attribute.
RFMXNR_VAL_TRIGGER_MINIMUM_QUIET_TIME_MODE_AUTO (1)	The measurement computes the minimum quiet time used for triggering.

RFMXNR_ATTR_TRIGGER_MINIMUM_QUIET_TIME_DURATION

Data Type:	float64
Access:	read/write
Functions:	RFmxNR_SetAttributeF64 RFmxNR_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 RFMXNR_ATTR_IQ_POWER_EDGE_TRIGGER_SLOPE attribute to RFMXNR_VAL_IQ_POWER_EDGE_RISING_SLOPE, the signal is quiet below the trigger level. If you set the RFMXNR_ATTR_IQ_POWER_EDGE_TRIGGER_SLOPE attribute to RFMXNR_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: RFmxNR_GetTriggerMinimumQuietTimeDuration Set Function: RFmxNR_SetTriggerMinimumQuietTimeDuration