WIXLIB

10. Click on “Terminate” to stop the debug session.3.2Debugging with OpenOCDOpen On-Chip Debugger (OpenOCD) is an open source debugger implementationthat supports a variety of debugger probes. The CY7C65215 Cypress USB Serialpart on the CYUSB3KIT-003 development kit provides a debugger interface thatworks with OpenOCD.A version of OpenOCD binary that supports debugging using the CY7C65215 partis provided with the FX3 SDK, under the OpenOCD folder. This binary is based onthe OpenOCD 0.8.0 release and only supports the CY7C65215 part as a debuginterface.If any other OpenOCD compliant debug probe (such as the Olimex ARM JTAGdebug probe) is being used, replace the OpenOCD binary provided with a versionthat supports the target debug probe. The rest of the instructions are interfaceindependent, and apply to any OpenOCD compliant debug probe.The latest version of OpenOCD sources can be downloaded /openocd/. Pre-compiled binaries forWindows can be obtained egory/4-openocd.Note: When using OpenOCD on Linux or Mac platforms, the libraries that theOpenOCD binary depends on; need to be copied to the system folders. Pleasechange to the FX3 INSTALL PATH /OpenOCD/ platform folder and run thescript.sh script to do this. No specific installation steps are required on Windowsplatforms.The procedure for setting up OpenOCD based JTAG debugging is shown below:1. Select and right-click on the project to be debugged, and select the “DebugAs - Debug Configurations ” option. See Figure 3-1.EZ-USB Suite User Guide, Version 1.3.422

2. In the Debug Configurations popup window, right-click the “GDB OpenOCDdebugging” option and select “New”.Figure 3-8: Creating debug configuration: OpenOCD3. A “ ProjName Debug” configuration will be created. The settings for theconfiguration need to be entered as described in the next steps.EZ-USB Suite User Guide, Version 1.3.423

4. No changes are required under the “Main” tab.Figure 3-9: Creating OpenOCD debug configuration: Main tabEZ-USB Suite User Guide, Version 1.3.424

5. On the “Debugger” tab, browse and select the path to the OpenOCDexecutable, and selecting the OpenOCD configuration file provided with theSDK under “Config options”. Please note that the full path to the config fileneeds to be provided here, and may need to be enclosed in quotes if itincludes spaces. Please note that the {cross prefix} variable must be set toarm-none-eabi- in some cases if the default settings don’t work.Figure 3-10: Creating OpenOCD debug configuration: Debugger tabEZ-USB Suite User Guide, Version 1.3.425

6. On the “Startup” tab, disable the “Enable ARM semihosting” and “Pre-runreset” options using the corresponding checkboxes.Figure 3-11: Creating OpenOCD debug configuration: Startup Tab7. Click on “Apply” to save settings, and then click on “Debug” to startdebugging.8. If a “Confirm Perspective Switch” popup window (as shown below) appears,select “Yes” to switch to the Debug perspective. The “Remember mydecision” checkbox can be ticked to prevent this popup from appearing insubsequent debug sessions. See Figure 3-6.9. Please note that firmware download using the CY7C65215 debug probe is aslow process and can take about 30 to 40 seconds. Wait for the firmwaredownload to be completed before the session is ready for debugging.10. Execution stops at the “main ()” function. Additional breakpoints can beplaced at this stage, and the Resume, Step Into or Step Over actions can beused to run through the code. See Figure 3-7.11.Click on “Terminate” to stop the debug session.EZ-USB Suite User Guide, Version 1.3.426

4CX3 Configuration UtilityThis section provides an introduction to MIPI CSI-2 interface on the CX3 deviceand provides a usage guide for the CX3 Configuration tool available as part of theCypress EZ USB Suite Eclipse based IDE. More details on the CX3 part areavailable on the Cypress website at http://www.cypress.com/cx3/4.1Introduction to the CX3 deviceThe CX3 is a variant of the FX3 device that features an integrated MIPI CSI-2receiver mated to the GPIF as shown in the CX3 Logic block diagram. This deviceprovides the ability to add USB 3.0 connectivity to Image Sensors implementing theMIPI CSI-2 interface.LOGIC BLOCK DIAGRAMJTAGMIPICSI2InputMIPICSI-2InterfaceI2C SCLI2C SDAFixedFunctionGPIF SPIUSB InterfaceMemoryControllerARM926EJ-SSSRXSSRX SSTXSSTX DD I2SFigure 4-1: CX3 Device Block DiagramThe MIPI CSI-2 interface on the CX3 supports 1 to 4 CSI-2 data lanes andRAW8/10/12/14, YUV422, and RGB888/666/565 image formats. It reads imageEZ-USB Suite User Guide, Version 1.3.427

