CP2103 datasheet(29/45 Pages) SILABS

29 / 45 page

AN721

Rev. 1.2

Return Value: CP210x_STATUS = CP210x_SUCCESS,



CP210x_INVALID_PARAMETER,



CP210x_INVALID_HANDLE,



CP210x_DEVICE_IO_FAILED

6.1.9. CP210x_SetInterfaceString

Description:

Sets the Interface String for the one of the interfaces available on the CP2105 or CP2108. If the

string is not already in Unicode format, the function will convert the string to Unicode before com-

mitting it to programmable memory. The character size limit (in characters, not bytes), NOT includ-

ing a NULL terminator, is CP2105_MAX_INTERFACE_STRLEN.

Supported Devices:

CP2105, CP2108

Location:

CP210x Manufacturing DLL

Prototype:

CP210x_STATUS

CP210x_SetInterfaceString(

HANDLE

Handle,

BYTE

Interfa-

ceNumber, LPVOID Interface, BYTE Length, BOOL ConvertToUnicode)

Parameters:

1. Handle—Handle to the device to close as returned by CP210x_Open().

2. InterfaceNumber—Set to 0 for Enhanced Interface String, or 1 for Standard Interface String on

the CP2105. 0-3 for the CP2108 which has 4 interfaces.

3. Interface—Buffer containing the Interface String.

4. Length—Length of the string in characters (not bytes), NOT including a NULL terminator.

5. ConvertToUnicode—Boolean flag that tells the function if the string needs to be converted to

Unicode. The flag is set to TRUE by default (i.e., the string is in ASCII format and needs to be

converted to Unicode).

Return Value: CP210x_STATUS = CP210x_SUCCESS,



CP210x_INVALID_PARAMETER,



CP210x_INVALID_HANDLE,



CP210x_DEVICE_IO_FAILED

6.1.10. CP210x_SetSerialNumber

Description:

Sets the Serial Number String of the String Descriptor of a CP210x device. If the string is not

already in Unicode format, the function will convert the string to Unicode before committing it to

programmable memory. The character size limit (in characters, not bytes), NOT including a NULL

terminator, is CP210x_MAX_SERIAL_STRLEN.

Supported Devices:

CP2101, CP2102, CP2103, CP2104, CP2105, CP2108

Location:

CP210x Manufacturing DLL

Prototype:

CP210x_STATUS CP210x_SetSerialNumber( HANDLE Handle,



LPVOID SerialNumber, BYTE Length, BOOL ConvertToUnicode=TRUE )

Parameters:

1. Handle—Handle to the device to close as returned by CP210x_Open().

2. SerialNumber—Buffer containing the Serial Number String value.

3. Length—Length in characters (not bytes), NOT including a NULL terminator.

4. ConvertToUnicode—Boolean flag that tells the function if the string needs to be converted to

Unicode. The flag is set to TRUE by default, i.e. the string is in ASCII format and needs to be

converted to Unicode.

CP2103 Datasheet(PDF) 29 Page - Silicon Laboratories

CP2103 Datasheet(HTML) 29 Page - Silicon Laboratories

Html Pages

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45

Datasheet Download

Link URL