Function
Retrieves the analog input status.
Format
Ret = AioGetAiStatus ( Id , AiStatus )
Parameters
Id
[ C, C++ : short ] [ Python : ctypes.c_short ]
Specifies the Device ID retrieved from AioInit function.
AiStatus
[ C, C++ : long * ] [ Python : ctypes.POINTER(ctypes.c_long) ]
Specifies the address of the variable that stores the status.
AiStatus have the meanings as following in bit.
Status |
Macro |
Value |
AIS_BUSY |
00000001H |
|
AIS_START_TRG |
00000002H |
|
AIS_DATA_NUM |
00000010H |
|
AIS_OFERR |
00010000H |
|
AIS_SCERR |
00020000H |
|
AIS_AIERR |
00040000H |
|
AIS_DRVERR |
00080000H |
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 |
11500 |
Pointer
to AiStatus is NULL |
20001 |
This function can't be used by this device |
20003 |
Can
not use because another process is using the device |
Initial value
In all devices, AiStatus = 0
Remarks
If the sampling clock period error or AD
conversion error occurs, the conversion stops.
In the FIFO memory format, if an overflow occurs, the conversion stops.
In the RING memory format, the conversion doesn't stop even if the overflow
occurs.
This function cannot be used on devices without the analog input function.
This function can be executed if the device is working.
If the conversion start condition is specified to Event controller output,
Wait the start trigger status will not be notified.
Example
Retrieves the analog input status.
C, C++ |
long
Ret; |
Python |
Ret
= ctypes.c_long() |
See also