data from the sensor, de-packetizes it and sends it in to the parallel interface of thefixed-function GPIF-II interface on the CX3.As the GPIF-II signals on CX3 are connected internally to the MIPI CSI-2 Interfaceblock, it is not possible make use of the GPIF-II to talk to any external devices. Thecontrol signals on the interface are also fixed, and only the width of the data buscan be selected from the values of 8-bit, 16-bit and 24-bits. CX3 firmwareapplications typically make use of a pre-defined GPIF-II configuration with changesbeing made only to the data bus width and the counter limits used.Support for the MIPI CSI-2 interface is provided through a new firmware libraryadded to the SDK (cyu3mipicsi.a). The APIs provided by the library and the datastructures and enumerations used by this interface are provided through thecyu3mipicsi.h header file.4.2CX3 MIPI CSI-2 interface4.2.1Data LanesThe MIPI CSI-2 interface on the CX3 supports 1 to 4 CSI-2 data lanes eachcapable of transfers of up to 1 Gbps. The number of data lanes to be selected for aCX3 application will depend upon the number of data lanes provided by the ImageSensor and the total required data transfer rate.4.2.2MIPI CSI-2 stream formats supported by the CX3The MIPI CSI-2 interface on the CX3 supports the following stream formats andoutput modes:Table 4-1: Stream formats supported by CX3FormatandModeCX3 Enumeration TypeDescriptionCSI-2DataTypeOutput StreamRAW8CY U3P CSI DF RAW8Bayer format 8-bits perpixel data stream.0x2A8-Bit Output: RAW[7:0]RAW10CY U3P CSI DF RAW10Bayer format 10-bits perpixel data stream.0x2B16-Bit Output: 6’b0, RAW[9:0]RAW12CY U3P CSI DF RAW12Bayer format 12-bits perpixel data stream.0x2C16-Bit Output: 4’b0,RAW[11:0]RAW14CY U3P CSI DF RAW14Bayer format 14-bits perpixel data stream.0x2D16-Bit Output: 2'b0,RAW[13:0]RGB888CY U3P CSI DF RGB888RGB 888 format 24- bitsper pixel data stream.0x2424-Bit Output: R[7:0],G[7:0],B[7:0]RGB666Mode 0CY U3P CSI DF RGB666 0RGB 666 format 24- bitsper pixel data stream.0x2324-Bit Output:2’b0,R[5:0],2’b0,G[5:0], 2’b0,B[5:0]EZ-USB Suite User Guide, Version 1.3.428

FormatandModeCX3 Enumeration TypeDescriptionCSI-2DataTypeOutput StreamRGB666Mode 1CY U3P CSI DF RGB666 1RGB 666 format 24- bitsper pixel data stream.0x2324 Bit Output: 6’b0,R[5:0],G[5:0],B[5:0]RGB565Mode 0CY U3P CSI DF RGB565 0RGB 565 format 24- bitsper pixel data stream.0x2224 Bit ’b0RGB565Mode 1CY U3P CSI DF RGB565 1RGB 565 format 24- bitsper pixel data stream.0x2224 Bit Output:3’b0,R[4:0],2’b0,G[5:0], 3’b0,B[4:0]RGB565Mode 2CY U3P CSI DF RGB565 2RGB 565 format 16-bitsper pixel data stream.0x2216 Bit Output: R[4:0],G[5:0], B[4:0]YUV422 8Bit Mode 0CY U3P CSI DF YUV422 8 0YUV422 format 8-bits perpixel data stream.0x1EYUV422 8Bit Mode 1CY U3P CSI DF YUV422 8 1YUV422 format 8-bits perpixel data stream.0x1EYUV422 8Bit Mode 2CY U3P CSI DF YUV422 8 2YUV422 format 8-bits perpixel data stream.0x1EYUV42210-BitCY U3P CSI DF YUV422 10YUV422 format 10-bitsper pixel data stream.0x1F8 Bit Output: P[7:0]Data Order: U1,Y1,V1,Y2,U3,Y3,.16 Bit Output: P[15:0]Data Order:{U1,Y1},{V1,Y2},{U3,Y3},{V3,Y4}.16 Bit Output: P[15:0]Data Order:{Y1,U1},{Y2,V1},{Y3,U3},{Y4,V3}.16 Bit Output: 6'b0,P[9:0]Data Order:U1,Y1,V1,Y2,U3,Y3,V3,Y4.If the GPIF interface used is larger than the width of the output stream (e.g. if a 24bit GPIF II interface is used for the CY U3P CSI DF YUV422 8 1 type) theupper bits on the GPIF II interface will be padded with 0s.4.2.3MIPI CSI-2 interface clocksThe primary clocks on the MIPI CSI-2 interface of the CX3 are shown in Figure 4-2below.The interface takes a reference clock as its input and generates the requiredclocking using a PLL and multiple clock dividers on the PLL generated clock. Clockconfiguration parameters are a part of the CyU3PMipicsiCfg t structure whichpassed to the CyU3PMipicsiSetIntfParams() API to configure the CSI-2 interface.EZ-USB Suite User Guide, Version 1.3.429

