SsiInit

Function

Retrieve the device ID then the device can be accessed.

Format

Ret = SsiInit ( DeviceName , &Id )

Parameters

DeviceName [ C, C++: char * ] [ Python: ctypes.c_char_p ]
Specify the device name set with the setup tool(config). Device name is maximum 50 characters(NULL is included).

Id [ C, C++: short * ] [ Python: ctypes.POINTER(ctypes.c_short) ]
A device ID is returned. By using this device ID, you can access to the device in the following functions.

Return Value

Ret [ C, C++: long ] [ Python: ctypes.c_long ]

Definition	Value [Dec]	Description
SSI_ERR_SUCCESS	0	Succeeded
SSI_ERR_INI_RESOURCE	1	Can not get resources.
SSI_ERR_INI_MEMORY	3	Can not allocate memory. This error would hardly occur. If this error occurred, please extend the memory.
SSI_ERR_INI_CONFIG_FILE	4	Can not read setting file.
SSI_ERR_INI_BOARD_ID	5	BoardID conflict error.
SSI_ERR_DLL_DEVICE_NAME	10000	Invalid device name. Device name which isn't registered in setting file is specified.
SSI_ERR_DLL_CALL_DRIVER	10002	Can not call driver (ioctl failed). Please confirm whether the initialization function has completed normally. And confirm the scope of variable that stores ID.
SSI_ERR_DLL_CREATE_FILE	10003	Can not open driver file (open failed). Please confirm whether the device driver is started by lsmod.
SSI_ERR_INFO_INVALID_DEVICE	10050	Invalid device. Specified device name is not found. Please check spelling.
SSI_ERR_INFO_NOT_FIND_DEVICE	10051	Can not find device.

The others (See also: Details of Error Code)

Initial Value

None

Remarks

Retrieve the device ID then the device can be accessed.
By using this device ID, you can access the device in the following functions.
If you want to access more than one device, you need to provide several variables to store ID.
After SsiInit normal completed, each function can be used until SsiExit is called.

Example

Initialize the device "SSI000" , and retrieves an Id.

C, C++

long Ret;
short Id;
Ret = SsiInit("SSI000", &Id);

Python

Ret = ctypes.c_long()

Id = ctypes.c_short()
Ret.value = cssi.SsiInit("SSI000",ctypes.byref(Id))

Limitations

Up to 16 processes can access a single device.
There is no limit when accessing from multiple threads in the same process.