Cypress Cyapi Programmer'S Reference

Download as pdf or txt
Download as pdf or txt
You are on page 1of 75

Cypress CyAPI

Programmer's Reference
2011 Cypress Semiconductor

Cypress CyAPI Programmer's Reference

Table of Contents
Foreword

Part I Overview

Part II How to Link to CyAPI.lib

Part III New API

Part IV Features Not Supported

Part V CCyBulkEndPoint

1 BeginDataXfer(
...................................................................................................................................
)
9
2 CCyBulkEndPoint(
...................................................................................................................................
)
10
3 CCyBulkEndPoint(
...................................................................................................................................
)
11

Part VI CCyControlEndPoint

11

1 BeginDataXfer(
...................................................................................................................................
)
12
2 CCyControlEndPoint(
...................................................................................................................................
)
13
3 CCyControlEndPoint(
...................................................................................................................................
)
14
4 Direction
................................................................................................................................... 14
5 Index................................................................................................................................... 15
6 Read(...................................................................................................................................
)
15
7 ReqCode
................................................................................................................................... 16
8 ReqType
................................................................................................................................... 17
9 Target
................................................................................................................................... 17
10 Value................................................................................................................................... 18
11 Write(...................................................................................................................................
)
19

Part VII CCyInterruptEndPoint

19

1 BeginDataXfer(
...................................................................................................................................
)
20
2 CCyInterruptEndPoint(
...................................................................................................................................
)
21
3 CCyInterruptEndPoint(
...................................................................................................................................
)
21

Part VIII CCyIsocEndPoint

22

1 BeginDataXfer(
...................................................................................................................................
)
22
2 CCyIsocEndPoint(
...................................................................................................................................
)
24
3 CCyIsocEndPoint(
...................................................................................................................................
)
24
4 CreatePktInfos(
...................................................................................................................................
)
24

2011 Cypress Semiconductor

Contents

Part IX CCyIsoPktInfo

25

Part X CCyUSBDevice

27

1 AltIntfc(
...................................................................................................................................
)
27
2 AltIntfcCount(
...................................................................................................................................
)
28
3 bHighSpeed
................................................................................................................................... 28
4 BcdDevice
................................................................................................................................... 28
5 BcdUSB
................................................................................................................................... 29
6 BulkInEndPt
................................................................................................................................... 29
7 BulkOutEndPt
................................................................................................................................... 30
8 CCyUSBDevice(
...................................................................................................................................
)
30
9 ~CCyUSBDevice(
...................................................................................................................................
)
32
10 Close(...................................................................................................................................
)
33
11 Config(
...................................................................................................................................
)
33
12 ConfigAttrib
................................................................................................................................... 33
13 ConfigCount(
...................................................................................................................................
)
33
14 ConfigValue
................................................................................................................................... 34
15 ControlEndPt
................................................................................................................................... 34
16 DevClass
................................................................................................................................... 34
17 DeviceCount(
...................................................................................................................................
)
35
18 DeviceHandle(
...................................................................................................................................
)
35
19 DeviceName
................................................................................................................................... 35
20 DevProtocol
................................................................................................................................... 35
21 DevSubClass
................................................................................................................................... 36
22 DriverGUID(
...................................................................................................................................
)
36
23 DriverVersion
................................................................................................................................... 36
24 EndPointCount(
...................................................................................................................................
)
36
25 EndPointOf(
...................................................................................................................................
)
37
26 EndPoints
................................................................................................................................... 37
27 FriendlyName
................................................................................................................................... 38
28 GetDeviceDescriptor(
...................................................................................................................................
)
38
29 GetConfigDescriptor(
...................................................................................................................................
)
38
30 GetIntfcDescriptor(
...................................................................................................................................
)
39
31 GetUSBConfig(
...................................................................................................................................
)
39
32 Interface(
...................................................................................................................................
)
40
33 InterruptInEndPt
................................................................................................................................... 40
34 InterruptOutEndPt
................................................................................................................................... 41
35 IntfcClass
................................................................................................................................... 42
36 IntfcCount(
...................................................................................................................................
)
42
2011 Cypress Semiconductor

Cypress CyAPI Programmer's Reference


37 IntfcProtocol
................................................................................................................................... 42
38 IntfcSubClass
................................................................................................................................... 42
39 IsocInEndPt
................................................................................................................................... 42
40 IsocOutEndPt
................................................................................................................................... 43
41 IsOpen(
...................................................................................................................................
)
44
42 Manufacturer
................................................................................................................................... 44
43 MaxPacketSize
................................................................................................................................... 44
44 MaxPower
................................................................................................................................... 44
45 NtStatus
................................................................................................................................... 44
46 Open(...................................................................................................................................
)
45
47 PowerState(
...................................................................................................................................
)
46
48 Product
................................................................................................................................... 46
49 ProductID
................................................................................................................................... 46
50 ReConnect(
...................................................................................................................................
)
46
51 Reset(...................................................................................................................................
)
47
52 Resume(
...................................................................................................................................
)
47
53 SerialNumber
................................................................................................................................... 47
54 SetConfig(
...................................................................................................................................
)
47
55 SetAltIntfc(
...................................................................................................................................
)
47
56 StrLangID
................................................................................................................................... 48
57 Suspend(
...................................................................................................................................
)
48
58 USBAddress
................................................................................................................................... 48
59 USBDIVersion
................................................................................................................................... 49
60 UsbdStatus
................................................................................................................................... 49
61 UsbdStatusString(
...................................................................................................................................
)
49
62 VendorID
................................................................................................................................... 49

Part XI CCyUSBConfig

50

1 AltInterfaces
................................................................................................................................... 52
2 bConfigurationValue
................................................................................................................................... 52
3 bDescriptorType
................................................................................................................................... 52
4 bLength
................................................................................................................................... 52
5 bmAttributes
................................................................................................................................... 52
6 bNumInterfaces
................................................................................................................................... 52
7 CCyUSBConfig(
...................................................................................................................................
)
53
8 CCyUSBConfig(
...................................................................................................................................
)
53
9 CCyUSBConfig(
...................................................................................................................................
)
53
10 ~CCyUSBConfig
................................................................................................................................... 54
11 iConfiguration
................................................................................................................................... 54
12 Interfaces
................................................................................................................................... 54
2011 Cypress Semiconductor

Contents

13 wTotalLength
................................................................................................................................... 56

Part XII CCyUSBEndPoint

56

1 Abort(...................................................................................................................................
)
56
2 Address
................................................................................................................................... 57
3 Attributes
................................................................................................................................... 57
4 BeginDataXfer(
...................................................................................................................................
)
58
5 bIn

................................................................................................................................... 59

6 CCyUSBEndPoint(
...................................................................................................................................
)
60
7 CCyUSBEndPoint(
...................................................................................................................................
)
60
8 CCyUSBEndPoint(
...................................................................................................................................
)
61
9 DscLen
................................................................................................................................... 61
10 DscType
................................................................................................................................... 61
11 GetXferSize(
...................................................................................................................................
)
62
12 FinishDataXfer(
...................................................................................................................................
)
62
13 hDevice
................................................................................................................................... 63
14 Interval
................................................................................................................................... 63
15 MaxPktSize
................................................................................................................................... 64
16 NtStatus
................................................................................................................................... 64
17 Reset(...................................................................................................................................
)
64
18 SetXferSize(
...................................................................................................................................
)
64
19 TimeOut
................................................................................................................................... 65
20 UsbdStatus
................................................................................................................................... 66
21 WaitForXfer(
...................................................................................................................................
)
66
22 XferData(
...................................................................................................................................
)
67

Part XIII CCyUSBInterface

68

1 bAlternateSetting
................................................................................................................................... 69
2 bAltSettings
................................................................................................................................... 70
3 bDescriptorType
................................................................................................................................... 70
4 CCyUSBInterface(
...................................................................................................................................
)
70
5 CCyUSBInterface(
...................................................................................................................................
)
70
6 bInterfaceClass
................................................................................................................................... 71
7 bInterfaceNumber
................................................................................................................................... 71
8 bInterfaceProtocol
................................................................................................................................... 71
9 bInterfaceSubClass
................................................................................................................................... 72
10 bLength
................................................................................................................................... 72
11 bNumEndpoints
................................................................................................................................... 72
12 EndPoints
................................................................................................................................... 72
13 iInterface
................................................................................................................................... 74
2011 Cypress Semiconductor

Cypress CyAPI Programmer's Reference

Index

75

2011 Cypress Semiconductor

Overview

Overview
Library Overview

Top Next

CyAPI.lib provides a simple, powerful C++ programming interface to USB devices. More specifically, it
is a C++ class library that provides a high-level programming interface to the CyUsb.sys device driver.
The library is only able to communicate with USB devices that are served by (i.e. matched to) this driver.
Rather than communicate with the driver via Windows API calls such as SetupDiXxxx and
DeviceIoControl, applications call simpler CyAPI methods such as Open, Close, and XferData to
communicate with USB devices.
To use the library, you need to include the header file, CyAPI.h, in files that access the CCyUSBDevice
class. In addition, the statically linked CyAPI.lib file must be linked to your project. Versions of the .lib
file are available for use with Microsoft Visual Studio 2008, 2010 and Borland C++ Builder 6.0. Please
refer section How to Link to CyAPI.lib for more detail.
The library employs a Device and EndPoints use model. To use the library you must create an
instance of the CCyUSBDevice class using the new keyword. A CCyUSBDevice object knows how
many USB devices are attached to the CyUsb.sys driver and can be made to abstract any one of those
devices at a time by using the Open method. An instance of CCyUSBDevice exposes several methods
and data members that are device-specific, such as DeviceName, DevClass, VendorID, ProductID, and
SetAltIntfc.
When a CCyUSBDevice object is open to an attached USB device, its endpoint members provide an
interface for peforming data transfers to and from the device's endpoints. Endpoint-specific data
members and methods such as MaxPktSize, TimeOut, bIn, Reset and XferData are only accessible
through endpoint members of a CCyUSBDevice object.
In addition to its simplicity, the class library facilitates creation of sophisticated applications as well.
The CCyUSBDevice constructor automatically registers the application for Windows USB Plug and Play
event notification. This allows your application to support "hot plugging" of devices. Also, the
asynchronous BeginDataXfer/WaitForXfer/FinishDataXfer methods allow queueing of multiple data
transfer requests on a single endpoint, thus enabling data streaming from the application level.

How to Link to CyAPI.lib


Please follow the below steps to add CyAPI.lib to your project.
1. Add the CyAPI.h header files to your project from the CySuiteUSB installation directory CyAPI\inc.
Note that the other related header files are available in the same
directory.
2. Linking CyAPI.lib
Select Project property.
Select 'Linker' node under the 'Configuration Properties'.
Select the 'Input' node under the 'Linker'.

2011 Cypress Semiconductor

Cypress CyAPI Programmer's Reference

Add lib path( including the lib name, example-..\..\lib\x86\cyapi.lib ) in the 'Additional Dependencies'
edit box. Libraries for 32/64 bit available in the CySuiteUSB installation directory CyAPI\lib. The
directory 'x64' is for 64-bit library and the 'x86' directory is for 32-bit library.

New API
bool

XferData(PUCHAR buf, LONG &bufLen, CCyIsoPktInfo* pktInfos, bool pktMode);

XferData() method of CCyUSBEndPoint is overloaded such that it can be used for partial IN transfer.
if pktMode = true, partial data transfer is enabled or else calls the bool XferData(PUCHAR buf, LONG
&len, CCyIsoPktInfo* pktInfos = NULL) where partial data is discarded.
This parameter has no effect on Out endpoint.
Example
CCyUSBDevice *USBDevice = new CCyUSBDevice(NULL);
unsigned char buf[12] = "hello world";
LONG length = 11;
if (USBDevice->BulkOutEndPt)
USBDevice->BulkOutEndPt->XferData(buf, length, NULL, false);
if (USBDevice->BulkInEndPt)
USBDevice->BulkInEndPt->XferData(buf, length, NULL, true);

Features Not Supported


The Following features are not supported by CyAPI.lib
1. SET ADDRESS Feature
The SET ADDRESS Request cannot be implemented through control endpoint.
2. SYNC FRAME
The SYNC FRAME Request cannot be implemented through Control Endpoint.

CCyBulkEndPoint
CCyBulkEndPoint Class

Previous Top Next

2011 Cypress Semiconductor

CCyBulkEndPoint

Header
CyUSB.h
Description
CCyBulkEndPoint is a subclass of the CCyUSBEndPoint abstract class. CCyBulkEndPoint exists to
implement a bulk-specific BeginDataXfer( ) function.
Normally, you should not need to construct any of your own instances of this class. Rather, when an
instance of CyUSBDevice is created, instances of this class are automatically created for all bulk
endpoints as members of that class. Two such members of CyUSBDevice are BulkInEndPt and
BulkOutEndPt.

Example
// Find bulk endpoints in the EndPoints[]
array
CCyBulkEndPoint *BulkInEpt = NULL;
CCyBulkEndPoint *BulkOutEpt = NULL;
CCyUSBDevice *USBDevice = new
CCyUSBDevice(NULL);
int eptCount = USBDevice->EndPointCount();
for (int i=1; i<eptCount; i++) {
bool bIn = ((USBDevice->EndPoints[i]>Address & 0x80)==0x80);
bool bBulk = (USBDevice->EndPoints[i]>Attributes == 2);
if (bBulk && bIn) BulkInEpt =
(CCyBulkEndPoint *) USBDevice->EndPoints
[i];
if (bBulk && !bIn) BulkOutEpt =
(CCyBulkEndPoint *) USBDevice->EndPoints
[i];}

5.1

BeginDataXfer( )
PUCHAR CCyBulkEndPoint::BeginDataXfer(
PCHAR buf, LONG len, OVERLAPPED *ov)

Previous Top Next

Description
BeginDataXfer is an advanced method for performing asynchronous IO. This method sets-up all the
parameters for a data transfer, initiates the transfer, and immediately returns, not waiting for the transfer
to complete.
BeginDataXfer allocates a complex data structure and returns a pointer to that structure. FinishDataXfer
de-allocates the structure. Therefore, it is imperative that each BeginDataXfer call have exactly one

2011 Cypress Semiconductor

10

Cypress CyAPI Programmer's Reference

matching FinishDataXfer call.


You will usually want to use the synchronous XferData method rather than the asynchronous
BeginDataXfer/WaitForXfer/FinishDataXfer approach.

Example
// This example assumes that the device automatically sends back,
// over its bulk-IN endpoint, any bytes that were received over its
// bulk-OUT endpoint (commonly referred to as a loopback function)
CCyUSBDevice

*USBDevice = new

CCyUSBDevice(NULL);

OVERLAPPED outOvLap, inOvLap;


outOvLap.hEvent = CreateEvent(NULL, false, false, L"CYUSB_OUT");
inOvLap.hEvent
= CreateEvent(NULL, false, false, L"CYUSB_IN");
unsigned char inBuf[128];
ZeroMemory(inBuf, 128);
unsigned char buffer[128];
LONG length = 128;
// Just to be cute, request the return data before initiating the loopback
UCHAR *inContext = USBDevice->BulkInEndPt->BeginDataXfer(inBuf, length, &inOvLap);
UCHAR *outContext = USBDevice->BulkOutEndPt->BeginDataXfer(buffer, length,
&outOvLap);
USBDevice->BulkOutEndPt->WaitForXfer(&outOvLap,100);
USBDevice->BulkInEndPt->WaitForXfer(&inOvLap,100);
USBDevice->BulkOutEndPt->FinishDataXfer(buffer, length, &outOvLap,outContext);
USBDevice->BulkInEndPt->FinishDataXfer(inBuf, length, &inOvLap,inContext);
CloseHandle(outOvLap.hEvent);
CloseHandle(inOvLap.hEvent);

5.2

CCyBulkEndPoint( )
CCyBulkEndPoint::CCyBulkEndPoint ( void)

Previous Top Next

Description
This is the default constructor for the CCyBulkEndPoint class.
The resulting instance has most of it's member variables initialized to zero. The two exceptions are
hDevice, which gets set to INVALID_HANDLE_VALUE and TimeOut which is set to 10,000 (10
seconds).

