Function
Sets In Range when the conversion start condition
is In Range comparison. The In Range is stored in Voltage or Current.
This settings is necessary when the conversion start condition that is
set by AioSetAiStartTrigger function is the In Range comparison.
This function doesn't need to be executed when the conversion start condition
is not In Range comparison.
It can be set only 1ch for each device. The latest setting is available when you set it several times.
Format
Ret = AioSetAiStarInRangeEx ( 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 In Range comparison.
Level1
[ C, C++ : float ] [ Python : ctypes.c_float ]
Sets the upper limit of In Range comparison in Voltage or Current.
Level2
[ C, C++ : float ] [ Python : ctypes.c_float ]
Sets the lower limitof In 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 In Range comparison is satisfied.
In fact, the conversion is started after sampling time of StateTime 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 |
12270 |
The
value of AiChannel is outside the designated range of the function |
12271 |
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 |
22270 |
The value of AiChannel is outside the designated range of the device being used |
22271 |
The value of Level1 or Level2 is outside the designated range of the device being used |
22273 |
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 In Range comparison
start to channel 0.
The comparison data is 5.0V to -5.0V, state-held times is 1.
C, C++ |
long
Ret; |
Python |
Ret
= ctypes.c_long() |