IviScope Value Definitions
The following table defines value for each attribute constant in the IviScope class driver.
IviScope Attribute Defined Values
| Attribute | Value Name | Defined Value | Description |
|---|---|---|---|
| VERTICAL_COUPLING | VAL_AC | 0 | The oscilloscope AC couples the input signal. |
| VAL_DC | 1 | The oscilloscope DC couples the trigger signal. | |
| VAL_GND | 2 | The oscilloscope ground couples the input signal. | |
| PROBE_ATTENUATION | VAL_PROBE_SENSE_ON | –1 |
Setting this attribute to IVISCOPE_VAL_PROBE_SENSE_ON configures the oscilloscope to sense the attenuation of the probe automatically. After you enable the automatic probe sense, subsequent queries of this attribute return the value IVISCOPE_VAL_PROBE_SENSE_ON. Use the IVISCOPE_ATTR_PROBE_SENSE_VALUE attribute to obtain the actual probe attenuation. If you set the oscilloscope to sense the probe attenuation automatically, the probe attenuation value can change at any time. When the oscilloscope detects a new probe attenuation value, other settings in the oscilloscope might also change. The driver has no way of knowing when these changes occur. Therefore, when you enable the automatic probe sense capability, the driver disables caching for attributes that depend on the probe attenuation. These attributes include IVISCOPE_ATTR_VERTICAL_RANGE, IVISCOPE_ATTR_VERTICAL_OFFSET, and all the attributes that configure trigger levels. To maximize performance, set this attribute to a manual probe attenuation setting. If the oscilloscope is set to sense the probe attenuation automatically, setting this attribute to a positive value disables the automatic probe sense and configures the oscilloscope to use the manual probe attenuation you specify. |
| TRIGGER_TYPE | VAL_EDGE_TRIGGER | 1 | Configures the oscilloscope for edge triggering. An edge trigger occurs when the trigger signal passes through the voltage threshold specified by the IVISCOPE_ATTR_TRIGGER_LEVEL attribute and has the slope specified by the IVISCOPE_ATTR_TRIGGER_SLOPE attribute. |
| VAL_WIDTH_TRIGGER | 2 | Configures the oscilloscope for width triggering. 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 IVISCOPE_ATTR_WIDTH_HIGH_THRESHOLD and IVISCOPE_ATTR_WIDTH_LOW_THRESHOLD attributes. You specify whether the oscilloscope triggers on pulse widths that are within or outside the width thresholds with the IVISCOPE_ATTR_WIDTH_CONDITION attribute. You specify the polarity of the pulse with the IVISCOPE_ATTR_WIDTH_POLARITY attribute. The trigger does not actually occur until the edge of a pulse that corresponds to the width thresholds, width condition, and polarity you specify crosses the trigger level that you specify with the IVISCOPE_ATTR_TRIGGER_LEVEL attribute. | |
| VAL_RUNT_TRIGGER | 3 | Configures the oscilloscope for runt triggering. 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 IVISCOPE_ATTR_RUNT_HIGH_THRESHOLD and IVISCOPE_ATTR_RUNT_LOW_THRESHOLD attributes. You specify the polarity of the runt with the IVISCOPE_ATTR_RUNT_POLARITY attribute. | |
| VAL_GLITCH_TRIGGER | 4 | Configures the oscilloscope for glitch triggering. A glitch trigger occurs when the trigger signal has a pulse with a width that is less than the glitch width. You specify the glitch width with the IVISCOPE_ATTR_GLITCH_WIDTH attribute. You specify the polarity of the pulse with the IVISCOPE_ATTR_GLITCH_POLARITY attribute. The trigger does not actually occur until the edge of a pulse that corresponds to the glitch width and polarity you specify crosses the trigger level that you specify with the IVISCOPE_ATTR_TRIGGER_LEVEL attribute. | |
| VAL_TV_TRIGGER | 5 | Configures the oscilloscope to trigger on TV signals. You configure the trigger with the IVISCOPE_ATTR_TV_TRIGGER_SIGNAL_FORMAT, IVISCOPE_ATTR_TV_TRIGGER_LINE_NUMBER, and IVISCOPE_ATTR_TV_TRIGGER_POLARITY, attributes. | |
| VAL_IMMEDIATE_TRIGGER | 6 | The oscilloscope does not wait for a trigger of any kind. | |
| VAL_AC_LINE_TRIGGER | 7 | Configures the oscilloscope for AC line triggering. An AC Line trigger occurs when the oscilloscope detects a positive zero crossing, negative zero crossing, or optionally either positive or negative zero crossing of the network supply voltage. | |
| TRIGGER_SLOPE | VAL_POSITIVE | 1 | Configures the oscilloscope to trigger on positive slope zero crossings of the network supply voltage. |
| VAL_NEGATIVE | 0 | Configures the oscilloscope to trigger on negative slope zero crossings of the network supply voltage. | |
| IVISCOPE_VAL_AC_LINE_EITHER | 3 | Configures the oscilloscope to trigger on either positive or negative slope zero crossings of the network supply voltage. | |
| TRIGGER_SOURCE | VAL_EXTERNAL | "VAL_EXTERNAL" | The oscilloscope waits for a trigger on the external trigger input. |
| VAL_TTL0 | "VAL_TTL0" | The oscilloscope waits until it receives a trigger on the TLL0 line. | |
| VAL_TTL1 | "VAL_TTL1" | The oscilloscope waits until it receives a trigger on the TLL1 line. | |
| VAL_TTL2 | "VAL_TTL2" | The oscilloscope waits until it receives a trigger on the TLL2 line. | |
| VAL_TTL3 | "VAL_TTL3" | The oscilloscope waits until it receives a trigger on the TLL3 line. | |
| VAL_TTL4 | "VAL_TTL4" | The oscilloscope waits until it receives a trigger on the TLL4 line. | |
| VAL_TTL5 | "VAL_TTL5" | The oscilloscope waits until it receives a trigger on the TLL5 line. | |
| VAL_TTL6 | "VAL_TTL6" | The oscilloscope waits until it receives a trigger on the TLL6 line. | |
| VAL_TTL7 | "VAL_TTL7" | The oscilloscope waits until it receives a trigger on the TLL7 line. | |
| VAL_ECL0 | "VAL_ECL0" | The oscilloscope waits until it receives a trigger on the ECL0 line. | |
| VAL_ECL1 | "VAL_ECL1" | The oscilloscope waits until it receives a trigger on the ECL1 line. | |
| VAL_PXI_STAR | "VAL_PXI_STAR" | The oscilloscope waits until it receives a trigger on the PXI Star bus. | |
| VAL_RTSI_0 | "VAL_RTSI_0" | The oscilloscope waits until it receives a trigger on the RTSI 0 line. | |
| VAL_RTSI_1 | "VAL_RTSI_1" | The oscilloscope waits until it receives a trigger on the RTSI 1 line. | |
| VAL_RTSI_2 | "VAL_RTSI_2" | The oscilloscope waits until it receives a trigger on the RTSI 2 line. | |
| VAL_RTSI_3 | "VAL_RTSI_3" | The oscilloscope waits until it receives a trigger on the RTSI 3 line. | |
| VAL_RTSI_4 | "VAL_RTSI_4" | The oscilloscope waits until it receives a trigger on the RTSI 4 line. | |
| VAL_RTSI_5 | "VAL_RTSI_5" | The oscilloscope waits until it receives a trigger on the RTSI 5 line. | |
| VAL_RTSI_6 | "VAL_RTSI_6" | The oscilloscope waits until it receives a trigger on the RTSI 6 line. | |
| TRIGGER_COUPLING | VAL_AC | 0 | The oscilloscope AC couples the trigger signal. |
| VAL_DC | 1 | The oscilloscope DC couples the input signal. | |
| VAL_HF_REJECT | 3 | The oscilloscope filters out the low frequencies from the trigger signal. | |
| VAL_LF_REJECT | 4 | The oscilloscope filters out the high frequencies from the trigger signal. | |
| VAL_NOISE_REJECT | 5 | The oscilloscope filters out the noise from the trigger signal. | |
| INTERPOLATION | VAL_NO_INTERPOLATION | 1 | The oscilloscope does not interpolate points in the waveform. Instead, the driver sets every element in the waveform array for which the oscilloscope cannot resolve a value to an IEEE-defined NaN (Not a Number) value. |
| VAL_SINE_X | 2 | The oscilloscope uses a sine(x)/x calculation to interpolate a value when it can not resolve a voltage in the waveform record. | |
| VAL_LINEAR | 3 | The oscilloscope uses a linear approximation to interpolate a value when it can not resolve a voltage in the waveform record. | |
| TV_TRIGGER_SIGNAL_ FORMAT | VAL_NTSC | 1 | Sets the TV trigger signal format to NTSC. |
| VAL_PAL | 2 | Sets the TV trigger signal format to PAL. | |
| VAL_SECAM | 3 | Sets the TV trigger signal format to SECAM. | |
| TV_TRIGGER_EVENT | VAL_TV_EVENT_FIELD1 | 1 | Sets the oscilloscope to trigger on field 1 of the video signal. |
| VAL_TV_EVENT_FIELD2 | 2 | Sets the oscilloscope to trigger on field 2 of the video signal. | |
| VAL_TV_EVENT_ANY_FIELD | 3 | Sets the oscilloscope to trigger on any field. | |
| VAL_TV_EVENT_ANY_LINE | 4 | Sets the oscilloscope to trigger on any line. | |
| VAL_TV_EVENT_ANY_LINE_NUMBER | 5 | Sets the oscilloscope to trigger on a specific line number you specify with the IVISCOPE_ATTR_TV_TRIGGER_LINE_NUMBER attribute. | |
| TV_TRIGGER_ POLARITY | VAL_TV_POSITIVE | 1 | Positive video sync pulse. |
| VAL_TV_NEGATIVE | 2 | Negative video sync pulse. | |
| RUNT_POLARITY | VAL_RUNT_POSITIVE | 1 | The oscilloscope triggers on a positive runt. A positive runt occurs when a rising edge crosses the low runt threshold and does not cross the high runt threshold before re-crossing the low runt threshold. |
| VAL_RUNT_NEGATIVE | 2 | The oscilloscope triggers on a negative runt. A negative runt occurs when a falling edge crosses the high runt threshold and does not cross the low runt threshold before re-crossing the high runt threshold. | |
| VAL_RUNT_EITHER | 3 | The oscilloscope triggers on either a positive or negative runt. | |
| GLITCH_POLARITY | VAL_GLITCH_POSITIVE | 1 | The oscilloscope triggers on a positive glitch. |
| VAL_GLITCH_NEGATIVE | 2 | The oscilloscope triggers on a negative glitch. | |
| VAL_GLITCH_EITHER | 3 | The oscilloscope triggers on either a positive or negative glitch. | |
| GLITCH_CONDITION | VAL_GLITCH_LESS_THAN | 1 | The oscilloscope triggers when the pulse width is less than the value you specify with the IVISCOPE_ATTR_GLITCH_WIDTH attribute. |
| VAL_GLITCH_GREATER_THAN | 2 | The oscilloscope triggers when the pulse width is greater than the value you specify with the IVISCOPE_ATTR_GLITCH_WIDTH attribute. | |
| WIDTH_POLARITY | VAL_WIDTH_POSITIVE | 1 | Configures the oscilloscope to trigger on positive pulses that have a width that meets the condition you specify with the IVISCOPE_ATTR_WIDTH_CONDITION attribute. |
| VAL_WIDTH_NEGATIVE | 2 | Configures the oscilloscope to trigger on negative pulses that have a width that meets the condition you specify with the IVISCOPE_ATTR_WIDTH_CONDITION attribute. | |
| WIDTH_CONDITION | VAL_WIDTH_WITHIN | 1 | Configures the oscilloscope to trigger on pulses that have a width that is less than the high threshold and greater than the low threshold. You specify the high and low thresholds with the IVISCOPE_ATTR_WIDTH_HIGH_THRESHOLD and IVISCOPE_ATTR_WIDTH_LOW_THRESHOLD attributes. |
| VAL_WIDTH_OUTSIDE | 2 | Configures the oscilloscope to trigger on pulses that have a width that is either greater than the high threshold or less than a low threshold. You specify the high and low thresholds with the IVISCOPE_ATTR_WIDTH_HIGH_THRESHOLD and IVISCOPE_ATTR_WIDTH_LOW_THRESHOLD attributes. | |
| ACQUISITION_TYPE | VAL_NORMAL | 0 | Configures the oscilloscope to acquire one sample for each point in the waveform record. The oscilloscope uses real-time or equivalent-time sampling. |
| VAL_PEAK_DETECT | 1 | Sets the oscilloscope to the peak-detect acquisition mode. The oscilloscope oversamples the input signal and keeps the minimum and maximum values that correspond to each position in the waveform record. The oscilloscope uses only real-time sampling. | |
| VAL_HI_RES | 2 | Configures the oscilloscope to oversample the input signal. The oscilloscope calculates the average value that corresponds to each position in the waveform record. The oscilloscope uses only real-time sampling. | |
| VAL_ENVELOPE | 3 | Sets the oscilloscope to the envelope acquisition mode. The oscilloscope acquires multiple waveforms and keeps the minimum and maximum voltages it acquires for each point in the waveform record. You specify the number of waveforms the oscilloscope acquires with the IVISCOPE_ATTR_NUM_ENVELOPES attribute. The oscilloscope can use real-time or equivalent-time sampling. | |
| VAL_AVERAGE | 4 | Configures the oscilloscope to acquire multiple waveforms and calculate the average value for each point in the waveform record. You specify the number of waveforms to acquire with the IVISCOPE_ATTR_NUM_AVERAGES attribute. The oscilloscope uses real-time or equivalent-time sampling. | |
| TRIGGER_MODIFIER | VAL_NO_TRIGGER_MOD | 1 | The oscilloscope waits until the trigger you specify occurs. |
| VAL_AUTO | 2 | The oscilloscope automatically triggers if the configured trigger does not occur within the oscilloscope's timeout period. | |
| VAL_AUTO_LEVEL | 3 | The oscilloscope adjusts the trigger level if the trigger you specify does not occur within the oscilloscope's timeout period. | |
| SAMPLE_MODE | VAL_REAL_TIME | 0 | Indicates that the oscilloscope is using real-time sampling. |
| VAL_EQUIVALENT_TIME | 1 | Indicates that the oscilloscope is using equivalent-time sampling. |
Parameter Defined Values
| Parameter | Defined Value | Description |
|---|---|---|
| status | IVISCOPE_VAL_ACQ_COMPLETE | |
| IVISCOPE_VAL_ACQ_IN_PROGRESS | ||
| IVISCOPE_VAL_ACQ_STATUS_UNKNOWN | ||
| measFunction | IVISCOPE_VAL_RISE_TIME | |
| IVISCOPE_VAL_FALL_TIME | ||
| IVISCOPE_VAL_FREQUENCY | ||
| IVISCOPE_VAL_PERIOD | ||
| IVISCOPE_VAL_VOLTAGE_RMS | ||
| IVISCOPE_VAL_VOLTAGE_PEAK_TO_PEAK | ||
| IVISCOPE_VAL_VOLTAGE_MAX | ||
| IVISCOPE_VAL_VOLTAGE_MIN | ||
| IVISCOPE_VAL_VOLTAGE_HIGH | ||
| IVISCOPE_VAL_VOLTAGE_LOW | ||
| IVISCOPE_VAL_VOLTAGE_AVERAGE | ||
| IVISCOPE_VAL_WIDTH_NEG | ||
| IVISCOPE_VAL_WIDTH_POS | ||
| IVISCOPE_VAL_DUTY_CYCLE_NEG | ||
| IVISCOPE_VAL_DUTY_CYCLE_POS | ||
| IVISCOPE_VAL_AMPLITUDE | ||
| IVISCOPE_VAL_VOLTAGE_CYCLE_RMS | ||
| IVISCOPE_VAL_VOLTAGE_CYCLE_AVERAGE | ||
| IVISCOPE_VAL_OVERSHOOT | ||
| IVISCOPE_VAL_PRESHOOT | ||
| maxTime | IVISCOPE_VAL_MAX_TIME_IMMEDIATE | |
| IVISCOPE_VAL_MAX_TIME_INFINITE |