2011 Cypress Semiconductor

CCyBulkEndPoint

5.3

11

CCyBulkEndPoint( )
CCyBulkEndPoint::CCyBulkEndPoint (HANDLE
h, PUSB_ENDPOINT_DESCRIPTOR
pEndPtDescriptor)

Previous Top Next

Description
This constructor creates a legitimate CCyBulkEndPoint object through which bulk transactions can be
performed on the endpoint.
The constructor is called by the library, itself, in the process of performing the Open( ) method of the
CCyUSBDevice.
You should never need to invoke this constructor. Instead, you should use the CCyBulkEndPoint objects
created for you by the CCyUSBDevice class and accessed via its EndPoints,BulkInEndPt and
BulkOutEndPt members.

CCyControlEndPoint
CCyControlEndPoint Class

Previous Top Next

Header
CyUSB.h
Description
CCyControlEndPoint is a subclass of the CCyUSBEndPoint abstract class.
Instances of this class can be used to perform control transfers to the device.
Control transfers require 6 parameters that are not needed for bulk, isoc, or interrupt transfers. These
are:
Target
ReqType
Direction
ReqCode
Value
Index

All USB devices have at least one Control endpoint, endpoint zero. Whenever an instance of
CCyUSBDevice successfully performs its Open( ) function, an instance of CCyControlEndPoint called
ControlEndPt is created. Normally, you will use this ControlEndPt member of CCyUSBDevice to perform
all your Control endpoint data transfers.

2011 Cypress Semiconductor

12

Cypress CyAPI Programmer's Reference

Example
CCyUSBDevice *USBDevice = new
CCyUSBDevice(NULL);

//

Just for typing efficiency

CCyControlEndPoint
>ControlEndPt;

ept->Target
ept->ReqType
ept->Direction
ept->ReqCode
ept->Value
ept->Index

=
=
=
=
=
=

*ept = USBDevice-

TGT_DEVICE;
REQ_VENDOR;
DIR_TO_DEVICE;
0x05;
1;
0;

unsigned char buf[512];


ZeroMemory(buf, 512);
LONG buflen = 512;
ept->XferData(buf,

6.1

buflen);

BeginDataXfer( )
PUCHAR CCyControlEndPoint::BeginDataXfer (
PCHAR buf, LONG len, OVERLAPPED *ov)

Previous Top Next

Description
BeginDataXfer is an advanced method for performing asynchronous IO.
This method sets-up all the parameters for a data transfer, initiates the transfer, and immediately
returns, not waiting for the transfer to complete.
BeginDataXfer allocates a complex data structure and returns a pointer to that structure. FinishDataXfer
de-allocates the the structure. Therefore, it is imperative that each BeginDataXfer call have exactly one
matching FinishDataXfer call.
You will usually want to use the synchronous XferData method rather than the asynchronous
BeginDataXfer/WaitForXfer/FinishDataXfer approach.
Control transfers require 6 parameters that are not needed for bulk, isoc, or interrupt transfers. These
are:
Target
ReqType
Direction
ReqCode
Value

2011 Cypress Semiconductor

CCyControlEndPoint

13

Index

Be sure to set the value of these CCyControlEndPoint members before invoking the BeginDataXfer or
XferData methods.

Example
CCyUSBDevice

*USBDevice = new

CCyUSBDevice(NULL);

// Just for typing efficiency


CCyControlEndPoint *ept = USBDevice->ControlEndPt;
OVERLAPPED OvLap;
OvLap.hEvent = CreateEvent(NULL, false, false, L"CYUSB_CTL");
unsigned char buffer[128];
LONG length
= 128;
ept->Target
= TGT_DEVICE;
ept->ReqType
= REQ_VENDOR;
ept->Direction = DIR_TO_DEVICE;
ept->ReqCode
= 0x05;
ept->Value
= 1;
ept->Index
= 0;
PUCHAR Context = ept->BeginDataXfer(buffer, length, &OvLap);
ept->WaitForXfer(&OvLap,100);
ept->FinishDataXfer(buffer, length, &OvLap,Context);
CloseHandle(OvLap.hEvent);

6.2

CCyControlEndPoint( )
CCyControlEndPoint::CCyControlEndPoint(void)
Description
This is the default contstructor for the CCyControlEndPoint class.
It sets the class' data members to:
Target
ReqType
Direction
ReqCoe
Value
Index

=
=
=
=
=
=

TGT_DEVICE
REQ_VENDOR
DIR_TO_DEVICE
0
0
0

2011 Cypress Semiconductor

Previous Top Next

14

6.3

Cypress CyAPI Programmer's Reference

CCyControlEndPoint( )
CCyControlEndPoint::CCyControlEndPoint(
HANDLE h, PUSB_ENDPOINT_DESCRIPTOR
pEndPtDescriptor)

Previous Top Next

Description
This is the primary contstructor for the CCyControlEndPoint class.
It sets the class' data members to:
Target
ReqType
Direction
ReqCoe
Value
Index

6.4

=
=
=
=
=
=

TGT_DEVICE
REQ_VENDOR
DIR_TO_DEVICE
0
0
0

Direction
CTL_XFER_DIR_TYPE CCyControlEndPoint::
Direction

Previous Top Next

Description
Direction is one of the essential parameters for a Control transfer and a data member of the
CCyControlEndPoint class.
Legitimate values for the Direction member are DIR_TO_DEVICE and DIR_FROM_DEVICE.
Unlike Bulk, Interrupt and ISOC endpoints, which are uni-directional (either IN or OUT), the Control
endpoint is bi-directional. It can be used to send data to the device or read data from the device. So, the
direction of the transaction is one of the fundamental parameters required for each Control transfer.
Direction is automatically set to DIR_TO_DEVICE by the Write( ) method. It is automatically set to
DIR_FROM_DEVICE by the Read( ) method.

Example
CCyUSBDevice *USBDevice

= new

CCyUSBDevice(NULL);

// Just for typing efficiency


CCyControlEndPoint *ept = USBDevice->ControlEndPt;
ept->Target
ept->ReqType
ept->Direction
ept->ReqCode

=
=
=
=

TGT_DEVICE;
REQ_VENDOR;
DIR_TO_DEVICE;
0x05;

2011 Cypress Semiconductor

CCyControlEndPoint

ept->Value
ept->Index

15

= 1;
= 0;

unsigned char buf[512];


ZeroMemory(buf, 512);
LONG buflen = 512;
ept->XferData(buf, buflen);

6.5

Index
WORD CCyControlEndPoint::Index

Previous Top Next

Description
Index is one of the essential parameters for a Control transfer and a data member of the
CCyControlEndPoint class.
Index values typically depend on the specific ReqCode that is being sent in the Control transfer.
Example
CCyUSBDevice *USBDevice

= new

CCyUSBDevice(NULL);

// Just for typing efficiency


CCyControlEndPoint *ept = USBDevice->ControlEndPt;
ept->Target
ept->ReqType
ept->Direction
ept->ReqCode
ept->Value
ept->Index

=
=
=
=
=
=

TGT_DEVICE;
REQ_VENDOR;
DIR_TO_DEVICE;
0x05;
1;
0;

unsigned char buf[512];


ZeroMemory(buf, 512);
LONG buflen = 512;
ept->XferData(buf, buflen);

6.6

Read( )
bool CCyControlEndPoint::Read( PCHAR buf,
LONG &len)

Previous Top Next

Description
Read( ) sets the CyControlEndPoint Direction member to DIR_FROM_DEVICE and then calls
CCyUSBEndPoint::XferData( ).
The buf parameter points to a memory buffer where the read bytes will be placed.
2011 Cypress Semiconductor

16

Cypress CyAPI Programmer's Reference

The len parameter tells how many bytes are to be read.


Returns true if the read operation was successful.
Passes-back the actual number of bytes transferred in the len parameter.

Example
CCyUSBDevice

*USBDevice = new

CCyUSBDevice(NULL);

// Just for typing efficiency


CCyControlEndPoint *ept = USBDevice->ControlEndPt;
ept->Target
ept->ReqType
ept->ReqCode
ept->Value
ept->Index

=
=
=
=
=

TGT_DEVICE;
REQ_VENDOR;
0x07;
1;
0;

unsigned char buf[512];


LONG bytesToRead = 64;
ept->Read(buf, bytesToRead);

6.7

ReqCode
UCHAR CCyControlEndPoint::ReqCode

Previous Top Next

Description
ReqCode is one of the essential parameters for a Control transfer and a data member of the
CCyControlEndPoint class.
ReqCode values indicate, to the USB chip, a particular function or command that the chip should
perform. They are usually documented by the USB chip manufacturer.

Example
CCyUSBDevice *USBDevice = new CCyUSBDevice(NULL);
// Just for typing efficiency
CCyControlEndPoint *ept = USBDevice->ControlEndPt;
ept->Target
ept->ReqType
ept->Direction
ept->ReqCode
ept->Value
ept->Index

=
=
=
=
=
=

TGT_DEVICE;
REQ_VENDOR;
DIR_TO_DEVICE;
0x05;
1;
0;

2011 Cypress Semiconductor

CCyControlEndPoint

17

unsigned char buf[512];


ZeroMemory(buf, 512);
LONG buflen = 512;
ept->XferData(buf, buflen);

6.8

ReqType
CTL_XFER_REQ_TYPE CCyControlEndPoint::
ReqType

Previous Top Next

Description
ReqType is one of the essential parameters for a Control transfer and a data member of the
CCyControlEndPoint class.
Legitimate values for the ReqType member are REQ_STD, REQ_CLASS and REQ_VENDOR.

Example
CCyUSBDevice *USBDevice = new CCyUSBDevice(NULL);
// Just for typing efficiency
CCyControlEndPoint *ept = USBDevice->ControlEndPt;
ept->Target
ept->ReqType
ept->Direction
ept->ReqCode
ept->Value
ept->Index

=
=
=
=
=
=

TGT_DEVICE;
REQ_VENDOR;
DIR_TO_DEVICE;
0x05;
1;
0;

unsigned char buf[512];


ZeroMemory(buf, 512);
LONG buflen = 512;
ept->XferData(buf,

6.9

buflen);

Target
CTL_XFER_TGT_TYPE CCyControlEndPoint::
Target

Previous Top Next

Description
Target is one of the essential parameters for a Control transfer and a data member of the
CCyControlEndPoint class.

2011 Cypress Semiconductor

18

Cypress CyAPI Programmer's Reference

Legitimate values for the Target member are TGT_DEVICE, TGT_INTFC, TGT_ENDPT and
TGT_OTHER.

Example
CCyUSBDevice *USBDevice = new

CCyUSBDevice(NULL);

// Just for typing efficiency


CCyControlEndPoint *ept = USBDevice->ControlEndPt;
ept->Target
ept->ReqType
ept->Direction
ept->ReqCode
ept->Value
ept->Index

=
=
=
=
=
=

TGT_DEVICE;
REQ_VENDOR;
DIR_TO_DEVICE;
0x05;
1;
0;

unsigned char buf[512];


ZeroMemory(buf, 512);
LONG buflen = 512;
ept->XferData(buf,

buflen);

6.10 Value
WORD CCyControlEndPoint::Value

Previous Top Next

Description
Value is one of the essential parameters for a Control transfer and a data member of the
CCyControlEndPoint class.
Values typically depend on the specific ReqCode that is being sent in the Control transfer.

Example
CCyUSBDevice *USBDevice = new

CCyUSBDevice(NULL);

// Just for typing efficiency


CCyControlEndPoint *ept = USBDevice->ControlEndPt;
ept->Target
ept->ReqType
ept->Direction
ept->ReqCode
ept->Value
ept->Index

=
=
=
=
=
=

TGT_DEVICE;
REQ_VENDOR;
DIR_TO_DEVICE;
0x05;
1;
0;

unsigned char buf[512];


ZeroMemory(buf, 512);

2011 Cypress Semiconductor

CCyControlEndPoint

19

LONG buflen = 512;


ept->XferData(buf,

buflen);

6.11 Write( )
bool CCyControlEndPoint::Write(PCHAR buf,
LONG &len)

Previous Top Next

Description
Write( ) sets the CyControlEndPoint Direction member to DIR_TO_DEVICE and then calls
CCyUSBEndPoint::XferData( ).
The buf parameter points to a memory buffer where the read bytes will be placed.
The len parameter tells how many bytes are to be read.
Returns true if the write operation was successful.
Passes-back the actual number of bytes transferred in the len parameter.

Example
CCyUSBDevice

*USBDevice = new CCyUSBDevice(NULL);

// Just for typing efficiency


CCyControlEndPoint *ept = USBDevice->ControlEndPt;
ept->Target
ept->ReqType
ept->ReqCode
ept->Value
ept->Index

=
=
=
=
=

TGT_DEVICE;
REQ_VENDOR;
0x07;
1;
0;

unsigned char buf[512];


ZeroMemory(buf,512);
LONG bytesToSend = 128;
ept->Write(buf,

bytesToSend);

CCyInterruptEndPoint
CCyInterruptEndPoint Class
Header
CyUSB.h

2011 Cypress Semiconductor

Previous Top Next

20

Cypress CyAPI Programmer's Reference

Description
CCyInterruptEndPoint is a subclass of the CCyUSBEndPoint abstract class.
CCyInterruptEndPoint exists to implement a interrupt-specific BeginDataXfer( ) function.
Normally, you should not need to construct any of your own instances of this class. Rather, when an
instance of CyUSBDevice is created, instances of this class are automatically created as members of
that class. Two such members of CyUSBDevice are InterruptInEndPt and InterruptOutEndPt.

Example
// Find interrupt endpoints in the EndPoints[] array
CCyInterruptEndPoint *IntInEpt = NULL;
CCyInterruptEndPoint *IntOutEpt = NULL;
CCyUSBDevice *USBDevice = new CCyUSBDevice(NULL);
int eptCount = USBDevice->EndPointCount();
for (int i=1; i<eptCount; i++) {
bool bIn = ((USBDevice->EndPoints[i]->Address & 0x80)==0x80);
bool bInt = (USBDevice->EndPoints[i]->Attributes == 3);
if (bInt && bIn) IntInEpt = (CCyInterruptEndPoint *) USBDevice->EndPoints[i];
if (bInt && !bIn) IntOutEpt = (CCyInterruptEndPoint *) USBDevice->EndPoints[i];
}

7.1

BeginDataXfer( )
PUCHAR CCyInterruptEndPoint::BeginDataXfer
(PCHAR buf, LONG len, OVERLAPPED *ov)

Previous Top Next

Description
BeginDataXfer is an advanced method for performing asynchronous IO. This method sets-up all the
parameters for a data transfer, initiates the transfer, and immediately returns, not waiting for the transfer
to complete.
BeginDataXfer allocates a complex data structure and returns a pointer to that structure. FinishDataXfer
de-allocates the structure. Therefore, it is imperative that each BeginDataXfer call have exactly one
matching FinishDataXfer call.
You will usually want to use the synchronous XferData method rather than the asynchronous
BeginDataXfer/WaitForXfer/FinishDataXfer approach.

Example
// This example assumes that the device automatically sends back,
// over its bulk-IN endpoint, any bytes that were received over its
// bulk-OUT endpoint (commonly referred to as a loopback function)

2011 Cypress Semiconductor

CCyInterruptEndPoint

CCyUSBDevice

*USBDevice = new

21

CCyUSBDevice(NULL);

OVERLAPPED outOvLap, inOvLap;


outOvLap.hEvent = CreateEvent(NULL, false, false, L"CYUSB_OUT");
inOvLap.hEvent
= CreateEvent(NULL, false, false, L"CYUSB_IN");
unsigned char inBuf[128];
ZeroMemory(inBuf, 128);
unsigned char buffer[128];
LONG length = 128;
// Just to be cute, request the return data before initiating the loopback
UCHAR *inContext = USBDevice->BulkInEndPt->BeginDataXfer(inBuf, length, &inOvLap);
UCHAR *outContext = USBDevice->BulkOutEndPt->BeginDataXfer(buffer, length,
&outOvLap);
USBDevice->BulkOutEndPt->WaitForXfer(&outOvLap,100);
USBDevice->BulkInEndPt->WaitForXfer(&inOvLap,100);
USBDevice->BulkOutEndPt->FinishDataXfer(buffer, length, &outOvLap,outContext);
USBDevice->BulkInEndPt->FinishDataXfer(inBuf, length, &inOvLap,inContext);
CloseHandle(outOvLap.hEvent);
CloseHandle(inOvLap.hEvent);

