Memread.vi – Measurement Computing UL for NI LabVIEW User Manual

Page 90

Advertising
background image

Universal Library Virtual Instruments (VIs)

Memory board VIs

MemRead.VI

Reads data from a memory board into an array.

Summary:

Inputs:

BoardNum

[U32] - The board number assigned when installed with InstaCal. Can

be 0 to 100.

FirstPoint

[I32] - Index of first point to read or

FROMHERE

.

Count

[U32] - Number of samples (words) to read

Outputs:

DataBuffer

[U16] - Output data array.

ErrCode

[I32] - Error code. See ErrMsg.VI.

Arguments:

BoardNum

The memory board number associated with a board when it was installed with

InstaCal.

FirstPoint

Use

the

FirstPoint

argument to specify the first point to be read. For example, to

read points #200 - #250, set

FirstPoint

=200 and

Count

=50.

To read a large amount of data from the board in small portions, set

FirstPoint

to

FROMHERE

(-1) to read each successive portion. Using

FROMHERE

(-1) speeds up the

operation of MemRead VI when working with large amounts of data.

Count

Number of samples (words) to read.

DataBuffer

Data read from memory board.

ErrCode

Error code returned from the Universal Library. Zero if no error occurred. Use the

ErrMsg VI to convert

ErrCode

into a readable string.

Notes:

DT-Connect conflicts - The MemRead.VI can not be called while a DT-CONNECT transfer is in progress.
For example, if you start collecting A/D data to the memory board in the background (by calling AInScBg.VI
or AInScFg.VI with the

DTCONNECT

+

BACKGROUND

options). You cannot call MemRead.VI until the

AInScBg.VI or AInScFg.VI has completed. If you do, you will get a

DTACTIVE

error.

90

Advertising