DioGetInputLoadCommutatingVoltage

Applies To

GX5055, GX5295, File

Purpose

Returns the channel input constant current voltage clamps.

Syntax

DioGetInputLoadCommutatingVoltage (nHandle, nChannel, pdVComHi, pdVComLo, pnStatus)

Parameters

Name
Type
Comments
nHandle
SHORT
DIO Master board handle, Board handle 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 had 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 n umber range is 0-991 (1 Master and 30 slaves).
Gx5295: Each DIO board adds 4 Auxiliary channels, Auxiliary channels number range is 0-123 (1 Master and 30 slaves).
pdVComHi
PDOUBLE
GX5055: Input active load sink and source currents high commutating voltages value, voltage settings and range depends on supply rail voltages see comments for details.
GX5295: Input active load sink and source currents commutating voltages value, voltage can be set from --2V to +7V.
pdVComLo
PDOUBLE
GX5055: Input active load sink and source currents low commutating voltages value, voltage settings and range depends on supply rail voltages see comments for details.
GX5295: Not used should be set to 0.
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

GX5055:

Each channel has an independent load with the following capabilities:

●     Channels’ Input constant source and sink currents up to 24 mA – DioSetupInputLoadCurrent  function.

●     Maintain high impedance over a wide voltage.

●     Separate high and low commutating voltages – DioSetupInputLoadCommutatingVoltage function.

●     Channels’ Input Resistive load options - DioSetupInputLoadResistance function.

 Min/Max commutating voltages:

 
Min
Max
pdVComHi
Low Rail Supply +2V
High Rail Supply -7V
pdVComLo
Low Rail Supply +2V
High Rail Supply -7V

 

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

With independent high and low commutating voltages, the source and sink currents each have their own threshold voltage. If the voltage on the input, when the load is activated, is between the two commutating voltages, the load will remain in a high impedance state.

GX5295:

Each channel has an independent load with the following capabilities:

●     Channels’ Input constant source and sink currents up to 24 mA – DioSetupInputLoadCurrent  function.

●     Maintain high impedance over a wide voltage.

●     Single commutating voltage – DioSetupInputLoadCommutatingVoltage function.

With a single commutating voltage, the source and sink currents have a single threshold voltage.

Channels input constant current commutating voltage can be read back and set dynamically at any time even while the DIO is running mode.

Example

The following example returns the input constant current commutating voltage for channel 0:

 

DOUBLE dVComHi, dVComLo;

DioGetInputLoadCommutatingVoltage(nHandle, 0, &dVComHi, &dVComLo, &nStatus);

 

See Also

DioSetupInputLoadState, DioSetupInputLoadCurrent, DioSetupInputLoadCommutatingVoltage, DioSetupInputLoadResistance, DioSetupInputThresholdVoltages, DioGetErrorString