7.2

CCyInterruptEndPoint( )
CCyInterruptEndPoint::CCyInterruptEndPoint (
void)

Previous Top Next

Description
This is the default constructor for the CCyInterruptEndPoint class.
The resulting instance has most of it's member variables initialized to zero. The two exceptions are
hDevice, which gets set to INVALID_HANDLE_VALUE and TimeOut which is set to 10,000 (10
seconds).

7.3

CCyInterruptEndPoint( )
CCyInterruptEndPoint::CCyInterruptEndPoint(
HANDLE h, PUSB_ENDPOINT_DESCRIPTOR
pEndPtDescriptor)

Previous Top Next

Description
This constructor creates a legitimate CCyInterruptEndPoint object through which interrupt transactions
can be performed on the endpoint.
The constructor may be called by the library, itself, in the process of performing the Open( ) method of
2011 Cypress Semiconductor

22

Cypress CyAPI Programmer's Reference

the CCyUSBDevice.
You should never need to invoke this constructor. Instead, you should use the CCyInterruptEndPoint
objects created for you by the CCyUSBDevice class and accessed via its EndPoints,InterruptInEndPt
and InterruptOutEndPt members.

CCyIsocEndPoint
CCyIsocEndPoint Class

Previous Top Next

Header
CyUSB.h
Description
CCyIsocEndPoint is a subclass of the CCyUSBEndPoint abstract class.
CCyIsocEndPoint exists to implement a isoc-specific BeginDataXfer( ) function.
Normally, you should not need to construct any of your own instances of this class. Rather, when an
instance of CyUSBDevice is created, instances of this class are automatically created as members of
that class. Two such members of CyUSBDevice are IsocInEndPt and IsocOutEndPt.
NOTE: For ISOC transfers, the buffer length and the endpoint's transfers size (see SetXferSize) must be
a multiple of 8 times the endpoint's MaxPktSize.

Example
// Find isoc endpoints in the EndPoints[] array
CCyIsocEndPoint *IsocInEpt = NULL;
CCyIsocEndPoint *IsocOutEpt = NULL;
CCyUSBDevice *USBDevice = new CCyUSBDevice(NULL);
int eptCount = USBDevice->EndPointCount();
for (int i=1; i<eptCount; i++) {
bool bIn = ((USBDevice->EndPoints[i]->Address & 0x80)==0x80);
bool bInt = (USBDevice->EndPoints[i]->Attributes == 1);
if (bInt && bIn) IsocInEpt = (CCyIsocEndPoint *) USBDevice->EndPoints[i];
if (bInt && !bIn) IsocOutEpt = (CCyIsocEndPoint *) USBDevice->EndPoints[i];
}

8.1

BeginDataXfer( )
PUCHAR CCyIsocEndPoint::BeginDataXfer (
PCHAR buf, LONG len, OVERLAPPED *ov)

Previous Top Next

Description

2011 Cypress Semiconductor

CCyIsocEndPoint

23

BeginDataXfer is an advanced method for performing asynchronous IO. This method sets-up all the
parameters for a data transfer, initiates the transfer, and immediately returns, not waiting for the transfer
to complete.
BeginDataXfer allocates a complex data structure and returns a pointer to that structure. FinishDataXfer
de-allocates the structure. Therefore, it is imperative that each BeginDataXfer call have exactly one
matching FinishDataXfer call.
You will usually want to use the synchronous XferData method rather than the asynchronous
BeginDataXfer/WaitForXfer/FinishDataXfer approach.
NOTE: For ISOC transfers, the buffer length and the endpoint's transfers size (see SetXferSize) must be
a multiple of 8 times the endpoint's MaxPktSize.

Example
CCyUSBDevice *USBDevice = new CCyUSBDevice(NULL);
CCyIsocEndPoint *IsoIn = USBDevice->IsocInEndPt;
if (IsoIn) {
int pkts = 16;
LONG bufSize = IsoIn->MaxPktSize * pkts;
PUCHAR
context;
OVERLAPPED
inOvLap;
PUCHAR
buffer
= new UCHAR[bufSize];
CCyIsoPktInfo *isoPktInfos = new CCyIsoPktInfo[pkts];
IsoIn->SetXferSize(bufSize);
inOvLap.hEvent = CreateEvent(NULL, false, false, NULL);
// Begin the data transfer
context = IsoIn->BeginDataXfer(buffer, bufSize, &inOvLap);

// Wait for the xfer to complete.


if (!IsoIn->WaitForXfer(&inOvLap, 1500)) {
IsoIn->Abort();
// Wait for the stalled command to complete
WaitForSingleObject(inOvLap.hEvent,INFINITE);
}
int complete = 0;
int partial = 0;
// Must always call FinishDataXfer to release memory of contexts[i]
if (IsoIn->FinishDataXfer(buffer, bufSize, &inOvLap, context, isoPktInfos)) {
for (int i=0; i< pkts; i++)
if (isoPktInfos[i].Status)
2011 Cypress Semiconductor

24

Cypress CyAPI Programmer's Reference

partial++;
else
complete++;
} else
partial++;
delete buffer;
delete [] isoPktInfos;
}

8.2

CCyIsocEndPoint( )
CCyIsocEndPoint::CCyIsocEndPoint (void)

Previous Top Next

Description
This is the default constructor for the CCyIsocEndPoint class.
The resulting instance has most of it's member variables initialized to zero. The two exceptions are
hDevice, which gets set to INVALID_HANDLE_VALUE and TimeOut which is set to 10,000 (10
seconds).

8.3

CCyIsocEndPoint( )
CCyIsocEndPoint::CCyIsocEndPoint(HANDLE h,
PUSB_ENDPOINT_DESCRIPTOR
pEndPtDescriptor)

Previous Top Next

Description
This constructor creates a legitimate CCyIsocEndPoint object through which isochronous transactions
can be performed on the endpoint.
The constructor is called by the library, itself, in the process of performing the Open( ) method of the
CCyUSBDevice.
You should never need to invoke this constructor. Instead, you should use the CCyIsocEndPoint objects
created for you by the CCyUSBDevice class and accessed via its EndPoints,IsocInEndPt and
IsocOutEndPt members.

8.4

CreatePktInfos( )
CCyIsoPktInfo* CCyIsocEndPoint::
CreatePktInfos(LONG bufLen, int &packets)

Previous Top Next

Description
The CreatePktInfos method is provided for convenience.
2011 Cypress Semiconductor

CCyIsocEndPoint

25

It creates an array of CCyIsoPktInfo objects to be used in calls to XferData and FinishDataXfer for Isoc
endpoints.
CreatePktInfos calculates the number of isoc packets that the driver will use to transfer a data buffer of
bufLen bytes. This number is returned in the packets parameter.
CreatePktInfos also dynamically constructs an array of CCyIsoPktInfo objects and returns a pointer to
the first element of that array. There are packets elements in the array.
After using the array of CCyPktInfo objects you must delete the array of objects yourself by calling
delete [ ].

Example
CCyUSBDevice *USBDevice = new CCyUSBDevice();
CCyIsocEndPoint *IsoIn = USBDevice->IsocInEndPt;
if (IsoIn) {
LONG
bufSize = 4096;
PUCHAR buffer = new UCHAR[bufSize];
CCyIsoPktInfo *isoPktInfos;
int
pkts;
// Allocate the IsoPktInfo objects, and find-out how many were allocated
isoPktInfos = IsoIn->CreatePktInfos(bufSize, pkts);
if (IsoIn->XferData(buffer, bufSize, isoPktInfos)) {
LONG recvdBytes = 0;
for (int i=0; i<pkts; i++)
if (isoPktInfos[i].Status == 0)
recvdBytes += isoPktInfos[i].Length;
}
delete [] buffer;
delete [] isoPktInfos;
}

CCyIsoPktInfo
CCyIsoPktInfo
The CCyIsoPktInfo class is defined as:

2011 Cypress Semiconductor

Previous Top Next

26

Cypress CyAPI Programmer's Reference

class CCyIsoPktInfo {
public:
LONG Status;
LONG Length;
};

When an Isoc transfer is performed, the data buffer passed to XferData or BeginDataXfer is logically
partitioned, by the driver, into multiple packets of data. The driver returns status and length information
for each of those packets.
The XferData and FinishDataXfer methods of CCyUSBEndPoint accept an optional parameter that is a
pointer to an array of CCyIsoPktInfo objects. If this parameter is not NULL, the array will be filled with the
packet status and length information returned by the driver.
If the value returned in the Status field is zero (USBD_STATUS_SUCCESS) all the data in the packet is
valid. Other non-zero values for the Status field can be found in the DDK include file, USBDI.H.
The value returned in the Length field indicates the number of bytes transferred in the packet. In ideal
conditions, this number will be bufferLength / numPackets (which is the maximum capacity of each
packet). However, fewer bytes could be transferred.
An array of CCyIsoPktInfo objects can be easily created buy invoking the CCyUSBIsocEndPoint::
CreatePktInfos method.

Example
CCyUSBDevice *USBDevice = new CCyUSBDevice();
CCyIsocEndPoint *IsoIn = USBDevice->IsocInEndPt;
if (IsoIn) {
LONG
bufSize = 4096;
PUCHAR buffer = new UCHAR[bufSize];
CCyIsoPktInfo *isoPktInfos;
int
pkts;
// Allocate the IsoPktInfo objects, and find-out how many were allocated
isoPktInfos = IsoIn->CreatePktInfos(bufSize, pkts);
if (IsoIn->XferData(buffer, bufSize, isoPktInfos)) {
LONG recvdBytes = 0;
for (int i=0; i<pkts; i++)
if (isoPktInfos[i].Status == 0)
recvdBytes += isoPktInfos[i].Length;
}

2011 Cypress Semiconductor

CCyIsoPktInfo

27

delete [] buffer;
delete [] isoPktInfos;
}

10

CCyUSBDevice
CCyUSBDevice Class

Previous Top Next

Header
CyUSB.h
Description
The CCyUSBDevice class is the primary entry point into the library. All the functionality of the library
should be accessed via an instance of CCyUSBDevice.
Create an instance of CCyUSBDevice using the new keyword.
An instance of CCyUSBDevice is aware of all the USB devices that are attached to the USB driver and
can selectively communicate with any ONE of them by using the Open( ) method.

Example
//

Look for a device having VID = 0547, PID = 1002

CCyUSBDevice *USBDevice
CCyUSBDevice
int
int
int

= new

CCyUSBDevice(NULL);

//

Create an instance of

devices = USBDevice->DeviceCount();
vID, pID;
d = 0;

do
{
USBDevice->Open(d);
// Open automatically calls Close() if necessary
vID = USBDevice->VendorID;
pID = USBDevice->ProductID;
d++;
}
while ((d < devices ) && (vID != 0x0547) && (pID != 0x1002));

10.1 AltIntfc( )
UCHAR CCyUSBDevice::AltIntfc(void)
Description
This function returns the current alternate interface setting for the device.

2011 Cypress Semiconductor

Previous Top Next

28

Cypress CyAPI Programmer's Reference

A return value of 255 (0xFF) indicates that the driver failed to return the current alternate interface
setting.
Call SetAltIntfc( ) to select a different alternate interface (changing the AltSetting).
Call AltIntfcCount( ) to find-out how many alternate interfaces are exposed by the device.

10.2 AltIntfcCount( )
UCHAR CCyUSBDevice::AltIntfcCount(void)

Previous Top Next

Description
This function returns the number of alternate interfaces exposed by the device.
The primary interface (AltSetting == 0) is not counted as an alternate interface.

Example
A return value of 2 means that there are 2 alternate interfaces, in addition to the primary interface.
Legitimate parameter values for calls to SetAltIntfc( ) would then be 0, 1 and 2.

10.3 bHighSpeed
bool CCyUSBDevice::bHighSpeed

Previous Top Next

Description
bHighSpeed indicates whether or not the device is a high speed USB device.
If the USB device represented is a high speed device, bHighSpeed will be true. Otherwise,
bHighSpeed will be false.
This property is only valid on systems running Windows 2K SP4 (and later) or WindowsXP. On earlier
versions of Windows, a high speed device will not be detected as such and bHighSpeed will incorrectly
have a value of false.

Example
CCyUSBDevice

*USBDevice = new

CCyUSBDevice(NULL);

if (USBDevice->bHighSpeed) {
// Do something
}

10.4

BcdDevice
USHORT CCyUSBDevice::BcdDevice

Previous Top Next

2011 Cypress Semiconductor

CCyUSBDevice

29

Description
This data member contains the value of the bcdDevice member from the device's USB descriptor
structure.

10.5 BcdUSB
USHORT CCyUSBDevice::BcdUSB

Previous Top Next

Description
This data member contains the value of the bcdUSB member from the device's USB descriptor
structure.

10.6 BulkInEndPt
CCyBulkEndPoint* CCyUSBDevice::
BulkInEndPt

Previous Top Next

Description
BulkInEndPt is a pointer to an object representing the first BULK IN endpoint enumerated for the
selected interface.
The selected interface might expose additional BULK IN endpoints. To discern this, one would need to
traverse the EndPoints array, checking the Attributes and Address members of each CCyUSBEndPoint
object referenced in the array.
If no BULK IN endpoints were enumerated by the device, BulkInEndPt will be set to NULL.

Example
//

Find a second bulk IN endpoint in the EndPoints[] array

CCyUSBDevice *USBDevice = new

CCyUSBDevice(NULL);

CCyBulkEndPoint *BulkIn2 = NULL;


int eptCount = USBDevice->EndPointCount();
for (int i=1; i<eptCount; i++) {
bool bIn = USBDevice->EndPoints[i]->bIn;
bool bBulk = (USBDevice->EndPoints[i]->Attributes == 2);
if (bBulk && bIn)
BulkIn2 = (CCyBulkEndPoint *) USBDevice->EndPoints[i];
if (BulkIn2 == USBDevice->BulkInEndPt)
BulkIn2 = NULL;
}

2011 Cypress Semiconductor

30

Cypress CyAPI Programmer's Reference

10.7 BulkOutEndPt
CCyBulkEndPoint* CCyUSBDevice::
BulkOutEndPt

Previous Top Next

Description
BulkOutEndPt is a pointer to an object representing the first BULK OUT endpoint enumerated for the
selected interface.
The selected interface might expose additional BULK OUT endpoints. To discern this, one would need to
traverse the EndPoints array, checking the Attributes and Address members of each CCyUSBEndPoint
object referenced in the array.
If no BULK OUT endpoints were enumerated by the device, BulkInEndPt will be set to NULL.

Example
// Find a second bulk OUT endpoint in the EndPoints[] array
CCyUSBDevice *USBDevice = new CCyUSBDevice(NULL);
CCyBulkEndPoint *BulkOut2 = NULL;
int

eptCount = USBDevice->EndPointCount();

for (int i=1; i<eptCount; i++) {


bool bIn = ((USBDevice->EndPoints[i]->Address & 0x80)==0x80);
bool bBulk = (USBDevice->EndPoints[i]->Attributes == 2);
if (bBulk && !bIn) BulkOut2 = (CCyBulkEndPoint *) USBDevice->EndPoints[i];
if (BulkOut2 == USBDevice->BulkOutEndPt) BulkOut2 = NULL;
}

10.8 CCyUSBDevice( )
CCyUSBDevice::CCyUSBDevice(HANDLE hnd =
NULL, GUID guid = CYUSBDRV_GUID)

Previous Top Next

