GtDio6xChannelSetSourceLevels

Applies To

GX5296, GX5961, GX5964, File

Purpose

Sets the specified channel output driver high and low voltages.

Syntax

GtDio6xChannelSetSourceLevels (nHandle, lChannelListArraySize, palChannelListArray, dVoh, dVol, pnStatus)

Parameters

Name
Type
Comments
nHandle
SHORT
Session identifier:

●     Board handle is used when communicating with the hardware. The Board handle session identifier is returned by calling GtDio6xInitialize or GtDio6xSetupInitialization.

●     File handle is used when communicating with a file. The File handle session identifier is  returned by calling GtDio6xFileOpen.
lChannelListArraySize
LONG
Used to specify the number of channels to set. This parameter should not be greater than the size of palChannelListArray. If GTDIO6X_ALL_DOMAIN is passed in, then the palChannelListArray parameter can be set to NULL and the settings will be applied to all channels in the Domain.
palChannelListArray
PLONG
Array containing channels numbers that will be set by this function, channels numbers are 0-based and refers to any channel in the Domain. Auxiliary channel numbers begin with 1000.
GX5961: Each GX5961 board has 4 fully programmable auxiliary channels, and 8 TTL I/O channels. First 4 auxiliary channels may use all the Pin Electronics API.
GX5964: Does not have Auxiliary channels.
nImpedance
SHORT
Used to set the source impedance.

0.  GTDIO6X_TERM_LOWZ: Low impedance (approximately 12Ohm) path.

1.  GTDIO6X_TERM_50OHM: 50-Ohm path.
dVoh
DOUBLE
GX5961/ GX5964: Output driver high voltage corresponding to logic high voltage settings and range depends on supply rail voltages see comments for details.
GX5296: Output driver high voltage corresponding to logic high. Voltage can be set from -2V to +7V and has to be greater or equal to the output driver low voltage.
dVol
DOUBLE
GX5961/ GX5964: Output driver low voltage corresponding to a logic low voltage settings and range depends on supply rail voltages see comments for details.
GX5296: Output driver low voltage corresponding to a logic low. Voltage can be set from -2V to +7V and has be lower or equal to the output driver high voltage.
pnStatus
PSHORT
Returned status: 0 on success, negative value on failure.

Comments

Each channels’ output driver has two level driver, low and high level.

Channels output driver voltages can be read back and set dynamically at any time even while the DIO is running mode.

The total output driver voltage swing (Output driver high voltage less Output driver low voltage) is limited to 24V per channel.

GX5960:

The total output driver voltage swing (Output driver high voltage less Output driver low voltage) is limited to 24V per channel.

 

 
Min
Max
dVoh
Low Rail Supply +5V
High Rail Supply -3V
dVol
Low Rail Supply +4V
High Rail Supply -7V
dVoh - dVol
0.5V
 

 

E.g. if high rail supply = 18V and low rail supply = -14V then min output driver high voltage >=-11V and max output driver high voltage <=12V.

Example

The following example sets channels 0 and 2 source high voltage to +5V and the low voltage to -1V, and return channel 0 settings:

 

SHORT nStatus;

LONG alChannelList[2];

DOUBLE dVoh, dVol;

 

// Fill channel array

alChannelList[0] = 0;

alChannelList[1] = 2;

 

GtDio6xChannelSetSourceLevels (nHandle, 2, alChannelList, 5.0, 1.0, &nStatus);

 

GtDio6xChannelGetSourceLevels (nHandle, 0, &dVoh, &dVol, &nStatus);

 

See Also

GtDio6xChannelGetSourceLevels, GtDio6xChannelGetSenseLevels, GtDio6xChannelSetSenseLevels, GtDio6xChannelGetSourceSlewRate, GtDio6xGetErrorString