CSI RX LP - HS CLK DIVIDER(2 / 4 / 8)REFCLKPLLCSI RX CLKPLL CLKPARALLEL OUTPUT CLOCK(PCLK) DIVIDER(2 / 4 / 8)PCLKFigure 4-2: CX3 MIPI CSI-2 Interface ClocksA brief description of each of the clocks is provided below:1. Reference Clock (REFCLK)This is the input reference clock provide to the MIPI-CSI interface. This input clockshould be between 6 and 40 MHz.2. PLL Clock (PLL CLK)The PLL CLK is the primary clock on the MIPI CSI-2 interface. The minimum legalvalue for PLL clock is 62.5 MHz and maximum legal value for the PLL is 1 GHz.All other internal/output clocks are derived from this clock.The PLL clock frequency is generated from the Input Reference Clock using thefollowing equation:PLL CLK REFCLK * [(pllFbd 1)/(pllPrd 1) ] /(2 pllFRS)wherepllPrd is the input divider whose range is between 0 and 0x0F.pllFbd is the feedback divider whose range is between 0 and 0x1FF.pllFRS is the frequency range selection parameter which takes the followingvalues:0 if PLL Clock is between 500MHz- 1GHz.1 if PLL Clock is between 250MHz- 500MHz.2 if PLL Clock is between 125MHz- 250MHz.3 if PLL Clock is between 62.5MHz- 125MHz.EZ-USB Suite User Guide, Version 1.3.430

E.g.:If RefClk is 19.2 MHz, pllFbd is 69, pllPrd is 1, and PLL Clock range is in the500MHz-1GHz range (i.e. pllFrs 0),PLL Clock (MHz) 19.2 * [(69 1)/(1 1)]/(2 0) 19.2 * [70/2]/1 672 MHzFor the same values, changing PLL frequency range to 125-250MHz (pllFrs 2)will change the PLL Clock value toPLL Clock (MHz) 19.2 * [(69 1)/(1 1)]/(2 2) 19.2 * [70/2]/4 168 MHz3. CSI RX LP HS Transition ClockThis clock is used for detecting the CSI link LP - HS transition. It is generated bydividing the PLL Clock by a value of 2, 4 or 8.The minimum value for this clock is 10Mhz and maximum value for this clock is125MHz.4. Output Parallel Clock (PCLK)This clock is the PCLK output which drives the fixed-function GPIF interface on theCX3. It is generated by dividing the PLL Clock by a value of 2, 4 or 8.The maximum value for this clock is 100MHz.4.3Configuring the CX3 DeviceThe typical CX3 application is a USB Video Class (UVC) compliant Cameraapplication that streams video or still image data captured by an Image Sensor to ahost PC. Most parts of a CX3 system design are common, with the only variationsbeing in the Image Sensor and data formats chosen.The typical steps involved in UVC implementations using the CX3 device are:1. Configuring the image sensor as required.2. Configuring the MIPI CSI-2 interface on the CX3 device based on the imagesensor settings.3. Defining the USB descriptors for the application based on the image formatsto be supported.4. Implementing the actual image streaming logic using CX3/FX3 APIs.5. Implementing the sensor control operations required to handle requests onthe Video Control interface (e.g. brightness, pan – tilt – zoom etc.)EZ-USB Suite User Guide, Version 1.3.431

