DioGetTriStateTerminationMode

Applies To

GX5295, File.

Purpose

Return the channel Tri-State termination mode.

Syntax

DioGetTriStateTerminationMode (nHandle, nChannel, pnMode, pnStatus)

Parameters

Name
Type
Comments
nHandle
SHORT
Master board handle, Board handle or File board handle.
nChannel
PSHORT
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.
Each DIO board has 4 Auxiliary channels number range is 0-3.
If Master Board Handle was supposed:
Channel number in the DIO domain, each DIO board adds 32 I/O channels, I/O channels number range is 0-991 (1 master and 30 slaves).
Each DIO board adds 4 Auxiliary channels, Auxiliary channels number range is 0-123 (1 master and 30 slaves).
pnMode
PSHORT
Returned Tri-State termination mode:
0  DIO_TRI_STATE_TERMINATION_MODE_DEFAULT: Default termination mode, in this mode the channel will be set to Hi-Z whenever the channel direction is set to input.
1  DIO_TRI_STATE_TERMINATION_MODE_LEVEL: in this mode the channel will be set to the voltage as specified in DioSetupTriStateTerminationVoltage API whenever the channel direction is set to input.
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

GX5295:

The specified termination voltage is the same voltage that is used by the input active load commutating voltage.

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

Example

The following example returns the channel Tri-State termination mode for channel 0:

 

SHORT nMode;

DioGetTriStateTerminationMode (nHandle, 0, &nMode, &nStatus);

 

See Also

DioSetupTriStateTerminationMode, DioSetupTriStateTerminationVoltage, DioSetupInputLoadCurrent, DioSetupInputLoadCommutatingVoltage, DioGetErrorString