GtDio6xChannelGetSourceLevels

Applies To

GX5296, GX5961, GX5964, File

Purpose

Returns the specified channel output driver high and low voltages.

Syntax

GtDio6xChannelGetSourceLevels (nHandle, nChannel, pdVoh, pdVol, 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.
nChannel
SHORT
Used to specify the channel to Get. This parameter is 0-based and refers to any channel in the Domain. Auxiliary channel numbers begin with 1000.
GX5296: Each GX5296 board has 4 auxiliary channels that support all the Pin Electronics API functions.
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.
pdVoh
PDOUBLE
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.
pdVol
PDOUBLE
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

GtDio6xChannelSetSourceLevels, GtDio6xChannelGetSourceLevels,  GtDio6xChannelSetSenseLevels, GtDio6xChannelSetSourceSlewRate, GtDio6xChannelGetSourceSlewRate, GtDio6xGetErrorString