Function
Sets Out Range when the conversion start
condition is Out Range comparison. The Out Range is stored in Voltage
or Current.
This settings is necessary when the conversion start condition that is
set by AioSetAiStartTrigger function is Out Range comparison.
This function doesn't need to be executed when the conversion start condition
is not Out Range comparison.
It can be set only 1ch for each device. The latest setting is available when you set it several times.
Format
Ret = AioSetAiStartOutRangeEx ( Id , AiChannel , Level1 , Level2 , StateTimes )
Parameters
Id
[ C, C++ : short ] [ Python : ctypes.c_short ]
Specifies the Device ID retrieved from AioInit function.
AiChannel
[ C, C++ : short ] [ Python : ctypes.c_short ]
Specifies the channel that performs the Out Range comparison.
Level1
[ C, C++ : float ] [ Python : ctypes.c_float ]
Sets the upper limit of Out Range comparison in Voltage or Current.
Level2
[ C, C++ : float ] [ Python : ctypes.c_float ]
Sets the lower limit of Out Range comparison in Voltage or Current.
StateTimes
[ C, C++ : long ] [ Python : ctypes.c_long ]
Sets the number of samplings within the state-held period after the condition
of Out Range comparison is satisfied.
In fact, the conversion is started after sampling time of StateTimes elapses.
Return value
Ret [ C, C++ : long ] [ Python : ctypes.c_long ]
Return values |
Content |
0 |
Normality completion |
7 |
Execute AioResetDevice function because the device has recovered from standby mode |
10001 |
Invalid
Id was specified |
10002 |
AIO
driver can't be called |
12290 |
The
value of AiChannel is outside the designated range of the function |
12291 |
The value of StateTimes is outside the designated range of the function |
20001 |
This function can't be used by this device |
20002 |
Can
not use while by another device works |
20003 |
Can
not use because another process is using the device |
22290 |
The value of AiChannel is outside the designated range of the device being used |
22291 |
The value of Level1 or Level2 is outside the designated range of the device being used |
22293 |
The value of StateTimes is outside the designated range of the device being used |
Initial value
In all devices, AiChannel = 0, StateTimes = 1, Voltage or Current value equals to Level1, Level2 = 0 in binary.
Remarks
This function cannot be used on devices without
the analog input function.
If the device is in operation, the function cannot be performed.
Example
Sets Out Range comparison
start to channel 0.
Comparison data is 5.0V to -5.0V, the state-held times is 1.
C, C++ |
long
Ret; |
Python |
Ret
= ctypes.c_long() |