GX5055, GX5295, File
Sets the specified channels range input constant current commutating voltage.
DioSetupInputLoadCommutatingVoltage (nHandle, nChannelListMode, nCountOrFirstChannel, panChannelList, nLastChannel, dVComHi, dVComLo, pnStatus)
Name |
Type |
Comments |
nHandle |
SHORT |
DIO Master handle, Slave handle or File board handle. |
nChannelListMode |
SHORT |
Channel list mode dictates how nCountOrFirstChannel and panChannelList parameters are used. Channel list mode options are as follows:0 DIO_CH_LIST_MODE_ARRAY_OF_CHANNELS: The user specifies an array of channels where nCountOrFirstChannel is the number of elements in the list array and panChannelList is an array contains the channels numbers. In this mode nLastChannel is ignored.1 DIO_CH_LIST_MODE_ALL_BOARD_CHANNELS: Apply the settings to all the board’s channels associated with this board handle. In this mode nCountOrFirstChannel, panChannelList and nLastChannel variavles are ignored.2 DIO_CH_LIST_MODE_ALL_DOMAIN_CHANNELS: Apply the settings to all the channels in the domain, e.g. if there are two boards in the domain (Master and a Slave), then all 64 channels will be set. In this mode nCountOrFirstChannel, panChannelList and nLastChannel variavles are ignored.3 DIO_CH_LIST_MODE_RANGE_OF_CHANNELS: Apply settings to a range of channels where nCountOrFirstChannel is the first channel number and nLastChannel is the last channel number. In this mode panChannelList variavle is ignored. |
nCountOrFirstChannel |
SHORT |
If nChannelListMode parameter is set to DIO_CH_LIST_MODE_ARRAY_OF_CHANNELS, then it is specifying the number of elements in the pnChannelList array parameter.If nChannelListMode parameter is set to DIO_CH_LIST_MODE_RANGE_OF_CHANNELS, then it is specifying the first channel number to apply the settings to,otherwise it is ignored and should set to zero.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).Gx5295: Each DIO board adds 4 Auxiliary channels, Auxiliary channels number range is 0-123 (1 master and 30 slaves). |
panChannelList |
PSHORT |
Array of channels numbers. Channels numbers can be from 0 to the last channel in the domain. E.g., if the domain has two boards then the last channel is 63.This parameter is only used if nChannelListMode parameter is set to DIO_CH_LIST_MODE_ARRAY_OF_CHANNELS, otherwise is should be passed as NULL.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).Gx5295: Each DIO board adds 4 Auxiliary channels, Auxiliary channels number range is 0-123 (1 master and 30 slaves). |
nLastChannel |
SHORT |
If nChannelListMode parameter is set to DIO_CH_LIST_MODE_RANGE_OF_CHANNELS, then it is specifying the last channel number to apply the settings to,otherwise it is ignored and should set to zero.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).Gx5295: Each DIO board adds 4 Auxiliary channels, Auxiliary channels number range is 0-123 (1 master and 30 slaves). |
dVComHi |
DOUBLE |
GX5055:Input active load sink and source currents high commutating voltages value, voltage can be set from -16V to +16V.GX5295:Input active load sink and source currents commutating voltages value, voltage can be set from --2V to +7V. |
dVComLo |
DOUBLE |
GX5055:Input active load sink and source currents low commutating voltages value, voltage can be set from -16V to +16V.GX5295:Not used should be set to 0. |
pnStatus |
PSHORT |
Returned status: 0 on success, negative number on failure. |
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 |
|
dVComHi |
Low Rail Supply +2V |
High Rail Supply -7V |
dVComLo |
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.
The following example uses an array of channels list to set their input current commutating voltage high to 4.2V and voltage low to -5.25V:
SHORT anChannelList[]={0, 2, 5, 7, 9, 13, 14, 27};
DioSetupInputLoadCommutatingVoltage (nHandle, DIO_CH_LIST_MODE_ARRAY_OF_CHANNELS, 8, anChannelList, 0, 4.2, -5.25, &nStatus);
The following example sets all the board’s channels comparators’ input current commutating voltage high to 4.2V and voltage low to -5.25V:
DioSetupInputLoadCommutatingVoltage (nHandle, DIO_CH_LIST_MODE_ALL_BOARD_CHANNELS, 0, NULL , 0, 4.2, -5.25, &nStatus);
The following example sets all the boards channels comparators’ input current commutating voltage high to 4.2V and voltage low to -5.25V:
DioSetupInputLoadCommutatingVoltage (nHandle, DIO_CH_LIST_MODE_ALL_DOMAIN_CHANNELS, 0, NULL , 0, 4.2, -5.25, &nStatus);
The following example sets channels 5 to 10 input current commutating voltage high to 4.2V and voltage low to -5.25V:
DioSetupInputLoadCommutatingVoltage (nHandle, DIO_CH_LIST_MODE_RANGE_OF_CHANNELS, 5, NULL, 10, 4.2, -5.25, &nStatus);
DioSetupInputLoadCurrent, DioGetInputLoadCommutatingVoltage, DioSetupInputLoadResistance, DioSetupInputThresholdVoltages, DioGetErrorString