beautypg.com

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

Page 78

background image

Universal Library Virtual Instruments (VIs)

Digital I/O VIs

DInScFg.VI

Multiple reads of digital input port of a high-speed digital port on a board with a pacer clock such as the CIO-
PDMA16. The DInScFg.VI will not return to your program until all of the requested data has been collected
and returned to input array.

Inputs:

BoardNum

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

be 0 to 100.

PortNum

[I32] - Specifies the digital I/O port to read.

Count

[I32] - Number of times to read digital input

Rate

[I32]- Number of times per second (Hz) to read

ExtClock

[TF] - External or internal clock

WordXfer

[TF] - Word or byte transfer

Outputs:

Rate

[I32] - Actual rate returned here

DataArray

[I16] - Data from scan is returned here

ErrCode

[I32] - Error code. See ErrMsg.VI

Arguments:

BoardNum

The board number associated when it was installed with InstaCal.

PortNum

If the port type is not

AUXPORT

, the specified port must be configured for input.

For many boards, AUXPORT is not configurable. However, some later boards do

require that the AUXPORT be configured using DCfgPort.VI or DCfgBit.VI.
Please see board details for more information.

Count

The number of times to read digital input

Rate

Number of times per second (Hz) to read the port. The actual sampling rate in

some cases will vary a small amount from the requested rate. The actual rate will
be returned to the

Rate

argument.

ExtClock

If this option (True) is used, transfers are controlled by the signal on the trigger

input line, rather than by the internal pacer clock. Each transfer is triggered on the
appropriate edge of the trigger input signal. When this option is used the

Rate

argument is ignored. The transfer rate is dependent on the trigger signal. The
default is

TIMED

(False).

WordXfer

Normally, this VI reads a single (byte) port (default is False). If

WORDXFER

is

specified (True), it will read two adjacent ports on each read and store the value of
both ports together as the low and high byte of a single array element in

DataArray

[].

Rate

(output)

Actual input rate in samples per second.

DataArray

Data from the scan is returned here.

ErrCode

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

ErrMsg VI to convert

ErrCode

into a readable string.

78