Description
This is the constructor for the CCyUSBDevice class.
It registers the window of hnd to receive USB Plug and Play messages when devices are connected or
disconnected to/from the driver.
The object created serves as the programming interface to the driver whose GUID is passed in the guid
parameter.
The constructor initializes the class members and then calls the Open(0) method to open the first device
that is attached to the driver.
2011 Cypress Semiconductor

CCyUSBDevice

31

Parameters
hnd
hnd is a handle to the application's main window (the window whose WndProc function will process USB
PnP events).
If you are building a console application or don't want your window to receive PnP events, you may omit
the hnd parameter.

guid
guid is the GUID defined in the [Strings] section of the CyUsb.inf file (or your own named copy). If this
parameter is omitted, guid defaults to CYUSBDRV_GUID.

If you don't want to register for PnP events, but you do want to pass your own driver GUID to the
constructor, you will need to pass NULL as the hnd parameter.

Example 1
NOTE: This is not a ready to compile sample code, you can use it as a guideline.
void MainForm::FormCreate(Object *Sender)
{
USBDevice = new CCyUSBDevice(Handle);
CurrentEndPt = USBDevice->ControlEndPt;
}
// Overload MainForm's WndProc method to watch for PnP messages
// Requires #include <dbt.h>
void MainForm::WndProc(Message &Message)
{
if (Message.Msg == WM_DEVICECHANGE) {
// Tracks DBT_DEVICEARRIVAL followed by DBT_DEVNODES_CHANGED
if (Message.WParam == DBT_DEVICEARRIVAL) {
bPnP_Arrival = true;
bPnP_DevNodeChange = false;
}
// Tracks DBT_DEVNODES_CHANGED followed by DBT_DEVICEREMOVECOMPLETE
if (Message.WParam == DBT_DEVNODES_CHANGED) {
bPnP_DevNodeChange = true;
bPnP_Removal = false;
}
if (Message.WParam == DBT_DEVICEREMOVECOMPLETE) {
bPnP_Removal = true;

2011 Cypress Semiconductor

32

Cypress CyAPI Programmer's Reference

PDEV_BROADCAST_HDR bcastHdr = (PDEV_BROADCAST_HDR) Message.LParam;


if (bcastHdr->dbch_devicetype == DBT_DEVTYP_HANDLE) {
PDEV_BROADCAST_HANDLE pDev = (PDEV_BROADCAST_HANDLE) Message.LParam;
if (pDev->dbch_handle == USBDevice->DeviceHandle())
USBDevice->Close();
}
}
// If DBT_DEVNODES_CHANGED followed by DBT_DEVICEREMOVECOMPLETE
if (bPnP_Removal && bPnP_DevNodeChange) {
Sleep(10);
DisplayDevices();
bPnP_Removal = false;
bPnP_DevNodeChange = false;
}
// If DBT_DEVICEARRIVAL followed by DBT_DEVNODES_CHANGED
if (bPnP_DevNodeChange && bPnP_Arrival) {
DisplayDevices();
bPnP_Arrival = false;
bPnP_DevNodeChange = false;
}
}
Form::WndProc(Message);
}

Example 2
In the CyUSB.inf file :
[Strings]
CyUSB.GUID="{BE18AA60-7F6A-11d4-97DD-00010229B959}"
In some application source (.cpp) file:
GUID guid = {0xBE18AA60, 0x7F6A, 0x11D4, 0x97, 0xDD, 0x00, 0x01, 0x02,
0x29, 0xB9, 0x59};
CCyUSBDevice *USBDevice = new CCyUSBDevice(NULL, guid); // Does not register for PnP
events

10.9 ~CCyUSBDevice( )
CCyUSBDevice::~CCyUSBDevice(void)

Previous Top Next

Description
This is the destructor for the CCyUSBDevice class. It calls the Close( ) method in order to properly close
2011 Cypress Semiconductor

CCyUSBDevice

33

any open handle to the driver and to deallocate dynamically allocated members of the class.

10.10 Close( )
void CCyUSBDevice:: Close(void)

Previous Top Next

Description
The Close method closes the handle to the CyUSB driver, if one is open.
Dynamically allocated members of the CCyUSBDevice class are de-allocated. And, all "shortcut"
pointers to elements of the EndPoints array (ControlEndPt, IsocIn/OutEndPt, BulkIn/OutEndPt,
InterruptIn/OutEndPt) are reset to NULL.
Close( ) is called automatically by the ~CCyUSBDevice( ) destructor. It is also called automatically by
the Open( ) method, if a handle to the driver is already open.
Therefor, it is rare that you would ever need to call Close( ) explicitly (though doing so would not cause
any problems).

10.11 Config( )
UCHAR CCyUSBDevice::Config(void)

Previous Top Next

Description
This method returns the current configuration index for the device.
Most devices only expose a single configuration at one time. So, this method should almost always
return zero.

10.12 ConfigAttrib
UCHAR CCyUSBDevice::ConfigAttrib

Previous Top Next

Description
This data member contains the value of the bmAttributes field from the device's current configuration
descriptor.

10.13 ConfigCount( )
UCHAR CCyUSBDevice::ConfigCount( void)

Previous Top Next

Description
This function returns the number of configurations reported by the device in the bNumConfigurations
field of its device descriptor.

2011 Cypress Semiconductor

34

Cypress CyAPI Programmer's Reference

10.14 ConfigValue
UCHAR CCyUSBDevice::ConfigValue

Previous Top Next

Description
This data member contains the value of the bConfigurationValue field from the device's current
configuration descriptor.

10.15 ControlEndPt
CCyControlEndPoint* CCyUSBDevice::
ControlEndPt

Previous Top Next

Description
ControlEndPt points to an object representing the primary Control endpoint, endpoint 0.
ControlEndPt should always be the same value as EndPoints[0].
Before calling the XferData( ) method for ControlEndPt, you should set the object's control properties.

Example
CCyUSBDevice *USBDevice = new CCyUSBDevice(NULL);
// Just for typing efficiency
CCyControlEndPoint *ept = USBDevice->ControlEndPt;
ept->Target
ept->ReqType
ept->Direction
ept->ReqCode
ept->Value
ept->Index

=
=
=
=
=
=

TGT_DEVICE;
REQ_VENDOR;
DIR_TO_DEVICE;
0x05;
1;
0;

unsigned char buf[512];


ZeroMemory(buf, 512);
LONG buflen = 512;
ept->XferData(buf,

buflen);

10.16 DevClass
UCHAR CCyUSBDevice::DevClass

Previous Top Next

Description
This data member contains the value of the bDeviceClass field from the open device's Device
Descriptor.

2011 Cypress Semiconductor

CCyUSBDevice

35

10.17 DeviceCount( )
UCHAR CCyUSBDevice::DeviceCount(void)

Previous Top Next

Description
Returns the number of devices attached to the USB driver.
The value returned can be used to discern legitimate parameters for the Open( ) method.

Example
//

Look for a device having VID = 0547, PID = 1002

CCyUSBDevice *USBDevice = new CCyUSBDevice(NULL);


int devices = USBDevice->DeviceCount( );
int vID, pID;
int d = 0;
do
{
USBDevice->Open(d);
// Open automatically calls Close( ) if necessary
vID = USBDevice->VendorID;
pID = USBDevice->ProductID;
d++;
}
while ((d < devices ) && (vID != 0x0547) && (pID != 0x1002));

10.18 DeviceHandle( )
HANDLE CCyUSBDevice::DeviceHandle(void)

Previous Top Next

Description
Returns the handle to the driver if the CCyUSBDevice is opened to a connected USB device.
If no device is currently open, DeviceHandle( ) returns INVALID_HANDLE_VALUE.

10.19 DeviceName
char CCyUSBDevice::DeviceName
[USB_STRING_MAXLEN]

Previous Top Next

Description
DeviceName is an array of characters containing the product string indicated by the device descriptor's
iProduct field.

10.20 DevProtocol
UCHAR CCyUSBDevice::DevProtocol
Description
2011 Cypress Semiconductor

Previous Top Next

36

Cypress CyAPI Programmer's Reference

This data member contains the value of the bDeviceProtocol field from the open device's Device
Descriptor.

10.21 DevSubClass
UCHAR CCyUSBDevice::DevSubClass

Previous Top Next

Description
This data member contains the value of the bDeviceSubClass field from the open device's Device
Descriptor.

10.22 DriverGUID( )
GUID CCyUSBDevice::DriverGUID(void)

Previous Top Next

Description
Returns the Global Unique IDentifier of the USB driver attached to the CCyUSBDevice.
See also: CCyUSBDevice( )

10.23 DriverVersion
ULONG CCyUSBDevice::DriverVersion

Previous Top Next

Description
DriverVersion contains 4 bytes representing the version of the driver that is attached to the
CCyUSBDevice.

10.24 EndPointCount( )
UCHAR CCyUSBDevice::EndPointCount( void)

Previous Top Next

Description
Returns the number of endpoints exposed by the currently selected interface (or Alternate Interface) plus
1.
The default Control endpoint (endpoint 0) is included in the count.

Example
// Find bulk endpoints in the EndPoints[] array
CCyBulkEndPoint *BulkInEpt = NULL;
CCyBulkEndPoint *BulkOutEpt = NULL;
CCyUSBDevice *USBDevice = new CCyUSBDevice(NULL);
int eptCount = USBDevice->EndPointCount();

2011 Cypress Semiconductor

CCyUSBDevice

37

// Skip EndPoints[0], which we know is the control endpoint


for (int i=1; i<eptCount; i++) {
bool bIn = ((USBDevice->EndPoints[i]->Address & 0x80)==0x80);
bool bBulk = (USBDevice->EndPoints[i]->Attributes == 2);
if (bBulk && bIn) BulkInEpt = (CCyBulkEndPoint *) USBDevice->EndPoints[i];
if (bBulk && !bIn) BulkOutEpt = (CCyBulkEndPoint *) USBDevice->EndPoints[i];
}

10.25 EndPointOf( )
CCyUSBEndPoint* CCyUSBDevice::EndPointOf(
UCHAR addr)

Previous Top Next

Description
Returns a pointer to the endpoint object in the EndPoints array whose Address property is equal to addr
.
Returns NULL If no endpoint with Address = addr is found.

Example
UCHAR eptAddr = 0x82;
CCyUSBDevice *USBDevice = new
CCyUSBDevice(NULL);
CCyUSBEndPoint *EndPt = USBDevice->EndPointOf(eptAddr);
if (EndPt) EndPt->Reset( );

10.26 EndPoints
CCyUSBEndPoint** CCyUSBDevice::EndPoints

Previous Top Next

Description
EndPoints is a list of up to MAX_ENDPTS (16) pointers to endpoint objects.
The objects pointed to represent all the USB endpoints reported for the current USB interface/Alt
interface of the device.
EndPoints[0] always contains a pointer to a CCyControlEndPoint representing the primary Control
Endpoint (endpoint 0) of the device.
Unused entries in EndPoints are set to NULL.
Use EndPointCount( ) to find-out how many entries in EndPoints are valid.
EndPoints is re-initialized each time Open( ) or SetAltIntfc( ) is called.
NOTE:
CCyUSBEndPoint is an abstract class, having a pure virtual

2011 Cypress Semiconductor

38

Cypress CyAPI Programmer's Reference

function BeginDataXfer( ).

The objects pointed to by EndPoints** are, therefore, actually


instances of CCyControlEndPoint,CCyBulkEndPoint,
CCyIsocEndPoint or CCyInterruptEndPoint.
Calling EndPoints[n]->XferData( ) automatically results in the
correct XferData( ) function being invoked.

Example
// Count the bulk-in endpoints
CCyUSBDevice
int

*USBDevice = new

CCyUSBDevice(NULL);

epCnt = USBDevice->EndPointCount();

bool bBulk, bIn;


int blkInCnt = 0;
for

(int

e=0;

e<epCnt; e++) {

bBulk = (USBDevice->EndPoints[e]->Attributes == 2);


bIn
= ((USBDevice->EndPoints[e]->Address & 0x80)==0x80);
if (bBulk && bIn) blkInCnt++;
}

10.27 FriendlyName
char CCyUSBDevice::FriendlyName
[USB_STRING_MAXLEN]

Previous Top Next

Description
FriendlyName is an array of characters containing the device description string for the open device which
was provided by the driver's .inf file.

10.28 GetDeviceDescriptor( )
void CCyUSBDevice::GetDeviceDescriptor(
PUSB_DEVICE_DESCRIPTOR descr)

Previous Top Next

Description
This function copies the current device's device descriptor into the memory pointed to by descr .

10.29 GetConfigDescriptor( )
void CCyUSBDevice::GetConfigDescriptor(
PUSB_CONFIGURATION_DESCRIPTOR descr)

Previous Top Next

2011 Cypress Semiconductor

CCyUSBDevice

39

Description
This function copies the current device's configuration descriptor into the memory pointed to by descr.

10.30 GetIntfcDescriptor( )
void CCyUSBDevice::GetIntfcDescriptor(
PUSB_INTERFACE_DESCRIPTOR descr)

Previous Top Next

Description
This function copies the currently selected interface descriptor into the memory pointed to by descr .

10.31 GetUSBConfig( )
CCyUSBConfig CCyUSBDevice::GetUSBConfig(
int index)

Previous Top Next

Description
This function returns a copy of the CCyUSBConfig object indicated by index .
The index parameter must be less than CCyUSBDevice::ConfigCount( ).

Example
// This code lists all the endpoints reported
//
for all the interfaces reported
//
for all the configurations reported
//
by the device.

CCyUSBDevice

*USBDevice = new

CCyUSBDevice(NULL);

char buf[512];
string s;
for (int c=0; c<USBDevice->ConfigCount(); c++)
{
CCyUSBConfig cfg = USBDevice->GetUSBConfig(c);
sprintf_s(buf,"bLength: 0x%x\n",cfg.bLength); s.append(buf);
sprintf_s(buf,"bDescriptorType: %d\n",cfg.bDescriptorType); s.append(buf);
sprintf_s(buf,"wTotalLength: %d (0x%x)\n",cfg.wTotalLength,cfg.wTotalLength);
s.append(buf);
sprintf_s(buf,"bNumInterfaces: %d\n",cfg.bNumInterfaces); s.append(buf);
sprintf_s(buf,"bConfigurationValue: %d\n",cfg.bConfigurationValue); s.append(buf);
sprintf_s(buf,"iConfiguration: %d\n",cfg.iConfiguration); s.append(buf);
sprintf_s(buf,"bmAttributes: 0x%x\n",cfg.bmAttributes); s.append(buf);
sprintf_s(buf,"MaxPower: %d\n",cfg.MaxPower); s.append(buf);
s.append("**********************************\n");
cout<<s;
s.clear();

2011 Cypress Semiconductor

40

Cypress CyAPI Programmer's Reference

for
(int i=0; i<cfg.AltInterfaces; i++)
{
CCyUSBInterface *ifc = cfg.Interfaces[i];
sprintf_s(buf,"Interface Descriptor:%d\n",(i+1));s.append(buf);
sprintf_s(buf,"--------------------------------\n");s.append(buf);
sprintf_s(buf,"bLength: 0x%x\n",ifc->bLength); s.append(buf);
sprintf_s(buf,"bDescriptorType: %d\n",ifc->bDescriptorType); s.append(buf);
sprintf_s(buf,"bInterfaceNumber: %d\n",ifc->bInterfaceNumber); s.append(buf);
sprintf_s(buf,"bAlternateSetting: %d\n",ifc->bAlternateSetting); s.append(buf);
sprintf_s(buf,"bNumEndpoints: %d\n",ifc->bNumEndpoints); s.append(buf);
sprintf_s(buf,"bInterfaceClass: %d\n",ifc->bInterfaceClass); s.append(buf);
sprintf_s(buf,"**********************************\n");s.append(buf);
cout<<s;
s.clear();
for
(int e=0; e<ifc->bNumEndpoints; e++)
{
CCyUSBEndPoint *ept = ifc->EndPoints[e+1];
sprintf_s(buf,"EndPoint Descriptor:%d\n",(e+1));s.append(buf);
sprintf_s(buf,"--------------------------------\n");s.append(buf);
sprintf_s(buf,"bLength: 0x%x\n",ept->DscLen); s.append(buf);
sprintf_s(buf,"bDescriptorType: %d\n",ept->DscType); s.append(buf);
sprintf_s(buf,"bEndpointAddress: 0x%x\n",ept->Address); s.append(buf);
sprintf_s(buf,"bmAttributes: 0x%x\n",ept->Attributes); s.append(buf);
sprintf_s(buf,"wMaxPacketSize: %d\n",ept->MaxPktSize); s.append(buf);
sprintf_s(buf,"bInterval: %d\n",ept->Interval); s.append(buf);
s.append("**********************************\n");
cout<<s;
s.clear();
}
}
}

