Admin Production ni-theme
Current Publication

Configure Runt Trigger Source

IVI Compliance Package

IviScope Configure Runt Trigger Source

IviScopeRuntTrigger Capability Group [RT]

This VI configures the runt trigger. A runt trigger occurs when the trigger signal crosses one of the runt thresholds twice without crossing the other runt threshold. You specify the runt thresholds with the Runt Low Threshold and Runt High Threshold parameters. You specify the polarity of the runt with the Runt Polarity parameter.

Note  This VI affects instrument behavior only if the trigger type is IVISCOPE_VAL_RUNT_TRIGGER. Call the IviScope Configure Trigger and IviScope Configure Trigger Coupling VIs to set the trigger type and trigger coupling 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 in 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_ECL—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.
runt low threshold (volts) Pass the low threshold you want the oscilloscope to use for runt triggering. The driver sets the IviScope Runt Low Threshold [RT] property to this value.

Units: volts

Default Value: 1.0

runt high threshold (volts) Pass the high threshold you want the oscilloscope to use for runt triggering. The driver sets the IviScope Runt High Threshold [RT] property to this value.

Units: volts

Default Value: 4.0

runt polarity Pass the polarity of the runt that you want to trigger the oscilloscope. The driver sets the IviScope Runt Polarity [RT] property to this value.

Defined Values:

  • IVISCOPE_VAL_RUNT_POSITIVE—The oscilloscope triggers on a positive runt. A positive runt occurs when a rising edge crosses the Runt Low Threshold and does not cross the Runt High Threshold before re-crossing the Low Runt Threshold.
  • IVISCOPE_VAL_RUNT_NEGATIVE—The oscilloscope triggers on a negative runt. A negative runt occurs when a falling edge crosses the Runt High Threshold and does not cross the Runt Low Threshold before re-crossing the High Runt Threshold.
  • IVISCOPE_VAL_RUNT_EITHER—The oscilloscope triggers on either a positive or negative runt.

Default Value: IVISCOPE_VAL_RUNT_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.