NI RFmx WLAN Trigger Attributes

Trigger Attributes

• RFMXWLAN_ATTR_TRIGGER_TYPE
• Digital Edge
  • RFMXWLAN_ATTR_DIGITAL_EDGE_TRIGGER_SOURCE
  • RFMXWLAN_ATTR_DIGITAL_EDGE_TRIGGER_EDGE
• IQ Power Edge
  • RFMXWLAN_ATTR_IQ_POWER_EDGE_TRIGGER_SOURCE
  • RFMXWLAN_ATTR_IQ_POWER_EDGE_TRIGGER_LEVEL
  • RFMXWLAN_ATTR_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE
  • RFMXWLAN_ATTR_IQ_POWER_EDGE_TRIGGER_SLOPE
• RFMXWLAN_ATTR_TRIGGER_DELAY
• Minimum Quiet Time
  • RFMXWLAN_ATTR_TRIGGER_MINIMUM_QUIET_TIME_MODE
  • RFMXWLAN_ATTR_TRIGGER_MINIMUM_QUIET_TIME_DURATION
• Gating
  • RFMXWLAN_ATTR_TRIGGER_GATE_ENABLED
  • RFMXWLAN_ATTR_TRIGGER_GATE_LENGTH

RFMXWLAN_ATTR_TRIGGER_TYPE

Data Type:	int32
Access:	read/write
Functions:	RFmxWLAN_SetAttributeI32 RFmxWLAN_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 RFMXWLAN_VAL_TRIGGER_TYPE_IQ_POWER_EDGE. Get Function: RFmxWLAN_GetTriggerType Set Function: RFmxWLAN_SetTriggerType
Values:

RFMXWLAN_VAL_TRIGGER_TYPE_NONE (0)	No reference trigger is configured.
RFMXWLAN_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 RFMXWLAN_ATTR_DIGITAL_EDGE_TRIGGER_SOURCE attribute.
RFMXWLAN_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 RFMXWLAN_ATTR_IQ_POWER_EDGE_TRIGGER_SLOPE attribute.
RFMXWLAN_VAL_TRIGGER_TYPE_SOFTWARE (3)	The reference trigger is not asserted until a software trigger occurs.

| :- | :- |

Digital Edge

RFMXWLAN_ATTR_DIGITAL_EDGE_TRIGGER_SOURCE

Data Type:	char []
Access:	read/write
Functions:	RFmxWLAN_SetAttributeString RFmxWLAN_GetAttributeString
Description:	Specifies the source terminal for the digital edge trigger. This attribute is used only when you set the RFMXWLAN_ATTR_TRIGGER_TYPE attribute to RFMXWLAN_VAL_TRIGGER_TYPE_DIGITAL_EDGE. On a MIMO session, this attribute configures the digital edge trigger on the master port. By default, the RFMXWLAN_ATTR_SELECTED_PORTS attribute is configured to 'segment0/chain0' and is considered as the master port. 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: RFmxWLAN_GetDigitalEdgeTriggerSource Set Function: RFmxWLAN_SetDigitalEdgeTriggerSource
Values:

RFMXWLAN_VAL_PFI0_STR (PFI0)	The trigger is received on PFI 0.
RFMXWLAN_VAL_PFI1_STR (PFI1)	The trigger is received on PFI 1.
RFMXWLAN_VAL_PXI_TRIG0_STR (PXI_Trig0)	The trigger is received on PXI trigger line 0.
RFMXWLAN_VAL_PXI_TRIG1_STR (PXI_Trig1)	The trigger is received on PXI trigger line 1.
RFMXWLAN_VAL_PXI_TRIG2_STR (PXI_Trig2)	The trigger is received on PXI trigger line 2.
RFMXWLAN_VAL_PXI_TRIG3_STR (PXI_Trig3)	The trigger is received on PXI trigger line 3.
RFMXWLAN_VAL_PXI_TRIG4_STR (PXI_Trig4)	The trigger is received on PXI trigger line 4.
RFMXWLAN_VAL_PXI_TRIG5_STR (PXI_Trig5)	The trigger is received on PXI trigger line 5.
RFMXWLAN_VAL_PXI_TRIG6_STR (PXI_Trig6)	The trigger is received on PXI trigger line 6.
RFMXWLAN_VAL_PXI_TRIG7_STR (PXI_Trig7)	The trigger is received on PXI trigger line 7.
RFMXWLAN_VAL_PXI_STAR_STR (PXI_STAR)	The trigger is received on the PXI star trigger line.
RFMXWLAN_VAL_PXIE_DSTARB_STR (PXIe_DStarB)	The trigger is received on the PXIe DStar B trigger line.
RFMXWLAN_VAL_TIMER_EVENT_STR (TimerEvent)	The trigger is received from the timer event.

