Operating Systems:

Windows 10 x64
Detailed Description:
Cypress USB-Serial Composite Device Driver 3.13.0.59 for Windows 10 64-bit
The driver package provides the installation files for Cypress USB-Serial Composite Device Driver 3.13.0.59 for Windows 10 64-bit system.
If you consider updating this driver package by Driver Genius, all you need to do is clicking the Update button beside this driver update. Driver Genius will install the driver automatically, smoothly and silently.
Moreover, constantly scan driver updates by Driver Genius or enable the Scheduled Scan function in Options- Schedule to make sure that you will not miss a new release.
About USB Driver:
Windows operating systems automatically apply a generic driver that allows users to transfer files using the USB (Universal Serial Bus) port; however, installing the appropriate software can bring about significant changes.
If the proper USB software is installed, systems will benefit from improved compatibility with different devices, numerous fixes regarding USB issues, and various other changes that can increase transfer speed with external storage drives.
Supported Devices:
USB to UART Adapter

• Owandy - Cypress Usb Devices Driver Adapter
• Owandy - Cypress Usb Devices Drivers

The USB host-side drivers are a set of drivers that work with EHCI or XHCI compliant USB host controllers. The drivers are loaded if the role-switch driver enumerates the host role. If your host controller is not specification-compliant, then you can write a custom driver by using USB host controller extension (UCX) programming interface. The device driver communicates with the host controller protocols which in this case is the personal computer system. It will allow for the downloading of codes to the supported hardware component and its subsequent execution. The device driver for the Cypress Generic USB Device is partially responsible for the Plug and Play detection feature.

The USB Device middleware provides a full-speed USB 2.0 Chapter 9 specification -compliant device framework. It uses the USBFS driver from PDL to interface with the hardware. The middleware provides support for Audio, CDC, and HID classes. Also, it allows implementing other class support. The USB Configurator tool makes it easy to construct the USB Device descriptor.

Features:

• USB Full-Speed Device Framework
• The following USB Classes are supported:

The USB Device structure is divided into layers. The implementation is event-driven: the USBFS driver receives interrupts from the hardware and provides callbacks to the USB Device layer which implements them and provides events to the Class layer. A simplified image is shown below.

Include cy_usb_dev.h along with the header for the USB class to be used (cy_usb_dev_hid.h, cy_usb_dev_cdc.h, cy_usb_dev_audio.h) to get access to all the functions and other declarations in this library. If you use ModusToolbox USB Device Configurator, also include cycfg_usbdev.h.

Cypress USB Device middleware can be used in various software environments. Refer to the Supported Software and Tools. The quickest way to get started is using the Code Examples. Cypress Semiconductor continuously extends its portfolio of code examples at Cypress Semiconductor website and at Cypress Semiconductor GitHub.

This quick start guide is for an environment configured to use for development PSoC 6 Peripheral Driver Library(psoc6pdl) included in the project.

To easily run a USB, use the ModusToolbox USBCommDevice or USBM project. The steps below show how to set up a USB Device based on a basic ModusToolbox project (like Hello_World).

The following steps set up a USB device recognized as an standard HID device - USB mouse and moves it from right to the left, and vice-versa.

Note

Some steps contain a corresponding to the figure below number in brackets.

STEP 1: Enable the USB Device middleware.

Launch ModusToolbox Library Manager and enable the USB Device middleware. This step is required only if the ModusToolbox IDE is used. Otherwise, ensure the USB Device Middleware is included in your project.

STEP 2: Generate initialization code.

