Admin Production ni-theme
Current Publication

Configure Edge Trigger Source

IVI Compliance Package

IviScope Configure Edge Trigger Source

IviScope Base Capability Group

This VI configures the edge trigger. An edge trigger occurs when the trigger signal passes through the voltage threshold that you specify with the Trigger Level parameter and has the slope that you specify with the Trigger Slope parameter.

Notes
  1. This VI affects instrument behavior only if the trigger type is IVISCOPE_VAL_EDGE_TRIGGER. Call the IviScope Configure Trigger and IviScope Configure Trigger Coupling VIs to set the trigger type and trigger coupling before calling this VI.
  2. If the trigger source is one of the analog input channels, you must configure the vertical range, vertical offset, vertical coupling, probe attenuation, and the maximum input frequency before calling this VI.
instrument handle The instrument handle that you obtain from the IviScope Initialize or the IviScope Initialize With Options VI.
trigger source Pass the source you want the oscilloscope to monitor for a trigger. The driver sets the IviScope Trigger Source property to this value.

After you call one of the IviScope Read Waveform, IviScope Read Min Max Waveform [MmW], IviScope Read Waveform Measurement [WM], or IviScope Initiate Acquisition VIs, the oscilloscope waits for the trigger from the source you specify in this parameter.

This control accepts one of the valid channel names or additional trigger sources listed below.

Virtual channel names are aliases for instrument specific channel strings. The instrument specific channel strings can differ from one instrument to another. Virtual channel names allow you to use and swap instruments without having to change the channel names in your source code. You assign a virtual channel name to an instrument specific channel through MAX. This control accepts virtual channel names you have assigned to the specific instrument you are using. It also accepts the instrument specific channel names.

Additional Trigger Sources

IVISCOPE_VAL_EXTERNAL—External

IVISCOPE_VAL_TTL0—PXI TRIG0 or VXI TTL0

IVISCOPE_VAL_TTL1—PXI TRIG1 or VXI TTL1

IVISCOPE_VAL_TTL2—PXI TRIG2 or VXI TTL2

IVISCOPE_VAL_TTL3—PXI TRIG3 or VXI TTL3

IVISCOPE_VAL_TTL4—PXI TRIG4 or VXI TTL4

IVISCOPE_VAL_TTL5—PXI TRIG5 or VXI TTL5

IVISCOPE_VAL_TTL6—PXI TRIG6 or VXI TTL6

IVISCOPE_VAL_TTL7—PXI TRIG7 or VXI TTL7

IVISCOPE_VAL_ECL0—VXI ECL0

IVISCOPE_VAL_ECL1—VXI ECL1

IVISCOPE_VAL_PXI_STAR—PXI Star

IVISCOPE_VAL_RTSI_0—RTSI line 0

IVISCOPE_VAL_RTSI_1—RTSI line 1

IVISCOPE_VAL_RTSI_2—RTSI line 2

IVISCOPE_VAL_RTSI_3—RTSI line 3

IVISCOPE_VAL_RTSI_4—RTSI line 4

IVISCOPE_VAL_RTSI_5—RTSI line 5

IVISCOPE_VAL_RTSI_6—RTSI line 6

Note  IVISCOPE_VAL_EXTERNAL—The oscilloscope waits for a trigger on the external trigger input.
trigger level (volts) Pass the voltage threshold you want the oscilloscope to use for edge triggering. The driver sets the IviScope Trigger Level property to this value.

The oscilloscope triggers when the trigger signal passes through the threshold you specify with this parameter and has the slope you specify with the Trigger Slope parameter.

Units: volts

Default value: 0.0

Note  This parameter affects instrument behavior only when you select a channel or the external trigger input as the Trigger Source. You cannot configure the trigger level that the oscilloscope uses for other trigger sources. For example, if you select IVISCOPE_VAL_AC_LINE_TRIGGER as the trigger source, the oscilloscope triggers on zero crossings.
trigger slope Specify whether you want a rising edge or a falling edge passing through the Trigger Level to trigger the oscilloscope. The driver sets the IviScope Trigger Slope property to this value.

Defined Values:

IVISCOPE_VAL_POSITIVE—Rising edge

IVISCOPE_VAL_NEGATIVE—Falling edge

Default value: IVISCOPE_VAL_POSITIVE

error in (no error) The error in cluster can accept error information wired from VIs previously called. Use this information to decide if any functionality should be bypassed in the event of errors from other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

instrument handle out The instrument handle that you obtain from the IviScope Initialize or the IviScope Initialize With Options VI.
error out The error out cluster passes error or warning information out of a VI to be used by other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.