| :- | :- |

RFMXWLAN_ATTR_DIGITAL_EDGE_TRIGGER_EDGE

Data Type:	int32
Access:	read/write
Functions:	RFmxWLAN_SetAttributeI32 RFmxWLAN_GetAttributeI32
Description:	Specifies the active edge for the trigger. This attribute is used only when you set the RFMXWLAN_ATTR_TRIGGER_TYPE attribute to RFMXWLAN_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 RFMXWLAN_VAL_DIGITAL_EDGE_RISING_EDGE. Get Function: RFmxWLAN_GetDigitalEdgeTriggerEdge Set Function: RFmxWLAN_SetDigitalEdgeTriggerEdge
Values:

RFMXWLAN_VAL_DIGITAL_EDGE_RISING_EDGE (0)	The trigger asserts on the rising edge of the signal.
RFMXWLAN_VAL_DIGITAL_EDGE_FALLING_EDGE (1)	The trigger asserts on the falling edge of the signal.

| :- | :- |

IQ Power Edge

RFMXWLAN_ATTR_IQ_POWER_EDGE_TRIGGER_SOURCE

Data Type:	char []
Access:	read/write
Functions:	RFmxWLAN_SetAttributeString RFmxWLAN_GetAttributeString
Description:	Specifies the channel from which the device monitors the trigger. This attribute is used only when you set the RFMXWLAN_ATTR_TRIGGER_TYPE attribute to RFMXWLAN_VAL_TRIGGER_TYPE_IQ_POWER_EDGE. On a MIMO session, this attribute configures the IQ Power edge trigger on the master port. By default, the RFMXWLAN_ATTR_SELECTED_PORTS attribute is configured to 'segment0/chain0' and is considered as the master port. 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: RFmxWLAN_GetIQPowerEdgeTriggerSource Set Function: RFmxWLAN_SetIQPowerEdgeTriggerSource

RFMXWLAN_ATTR_IQ_POWER_EDGE_TRIGGER_LEVEL

Data Type:	float64
Access:	read/write
Functions:	RFmxWLAN_SetAttributeF64 RFmxWLAN_GetAttributeF64
Description:	Specifies the power level at which the device triggers. This value is expressed in dB when you set the RFMXWLAN_ATTR_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE attribute to RFMXWLAN_VAL_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE_RELATIVE and in dBm when you set the RFMXWLAN_ATTR_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE attribute to RFMXWLAN_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 RFMXWLAN_ATTR_TRIGGER_TYPE attribute to RFMXWLAN_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: RFmxWLAN_GetIQPowerEdgeTriggerLevel Set Function: RFmxWLAN_SetIQPowerEdgeTriggerLevel

RFMXWLAN_ATTR_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE

Data Type:	int32
Access:	read/write
Functions:	RFmxWLAN_SetAttributeI32 RFmxWLAN_GetAttributeI32
Description:	Specifies the reference for the RFMXWLAN_ATTR_IQ_POWER_EDGE_TRIGGER_LEVEL attribute. The RFMXWLAN_ATTR_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE attribute is used only when you set the RFMXWLAN_ATTR_TRIGGER_TYPE attribute to RFMXWLAN_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 RFMXWLAN_VAL_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE_RELATIVE. Get Function: RFmxWLAN_GetIQPowerEdgeTriggerLevelType Set Function: RFmxWLAN_SetIQPowerEdgeTriggerLevelType
Values:

RFMXWLAN_VAL_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE_RELATIVE (0)	The IQ Power Edge Level attribute is relative to the value of the RFMXWLAN_ATTR_REFERENCE_LEVEL attribute.
RFMXWLAN_VAL_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE_ABSOLUTE (1)	The IQ Power Edge Level attribute specifies the absolute power.

| :- | :- |

RFMXWLAN_ATTR_IQ_POWER_EDGE_TRIGGER_SLOPE

Data Type:	int32
Access:	read/write
Functions:	RFmxWLAN_SetAttributeI32 RFmxWLAN_GetAttributeI32
Description:	Specifies whether the device asserts the trigger when the signal power is rising or 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 RFMXWLAN_ATTR_TRIGGER_TYPE attribute to RFMXWLAN_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 RFMXWLAN_VAL_IQ_POWER_EDGE_RISING_SLOPE. Get Function: RFmxWLAN_GetIQPowerEdgeTriggerSlope Set Function: RFmxWLAN_SetIQPowerEdgeTriggerSlope
Values:

