Measurement Computing WBK30 - Manual (Page 3)

p/n 1025-0901 rev 2.0 (per EO# 2116R3) WBK30 User's Guide 3
Software Setup
Reference Note: Chapter 5 of the WaveBook User's Manual explains WaveView in greater detail.
Chapters 14 and 15 explain programming with the enhanced API.
WaveView
The WBK30 is supported by WaveView version 7.2 and higher. Check-boxes in the System-Options menu
allow you to enable or disable the Pre-Trigger and/or Overflow Protection modes. Both modes will be
enabled by default when WaveView first detects the presence of the WBK30.
• Enable WBK30 Pre-Trigger Mode — causes WaveView to use the Pre-Trigger Mode for high-speed
pre-trigger acquisitions. Acquisitions unable to use the Pre-Trigger Mode will run normally whether
this setting is enabled or not. When using the WBK30 pre-trigger mode, the actual number of pre-
trigger scans acquired may be up to 3 scans less than the pre-trigger scan count programmed in the
acquisition configuration dialog.
• Enable Overflow Protection Mode — causes WaveView to use the Overflow Protection for all
acquisitions. Data is preserved if you cancel a transfer by selecting the STOP button in either the
Scope or Direct-to-Disk window. Disable this mode if data from a stopped acquisition is unwanted.
DaqX Programming of the WBK30
Only the enhanced API (DaqX versions 2.4 and higher) supports the WBK30. The standard API
(with wbk... commands) cannot address the WBK30. Commands affecting the WBK30 include:
daqAdcTransferSetBuffer
sets information to initialize a data transfer. One argument is a bit mask of
transfer-mode codes.
• DatmPacingMode – Setting this bit in the transferMask argument enables Pacing Mode. In this
mode, the caller paces the acquisition by proving a pacing count via daqAdcTransferGetStat.
daqAdcTransferGetStat
returns a count of scans transferred and a bit-mask of status bits for the current
acquisition. These arguments can also send information to DaqX when using a Pacing Mode transfer.
• DaafAcqArmed – TRUE means the device is armed—data is either being sampled and sent to the
buffer at the present time or will be when the trigger occurs. Data transfer may or may not be active.
• DaafDataPresent - TRUE means there is some data in the buffer. The device may or may not be
armed; data transfer may or may not be active.
daqGetInfo
can query WaveBook configuration options.
• DdiExtFeatures - Returns a mask of feature bits including features of the WBK30.
DhefFifoOverflowMode
Buffer has Overflow Protection mode.
DhefFifoCycleMode
Buffer has Cycle (Pre-Trigger) Mode.
DhefFifoScanCount
Buffer has readable, current data count.
• DdiFifoScanCount - Returns the count of scans currently in the WBK30. The
DhefFifoScanCount
bit of the DdiExtFeatures value will be set for supported hardware.
daqSetOption
can set WaveBook configuration options.
• DbotFifoOverflowMode – Enables the WBK30’s overflow protection.
• DbotFifoCycleMode – Enables the WBK30’s Pre-Trigger Mode.
• DbotFifoCycleSize – Sets the size of the WBK30’s circular buffer when in Pre-Trigger Mode.
The size is specified as the number of 16-bit words in the buffer.
• DbotFifoFlush – Tells the driver to immediately flush all data in the FIFO. This option is
enabled for WaveBooks with or without a WBK30.
• DbotFifoNoFlushOnDisarm – Disables flushing of data in the FIFO. This allows manually
stopping the current acquisition without losing data that is acquired but not yet transferred to the host
computer.
daqTest
can perform self-tests on the hardware.
• DtstFifoAddrDataBusValid – Performs a bus-address test on the WBK30.
• DtstFifoMemCellValid – Performs a memory test on the WBK30.
Transfer pacing can prevent the mouse from "freezing" during a Pre-Trigger Mode data transfer and help
eliminate the Buffer-Overrun error. To help manage data transfer from the WaveBook, an application can