IviScope Configure Width Trigger Source
IviScopeWidthTrigger Capability Group [WT]
This VI configures the width trigger. A width trigger occurs when the oscilloscope detects a positive or negative pulse with a width between, or optionally outside, the width thresholds. You specify the width thresholds with the Width Low Threshold and Width High Threshold parameters. You specify whether the oscilloscope triggers on pulse widths that are within or outside the width thresholds with the Width Condition parameter. You specify the polarity of the pulse with the Width Polarity parameter. The trigger does not actually occur until the edge of a pulse that corresponds to the Width Low Threshold, Width High Threshold, Width Condition, and Width Polarity crosses the threshold you specify in the Trigger Level parameter.
 |
Note This VI affects instrument behavior only if the trigger type is IVISCOPE_VAL_WIDTH_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 in Additional Trigger Sources. 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 SourcesIVISCOPE_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 width triggering. The driver sets the IviScope Trigger Level property to this value.
The oscilloscope triggers when the edge of a pulse that corresponds to the Width Low Threshold, Width High Threshold, Width Condition, and Width Polarity crosses the threshold you specify in this parameter. Units: volts Default value: 0.0 |
|
Note This parameter only affects instrument behavior 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. |
|
width low threshold (seconds) Pass the low width threshold time. The driver sets the IviScope Width Low Threshold [WT] to this value.
Units: seconds |
|
width high threshold (seconds) Pass the high width threshold time. The driver sets the IviScope Width High Threshold [WT] to this value.
Units: seconds |
 |
width polarity Pass the polarity of the pulse that you want to trigger the oscilloscope. The driver sets the IviScope Width Polarity [WT] property to this value.
Defined Values: IVISCOPE_VAL_WIDTH_POSITIVE—The oscilloscope triggers on a positive pulse. IVISCOPE_VAL_WIDTH_NEGATIVE—The oscilloscope triggers on a negative pulse. Default value: IVISCOPE_VAL_WIDTH_POSITIVE |
|
width condition Pass whether you want a pulse that is within or outside the Width High Threshold and Width Low Threshold to trigger the oscilloscope.
Defined Values: IVISCOPE_VAL_WIDTH_WITHIN—The oscilloscope triggers on pulses that have a width that is less than the Width High Threshold and greater than the Width Low Threshold. IVISCOPE_VAL_WIDTH_OUTSIDE—The oscilloscope triggers on pulses that have a width that is either greater than the Width High Threshold or less than a Width Low Threshold. Default Value: IVISCOPE_VAL_WIDTH_WITHIN |
 |
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. |