RFMXWLAN_VAL_IQ_POWER_EDGE_RISING_SLOPE (0)	The trigger asserts when the signal power is rising.
RFMXWLAN_VAL_IQ_POWER_EDGE_FALLING_SLOPE (1)	The trigger asserts when the signal power is falling.

| :- | :- |

RFMXWLAN_ATTR_TRIGGER_DELAY

Data Type:	float64
Access:	read/write
Functions:	RFmxWLAN_SetAttributeF64 RFmxWLAN_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 RFmxWLAN measurement dependent. Get Function: RFmxWLAN_GetTriggerDelay Set Function: RFmxWLAN_SetTriggerDelay

Minimum Quiet Time

RFMXWLAN_ATTR_TRIGGER_MINIMUM_QUIET_TIME_MODE

Data Type:	int32
Access:	read/write
Functions:	RFmxWLAN_SetAttributeI32 RFmxWLAN_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 RFMXWLAN_VAL_TRIGGER_MINIMUM_QUIET_TIME_MODE_AUTO. Get Function: RFmxWLAN_GetTriggerMinimumQuietTimeMode Set Function: RFmxWLAN_SetTriggerMinimumQuietTimeMode
Values:

RFMXWLAN_VAL_TRIGGER_MINIMUM_QUIET_TIME_MODE_MANUAL (0)	The minimum quiet time for triggering is the value of the Trigger Min Quiet Time Duration attribute.
RFMXWLAN_VAL_TRIGGER_MINIMUM_QUIET_TIME_MODE_AUTO (1)	The measurement computes the minimum quiet time used for triggering.

| :- | :- |

RFMXWLAN_ATTR_TRIGGER_MINIMUM_QUIET_TIME_DURATION

Data Type:	float64
Access:	read/write
Functions:	RFmxWLAN_SetAttributeF64 RFmxWLAN_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 RFMXWLAN_ATTR_IQ_POWER_EDGE_TRIGGER_SLOPE attribute to RFMXWLAN_VAL_IQ_POWER_EDGE_RISING_SLOPE, the signal is quiet below the trigger level. If you set the RFMXWLAN_ATTR_IQ_POWER_EDGE_TRIGGER_SLOPE attribute to RFMXWLAN_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: RFmxWLAN_GetTriggerMinimumQuietTimeDuration Set Function: RFmxWLAN_SetTriggerMinimumQuietTimeDuration

Gating

RFMXWLAN_ATTR_TRIGGER_GATE_ENABLED

Data Type:	int32
Access:	read/write
Functions:	RFmxWLAN_SetAttributeI32 RFmxWLAN_GetAttributeI32
Description:	Enables time-domain gating of the acquired signal for SEM measurement. If you set this attribute to True and the required measurement interval exceeds the value you set for the RFMXWLAN_ATTR_TRIGGER_GATE_LENGTH attribute, then the measurement restricts the acquisition duration of each record to RFMXWLAN_ATTR_TRIGGER_GATE_LENGTH attribute and acquires as many additional records as necessary for the required measurement interval. If you want to ignore the idle duration between multiple PPDUs during an SEM measurement, you must set RFMXWLAN_ATTR_TRIGGER_GATE_ENABLED to True and set RFMXWLAN_ATTR_TRIGGER_GATE_LENGTH to a value less than or equal to the length of the PPDU under analysis. This value is expressed in seconds. 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 RFMXWLAN_VAL_TRIGGER_GATE_ENABLED_FALSE. Get Function: RFmxWLAN_GetTriggerGateEnabled Set Function: RFmxWLAN_SetTriggerGateEnabled
Values:

RFMXWLAN_VAL_TRIGGER_GATE_ENABLED_FALSE (0)	Gate for SEM measurements is disabled.
RFMXWLAN_VAL_TRIGGER_GATE_ENABLED_TRUE (1)	Gate for SEM measurements is enabled.

| :- | :- |

RFMXWLAN_ATTR_TRIGGER_GATE_LENGTH

Data Type:	float64
Access:	read/write
Functions:	RFmxWLAN_SetAttributeF64 RFmxWLAN_GetAttributeF64
Description:	Specifies the maximum duration of time for each record used for computing the spectrum when you are performing an SEM measurement and when you set the RFMXWLAN_ATTR_TRIGGER_GATE_ENABLED attribute to RFMXWLAN_VAL_TRIGGER_GATE_ENABLED_TRUE. If the measurement interval required to perform the measurement exceeds the gate length, the measurement acquires as many additional records as necessary to honor the required measurement interval. This value is expressed in seconds. 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 1 millisecond. Get Function: RFmxWLAN_GetTriggerGateLength Set Function: RFmxWLAN_SetTriggerGateLength