|Download Help (Windows Only)|
The following behavior diagram illustrates the IviDigitizerBase group capability behavior.
Typically you configure the digitizer while it is in the Idle state. You can configure the digitizer by calling the high-level configure channel, configure acquisition type, configure acquisition record, configure trigger, and configure edge trigger source functions or by directly calling the appropriate channel, acquisition, and trigger sub-system attributes.
To acquire waveforms, the IviDigitizer class includes high-level read waveform functions, as well as the low-level functions to initiate acquisition, acquire status, fetch waveforms, and abort.
The Read Waveform functions initiate a waveform acquisition and return the acquired waveform after the digitizer has returned to the Idle state.
You can use IviDigitizer_InitiateAcquisition, IviDigitizer_Abort, and the Fetch Waveform functions for lower-level control over the measurement process. The IviDigitizer_InitiateAcquisition function initiates a waveform acquisition and moves the instrument into the Wait-For-Trigger state. Configure the trigger type with the trigger sub-system attributes or with the IviDigitizer_ConfigureEdgeTriggerSource function.
The IviDigitizer class provides multiple versions of the Read and Fetch functions to accommodate digitizers of various native data sizes for each waveform sample. For example, you can retrieve waveforms as arrays of 8-bit, 16-bit, and 32-bit integers as well as 32-bit and 64-bit floating-point numbers.
If the trigger delay is negative, the first point in the waveform record occurs prior to the trigger event. When the trigger event occurs, the waveform record contains the amount of pre-trigger data that corresponds to the trigger delay. The digitizer leaves the Wait-for-Trigger state and acquires the remaining points in the waveform record.
If the trigger delay equals zero, the first point in the waveform record occurs at the time of the trigger event. When the trigger event occurs, the digitizer leaves the Wait-for-Trigger state and acquires all the points in the waveform record.
If the acquisition start time is greater than zero, the first point in the waveform record occurs after the trigger event. When the trigger event occurs, the digitizer leaves the Wait-for-Trigger state, waits a length of time that is equal to the trigger delay, and acquires all the points in the waveform record.
If the digitizer has acquired the requested number of records, it returns to the Idle state. However, if the digitizer must acquire additional records to satisfy the specified Num Records requirement, it then moves to the Wait-For-Samples state. The digitizer then waits until the hold-off time expires before moving to the Wait-For-Trigger state.
Note that the hold-off time is measured from the moment the digitizer exits the Wait-for-Trigger state, not from the moment when the digitizer enters the Wait-for-Samples state.
After the instrument meets its acquisition complete criterion, the digitizer returns to the Idle state. This criterion is typically 95-98% of the acquisition record; there may be instrument specific attributes that allow you to configure the completion criterion. You can use the Acquisition Status function to determine if the acquisition is complete or is still in progress.
Use the Fetch Waveform functions to return a waveform from a previously initiated measurement. The Read Waveform and Fetch Waveform functions return the following parameters: