AN169

32

Rev. 2.3

AND

Supported Devices:

C8051F320/1/6/7, C8051F340/1/2/3/4/5/6/7/8/9/A/B/C/D,

C8051F380/1/2/3/4/5/6/7, C8051T320/1/2/3/6/7, C8051T620/1/2/3, CP2101/2/3/4/5/8/9

SI_SUCCESS

The function succeeded.

SI_DEVICE_NOT_FOUND

The device cannot be found on the system. Make sure the device is plugged in and powered. If the device is

plugged in, make sure that all previous application handles to the device have been closed (SI_Close). If a

previous instance of the application was not able to close its handle to the device before exiting, disconnect and

reconnect the device. To avoid having to temporarily remove the device in this case, you may have your application

store the current handle value (returned by SI_Open) in the Windows registry so that if the application crashes, the

handle is still accessible and can be closed (SI_Close).

SI_INVALID_HANDLE

The value of the Handle passed to the function is not valid. A valid handle is obtained by declaring a HANDLE

variable in your program and passing the address of that HANDLE to the SI_Open function. A Handle may become

invalid if the device is removed from the system, so first verify that the device is connected.

SI_WRITE_ERROR

The write operation failed. The device may have been removed.

SI_INVALID_PARAMETER

An invalid parameter was passed to the DLL function called. See the function definition for valid parameter types

and/or ranges.

SI_INVALID_REQUEST_LENGTH

See SI_Read and SI_Write function descriptions for valid request lengths.

SI_DEVICE_IO_FAILED

Device IO operation failed. The device may have been removed.

SI_INVALID_BAUDRATE

See the CP210x device-specific data sheet for supported baud rates.

SI_FUNCTION_NOT_SUPPORTED

The function called is not supported by the device. For example, attempting to use the SI_ReadLatch and

SI_WriteLatch functions on a device other than the CP2103 will cause the functions to return this value.

SI_GLOBAL_DATA_ERROR

An error has occurred such that the thread global data cannot be retrieved. Unload and reload the DLL if this return

code is received.

SI_SYSTEM_ERROR_CODE

Call GetLastError (Win32 Base) to retrieve Windows System Error Code. The error codes are defined on MSDN.