1. Launch the ModusToolbox Device Configurator Tool and switch to the Peripherals tab (#1.1).
2. Enable the USB personality under Communication and enter Alias (#1.2). We use USBHID in Quick Start Guide
3. Go to the Parameters pane and configure the USB personality: assign the peripheral clock divider (#1.3) for Clock (Bus Reset). Any available free divider can be used.
4. Set Endpoint Mask to 1 to enable data endpoint 1 (#1.4) Enabled data endpoints must match the descriptor tree in the USB Configurator.
5. Switch to the System tab (#2.1).
6. Check the IMO clock is enabled (#2.2). Select Trim with USB (#2.3)
7. Select one of the PLLs, if your device supports more than one. Enable the PLL and set a frequency of 48 MHz (#2.4).
8. Select the CLK_HF3 USB clock (#2.5). Assign the source clock to the CLK_PATH connected to the configured previously PLL (#2.6).
9. Check the FLL clock is enabled (#2.7).
10. Select File->Save to generate initialization code.

STEP 3: Generate USB descriptors.

1. Run the USB Configurator.
2. In the Device Descriptor node, set bDeviceClass - 0x02(#3.1), iProduct - the device name to identify among connected devices. We use 'USB Device Quick Start guide'(#3.2).
3. Remove default Alternate Settings.
4. Add HID Alternate Settings.
5. Add HID Descriptor and select 3-Button Mouse in HID Report (#3.3).
6. Add Endpoint Descriptor and set: direction - IN, Transfer Type - Interrupt, wMaxPacketSize - 3, bInterval - 10(#3.4).
7. Perform File->Save to generate initialization code. If configuration is saved for the first time, choose a name (like design.cyusbdev) and save it to the project root.

STEP 4: Update main.c

1. Include the USB headers to get access to the generated descriptor structures, USB driver, device, and class layers APIs.
   #include 'cy_usb_dev.h'

   #include 'cy_usb_dev_audio.h'

   #include 'cy_usb_dev_hid.h'

   #include 'cycfg_usbdev.h'
2. Declare the USB context global variables:
   /*******************************************************************************

   *******************************************************************************/

   cy_stc_usb_dev_context_t USBHID_devContext;
3. Configure the USB interrupt structures and declare interrupt handlers (refer to the Configure Interrupts section of the USBFS driver in the PDL API Reference).
   /*******************************************************************************

   *******************************************************************************/

   staticvoid USBD_IsrMedium(void);

   {

   .intrPriority = 5U,

   {

   .intrPriority = 6U,

   {

   .intrPriority = 7U,
4. Implement the interrupt handlers:
   /*******************************************************************************

   *******************************************************************************/

   {

   Cy_USBFS_Dev_Drv_Interrupt(USBHID_HW, Cy_USBFS_Dev_Drv_GetInterruptCauseHi(USBHID_HW),

   }

   /*******************************************************************************

   *******************************************************************************/

   {

   Cy_USBFS_Dev_Drv_Interrupt(USBHID_HW, Cy_USBFS_Dev_Drv_GetInterruptCauseMed(USBHID_HW),

   }

   /*******************************************************************************

   *******************************************************************************/

   {

   Cy_USBFS_Dev_Drv_Interrupt(USBHID_HW, Cy_USBFS_Dev_Drv_GetInterruptCauseLo(USBHID_HW),

   }
5. Update the main() function with the USB and interrupt initialization routines:
   init_cycfg_all();

   /* Initialize USB */

   status = Cy_USB_Dev_Init(USBHID_HW, &USBHID_config, &USBHID_context,

   &usb_devices[0], &usb_devConfig, &USBHID_devContext);

   {

   while(1);

   status = Cy_USB_Dev_HID_Init(&usb_hidConfig, &USBHID_hidContext, &USBHID_devContext);

   {

   while(1);

   (void) Cy_SysInt_Init(&USBD_IntrLowConfig, &USBD_IsrLow);

   (void) Cy_SysInt_Init(&USBD_IntrMeduimConfig, &USBD_IsrMedium);

   (void) Cy_SysInt_Init(&USBD_IntrHighConfig, &USBD_IsrHigh);

   /* Enable interrupts */

   NVIC_EnableIRQ((IRQn_Type) USBD_IntrLowConfig.intrSrc);

   NVIC_EnableIRQ((IRQn_Type) USBD_IntrMeduimConfig.intrSrc);

   NVIC_EnableIRQ((IRQn_Type) USBD_IntrHighConfig.intrSrc);

   /* Enable interrupts */

   Cy_USB_Dev_Connect(true, CY_USB_DEV_WAIT_FOREVER, &USBHID_devContext);
6. Example of the routine to move mouse from right to the left, and vice-versa.
   const uint32_t MOUSE_DATA_LEN = 3UL;

   const uint32_t STEPS_NUMBER = 96UL;

   uint8_t counter = 0U;

   /* Mouse packet array: buttons (1st byte), X (2nd byte), Y (3rd byte) */

   mouseData[2U] = 0U; /* No changes in Y - position */

   for(;;)

   /* Move mouse to the right or to the left appropriate number of steps */

   mouseData[CURSOR_X_POS] = moveRight ? CURSOR_STEP : (uint8_t)-CURSOR_STEP;

   /* Define direction of the movement */

   {

   moveRight = !moveRight;

   Cy_USB_Dev_WriteEpBlocking(MOUSE_IN_EP, mouseData, MOUSE_DATA_LEN,

   counter--;

   }

STEP 5: Build and program the device.

Connect the device to the Host PC. On the PC, verify a new USB device was enumerated as a mouse device. The mouse’s cursor shall move left to right and vice-versa.

This section explains how to configure the USB Device for operation.

Configure USBFS driver

The driver and system resources configuration details are provided in the USBFS driver section Configuration Considerations in the PDL API Reference Manual. The provided code snippets expect that driver and system resources configuration is done.

Construct USB Device Descriptors

Run standalone USB Configurator tool to construct the USB Device descriptors. After USB Device descriptors are constructed, save generated source and header files. Add these files to your project. Open header files to get external definitions for:

• USB Device configuration structure cy_stc_usb_dev_config_t instance.
• Array of USB Devices structures cy_stc_usb_dev_device_t.
• CDC and/or HID class configuration structure instances.

These definitions will be required in the configuration steps provided below.

Configure USB Device

To initialize the USB Device middleware, call Cy_USB_Dev_Init function providing:

• The pointer to the USBFS instance.
• The pointer to the filled USBFS driver configuration structure cy_stc_usbfs_dev_drv_config_t.
• The pointer to the allocated USBFS driver context structure cy_stc_usbfs_dev_drv_context_t.
• The pointer to the generated middleware USB Device structure cy_stc_usb_dev_device_t.
• The pointer to the generated middleware USB Device configuration structure cy_stc_usb_dev_config_t.
• The pointer to the allocated middleware USB Device context structure cy_stc_usb_dev_context_t.

Configure USB Classes

The USB Device middleware provides support of Audio, HID, and CDC classes. Each class has own initialization function. This function must be called after Cy_USB_Dev_Init to initialize class data and register it. The class-specific request will be passed to the class handler after registration. Note that the USB Configurator tool generates HID and CDC Class configuration structures that are required class initialization. Find these structure external declaration in the generated header file.

To initialize the Audio Class, call Cy_USB_Dev_Audio_Init function providing:

• The NULL pointer (reserved for possible future use).
• The pointer to the allocated Audio Class context structure cy_stc_usb_dev_audio_context_t.
• The pointer to the allocated USB Device context structure cy_stc_usb_dev_context_t.

To initialize the CDC Class, call Cy_USB_Dev_CDC_Init function providing:

• The pointer to the populated CDC Class configuration structure cy_stc_usb_dev_cdc_config_t.
• The pointer to the allocated CDC Class context structure cy_stc_usb_dev_cdc_context_t.
• The pointer to the allocated USB Device context structure cy_stc_usb_dev_context_t.

To initialize the HID Class, call Cy_USB_Dev_HID_Init function providing:

• The pointer to the populated HID Class configuration structure cy_stc_usb_dev_hid_config_t.
• The pointer to the allocated HID Class context structure cy_stc_usb_dev_hid_context_t.
• The pointer to the allocated USB Device context structure cy_stc_usb_dev_context_t.

Enable USB Device

Finally, enable the USB Device operation calling Cy_USB_Dev_Connect. This function call enables pull-up on D+ to signal USB Device connection on USB Bus. The USB Host detects device connection and starts device enumeration. It requests the device descriptors to define device capabilities and finally sets device configuration for the following operation. The Cy_USB_Dev_Connect provides an argument to block until enumeration completes or exits after the USB Device is enabled.

Note

The interrupts are mandatory for the USB Device operation. Therefore, USBFS interrupts must be enabled in the NVIC and global interrupts must be enabled as well.

The typical use case is that application calls the middleware API interface provided by the USB Device or Class layer to implement application logic. However, some features are provided only by the USBFS driver layer. Therefore, if the application needs them, the driver API interface must be used. The list of these features is provided in the section Driver Features.

USB Configurator

The standalone USB Configurator tool helps construct USB Device descriptors. The USB device descriptors provide to the USB Host complete information about the connected device. The tool output are generated source and header files that contain information about the USB Device: device descriptors plus structures that help access device descriptors. Generated files are mandatory for the middleware operation and must be added to your project. The header file provides access to instances of the USB Device configuration structure cy_stc_usb_dev_config_t and array of the USB Device structures cy_stc_usb_dev_device_t. Both these definitions are required for USB Device configuration. The tool also generates instances of configuration structures required for CDC and HID Class configuration.

A detailed information about USB Descriptors is provided by the USB Specification

The USB Configurator tool provides the User Guide, which can be found in the documentation.

Standard Request Support

The USB Device supports standard requests listed in the table below.

Audio Class

The USB Audio class can be used in a large amount of applications, either Made for iPod (MFI) or general USB Audio based. These applications consist of, but are not limited to, speakers, microphones, headsets, music creation tools (DJ equipment, guitar jacks, etc), and mixers. An additional application for the Audio class is in Musical Instrument Digital Interface (MIDI) applications. This interface uses a digital UART-like interface and allows the information to be sent across to the Host to be used with software applications, such as Apple Garage Band. Various instruments, such as electronic pianos, interface with MIDI.

A detailed description about Audio Class is provided by the USB Implementers Forum (USB-IF) Class Documentation

The Audio Class does not provide support any of Audio v1.0 or v2.0 requests processing and provides only the API interface to register Audio request handlers implemented on the application level. However, USB Configurator supports Audio v1.0 or v2.0 descriptors.

Note

The MIDI Class support is not available in this version.

CDC: Communication Device Class

Common use case for this class in a PSoC design is to replace a legacy serial (RS232) COM port with a USB connection. This allows customers to use legacy serial software while updating the communication interface to something more readily available on today's computers. The type of data that might be streamed across USB can vary depending on the end application. This could be as simple as streaming raw ADC counts to an entire command protocol. Additionally, CDC is extremely useful for debug purposes. Users can easily develop a USB interface that can send and receive information across CDC. On the Host side, GUI applications are widely available to view the data being transmitted, such as TeraTerm, Terminal, or Hyper-Terminal (depending on version of Microsoft Windows).

A detailed description about CDC class is provided by the USB Implementers Forum (USB-IF) Class Documentation

The CDC Class supports requests listed in the table below.

The CDC Class supports notifications listed in the table below.

HID: Human Interface Device

There are many possible use cases for HID depending on the end application. A keyboard/keypad is a common HID application that has been implemented previously with PSoC. Additionally, customers can use PSoC to implement a PC mouse or game controller device. A more generic use case seen is with regards to customers using USB as general-purpose interface between PSoC and the Host, without conforming to specific USAGE such as a Keyboard, Mouse, etc. Instead the user configures the HID descriptor to be a generic device, which allows them to transfer Vendor-Specific information, such as ADC data, button presses, etc., across the HID protocol. This allows customers to perform custom/generic data transfers over USB, without needing to provide an INF or SYS file during enumeration or worry about WHQL certification. All this is accomplished using the HID drivers that are built into all modern operation systems today. This includes Windows, Mac, and Linux.

A detailed description about HID is provided by the USB Implementers Forum (USB-IF) Class Documentation

The HID Class supports requests listed in the table below.

Adding Custom Class

The USB Device middleware provides API interface that allows the user to implement custom class support. The middleware notifies registered class about following events:

• Bus Reset detected ( cy_cb_usb_dev_bus_reset_t ).
• Set Configuration request received ( cy_cb_usb_dev_set_config_t ).
• Set Interface request received ( cy_cb_usb_dev_set_interface_t ).
• Setup packet received ( cy_cb_usb_dev_request_received_t ).
• Data is received in response for current setup packet ( cy_cb_usb_dev_request_cmplt_t ).

To create a new custom Class, follow the steps below:

1. Implement functions to service events (from the list above) required for class operation. Typically, class should implement service of class-specific requests therefore needs to implement functions defined by cy_cb_usb_dev_request_received_t and cy_cb_usb_dev_request_cmplt_t.
2. Initialize instance of cy_stc_usb_dev_class_t structure using implemented service functions. Provide NULL pointer as function pointer if class does not use this event.
3. Allocate instance of cy_stc_usb_dev_class_ll_item_t structure to provide storage for a linked list item of the class.
4. The class might need a context to store class-specific data. If needed, define context type specific for this class and allocate it.
5. To enable class operation, this needs to be registered using Cy_USB_Dev_RegisterClass function after USB Device middleware is initialized.

Any of supported classes can be taken as an example to implement a custom class.

Vendor-Specific Requests Support

The vendor-specific requests are STALLed by USB Device middleware by default. The exception is MS OS String vendor-specific request to retrieve an OS Feature Descriptor (Note that USB device must contain MS OS String descriptor to handle this vendor-specific by middleware). The middleware provides the Cy_USB_Dev_RegisterVendorCallbacks function to register callbacks to handle vendor-specific requests.

Allocate Data Endpoint Buffer

The application allocates buffers for data endpoints to operate. The buffer allocation depends on USBFS driver endpoint buffer access type configuration. It specifies which hardware register set 8-bit or 16-bit is used to access hardware endpoints buffer. The 16-bit access requires that the specific rules for the endpoints buffer allocation must be met (See Hardware Buffer Access section of the USBFS driver for more information).
To make endpoint buffer allocation configuration independent, use the CY_USB_DEV_ALLOC_ENDPOINT_BUFFER macro.

Self-Powered Devices

The USB Device responds to GET_STATUS requests based on the status set with the Cy_USB_Dev_SetPowerStatus function. To set the correct status, Cy_USB_Dev_SetPowerStatus must be called during initialization if USB Device is configured as self-powered. The Cy_USB_Dev_SetPowerStatus must be called any time the device changes status. A self-powered device also requires monitoring VBUS to control pull-up resistors. The pull-up resistor does not supply power to the data line until you call Cy_USB_Dev_Connect. Cy_USB_Dev_Disconnect disconnects the pull-up resistor from the data line. Find information about how to add VBUS monitoring in your application in the USBFS driver section VBUS Detection in the PDL API Reference Manual.

Timeout Function Redefinition

The USB Device middleware provides following blocking functions: Cy_USB_Dev_ReadEpBlocking, Cy_USB_Dev_WriteEpBlocking, and Cy_USB_Dev_Connect (the behavior defined by the blocking parameter of the connect function). The blocking functions parameter timeout defines how many milliseconds to wait before timeout. The SysLib driver function Cy_SysLib_Delay is used to implement a 1 millisecond wait cycle. The middleware provides function Cy_USB_Dev_OverwriteHandleTimeout that allows overriding the wait function implementation. This might be useful when an operation system is used in your application.

Note

The blocking function must be used carefully to not cause application lock-up. The preferred solution is using non-blocking functions.

Driver Features

There are driver features that do not have corresponding an API interface provided in the middleware. However, the application might need these features for USB Device implementation. If there is such a need, the driver functions must be used. These features are listed below:

• Data Endpoint 1 - 8 Completion, SOF received and LPM transfer ACKed events notification.
• Low power support: Suspend / Resume, Remote wakeup signaling.
• Link Power Management (LPM) support.

Find more information in the appropriate section of the USBFS driver documentation provided in the PDL API Reference Manual.

This version of the USB Device Middleware was validated for the compatibility with the following Software and Tools:

The MISRA-C Compliant verification is not performed for Beta release.

Owandy - Cypress Usb Devices Driver Adapter

This section lists the known problems with the USB Device middleware.

For more detail, refer to the following documents:

Owandy - Cypress Usb Devices Drivers

Note

The links to the other software component’s documentation (middleware and PDL) point to GitHub to the software latest available version. To get documentation of the specified version, download from GitHub and unzip the component archive. The documentation is available in the docs folder.