Init and Exit Processing

Init and exit processing are common processing that are necessary for all programming.
Init processing is performed by function AioInit. This function creates driver file and secures necessary memory.

There are 2 parameters in function AioInit. The first parameter is DeviceName.
DeviceName is a character string such as "AIO000" which is registered in Configuration Tool (config).
For Linux, using the setting tool to set DeviceName.

The second parameter is ID. ID is a number passed from driver, and this ID is required to use the following functions.
If function terminates normally, the return value is 0. If function execution failed, a value other than 0 is returned.

Exit processing is performed by function AioExit. This function stops the device and driver operation, releases all the resources used by memory and threads, etc.
Please make sure to execute this function before terminating application. Otherwise, the resources used by driver may remain unopened.

Programming Example in C

Perform the init and exit processing for device "Aio000"

long Ret;
short Id;

Ret = AioInit( "Aio000" , &Id );
if(Ret != 0){
    printf("Error occurred in AioInit %d\n", Ret);
}

Ret = AioExit( Id );
if(Ret != 0){
    printf("Error occurred in AioExit %d\n", Ret);
}

 

Programming Example in Python

Perform the init and exit processing for device "Aio000"

Ret = ctypes.c_long()
Id = ctypes.c_short()

Ret.value = caio.AioInit ( b"AIO000" , ctypes.byref(Id))
if Ret.value != 0:
    print(f"Error occurred in AioInit {Ret.value}\n")

Ret.value = caio.AioExit ( Id )
if Ret.value != 0:
    print(f"Error occurred in AioExit {Ret.value}\n")