10.32 Interface( )
UCHAR CCyUSBDevice::Interface(void)

Previous Top Next

Description
Interface returns the index of the currently selected device interface.
Because Windows always represents different reported interfaces as separate devices, the CyUSB driver
is only shown devices that have a single interface. This causes the Interface( ) method to always return
zero.

10.33 InterruptInEndPt
CCyInterruptEndPoint* CCyUSBDevice::
InterruptInEndPt

Previous Top Next

Description
InterruptInEndPt is a pointer to an object representing the first INTERRUPT IN endpoint enumerated for
the selected interface.
2011 Cypress Semiconductor

CCyUSBDevice

41

The selected interface might expose additional INTERRUPT IN endpoints. To discern this, one would
need to traverse the EndPoints array, checking the Attributes and Address members of each
CCyUSBEndPoint object referenced in the array.
If no INTERRUPT IN endpoints were enumerated by the device, InterruptInEndPt will be set to NULL.

Example
//

Find a second Interrupt IN endpoint in the EndPoints[] array

CCyUSBDevice

*USBDevice = new

CCyUSBDevice(NULL);

CCyInterruptEndPoint *IntIn2 = NULL;


int eptCount = USBDevice->EndPointCount();
for (int i=1; i<eptCount; i++) {
bool bIn = ((USBDevice->EndPoints[i]->Address & 0x80)==0x80);
bool bInt = (USBDevice->EndPoints[i]->Attributes == 3);
if (bInt && bIn) IntIn2 = (CCyInterruptEndPoint *) USBDevice->EndPoints[i];
if (IntIn2 == USBDevice->InterruptInEndPt) IntIn2 = NULL;
}

10.34 InterruptOutEndPt
CCyInterruptEndPoint* CCyUSBDevice::
InterruptOutEndPt

Previous Top Next

Description
InterruptOutEndPt is a pointer to an object representing the first INTERRUPT OUT endpoint enumerated
for the selected interface.
The selected interface might expose additional INTERRUPT OUT endpoints. To discern this, one would
need to traverse the EndPoints array, checking the Attributes and Address members of each
CCyUSBEndPoint object referenced in the array.
If no INTERRUPT OUT endpoints were enumerated by the device, InterruptOutEndPt will be set to NULL.

Example
// Find a second Interrupt OUT endpoint in the EndPoints[] array
CCyUSBDevice *USBDevice = new CCyUSBDevice(NULL);
CCyInterruptEndPoint *IntOut2 = NULL;
int eptCount = USBDevice->EndPointCount();
for (int i=1; i<eptCount; i++) {
bool bIn = ((USBDevice->EndPoints[i]->Address & 0x80)==0x80);
bool bInt = (USBDevice->EndPoints[i]->Attributes == 3);

2011 Cypress Semiconductor

42

Cypress CyAPI Programmer's Reference

if (bInt && !bIn) IntOut2 = (CCyInterruptEndPoint *) USBDevice->EndPoints[i];


if (IntOut2 == USBDevice->InterruptInEndPt) IntOut2 = NULL;
}

10.35 IntfcClass
UCHAR CCyUSBDevice::IntfcClass

Previous Top Next

Description
This data member contains the bInterfaceClass field from the currently selected interface's interface
descriptor.

10.36 IntfcCount( )
UCHAR CCyUSBDevice::IntfcCount(void)

Previous Top Next

Description
Returns the bNumInterfaces field of the current device's configuration descriptor.
This number does not include alternate interfaces that might be part of the current configuration.
Because Windows always represents different reported interfaces as separate devices, the CyUSB driver
is only shown devices that have a single interface. This causes the IntfcCount( ) method to always return
1.

10.37 IntfcProtocol
UCHAR CCyUSBDevice::IntfcProtocol

Previous Top Next

Description
This data member contains the bInterfaceProtocol field from the currently selected interface's interface
descriptor.

10.38 IntfcSubClass
UCHAR CCyUSBDevice::IntfcSubClass

Previous Top Next

Description
This data member contains the bInterfaceSubClass field from the currently selected interface's
interface descriptor.

10.39 IsocInEndPt
CCyIsocEndPoint* CCyUSBDevice::IsocInEndPt

Previous Top Next

Description
IsocInEndPt is a pointer to an object representing the first ISOCHRONOUS IN endpoint enumerated for
2011 Cypress Semiconductor

CCyUSBDevice

43

the selected interface.


The selected interface might expose additional ISOCHRONOUS OUT endpoints. To discern this, one
would need to traverse the EndPoints array, checking the Attributes and Address members of each
CCyUSBEndPoint object referenced in the array.
If no ISOCHRONOUS IN endpoints were enumerated by the device, IsocInEndPt will be set to NULL.

Example
//

Find a second Isoc IN endpoint in the EndPoints[] array

CCyUSBDevice *USBDevice = new CCyUSBDevice(NULL);


CCyIsocEndPoint *IsocIn2 = NULL;
int eptCount = USBDevice->EndPointCount();
for (int i=1; i<eptCount; i++) {
bool bIn = ((USBDevice->EndPoints[i]->Address & 0x80)==0x80);
bool bIsoc = (USBDevice->EndPoints[i]->Attributes == 1);
if (bIsoc && bIn) IsocIn2 = (CCyIsocEndPoint *) USBDevice->EndPoints[i];
if (IsocIn2 == USBDevice->IsocInEndPt) IsocIn2 = NULL;
}

10.40 IsocOutEndPt
CCyIsocEndPoint* CCyUSBDevice::
IsocOutEndPt

Previous Top Next

Description
IsocOutEndPt is a pointer to an object representing the first ISOCHRONOUS OUT endpoint enumerated
for the selected interface.
The selected interface might expose additional ISOCHRONOUS OUT endpoints. To discern this, one
would need to traverse the EndPoints array, checking the Attributes and Address members of each
CCyUSBEndPoint object referenced in the array.
If no ISOCHRONOUS OUT endpoints were enumerated by the device, IsocOutEndPt will be set to NULL.

Example
// Find a second Isoc OUT endpoint in the EndPoints[] array
CCyUSBDevice *USBDevice = new CCyUSBDevice(NULL);
CCyIsocEndPoint *IsocOut2 = NULL;
int eptCount = USBDevice->EndPointCount();
for

(int

i=1; i<eptCount;

2011 Cypress Semiconductor

i++) {

44

Cypress CyAPI Programmer's Reference

bool bIn = ((USBDevice->EndPoints[i]->Address & 0x80)==0x80);


bool bIsoc = (USBDevice->EndPoints[i]->Attributes == 1);
if (bIsoc && !bIn) IsocOut2 = (CCyIsocEndPoint *) USBDevice->EndPoints[i];
if (IsocOut2 == USBDevice->IsocOutEndPt) IsocOut2 = NULL;
}

10.41 IsOpen( )
bool CCyUSBDevice::IsOpen(void)

Previous Top Next

Description
IsOpen( ) returns true if CCyUSBDevice object has a valid handle to a device attached to the CyUSB
driver.
When IsOpen( ) is true , the CCyUSBDevice object is ready to perform IO operations via its EndPoints
members.

10.42 Manufacturer
wchar_t CCyUSBDevice::Manufacturer
[USB_STRING_MAXLEN]

Previous Top Next

Description
Manufacturer is an array of wide characters containing the manufacturer string indicated by the device
descriptor's iManufacturer field.

10.43 MaxPacketSize
UCHAR CCyUSBDevice::MaxPacketSize

Previous Top Next

Description
This data member contains the value of the bMaxPacketSize0 field from the open device's Device
Descriptor structure.

10.44 MaxPower
UCHAR CCyUSBDevice::MaxPower

Previous Top Next

Description
This data member contains the value of the MaxPower field of the open device's selected configuration
descriptor.

10.45 NtStatus
ULONG CCyUSBDevice::NtStatus

Previous Top Next

Description

2011 Cypress Semiconductor

CCyUSBDevice

45

The NtStatus member contains the NTSTATUS returned by the driver for the most recent call to a nonendpoint IO method (SetAltIntfc, Open, Reset, etc.)
More often, you will want to access the NtStatus member of the CCyUSBEndPoint objects.

10.46 Open( )
bool CCyUSBDevice::Open(UCHAR dev)

Previous Top Next

Description
The Open( ) method is one of the main workhorses of the library.
When Open( ) is called, it first checks to see if the CCyUSBDevice object is already opened to one of
the attached devices. If so, it calls Close( ), then proceeds.
Open( ) calls DeviceCount( ) to determine how many devices are attached to the USB driver.
Open( ) creates a valid handle to the device driver, through which all future access is accomplished by
the library methods.
Open( ) calls the driver to gather the device, interface, endpoint and string descriptors.
Open( ) results in the EndPoints array getting properly initialized to pointers of the default interface's
endpoints.
Open( ) initializes the ControlEndPt member to point to an instance of CCyControlEndPoint that
represents the device's endpoint zero.
Open( ) initializes the BulkInEndPt member to point to an instance of CCyBulkEndPoint representing the
first Bulk-IN endpoint that was found. Similarly, the BulkOutEndPt,InterruptInEndPt,InterruptOutEndPt,
IsocInEndPt and IsocOutEndPt members are intialized to point to instances of their respective endpoint
classes if such endpoints were found.
After Open( ) returns true, all the properties and methods of CCyUSBDevice are legitimate.
Open( ) returns false if it is unsuccessful in accomplishing the above activities. However, if Open( ) was
able to obtain a valid handle to the driver, the handle will remain valid even after Open( ) returns false.
(When open fails, it does not automatically call Close( ).) This allows the programmer to call the Reset( )
or ReConnect( ) methods and then call Open( ) again. Sometimes this will allow a device to open
properly.

Example
CCyUSBDevice *USBDevice = new CCyUSBDevice(NULL);
// Attempt to open device #0
if (USBDevice->DeviceCount() && !USBDevice->Open(0)) {
USBDevice->Reset();
USBDevice->Open(0);
}

2011 Cypress Semiconductor

46

Cypress CyAPI Programmer's Reference

if (! USBDevice->IsOpen()) return false;

10.47 PowerState( )
UCHAR CCyUSBDevice::PowerState(void)

Previous Top Next

This method returns the current power state of the device.


A return value of 1 indicates a power state of D0 (Device fully on).
A return value of 4 indicates a power state of D3 (Device fully asleep).

10.48 Product
wchar_t CCyUSBDevice::Product
[USB_STRING_MAXLEN]

Previous Top Next

Description
Product is an array of wide characters containing the product string indicated by the device descriptor's
iProduct field.

10.49 ProductID
USHORT CCyUSBDevice::ProductID

Previous Top Next

Description
This data member contains the value of idProduct from the open device's Device Descriptor structure.

Example
//

Look for a device having VID = 0547, PID = 1002

CCyUSBDevice *USBDevice = new CCyUSBDevice(NULL); // Create an instance of


CCyUSBDevice
int
devices = USBDevice->DeviceCount();
int
vID, pID;
int d = 0;
do {
USBDevice->Open(d);
// Open automatically calls Close() if necessary
vID = USBDevice->VendorID;
pID = USBDevice->ProductID;
d++;
} while ((d < devices ) && (vID != 0x0547) && (pID != 0x1002));

10.50 ReConnect( )
bool CCyUSBDevice::ReConnect(void)

Previous Top Next

2011 Cypress Semiconductor

CCyUSBDevice

47

Description
ReConnect( ) calls the USB device driver to cause the currently open USB device to be logically
disconnected from the USB bus and re-enumerated.

10.51 Reset( )
bool CCyUSBDevice::Reset( void)

Previous Top Next

Description
Reset( ) calls the USB device driver to cause the currently open USB device to be reset.
This call causes the device to return to its initial power-on configuration.

10.52 Resume( )
bool CCyUSBDevice::Resume(void)

Previous Top Next

The Resume( ) method sets the device power state to D0 (Full on).
The method returns true if successful and false if the command failed.

10.53 SerialNumber
wchar_t CCyUSBDevice::SerialNumber
[USB_STRING_MAXLEN]

Previous Top Next

Description
SerialNumber is an array of wide characters containing the serial number string indicated by the device
descriptor's iSerialNumber field.

10.54 SetConfig( )
void CCyUSBDevice::SetConfig( UCHAR cfg)

Previous Top Next

Description
This method will set the current device configuration to cfg, if cfg represents an existing configuration.
In practice, devices only expose a single configuration. So, while this method exists for completeness, it
should probably never be invoked with a cfg value other than 0.

10.55 SetAltIntfc( )
bool CCyUSBDevice::SetAltIntfc(UCHAR alt)
Description
SetAltIntfc( ) calls the driver to set the active interface of the device to alt .
If alt is not a valid alt interface setting, the method does nothing.
2011 Cypress Semiconductor

Previous Top Next

48

Cypress CyAPI Programmer's Reference

Legitimate values for alt are 0 to AltIntfcCount( ).


Calling SetAltIntfc( ) causes all the EndPoints members of CCyUSBDevice to be re-assigned to objects
reflecting the endpoints of the new alternate interface.
Returns true if the alternate interface was successfully set to alt .

Example
CCyUSBDevice *USBDevice

= new

CCyUSBDevice(NULL);

int lastIntfc = USBDevice->AltIntfcCount( );


// Select the last Alternate Interface
USBDevice->SetAltIntfc(lastIntfc);

10.56 StrLangID
USHORT CCyUSBDevice::StrLangID

Previous Top Next

Description
This data member contains the value of bString field from the open device's first String Descriptor.
This value indicates the language of the other string descriptors.
If multiple languages are supported in the string descriptors and English is one of the supported
languages, StrLangID is set to the value for English (0x0409).

10.57 Suspend( )
bool CCyUSBDevice::Suspend(void)

Previous Top Next

The Suspend( ) method sets the device power state to D3 (Full asleep).
The method returns true if successful and false if the command failed.

10.58 USBAddress
UCHAR CCyUSBDevice::USBAddress

Previous Top Next

Description
USBAddress contains the bus address of the currently open USB device.
This is the address value used by the Windows USBDI stack. It is not particularly useful at the
application level.

2011 Cypress Semiconductor

CCyUSBDevice

49

10.59 USBDIVersion
ULONG CCyUSBDevice::USBDIVersion

Previous Top Next

Description
This data member contains the version of the USB Host Controller Driver in BCD format.

10.60 UsbdStatus
ULONG CCyUSBDevice::UsbdStatus

Previous Top Next

Description
The UsbdStatus member contains the USBD_STATUS returned by the driver for the most recent call to
a non-endpoint IO method (SetAltIntfc, Open, Reset, etc.)
More often, you will want to access the UsbdStatus member of the CCyUSBEndPoint objects.

10.61 UsbdStatusString( )
void CCyUSBDevice::UsbdStatusString(ULONG
stat, PCHAR s)

Previous Top Next

Description
The UsbdStatusString method returns a string of characters in s that represents the UsbdStatus error
code contained in stat.
The stat parameter should be the UsbdStatus member or a CCyUSBEndPoint::UsbdStatus member.
The format of the returned string, s , is:
"[state=SSSSSS status=TTTTTTTT]"
where SSSSSS can be "SUCCESS", "PENDING", "STALLED", or "ERROR".
Note:
There is no endpoint equivalent for this method. To
interpret the UsbdStatus member of an endpoint
object, call this method (CCyUSBDevice::
UsbdStatusString) passing the UsbdStatus member
of the endpoint.

10.62 VendorID
USHORT CCyUSBDevice::VendorID

Previous Top Next

