DioGetOutputVoltages

Applies To

GX5055, GX5295, File.

Purpose

Returns the channel output driver high and low voltages.

Syntax

DioGetOutputVoltages (nHandle, nChannel, pdHiLevel, pdLoLevel, pnStatus)

Parameters

Name
Type
Comments
nHandle
SHORT
Board or File board handle.
nChannel
SHORT
If Board Handle was passed:
channel number in the DIO board, each board has 32 I/O channels I/O channels number range is 0-31.
Gx5295: Each DIO board has 4 Auxiliary channels, Auxiliary channels number range is 0-3.
If Master Board Handle was passed:
Channel number in the DIO domain, each DIO board adds 32 I/O channels, I/O channels number range is 0-991 (1master and 30 slaves).
Gx5295: Each DIO board adds 4 Auxiliary channels, Auxiliary channels number range is 0-123 (1 master and 30 slaves).
pdHiLevel
PDOUBLE
GX5055:
Output driver high voltage corresponding to logic high voltage settings and range depends on supply rail voltages see comments for details.
GX5295:
Output driver high voltage corresponding to logic high. Voltage can be set from -2V to +7V and must be greater than the output driver low voltage.
pdLoLevel
PDOUBLE
GX5055:
Output driver low voltage corresponding to a logic low voltage settings and range depends on supply rail voltages see comments for details.
GX5295:
Output driver low voltage corresponding to a logic low. Voltage can be set from -2V to +7V and must be lower than the output driver high voltage.
pnStatus
PSHORT
Returned status: 0 on success, negative number 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.

GX5055:

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

Min/Max output driver high and low voltages:

 
Min
Max
pdHiLevel
Low Rail Supply +5V
High Rail Supply -3V
pdLoLevel
Low Rail Supply +4V
High Rail Supply -7V
pdHiLevel - pdLoLevel
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 returns channel 0 output driver high and low voltages:

 

DOUBLE dHiLevel, dLoLevel;

DioGetOutputVoltages (nHandle, 0, &dHiLevel, &dLoLevel, &nStatus);

 

See Also

DioSetupOutputVoltages, DioSetupOutputSlewRate, DioSetupInputLoadCommutatingVoltage, DioSetupInputLoadResistance, DioSetupInputThresholdVoltages, DioGetErrorString