The EZ-USB Suite application provides a CX3 Configuration utility that helps insteps 2, 3 and 4. The actual image sensor control (step 1) and the control interfacehandling (step 5) are sensor dependent, and not handled by the tool.4.3.1MIPI CSI-2 ConfigurationThe MIPI CSI-2 interface on CX3 is configured using theCyU3PMipicsiSetIntfParams() API. This API takes an input parameter of typeCyU3PMipicsiCfg t which contains various configurations like output data format,clock dividers and configuration parameters, number of CSI data lanes to use,horizontal resolution etc.The CSI Configuration Utility generates the data required to configure the interfacein the form of C code which can be embedded into the firmware application.4.3.2Defining the USB DescriptorsThe UVC specification defines the format for the USB configuration descriptors forall UVC compliant devices. The size of the configuration descriptor can stretch to200 bytes or more depending on the number and types of video formats andresolutions supported. Putting together the descriptors in a fully spec compliantmanner across all three USB connection speeds (SuperSpeed, Hi-Speed and FullSpeed) is a cumbersome process.The CSI Configuration Utility generates the USB descriptors based on the settingsprovided. The descriptor data is generated in the form of C code which can beembedded into the firmware application.4.3.3Video Streaming LogicThe firmware design and implementation to handle video streaming includeselements such as:1. Defining the buffering requirements for the video stream.2. Setting up the DMA connection from the GPIF-II interface to the USBendpoint3. Handling Video Streaming control requests to negotiate the video format andresolution.4. Managing the actual video data transfer with UVC header addition.The CSI configuration tool generates C header and source files that implement thislogic. These files can be used along with the CSI-2 configuration file and the USBdescriptor file to create the UVC firmware project.The next section describes the usage of the MIPI CSI-2 Configuration tool providedas part of the EZ-USB Suite IDE.EZ-USB Suite User Guide, Version 1.3.432

4.4Using the CSI Configuration Utility4.4.1Creating a new CX3 Configuration ProjectFrom the File menu of the EZ USB Suite IDE, select the New Other option.Figure 4-3: CX3 Configuration File Creation MenuFigure 4-4: CX3 Configuration Project Creator4.4.2Image Sensor Selection and ConfigurationThe first step in configuring the CX3 UVC project is to define the properties of theimage sensor being used in the system. This includes properties like the type ofsensor, still image and video capture support, the format and resolution of theimages etc.Configurations for the Aptina AS0260 and OmniVision OV5640 sensors areprovided as part of the tool, and you can use these directly if these sensors arebeing used. If other sensors are being used, the wizard can be used to input thesensor properties for conversion into the required format.EZ-USB Suite User Guide, Version 1.3.433

4.4.2.1 CX3 Configuration Project CreationThe CX3 Configuration Project Creation Wizard provides three possiblealternatives for configuring the newly created project:1. Create a Configuration with Basic Settings2. Select a Pre-Defined Configuration3. Select an User defined ConfigurationThe steps for configuring the MIPI CSI-2 interface and image sensor using each ofthe three possible options are described in the following sub-sections.4.4.2.1.1 Configuration with Basic Settings1. Click on Create a Configuration with Basic Settings Radio Button andprovide a new name to the project. Click on Finish button to start generatingrelevant configuration data.Figure 4-5: CX3 Configuration Project SelectorEZ-USB Suite User Guide, Version 1.3.434

2. An empty Image Sensor Configuration window with no pre-defined sensorand frame opens up. A new CX3 Project is created under the Eclipse workspaceas well.Figure 4-6: Image Sensor Configuration Stage3. Input the desired sensor configuration and select the appropriate video formatfrom the dropdown list provided in the configuration window.a. A name string can be provided for the sensor.b. The THS-Prepare value represents the duration for which the sensordrives the CSI data lane LP-00 line state before starting the HStransmission. This value can be determined from the image sensordatasheet.c. The THS-Zero value represents the duration for which the sensordrives the HS-0 state before transmitting the sync sequence. Thisvalue can also be determined from the image sensor datasheet.d. The Input Video Format represents the video picture encoding formatsupported by the sensor. This has to be selected from the drop-downlist.e. The Output Video Format represents the data size of each pixel in theimage stream. This has to be selected from the drop-down list.Figure 4-7: Image Sensor ConfigurationEZ-USB Suite User Guide, Version 1.3.435

4. Each Image Sensor may be capable of supporting multiple video resolutionsand frame rates. The Frame Configuration area of the Image Sensorconfiguration wizard can be used to input the supported (desired) frameresolutions and frame rates. The properties to be specified for each frameconfiguration includes:a. A name string to identify the configuration.b. The number of CSI-2 data lanes used.c. The CSI-2 clock frequency used.d. The H-Active value represents the frame width in number of pixels.e. The H-Blanking value represents the horizontal blanking period aftereach line of image data is transferred.f. The V-Active

2 Creating an FX3 Firmware Project This chapter outlines the steps involved in creating a FX3 firmware application, using the GpifToUsb project from the SDK as a reference. 2.1 Starting the EZ-USB Suite IDE Launch the EZ-USB Suite IDE by following the "All Programs - Cypress - Eclipse - EZ USB Suite" path from the Start Menu.