Description
This data member contains the value of idVendor from the open device's Device Descriptor structure.

2011 Cypress Semiconductor

50

Cypress CyAPI Programmer's Reference

Example
//

Look for a device having VID = 0547, PID = 1002

CCyUSBDevice *USBDevice
CCyUSBDevice

= new

CCyUSBDevice(NULL); //

Create an instance of

int devices = USBDevice->DeviceCount();


int vID, pID;
int d = 0;
do
{
USBDevice->Open(d);
// Open automatically calls Close() if necessary
vID = USBDevice->VendorID;
pID = USBDevice->ProductID;
d++;
} while ((d < devices) && (vID != 0x0547) && (pID != 0x1002));

11

CCyUSBConfig
CCyUSBConfig Class

Previous Top Next

Header
CyUSB.h
Description
CCyUSBConfig represents a USB device configuration. Such configurations have one or more interfaces
each of which exposes one or more endpoints.
When CCyUSBDevice::Open( ) is called, an instance of CCyUSBConfig is constructed for each
configuration reported by the open device's device descriptor. (Normally, there is just one.)
In the process of construction, CCyUSBConfig creates instances of CCyUSBInterface for each interface
exposed in the device's configuration descriptor. In turn, the CCyUSBInterface class creates instances
of CyUSBEndPoint for each endpoint descriptor contained in the interface descriptor. In this iterative
fashion, the entire structure of Configs->Interfaces->EndPoints gets populated from a single construction
of the CCyUSBConfig class.
The following example code shows how you might use the CCyUSBConfig class in an application.

Example
// This code lists all the endpoints reported
//
for all the interfaces reported
//
for all the configurations reported
//
by the device.

2011 Cypress Semiconductor

CCyUSBConfig

CCyUSBDevice

*USBDevice = new

51

CCyUSBDevice(NULL);

char buf[512];
string s;
for (int c=0; c<USBDevice->ConfigCount(); c++)
{
CCyUSBConfig cfg = USBDevice->GetUSBConfig(c);
sprintf_s(buf,"bLength: 0x%x\n",cfg.bLength); s.append(buf);
sprintf_s(buf,"bDescriptorType: %d\n",cfg.bDescriptorType); s.append(buf);
sprintf_s(buf,"wTotalLength: %d (0x%x)\n",cfg.wTotalLength,cfg.wTotalLength);
s.append(buf);
sprintf_s(buf,"bNumInterfaces: %d\n",cfg.bNumInterfaces); s.append(buf);
sprintf_s(buf,"bConfigurationValue: %d\n",cfg.bConfigurationValue); s.append(buf);
sprintf_s(buf,"iConfiguration: %d\n",cfg.iConfiguration); s.append(buf);
sprintf_s(buf,"bmAttributes: 0x%x\n",cfg.bmAttributes); s.append(buf);
sprintf_s(buf,"MaxPower: %d\n",cfg.MaxPower); s.append(buf);
s.append("**********************************\n");
cout<<s;
s.clear();
for
(int i=0; i<cfg.AltInterfaces; i++)
{
CCyUSBInterface *ifc = cfg.Interfaces[i];
sprintf_s(buf,"Interface Descriptor:%d\n",(i+1));s.append(buf);
sprintf_s(buf,"--------------------------------\n");s.append(buf);
sprintf_s(buf,"bLength: 0x%x\n",ifc->bLength); s.append(buf);
sprintf_s(buf,"bDescriptorType: %d\n",ifc->bDescriptorType); s.append(buf);
sprintf_s(buf,"bInterfaceNumber: %d\n",ifc->bInterfaceNumber); s.append(buf);
sprintf_s(buf,"bAlternateSetting: %d\n",ifc->bAlternateSetting); s.append(buf);
sprintf_s(buf,"bNumEndpoints: %d\n",ifc->bNumEndpoints); s.append(buf);
sprintf_s(buf,"bInterfaceClass: %d\n",ifc->bInterfaceClass); s.append(buf);
sprintf_s(buf,"**********************************\n");s.append(buf);
cout<<s;
s.clear();
for
(int e=0; e<ifc->bNumEndpoints; e++)
{
CCyUSBEndPoint *ept = ifc->EndPoints[e+1];
sprintf_s(buf,"EndPoint Descriptor:%d\n",(e+1));s.append(buf);
sprintf_s(buf,"--------------------------------\n");s.append(buf);
sprintf_s(buf,"bLength: 0x%x\n",ept->DscLen); s.append(buf);
sprintf_s(buf,"bDescriptorType: %d\n",ept->DscType); s.append(buf);
sprintf_s(buf,"bEndpointAddress: 0x%x\n",ept->Address); s.append(buf);
sprintf_s(buf,"bmAttributes: 0x%x\n",ept->Attributes); s.append(buf);
sprintf_s(buf,"wMaxPacketSize: %d\n",ept->MaxPktSize); s.append(buf);
sprintf_s(buf,"bInterval: %d\n",ept->Interval); s.append(buf);
s.append("**********************************\n");
cout<<s;
s.clear();
}
}
}

2011 Cypress Semiconductor

52

Cypress CyAPI Programmer's Reference

11.1 AltInterfaces
CCyUSBConfig::AltInterfaces

Previous Top Next

Description
AltInterfaces contains the total number of interfaces exposed by the configuration (including the default
interface). This value is the number of interface descriptors contained in the current configuration
descriptor.
Becuase the CCyUSBDevice::AltIntfcCount( ) method does not count the primary interface, it returns
CCyUSBConfig::AltInterfaces - 1.

11.2 bConfigurationValue
UCHAR CCyUSBConfig::bConfigurationValue

Previous Top Next

Description
bConfigurationValue contains value of the bConfigurationValue field from the selected configuration
descriptor.

11.3 bDescriptorType
UCHAR CCyUSBConfig::bDescriptorType

Previous Top Next

Description
bDescriptorType contains value of the bDescriptorType field from the selected configuration descriptor.

11.4

bLength
UCHAR CCyUSBConfig::bLength

Previous Top Next

Description
bLength contains value of the bLength field from the selected configuration descriptor.

11.5 bmAttributes
UCHAR CCyUSBConfig::bmAttributes

Previous Top Next

Description
bmAttributes contains value of the bmAttributes field from the selected configuration descriptor.

11.6 bNumInterfaces
UCHAR CCyUSBConfig::bNumInterfaces

Previous Top Next

Description

2011 Cypress Semiconductor

CCyUSBConfig

53

bNumInterfaces contains value of the bNumInterfaces field from the selected configuration descriptor.

11.7 CCyUSBConfig( )
CCyUSBConfig::CCyUSBConfig(void)

Previous Top Next

Description
This is the default constructor for the CCyUSBConfig class.
This constructor simply sets all it's data members to zero.

11.8 CCyUSBConfig( )
CCyUSBConfig::CCyUSBConfig(HANDLE handle,
PUSB_CONFIGURATION_DESCRIPTOR
pConfigDescr)

Previous Top Next

Description
This constructor creates a functional CCyUSBConfig object, complete with a populated Interfaces[]
array.
During construction, the pConfigDescr structure is traversed and all interface descriptors are read,
creating CCyUSBInterface objects.
This constructor is called automatically as part of the CCyUSBDevice::Open( ) method. You should
never need to call this constructor yourself.

11.9 CCyUSBConfig( )
CCyUSBConfig::CCyUSBConfig(CCyUSBConfig&
cfg)

Previous Top Next

Description
This is the copy constructor for the CCyUSBConfig class.
This constructor copies all of the simple data members of cfg. Then, it walks through cfg 's list of
CCyUSBInterface objects and makes copies of them, storing pointers to the new interface objects in a
private, internal data array. (This is accomplished by calling the copy constructor for CCyUSBInterface.)
You should usually not call the copy constructor explicitly. Instead, use the GetUSBConfig( ) method of
the CCyUSBDevice class.

Example
CCyUSBDevice *USBDevice = new CCyUSBDevice(NULL);
CCyUSBConfig cfg = USBDevice->GetUSBConfig(0);

2011 Cypress Semiconductor

54

Cypress CyAPI Programmer's Reference

11.10 ~CCyUSBConfig
CCyUSBConfig::~CCyUSBConfig(void)

Previous Top Next

Description
This is the destructor for the CCyUSBConfig class.
The destructor deletes all the dynamically constructed CCyUSBInterface objects that were created
during construction of the object.

11.11 iConfiguration
UCHAR CCyUSBConfig::iConfiguration

Previous Top Next

Description
iConfiguration contains value of the iConfiguration field from the selected configuration descriptor.

11.12 Interfaces
CCyUSBInterface* CCyUSBConfig::Interfaces
[MAX_INTERFACES]

Previous Top Next

Description
Interfaces is an array of pointers to CCyUSBInterface objects. One valid pointer exists in Interfaces[] for
each alternate interface exposed by the configuration (including alt setting 0).
The AltInterfaces member tells how many valid entries are held in Interfaces.
Use CCyUSBDevice::AltIntfcCount( ) and CCyUSBDevice::SetAltIntfc( ) to access a configuration's
alternate interfaces.

Example
// This code lists all the endpoints reported
//
for all the interfaces reported
//
for all the configurations reported
//
by the device.

CCyUSBDevice

*USBDevice = new

CCyUSBDevice(NULL);

char buf[512];
string s;
for (int c=0; c<USBDevice->ConfigCount(); c++)
{
CCyUSBConfig cfg = USBDevice->GetUSBConfig(c);
sprintf_s(buf,"bLength: 0x%x\n",cfg.bLength); s.append(buf);

2011 Cypress Semiconductor

CCyUSBConfig

55

sprintf_s(buf,"bDescriptorType: %d\n",cfg.bDescriptorType); s.append(buf);


sprintf_s(buf,"wTotalLength: %d (0x%x)\n",cfg.wTotalLength,cfg.
wTotalLength); s.append(buf);
sprintf_s(buf,"bNumInterfaces: %d\n",cfg.bNumInterfaces); s.append(buf);
sprintf_s(buf,"bConfigurationValue: %d\n",cfg.bConfigurationValue); s.
append(buf);
sprintf_s(buf,"iConfiguration: %d\n",cfg.iConfiguration); s.append(buf);
sprintf_s(buf,"bmAttributes: 0x%x\n",cfg.bmAttributes); s.append(buf);
sprintf_s(buf,"MaxPower: %d\n",cfg.MaxPower); s.append(buf);
s.append("**********************************\n");
cout<<s;
s.clear();
for
{

(int

i=0; i<cfg.AltInterfaces; i++)

CCyUSBInterface *ifc = cfg.Interfaces[i];


sprintf_s(buf,"Interface Descriptor:%d\n",(i+1));s.append(buf);
sprintf_s(buf,"--------------------------------\n");s.append(buf);
sprintf_s(buf,"bLength: 0x%x\n",ifc->bLength); s.append(buf);
sprintf_s(buf,"bDescriptorType: %d\n",ifc->bDescriptorType); s.
append(buf);
sprintf_s(buf,"bInterfaceNumber: %d\n",ifc->bInterfaceNumber); s.
append(buf);
sprintf_s(buf,"bAlternateSetting: %d\n",ifc->bAlternateSetting); s.
append(buf);
sprintf_s(buf,"bNumEndpoints: %d\n",ifc->bNumEndpoints); s.append
(buf);
sprintf_s(buf,"bInterfaceClass: %d\n",ifc->bInterfaceClass); s.
append(buf);
sprintf_s(buf,"**********************************\n");s.append
(buf);
cout<<s;
s.clear();
for
{

(int

e=0; e<ifc->bNumEndpoints; e++)

CCyUSBEndPoint *ept = ifc->EndPoints[e+1];


sprintf_s(buf,"EndPoint Descriptor:%d\n",(e+1));s.append
(buf);
sprintf_s(buf,"--------------------------------\n");s.append
(buf);
sprintf_s(buf,"bLength: 0x%x\n",ept->DscLen); s.append(buf);
sprintf_s(buf,"bDescriptorType: %d\n",ept->DscType); s.append
(buf);
sprintf_s(buf,"bEndpointAddress: 0x%x\n",ept->Address); s.
append(buf);
sprintf_s(buf,"bmAttributes: 0x%x\n",ept->Attributes); s.
append(buf);
sprintf_s(buf,"wMaxPacketSize: %d\n",ept->MaxPktSize); s.
append(buf);

2011 Cypress Semiconductor

56

Cypress CyAPI Programmer's Reference

sprintf_s(buf,"bInterval: %d\n",ept->Interval); s.append(buf);


s.append("**********************************\n");
cout<<s;
s.clear();
}
}
}

11.13 wTotalLength
USHORT CCyUSBConfig::wTotalLength

Previous Top Next

Description
wTotalLength contains value of the wTotalLength field from the selected configuration descriptor.

12

CCyUSBEndPoint
CCyUSBEndPoint Class

Previous Top Next

Header
CyUSB.h
Description
CCyUSBEndPoint is an abstract class, having a pure virtual method, BeginDataXfer( ). Therefore,
instances of CCyUSBEndPoint cannot be constructed. CCyControlEndPoint,CCyBulkEndPoint,
CCyIsocEndPoint, and CCyInterruptEndPoint are all classes derived from CCyUSBEndPoint.
All USB data traffic is accomplished by using instances of the endpoint classes.
When a CCyUSBDevice is opened, a list of all the EndPoints for the current alt interface is generated.
This list is populated with viable CCyUSBEndPoint objects, instantiated for the appropriate type of
endpoint. Data access is then accomplished via one of these CCyUSBEndPoint objects.

12.1 Abort( )
void CCyUSBEndPoint::Abort(void)

Previous Top Next

Description
Abort sends an IOCTL_ADAPT_ABORT_PIPE command the the USB device, with the endpoint address
as a parameter. This causes an abort of pending IO transactions on the endpoint.

Example
CCyUSBDevice

*USBDevice = new CCyUSBDevice(NULL);

USBDevice->ControlEndPt->Abort();

2011 Cypress Semiconductor

CCyUSBEndPoint

57

12.2 Address
UCHAR CCyUSBEndPoint::Address

Previous Top Next

Description
Address contains the value of the bEndpointAddress field of the endpoint descriptor returned by the
device.
Addresses with the high-order bit set (0x8_) are IN endpoints.
Addresses with the high-order bit cleared (0x0_) are OUT endpoints.
The default control endpoint (ControlEndPt) has Address = 0.

Example
//

Find a second bulk IN endpoint in the EndPoints[] array

CCyUSBDevice

*USBDevice = new

CCyUSBDevice(NULL);

CCyBulkEndPoint *BulkIn2 = NULL;


int eptCount = USBDevice->EndPointCount();
for (int i=1; i<eptCount; i++) {
bool bIn = ((USBDevice->EndPoints[i]->Address & 0x80)==0x80);
bool bBulk = (USBDevice->EndPoints[i]->Attributes == 2);
if (bBulk && bIn) BulkIn2 = (CCyBulkEndPoint *) USBDevice->EndPoints[i];
if (BulkIn2 == USBDevice->BulkInEndPt) BulkIn2 = NULL;
}

12.3 Attributes
UCHAR CCyUSBEndPoint::Attributes

Previous Top Next

Description
Attributes contains the value of the bmAttributes field of the endpoint's descriptor.
The Attributes member indicates the type of endpoint per the following list.
0: Control
1: Isochronous
2: Bulk
3: Interrupt

2011 Cypress Semiconductor

58

Cypress CyAPI Programmer's Reference

Example
//

Find a second bulk IN endpoint in the EndPoints[] array

CCyUSBDevice

*USBDevice = new

CCyUSBDevice(NULL);

CCyBulkEndPoint *BulkIn2 = NULL;


int

eptCount = USBDevice->EndPointCount();

for (int i=1; i<eptCount; i++) {


bool bIn = USBDevice->EndPoints[i]->bIn;
bool bBulk = (USBDevice->EndPoints[i]->Attributes == 2);
if (bBulk && bIn) BulkIn2 = (CCyBulkEndPoint *) USBDevice->EndPoints[i];
if (BulkIn2 == USBDevice->BulkInEndPt) BulkIn2 = NULL;
}

