Skip to content

NI RFmx SpecAn Trigger Attributes

Alex Starche edited this page Feb 28, 2022 · 4 revisions

Trigger Attributes

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

Table of Contents

Internal Development

Creating and Setting Up a gRPC Server

Server Security Support

Creating a gRPC Client

gRPC Client Examples

Session Utilities API Reference

Driver Documentation

gRPC API Differences From C API

Sharing Driver Sessions Between Clients

C API Docs
NI-DAQmx
NI-DCPOWER
NI-DIGITAL PATTERN DRIVER
NI-DMM
NI-FGEN
NI-FPGA
NI-RFmx Bluetooth
NI-RFmx NR
NI-RFmx WCDMA
NI-RFmx GSM
NI-RFmx CDMA2k
NI-RFmx Instr
NI-RFmx LTE
NI-RFmx SpecAn
NI-RFmx TD-SCDMA
NI-RFmx WLAN
NI-RFSA
NI-RFSG
NI-SCOPE
NI-SWITCH
NI-TCLK
NI-XNET
Clone this wiki locally