12.4

BeginDataXfer( )
virtual PUCHAR CCyUSBEndPoint::
BeginDataXfer(PCHAR buf, LONG len,
OVERLAPPED *ov) = 0

Previous Top Next

Description
Note that the CCyUSBEndPoint version of this method is a pure virtual function. There is no
implementation body for this function in the CCyUSBEndPoint class. Rather, all the classes derived from
CCyUSBEndPoint provide their own special implementation of this method.
BeginDataXfer is an advanced method for performing asynchronous IO. This method sets-up all the
parameters for a data transfer, initiates the transfer, and immediately returns, not waiting for the transfer
to complete.
BeginDataXfer allocates a complex data structure and returns a pointer to that structure.
FinishDataXfer de-allocates the structure. Therefore, it is imperative that each BeginDataXfer call have
exactly one matching FinishDataXfer call.
You will usually want to use the synchronous XferData method rather than the asynchronous
BeginDataXfer/WaitForXfer/FinishDataXfer approach.

Example
// This example assumes that the device automatically sends back,
// over its bulk-IN endpoint, any bytes that were received over its
// bulk-OUT endpoint (commonly referred to as a loopback function)
CCyUSBDevice

*USBDevice = new

CCyUSBDevice(NULL);

OVERLAPPED outOvLap, inOvLap;

2011 Cypress Semiconductor

CCyUSBEndPoint

outOvLap.hEvent
inOvLap.hEvent

59

= CreateEvent(NULL, false, false, L"CYUSB_OUT");


= CreateEvent(NULL, false, false, L"CYUSB_IN");

unsigned char inBuf[128];


ZeroMemory(inBuf, 128);
unsigned char buffer[128];
LONG length = 128;
// Just to be cute, request the return data before initiating the loopback
UCHAR *inContext = USBDevice->BulkInEndPt->BeginDataXfer(inBuf, length, &inOvLap);
UCHAR *outContext = USBDevice->BulkOutEndPt->BeginDataXfer(buffer, length,
&outOvLap);
USBDevice->BulkOutEndPt->WaitForXfer(&outOvLap,100);
USBDevice->BulkInEndPt->WaitForXfer(&inOvLap,100);
USBDevice->BulkOutEndPt->FinishDataXfer(buffer, length, &outOvLap,outContext);
USBDevice->BulkInEndPt->FinishDataXfer(inBuf, length, &inOvLap,inContext);
CloseHandle(outOvLap.hEvent);
CloseHandle(inOvLap.hEvent);

12.5 bIn
bool CCyUSBEndPoint::bIn

Previous Top Next

Description
bIn indicates whether or not the endpoint is an IN endpoint.
IN endpoints transfer data from the USB device to the Host (PC).
Endpoint addresses with the high-order bit set (0x8_) are IN endpoints. Endpoint addresses with the
high-order bit cleared (0x0_) are OUT endpoints.
bIn is not valid for CCyControlEndPoint objects (such as CCyUSBDevice->ControlEndPt).

Example
//

Find a second bulk IN endpoint in the EndPoints[] array

CCyUSBDevice

*USBDevice = new

CCyUSBDevice(NULL);

CCyBulkEndPoint *BulkIn2 = NULL;


int

eptCount = USBDevice->EndPointCount();

for

(int

i=1; i<eptCount;

2011 Cypress Semiconductor

i++) {

60

Cypress CyAPI Programmer's Reference

bool In = USBDevice->EndPoints[i]->bIn;
bool bBulk = (USBDevice->EndPoints[i]->Attributes == 2);
if (bBulk && In) BulkIn2 = (CCyBulkEndPoint *) USBDevice->EndPoints[i];
if (BulkIn2 == USBDevice->BulkInEndPt) BulkIn2 = NULL;
}

12.6 CCyUSBEndPoint( )
CCyUSBEndPoint::CCyUSBEndPoint(void)

Previous Top Next

Description
This is the default constructor for the CCyUSBEndPoint class.
Because CCyUSBEndPoint is an abstract class, you cannot instantiate an object of CCyUSBEndPoint.
That is, the statement
new

CCyUSBEndPoint( );

would result in a compiler error.


The default constructor initializes most of its data members to zero. It sets the default endpoint Timeout
to 10 seconds. It sets bIn to false, and sets hDevice to INVALID_HANDLE_VALUE.

12.7 CCyUSBEndPoint( )
CCyUSBEndPoint::CCyUSBEndPoint(HANDLE h,
PUSB_ENDPOINT_DESCRIPTOR
pEndPtDescriptor)

Previous Top Next

Description
This is the primary constructor for the CCyUSBEndPoint class.
Because CCyUSBEndPoint is an abstract class, you cannot instantiate an object of CCyUSBEndPoint.
That is, the statement
new

CCyUSBEndPoint(h, pEndPtDesc);

would result in a compiler error.


However, the constructor does get called (automatically) in the process of constructing derived endpoint
classes.
This constructor sets most of its data members to their corresponding fields in the pEndPtDescriptor
structure. It sets the default endpoint Timeout to 10 seconds. It sets its hDevice member to h.

2011 Cypress Semiconductor

CCyUSBEndPoint

61

12.8 CCyUSBEndPoint( )
CCyUSBEndPoint::CCyUSBEndPoint(
CCyUSBEndPoint& ept)

Previous Top Next

Description
This is the copy constructor for the CCyUSBEndPoint class.
This constructor copies all of the simple data members of ept.
Because CCyUSBEndPoint is an abstract class, you cannot invoke this constructor explicitly. Instead,
it gets called as a side effect of invoking the copy constructors for CCyControlEndPoint,
CCyBulkEndPoint,CCyIsocEndPoint, and CCyInterruptEndPoint.

Example
CCyUSBDevice *USBDevice = new
CCyControlEndPoint

CCyUSBDevice(NULL);

*ctlEpt = new CCyControlEndPoint(*USBDevice->ControlEndPt);

12.9 DscLen
UCHAR CCyUSBEndPoint::DscLen

Previous Top Next

Description
DscLen contains the length of the endpoint descriptor as reported in the bLength field of the
USB_ENDPOINT_DESCRIPTOR structure that was passed to the endpoint object's constructor.
(Because the passed descriptor was an endpoint descriptor, this value should always be 0x07.)
This data member exists for completeness and debugging purposes. You should normally never need to
access this data member.

12.10 DscType
UCHAR CCyUSBEndPoint::DscType

Previous Top Next

Description
DscType contains the type of the endpoint descriptor as reported in the bDescriptorType field of the
USB_ENDPOINT_DESCRIPTOR structure that was passed to the endpoint object's constructor.
(Because the passed descriptor was an endpoint descriptor, this value should always be 0x05.)
This data member exists for completeness and debugging purposes. You should normally never need to
access this data member.

2011 Cypress Semiconductor

62

Cypress CyAPI Programmer's Reference

12.11 GetXferSize( )
ULONG CCyUSBEndPoint::GetXferSize(void)

Previous Top Next

Description
Each non-control endpoint has a transfer size that is some multiple of its MaxPacketSize. This transfer
size can be adjusted programmatically.
The transfer size establishes the size of internal buffers used by the USB driver stack for performing data
transfers. Larger values for the transfer size enable data transfers involving fewer transactions. However,
those larger buffers also consume more available memory.
GetXferSize( ) returns the current transfer size setting for the endpoint.

12.12 FinishDataXfer( )
bool CCyUSBEndPoint::FinishDataXfer(PCHAR
buf, LONG &len, OVERLAPPED *ov, PUCHAR
pXmitBuf, CCyIsoPktInfo* pktInfos = NULL)

Previous Top Next

Description
FinishDataXfer is an advanced method for performing asynchronous IO.
FinishDataXfer transfers any received bytes into buf . It sets the len parameter to the actual number of
bytes transferred. Finally, FinishDataXfer frees the memory associated with the pXmitBuf pointer. This
pointer was returned by a previous corresponding call to BeginDataXfer.
The pointer to an OVERLAPPED structure, passed in the ov parameter, should be the same one that
was passed to the corresponding BeginDataXfer method.
The pktInfos parameter is optional and points to an array of CCyIsoPktInfo objects. It should only be
used for Isochronous endpoint transfers.

You will usually want to use the synchronous XferData method rather than the asynchronous
BeginDataXfer/WaitForXfer/FinishDataXfer approach.

Example
// This example assumes that the device automatically sends back,
// over its bulk-IN endpoint, any bytes that were received over its
// bulk-OUT endpoint (commonly referred to as a loopback function)
CCyUSBDevice

*USBDevice = new

CCyUSBDevice(NULL);

OVERLAPPED outOvLap, inOvLap;


outOvLap.hEvent = CreateEvent(NULL, false, false, L"CYUSB_OUT");
inOvLap.hEvent
= CreateEvent(NULL, false, false, L"CYUSB_IN");
unsigned char

inBuf[128];
2011 Cypress Semiconductor

CCyUSBEndPoint

63

ZeroMemory(inBuf, 128);
unsigned char buffer[128];
LONG length = 128;
// Just to be cute, request the return data before initiating the loopback
UCHAR *inContext = USBDevice->BulkInEndPt->BeginDataXfer(inBuf, length, &inOvLap);
UCHAR *outContext = USBDevice->BulkOutEndPt->BeginDataXfer(buffer, length,
&outOvLap);
USBDevice->BulkOutEndPt->WaitForXfer(&outOvLap,100);
USBDevice->BulkInEndPt->WaitForXfer(&inOvLap,100);
USBDevice->BulkOutEndPt->FinishDataXfer(buffer, length, &outOvLap,outContext);
USBDevice->BulkInEndPt->FinishDataXfer(inBuf, length, &inOvLap,inContext);
CloseHandle(outOvLap.hEvent);
CloseHandle(inOvLap.hEvent);

12.13 hDevice
HANDLE CCyUSBEndPoint::hDevice

Previous Top Next

Description
hDevice contains a handle to the USB device driver, through which all the IO is carried-out. The handle
is created by the Open( ) method of a CCyUSBDevice object.
The only reason to access this data member would be to call the device driver explicitly, bypassing the
API library methods. This is not recommended.
You should never call CloseHandle(hDevice) directly. Instead, call the Close( ) method of a
CCyUSBDevice object.
Note that an instance of CCyUSBDevice will contain several CCyUSBEndPoint objects. Each of those
will have the same value for their hDevice member. Also, the endpont's hDevice member will be identical
to its container CCyUSBDevice object's private hDevice member (accessed via the DeviceHandle( )
method).

12.14 Interval
UCHAR CCyUSBEndPoint::Interval

Previous Top Next

Description
Interval contains the value reported in the bInterval field of the USB_ENDPOINT_DESCRIPTOR
structure that was passed to the endpoint object's constructor.
This data member exists for completeness and debugging purposes. You should normally never need to
2011 Cypress Semiconductor

64

Cypress CyAPI Programmer's Reference

access this data member.

12.15 MaxPktSize
UCHAR CCyUSBEndPoint::MaxPktSize

Previous Top Next

Description
MaxPktSize contains the value indicated by the wMaxPacketSize field of the
USB_ENDPOINT_DESCRIPTOR structure that was passed to the endpoint object's constructor.
MaxPktSize is calculated by multiplying the low-order 11 bits of wMaxPacketSize by the value
represented by 1 + the next 2 bits (bits 11 and 12) .
NOTE: For ISOC transfers, the buffer length and the endpoint's transfers size (see SetXferSize) must be
a multiple of 8 times the endpoint's MaxPktSize.
Example
If wMaxPacketSize is 0x1400 (binary = 0001 0100
0000 0000)
MaxPktSize = [100 0000 0000 binary] * [10 binary +
1] = 1024 * 3 = 3072

12.16 NtStatus
ULONG CCyUSBEndPoint::NtStatus

Previous Top Next

Description
NtStatus member contains the error code returned from the last call to the XferData or BeginDataXfer
methods.

12.17 Reset( )
bool CCyUSBEndPoint::Reset(void)

Previous Top Next

Description
The Reset method resets the endpoint, clearing any error or stall conditions on that endpoint.
Pending data transfers are not cancelled by the Reset method.
Call Abort( ) for the endpoint in order force completion of any transfers in-process.

12.18 SetXferSize( )
void CCyUSBEndPoint::SetXferSize(ULONG xfer
)

Previous Top Next

Description
2011 Cypress Semiconductor

CCyUSBEndPoint

65

Each non-control endpoint has a transfer size that is some multiple of its MaxPktSize. This transfer size
can be adjusted programmatically.
The transfer size establishes the size of internal buffers used by the USB driver stack for performing data
transfers. Larger values for the transfer size enable data transfers involving fewer transactions. However,
those larger buffers also consume more available memory.
SetXferSize( ) sets the current transfer size setting for the endpoint. It automatically sets the transfer
size to a multiple of the endpoint's MaxPktSize property that is greater or equal to the requested xfer
size.
Please refer given link for more information set transfer size :http://msdn.microsoft.com/en-us/library/
ff538112.aspx
NOTE: For ISOC transfers, the buffer length and the endpoint's transfers size (see SetXferSize) must be
a multiple of 8 times the endpoint's MaxPktSize.

12.19 TimeOut
ULONG CCyUSBEndPoint::TimeOut

Previous Top Next

Description
TimeOut limits the length of time that a XferData( ) call will wait for the transfer to complete.
The units of TimeOut is milliseconds.
NOTE : For CCyControlEndPoint, the TimeOut is rounded down to the nearest 1000 ms, except for
values between 0 and 1000 which are rounded up to 1000.
Set the TimeOut values to 0xFFFFFFFF(INFINITE), to wait for infinite time on the any transfers(bulk,
Isochronous,Interrupt, and Control).
The TimeOut value 0 for bulk,interrupt,and isochronous transfers does not wait for read/write operation to
complete, it will return immediately.
The TimeOut value 0 for control transfer is rounded up to 1000ms.
The default TimeOut for Bulk,Interrupt, Control, and Isochronous transfers is 10 seconds. User can
override this value depending upon their application needs.
Example
unsigned char buf[128];
LONG length = 128;
CCyUSBDevice *USBDevice = new CCyUSBDevice(NULL);
USBDevice->BulkOutEndPt->TimeOut = 1000; // 1 sec timeout , set INFINITE

(0xFFFFFFFF) to wait forever.


USBDevice->BulkOutEndPt->XferData(buf, length);

2011 Cypress Semiconductor

66

Cypress CyAPI Programmer's Reference

12.20 UsbdStatus
ULONG CCyUSBEndPoint::UsbdStatus

Previous Top Next

Description
UsbdStatus member contains an error code returned from the last call to the XferData or BeginDataXfer
methods.
UsbdStatus can be decoded by passing the value to the CCyUSBDevice::UsbdStatusString( ) method.

12.21 WaitForXfer( )
bool CCyUSBEndPoint::WaitForXfer(
OVERLAPPED *ov, ULONG tOut)

Previous Top Next

Description
This method is used in conjunction with BeginDataXfer and FinishDataXfer to perform asynchronous IO.
The ov parameter points to the OVERLAPPED object that was passed in the preceding BeginDataXfer
call.
tOut limits the time, in milliseconds, that the library will wait for the transaction to complete.
You will usually want to use the synchronous XferData method rather than the asynchronous
BeginDataXfer/WaitForXfer/FinishDataXfer approach.

Example
// This example assumes that the device automatically sends back,
// over its bulk-IN endpoint, any bytes that were received over its
// bulk-OUT endpoint (commonly referred to as a loopback function)
CCyUSBDevice

*USBDevice = new

CCyUSBDevice(NULL);

OVERLAPPED outOvLap, inOvLap;


outOvLap.hEvent = CreateEvent(NULL, false, false, L"CYUSB_OUT");
inOvLap.hEvent
= CreateEvent(NULL, false, false, L"CYUSB_IN");
unsigned char inBuf[128];
ZeroMemory(inBuf, 128);
unsigned char buffer[128];
LONG length = 128;
// Just to be cute, request the return data before initiating the loopback
UCHAR *inContext = USBDevice->BulkInEndPt->BeginDataXfer(inBuf, length, &inOvLap);
UCHAR *outContext = USBDevice->BulkOutEndPt->BeginDataXfer(buffer, length,
&outOvLap);
USBDevice->BulkOutEndPt->WaitForXfer(&outOvLap,100);

2011 Cypress Semiconductor

CCyUSBEndPoint

67

USBDevice->BulkInEndPt->WaitForXfer(&inOvLap,100);
USBDevice->BulkOutEndPt->FinishDataXfer(buffer, length, &outOvLap,outContext);
USBDevice->BulkInEndPt->FinishDataXfer(inBuf, length, &inOvLap,inContext);
CloseHandle(outOvLap.hEvent);
CloseHandle(inOvLap.hEvent);

12.22 XferData( )
bool CCyUSBEndPoint::XferData(PUCHAR buf,
LONG &bufLen, CCyIsoPktInfo* pktInfos)

Previous Top Next

Description
XferData sends or receives len bytes of data from / into buf.
This is the primary IO method of the library for transferring data. Most data transfers should occur by
invoking the XferData method of an instantiated endpoint object.
XferData calls the appropriate BeginDataXfer method for the instantiated class (one of
CCyBulkEndPoint,CCyControlEndPoint,CCyInterrruptEndPoint, or CCyIsocEndPoint). It then waits for
the transaction to complete (or until the endpoint's TimeOut expires), and finally calls the FinishDataXfer
method to complete the transaction. It call Abort() method internally if operation fail.
For all non-control endpoints, the direction of the transfer is implied by the endpoint itself. (Each such
endpoint will either be an IN or an OUT endpoint.)
For control endpoints, the Direction must be specified, along with the other control-specific parameters.
XferData performs synchronous (i.e. blocking) IO operations. It does not return until the transaction
completes or the endpoint's TimeOut has elapsed.
Returns true if the transaction successfully completes before TimeOut has elapsed.
Note that the len parameter is a reference, meaning that the method can modify its value. The number of
bytes actually transferred is passed back in len .
The pktInfos parameter is optional and points to an array of CCyIsoPktInfo objects. It should only be
used for Isochronous endpoint transfers.
NOTE: For ISOC transfers, the buffer length and the endpoint's transfers size (see SetXferSize) must be
a multiple of 8 times the endpoint's MaxPktSize.
Please refere XferData for Isochronous transfer for how to use the XferData for isochronous transfer.
Below sample demonstrate usage of XferData() api for bulk and interrupt transfer.

2011 Cypress Semiconductor

68

Cypress CyAPI Programmer's Reference

Example

CCyUSBDevice *USBDevice = new CCyUSBDevice(NULL);


unsigned char buf[] = "hello
LONG length = 11;

world";

if (USBDevice->BulkOutEndPt)
USBDevice->BulkOutEndPt->XferData(buf, length);

13

CCyUSBInterface
CCyUSBInterface Class

Previous Top Next

Header
CyUSB.h
Description
CCyUSBInterface represents a USB device interface. Such interfaces have one or more endpoints.
When CCyUSBDevice::Open( ) is called, an instance of CCyUSBConfig is constructed for each
configuration reported by the open device's device descriptor. (Normally, there is just one.)
In the process of construction, CCyUSBConfig creates instances of CCyUSBInterface for each interface
exposed in the device's configuration descriptor. In turn, the CCyUSBInterface class creates instances
of CyUSBEndPoint for each endpoint descriptor contained in the interface descriptor. In this iterative
fashion, the entire structure of Configs->Interfaces->EndPoints gets populated from a single construction
of the CCyUSBConfig class.
The below example code shows how you might use the CCyUSBInterface class in an application.

Example
// This code lists all the endpoints reported
//
for all the interfaces reported
//
for all the configurations reported
//
by the device.
CCyUSBDevice

*USBDevice = new

CCyUSBDevice(NULL);

char buf[512];
string s;
for (int c=0; c<USBDevice->ConfigCount(); c++)
{
CCyUSBConfig cfg = USBDevice->GetUSBConfig(c);
sprintf_s(buf,"bLength: 0x%x\n",cfg.bLength); s.append(buf);
sprintf_s(buf,"bDescriptorType: %d\n",cfg.bDescriptorType); s.append(buf);
2011 Cypress Semiconductor

CCyUSBInterface

69

sprintf_s(buf,"wTotalLength: %d (0x%x)\n",cfg.wTotalLength,cfg.wTotalLength);
s.append(buf);
sprintf_s(buf,"bNumInterfaces: %d\n",cfg.bNumInterfaces); s.append(buf);
sprintf_s(buf,"bConfigurationValue: %d\n",cfg.bConfigurationValue); s.append(buf);
sprintf_s(buf,"iConfiguration: %d\n",cfg.iConfiguration); s.append(buf);
sprintf_s(buf,"bmAttributes: 0x%x\n",cfg.bmAttributes); s.append(buf);
sprintf_s(buf,"MaxPower: %d\n",cfg.MaxPower); s.append(buf);
s.append("**********************************\n");
cout<<s;
s.clear();
for
(int i=0; i<cfg.AltInterfaces; i++)
{
CCyUSBInterface *ifc = cfg.Interfaces[i];
sprintf_s(buf,"Interface Descriptor:%d\n",(i+1));s.append(buf);
sprintf_s(buf,"--------------------------------\n");s.append(buf);
sprintf_s(buf,"bLength: 0x%x\n",ifc->bLength); s.append(buf);
sprintf_s(buf,"bDescriptorType: %d\n",ifc->bDescriptorType); s.append(buf);
sprintf_s(buf,"bInterfaceNumber: %d\n",ifc->bInterfaceNumber); s.append(buf);
sprintf_s(buf,"bAlternateSetting: %d\n",ifc->bAlternateSetting); s.append(buf);
sprintf_s(buf,"bNumEndpoints: %d\n",ifc->bNumEndpoints); s.append(buf);
sprintf_s(buf,"bInterfaceClass: %d\n",ifc->bInterfaceClass); s.append(buf);
sprintf_s(buf,"**********************************\n");s.append(buf);
cout<<s;
s.clear();
for
(int e=0; e<ifc->bNumEndpoints; e++)
{
CCyUSBEndPoint *ept = ifc->EndPoints[e+1];
sprintf_s(buf,"EndPoint Descriptor:%d\n",(e+1));s.append(buf);
sprintf_s(buf,"--------------------------------\n");s.append(buf);
sprintf_s(buf,"bLength: 0x%x\n",ept->DscLen); s.append(buf);
sprintf_s(buf,"bDescriptorType: %d\n",ept->DscType); s.append(buf);
sprintf_s(buf,"bEndpointAddress: 0x%x\n",ept->Address); s.append(buf);
sprintf_s(buf,"bmAttributes: 0x%x\n",ept->Attributes); s.append(buf);
sprintf_s(buf,"wMaxPacketSize: %d\n",ept->MaxPktSize); s.append(buf);
sprintf_s(buf,"bInterval: %d\n",ept->Interval); s.append(buf);
s.append("**********************************\n");
cout<<s;
s.clear();
}
}
}

13.1 bAlternateSetting
UCHAR CCyUSBInterface::bAlternateSetting

Previous Top Next

Description
This data member contains the bAlternateSetting field from the currently selected interface's interface
descriptor.
This data member exists for completeness and debugging purposes. You should normally never need to
access this data member.

2011 Cypress Semiconductor

70

Cypress CyAPI Programmer's Reference

13.2 bAltSettings
UCHAR CCyUSBInterface::bAltSettings

Previous Top Next

Description
This data member contains the number of valid alternate interface settings exposed by this interface.
For an interface that exposes a primary interface and two alternate interfaces, this value would be 3.
This data member exists for completeness and debugging purposes. You should normally never need to
access this data member.
See CCyUSBDevice::AltIntfcCount( ).

13.3 bDescriptorType
UCHAR CCyUSBInterface::bDescriptorType

Previous Top Next

Description
This data member contains the bDescriptorType field of the USB_INTERFACE_DESCRIPTOR
structure that was passed to the interface object's constructor. (Because the passed descriptor was an
interface descriptor, this value should always be 0x04.)
This data member exists for completeness and debugging purposes. You should normally never need to
access this data member.

13.4

CCyUSBInterface( )
CCyUSBInterface::CCyUSBInterface:(HANDLE
h, PUSB_INTERFACE_DESCRIPTOR
pIntfcDescriptor)

Previous Top Next

Description
This is the constructor for the CCyUSBInterface class.
It reads bNumEndpoint endpoint descriptors and creates the appropriate type of endpoint object for each
one, saving a pointer to each new endpoint in the class's EndPoints array.

13.5 CCyUSBInterface( )
CCyUSBInterface::CCyUSBInterface:(
CCyUSBInterface& intfc)

Previous Top Next

Description
This is the copy constructor for the CCyUSBInterface class.
This constructor copies all of the simple data members of intfc . It then walks through intfc 's EndPoints
array, making copies of every endpoint referenced there and storing pointers to the new copies in its own

2011 Cypress Semiconductor

CCyUSBInterface

71

EndPoints array.
You should usually not call the copy constructor explicitly. It is called by the copy constructor for
CCyUSBConfig when CCyUSBDevice::GetUSBConfig( ) is called.
The below example shows how you could create a copy of the first interface exposed by a device.

Example
CCyUSBDevice *USBDevice = new CCyUSBDevice(NULL);
CCyUSBConfig cfg = USBDevice->GetUSBConfig(0);
CCyUSBInterface *iface = new CCyUSBInterface(*cfg.Interfaces[0]);

13.6 bInterfaceClass
UCHAR CCyUSBInterface::bInterfaceClass

Previous Top Next

Description
This data member contains the bInterfaceClass field from the currently selected interface's interface
descriptor.
This data member exists for completeness and debugging purposes. You should normally never need to
access this data member.

13.7 bInterfaceNumber
UCHAR CCyUSBInterface::bInterfaceNumber

Previous Top Next

Description
This data member contains the bInterfaceNumber field from the currently selected interface's interface
descriptor.
This data member exists for completeness and debugging purposes. You should normally never need to
access this data member.

13.8 bInterfaceProtocol
UCHAR CCyUSBInterface::bInterfaceProtocol

Previous Top Next

Description
This data member contains the bInterfaceProtocol field from the currently selected interface's interface
descriptor.
This data member exists for completeness and debugging purposes. You should normally never need to
access this data member.

2011 Cypress Semiconductor

72

Cypress CyAPI Programmer's Reference

13.9 bInterfaceSubClass
UCHAR CCyUSBInterface::bInterfaceSubClass

Previous Top Next

Description
This data member contains the bInterfaceSubClass field from the currently selected interface's
interface descriptor.
This data member exists for completeness and debugging purposes. You should normally never need to
access this data member.

13.10 bLength
UCHAR CCyUSBInterface::bLength

Previous Top Next

Description
This data member contains the bLength field from the currently selected interface's interface descriptor.
It indicates the length of the interface descriptor. (Because the descriptor is an interface descriptor, this
value should always be 0x09.)

13.11 bNumEndpoints
UCHAR CCyUSBInterface::bNumEndpoints

Previous Top Next

Description
This data member contains the bNumEndpoints field from the currently selected interface's interface
descriptor. It indicates how many endpoint descriptors are returned for the selected interface.
This data member exists for completeness and debugging purposes. You should normally never need to
access this data member.

13.12 EndPoints
CCyUSBEndPoint* CCyUSBInterfac::EndPoints[
MAX_ENDPTS]

Previous Top Next

Description
This is the key data member of the CCyUSBInterface class. It is an array of pointers to
CCyUSBEndPoint objects that represent the endpoint descriptors returned, by the device, for the
interface.
The CCyUSBDevice::EndPoints member is actually a pointer to the currently selected interface's
EndPoints array.

Example
// This code

lists all the endpoints

reported

2011 Cypress Semiconductor

CCyUSBInterface

//
//
//

73

for
by

all the interfaces reported


for all the configurations reported
the device.

CCyUSBDevice

*USBDevice = new

CCyUSBDevice(NULL);

char buf[512];
string s;
for (int c=0; c<USBDevice->ConfigCount(); c++)
{
CCyUSBConfig cfg = USBDevice->GetUSBConfig(c);
sprintf_s(buf,"bLength: 0x%x\n",cfg.bLength); s.append(buf);
sprintf_s(buf,"bDescriptorType: %d\n",cfg.bDescriptorType); s.append(buf);
sprintf_s(buf,"wTotalLength: %d (0x%x)\n",cfg.wTotalLength,cfg.wTotalLength);
s.append(buf);
sprintf_s(buf,"bNumInterfaces: %d\n",cfg.bNumInterfaces); s.append(buf);
sprintf_s(buf,"bConfigurationValue: %d\n",cfg.bConfigurationValue); s.append(buf);
sprintf_s(buf,"iConfiguration: %d\n",cfg.iConfiguration); s.append(buf);
sprintf_s(buf,"bmAttributes: 0x%x\n",cfg.bmAttributes); s.append(buf);
sprintf_s(buf,"MaxPower: %d\n",cfg.MaxPower); s.append(buf);
s.append("**********************************\n");
cout<<s;
s.clear();
for
(int i=0; i<cfg.AltInterfaces; i++)
{
CCyUSBInterface *ifc = cfg.Interfaces[i];
sprintf_s(buf,"Interface Descriptor:%d\n",(i+1));s.append(buf);
sprintf_s(buf,"--------------------------------\n");s.append(buf);
sprintf_s(buf,"bLength: 0x%x\n",ifc->bLength); s.append(buf);
sprintf_s(buf,"bDescriptorType: %d\n",ifc->bDescriptorType); s.append(buf);
sprintf_s(buf,"bInterfaceNumber: %d\n",ifc->bInterfaceNumber); s.append(buf);
sprintf_s(buf,"bAlternateSetting: %d\n",ifc->bAlternateSetting); s.append(buf);
sprintf_s(buf,"bNumEndpoints: %d\n",ifc->bNumEndpoints); s.append(buf);
sprintf_s(buf,"bInterfaceClass: %d\n",ifc->bInterfaceClass); s.append(buf);
sprintf_s(buf,"**********************************\n");s.append(buf);
cout<<s;
s.clear();
for
(int e=0; e<ifc->bNumEndpoints; e++)
{
CCyUSBEndPoint *ept = ifc->EndPoints[e+1];
sprintf_s(buf,"EndPoint Descriptor:%d\n",(e+1));s.append(buf);
sprintf_s(buf,"--------------------------------\n");s.append(buf);
sprintf_s(buf,"bLength: 0x%x\n",ept->DscLen); s.append(buf);
sprintf_s(buf,"bDescriptorType: %d\n",ept->DscType); s.append(buf);
sprintf_s(buf,"bEndpointAddress: 0x%x\n",ept->Address); s.append(buf);
sprintf_s(buf,"bmAttributes: 0x%x\n",ept->Attributes); s.append(buf);
sprintf_s(buf,"wMaxPacketSize: %d\n",ept->MaxPktSize); s.append(buf);
sprintf_s(buf,"bInterval: %d\n",ept->Interval); s.append(buf);
s.append("**********************************\n");
cout<<s;
s.clear();
}
2011 Cypress Semiconductor

74

Cypress CyAPI Programmer's Reference

}
}

13.13 iInterface
UCHAR CCyUSBInterface::iInterface

Previous Top

Description
This data member contains the iInterface field from the currently selected interface's interface
descriptor.
This data member exists for completeness and debugging purposes. You should normally never need to
access this data member.

2011 Cypress Semiconductor

Index

Index
-DData Transfers
Asynchronous Transfers
58
Synchronous Transfers
67
Descriptors
Configuration 38
Device 38
Endpoint
56
Interface 68
Listing Descriptor Contents
50
Devices
Finding USB Devices
27
Manufacturer 44
Product
46
Serial Number 47

-EEndpoints
37
Bulk Endpoints
30
Control Endpoints
34
Interrupt Endpoints
41
Isochronous Endpoints
43

-IInterfaces
Alternate Interfaces

2011 Cypress Semiconductor

47

75

You might also like