USB30设计资源cypress芯片程序解读.docx

1、USB30设计资源cypress芯片程序解读CYPEESS USB3.0 程序解读解读同步FIFO的一个例子。生产者，消费者首先看DMA的回调函数：typedef void (* CyU3PDmaCallback_t )(CyU3PDmaChannel *handle, /* Handle to the DMA channel. */CyU3PDmaCbType_t type, /* The type of callback notification being generated. */CyU3PDmaCBInput_t *input /* Union that contains data

2、related to the notification.The input parameter will be a pointer to a CyU3PDmaBuffer_tvariable in the cases where the callback type is CY_U3P_DMA_CB_RECV_CPLT or CY_U3P_DMA_CB_PROD_EVENT. */);根据其说明，解读如下：1.对每一个DMA通道，回调函数必须被注册。如果没有注册或者相应的通知事件没有被注册，则回调函数不会被执行。2.回调函数不能被阻塞。即不能用 SLEEP ()之类的函数。如果数据需要处理，必须

3、在回调函数之外。3.在生产者事件中，应用希望尽可能快地处理输入的数据。如果缓冲的处理不能在规定的时间内完成，则输入的可能是陈旧的数据。在自动信号通道中，输入参量指向最新的数据。如果处理延时，生产者 socket 可能复盖部分数据。4.在手动或手动IN通道模式时，输入参量指向第一个缓冲(用于去消费者socket). 如果在第二次调用时，这个缓冲仍没有被处理，输入参量中将是被陈旧的数据。如果数据处理必须在通道中做，CyU3PDmaChannelGetBuffer函数必须被应用，而回调函数必须作为一个通知。而输入指针input 的定义如下：typedef struct CyU3PDmaBuffer_

4、t uint8_t* bufferuint16_tcountuint16_tsizeuint16 tstatus/* Pointer to the buffer */* Byte count of valid data in buffer */* Buffer size */* Buffer status. This is a four bit data field CyU3PDmaBuffer_tCyU3PDmaChannel这个结构中包含 20个左右的参数，其中含回调函数。定义了一个全局变量： CyBool_t gllsApplnActive=CyFalse; 这个变量是一个 BOOL型先

5、设为FALSE.程序然后定义了一个错误处理，我们不处理错误，故是一个死循环语句然后，定义一个debug_init 用串口来显示一些信息。 初始化串口，设波特率只允许发不允许收，另外,采用DMA模式来处理UARTo注意到这个函数：CyU3PDebuglnit(CY_U3P_LPP_SOCKET_UART_CONS,8) 表示只处理8以下的显示，大于8将不显示。接下来就是一个回调处理函数CyFxSIFifoUtoPDmaCallback(CyU3PDmaChannel *chHandle,CyU3PDmaCbType_t type,CyU3PDmaCBInput_t *input)CyU3PRet

6、urnStatus_t status =CYU3P_SUCESS;If(type = CY_U3P_DMA_CB_PR0D_EVENT)Status =CyU3PDmaChannelCommitBuffer(chHandler,input-buff_p.count,0);glDMARxCount+;其中，CommitBuffer 这个函数通常在手动 DMA方式下被调用，它 3个参数的含义分别为： DMA的句柄 号，处理的字节数及当前的状态。其中地址由通道描述符隐含着。这个函数发送一个 buffer 向消费者socket.接下来，是一个比较复杂的程序Void CyFxSIFifoApplnSta

7、rt(void)这个函数启动一个slave fifo应用。当从USB接口收到一个SET_CONF事件时，即设置配置事件时，它被 调用。在这个函数中，端点被配置， DMA管道被建立。我们稍后将看到它就是在 USB配置时被调用的。首先，根据USB的接口速度，决定这个 DMA缓冲区的大小为多少字节。对于 3。0是1024。然后，端点配置。而得到速度是一个库函数，如何得到速度不得而知。不过，由于配置是在设备描述符得到后，并且是设置地址后调用的。故此时估计 PC机已经与下位机协商好速度了。例如PC为2。0则速度只能设为2。0端口设为BULK方式，且被允许。突发长度为 1。尺寸也被设为1024。先配置生产

8、者：允许端点1的收，尺寸按速度设置好，其它没什么。不过IN端点1定义成0x81 OUT定义成0x01接下来，要产生一个 DMA_MANUAL 通道 为U TO P看dmaCfg的一些参数填充：尺寸，即1024。缓冲区个数，2个。生产者ID号从0X401开始的。消费者socket端口，从0X103开始的。DMA模式：为0表示按字节计数。DMA事件：CY_U3P_DMA_CB_PROD_EVENT表示收到一个生产者发来的缓冲DMA的回调函数 UtoP头0尾0消费socket的头的编移 0最少要多少个空的缓冲才会在生产者激活前。 0表示任何时候都要激活它。在接收PtoU的DMA通道中，修改了这些：产

9、生者socketID被定义为0x100消费者socketID被定义为0x301回调函数改变了。然后是生成 DMA 通道。 再就是刷新生产者端点 EP。 再就是刷新消费者端点 EP 设置 DMA 传输尺寸。设为 0 表示无限。 最后将 glIsApplnActive = CyTrue; 将这个全局变量设为 TRUE 。下面是一个停止 FIFO 循环的程序。断开时或复位时会被调用。此处暂不管它。 再下面是一个当 USB 在 SETUP 时的回调处理 由于 SETUP 时交由 DRIVER 缺省处理，故直接返回一个 FALSE.USB 事件处理回调函数当设置配置时，调用 AppStart() 但是如

10、果已激活又来这么一下，则直接调用 ApplnStop() 复位和断开时，调用 ApplnStop()下面又定义一个比较重要的函数：用于初始化 GPIF 和 USB 接口。CyFxSlFifoApplnInit(void) /下面将这个函数写于此CyU3PPibClock_t pitClock;CyU3PReturnStatus_t apiRetStatus =CY_U3P_SUCCESS;/以下初始化 p-port 块pibClock.clkDiv = 2;pibClock.clkSrc = CY_U3P_SYS_CLK;pibClock.isHanfDiv = CyFalse;pibCloc

11、k.isDllEnable = CyFalse;apiRetStatus = CyU3PPibInit(CyTrue,&pibClock); / 这里是设置好时钟/ 以下装载 GPIF Slave_Fifo 未明白 它是如何配置的。apiRetStatus = CyU3PGpifLoad(&Sync_Slave_Fifo_2Bit_CyFxGpifConfig);/ 接下来是启动状态机(略) ，启动 USB 函数：apiRetStatus = CyU3PUsbStart(0;-开始 USB 功能接下来注册回调函数用于 USB 的 SETUP 过程。但它是一个返回 FALSE 的函数。 CyU3

12、PUsbRegisterSetupCallback(CyFxSlFifoApplnUSBSetupCB,CyTrue); CyU3PUsbRegisterEventCallback(CyFxSlFifoApplnUSBEventCB); 事务处理不是缺省的，而是我们上面定义 过的。例如 ApplnStart() 就是在配置过程中启动的。接下来，要开始配置设备描述符了，因为描述符中含有 PID 和 VID 的值。所以必须配置。 apiRetStatus=CyU3PUsbSetDesc(CY_U3P_USB_SET_SS_DEVICE_DESCR,NULL,(uint8*)CyFxUSB30Dev

13、iceDscr); 接下来是二进对象存储描述符的设置。接下来是设备量化描述符。 接下来是超速配置描述符，高速设备配置描述符， 重点看一下超速配置描述符，它含配置描述符 主要指明了接口数，配置数，配置字符串(无) 特性 - 自供电，远端唤醒功能电流消耗 400mA接口描述符有：端口数量， 2 个。接口类FF,子类00接口协议0接口协议字符串0生产者端点描述符如下：端点地址 0x01 生产者。最大包的长度 1024 ,数据间隔传输类型 0 表示 BULK 超速端点公司描述符,基本上全是 0。消费者端点,与生产者基本类似。只是端口地址不一样,其它一样的。 接下来是高速,全速描述符。接下来是语言描述符

14、。接下来是制造厂名描述符。 为 CYPRESS 接下来是产品描述符 FX3 最后连接 USB 物理层。至此枚举将开始。 然后定义了一个线程进入点,如下：SlFifoAppThread_Entry(uint32 input)CyFxSlFifoApplnDegugInit();CyFxSlFifoApplnInit();for(;)/这里是 UART 串口初始化/初始化 FIFO 应用 在这中间是 GPIF 和 USB 的初始化程序。 CyU3PThreadSleep(1000);/sleepIf(glIsApplnActive)/如果还是激活状态CyU3PDebugPring(6, Data

15、tracker:d,buffer send:%dn ” ,glDMARxCount,glDMA TxCount); /下面是应用定义函数,估计这个函数名是不能改的。在这个函数中,我们先分配一个堆栈空间Ptr=CyU3PMemAlloc(CY_FX_SLFIFO_THREAD_STACK);/然后产生一个线程retThrdCreate = CyU3PThreadCreate(*slFifoAppThread,“21:Slave_FIFO_syne ”,slFifoAppThread_Entry,0,ptr,CY_FX_SLFIFO_THREAD_STACK,CY_FX_SLFIFO_THREAD

16、_PRIOITYCY_FX_SLFIFO_THREAD_PRIORITYCYU3P_NO_THIME_SLICE,CYU3P_AUTO_START);最后是主程序 main()首先初始化设备，设备指的是 CPU，主要是时钟和堆栈等。然后 cachecontrol 不用 DATA CACHE。 在开发板上，由于 53: 56脚被连接到UART，这意味着我们要么选择 DQ32模式，要么选择LppMode. 不然UART就没办法用了。 Lpp模式好象是GPIO+UART模式，见datasheet 33页。几个参数 用UART，不用IIC不用IIS，不用SPI。没有GPIO使用到(简单复杂都没有)。

17、然后就是设置配置了。最后进入到内核。不返回。结束主程序。内核于是调用某一个函数，也就是 CyFxApplicationDefine(void)。程序就从此开始了。问：1程序是如何下载到 USB中去的。要怎么做。例如将这个编译好的代码放到什么目录里还是怎么办，还是 启动时，安装driver时，自动下载，这个下载的东西是个什么文件格式？该放在哪里？不明白2.难道生产者：GPIF 口上没接任何东西， 如何将PC机发下来的数据发回到 PC机上去?USB的OUT接口 1,向GPIF发送一批数据消费者：GPIF向IN接口 81，由它消费掉一批数据。然后通过 IN发回PC机。再看一个简单一点的 GPIO的例

18、子1先是一个错误处理的函数，我们不需要它，故这是一个死循环2 CyFxDebugI nit 这个函数，将串口作为调试口用 115200bps 3 void CyFxGpioI ntrCb (uin t8_t gpioId /* In dicates the pin that triggered the in terrupt */)这个函数是一个中断回调函数。必须在某个地方注册一下。它有下列过程：apiRetStatus =CyU3PGpioGetValue(gpiolD, &gpioValue); /这个函数得到某个端口中断的值这个gpioValue是一个BOOL值。而ID则是某一个端口的端口

19、号。这个函数只能返回一个引脚。等会看这个ID是什么指定的。CyU3PEventSet(&glFxGpioAppEvent,CY_FX_GPIOAPP_GPIO_HIGH_EVENT,CYU3P_EVENT_OR);如果为高，则设置一个事件。是一个高事件发生。注意到事件是一个全局变量，而这个事件中有许多参数，其中比较重要的是一个回调函数。应该在某个地方将这个事件与一个回调函数联系起来。 一会要补充这里5. Void CyFxGpioInit ( void ) apiRetStatus = CyU3PGpioInit(&gpioClock,CyFxGpiolntrCB);这个函数是设定gpio的时

20、钟，以及中断的回调函数。这与 4中部分形成对照。然后将gpio45定义为输入且允许中断gpioC on fig. in trMode = CY_U3P_GPI 0N TR_BOTH_EDGE ;apiRetStatus = CyU3PGpioSetSimpleC onfig (45, & gpioCo nfig);GPIO的21脚本来作为 GPIF的控制信号的。不能用 CyU3PDeviceConfigureIOMatrix 来将它作为 GPIF IOs.这个过载API调用必须进行必须小心当改变这个引脚的功能时。 如果IO脚作为GPIF的一部分连到外部设备上。则它不能再作为 GPIF IO使用

21、。在这里CTL4是不使用的，所以用它用 IO脚是安全的。apiRetStatus = CyU3PDeviceGpioOverride(21,CyTrue);接下来 apiRetStatus = CyU3PGpioSetSimpleConfig(21,&gpioConfig);6接下来有两个线程，一个是输岀线程，一个是输入线程，先看输岀线程：apiRetStatus = CyFxDebuglnit(); /初始化调试模式。这个在 2中定义的。CyFxGpiolnit();这个也在前面5定义过。后面是一个闪灯程序。apiRetStatus = CyU3PGpioSetValue(21,true);

22、将输出置为高。延时2秒，将输出变为低。延进2秒。7下面再来看输入线程：是一个循环，等事件发生。txApiRetStatus = CyU3PEventGet (&glFxGpioAppEvent, (CY_FX_GPIOAPP_GPIO_HIGH_EVENT | CY_FX_GPIOAPP_GPIO_LOW_EVENT), CYU3P_EVENT_0R_CLEAR, & eventFlag, CYU3P_WAIT_FOREVER);这里表示永远等下去。等到后要清除事件，另返回事件的标志，这个标志我们没有用。如果等到高的标志， 就打印一个引脚为高，如果为低，就打印一个引脚为低的标志。估计这个等事件

23、标志将被 block.这样整个过程清楚了， IO脚触发引起一个中断。这个中断回调函数中将触发一个事件。在这个线程中将等事件发生，如果发生了，就打印岀引脚的状态。事件在什么地方初始化呢？还是不需要初始化？8果然，事件是要初始化的。在应用程序中初始化了，下面就看这个应用程序 先创建一个输岀线程。再创建一个输入线程然后 retThrdCreate = CyU3EventCreate(&glFxGpioAppEvent);9最后看一下main()Main()中主要是将GPIO引脚初始化一下。io_cfg.gpioSimpleE n0 = 0;io_cfg.gpioSimpleE n1 = 0x0000

24、2000;/* GPIO 45 */io_cfg.gpioComplexE n0 = 0;io_cfg.gpioComplexE n1 = 0;45引脚为什么对应的是 0x2000.这是因为它是32位的，45引脚=32+13这个D13位正好是0X2000从main开始看起：再看一下几个定义：输岀线程，输入线程及事件在文件一开始就定义了。CyU3PThread gpioOutputThread; /* GPIO thread structure */CyU3PThread gpioI nputThread; /* GPIO thread structure */CyU3PEve nt glFxG

25、pioAppEve nt; /* GPIO in put event group. */它主要是调用了一个串口设置函数， 然后就进入到cache控制设置，再后来就是设置一个IO脚，45脚使之 使能。并且选用配置模式(即LPP模式)。允许了 UART，不允许IIC，IIS，SPI，另外isDQ32bit也不允许。 这个表示它不支持GPIF的32位模式。然后我们再看应用程序启动，这是由系统自动调用的。我们可能修改它的内容，但是它是必须的。这个函数中，它创建了两个线程。一个是输入线程，一个是输岀线程。另外，容易遗忘的一件事是它创建了一个事件。事件的创建只要这样就可以了：retThrdCreate =

26、 Cy3U3PEventCreate(& glFxGpioAppEvent );再往上，就是输入线程了。这个线程看输入引脚的变化，而这个变化由中断回调函数引起，中断回调函数 中，它会产生一个事件，而我们的线程就监视这个事件。如果有事件高发生，就串口打印一个引脚高，如果低，就打印一个引脚低。看它是如何实现的：txApiRetStatus = CyU3PEventGet(&glFxGpioAppEvent, (CY_FX_GPIOAPPP_GPIO_HIGH_EVENT|CY_FX_GPIOAPP_GPIO_LOW_EVENT), CYU3P_EVENT_OR_CLEAR,&eventFlag,C

27、YU3P_WAIT_FOREVER);这是个等事件的函数，这个函数无法找到它的定义，它是一个 API 函数。我们找 API ，发现它的参数含义 这里有一个 CYU3P_EVENT_OR_CLEAR 表示只要上面有一个位被设置就返回且清除标志。 OR 。而真正的事件就放在标志中返回了。既然有读事件，就必有设置事件，事件的设置应该在中断回调中实现。而中断回调的注册，应该在初始化 时实现。下面应该可以很快看到这点。 - 事实上， 在下面的输出线程中就实现了注册 输出线程实现，输出线程比较有意思的是其 DebugInit() 居然是在它中间实现的。这有点不合常理。而接下来，它又调用了初始化 Gpiol

28、nit()这个函数。在这个函数中，先初始化 GPIO，这个GPIO居然还要将时钟也设置一下，有点不合常理。在这个初始化中，它还指明了 GPIO 中断回调函数的注册。尽管这个中断函数应该是在输入线程中注册似更合理一些。接下来， 45 脚要用之为输入，所以要将配置设一下：gpioConfig. gpioConfig. gpioConfig. gpioConfig. gpioConfig.outValue = CyTrue; / 输出为高 因为是输入，要将它设为高inputEn = CyTrue; / 输入使能driveLowEn = CyFalse; / 不要驱动低也不要驱动高driveHighE

29、n = CyFalse;intrMode = CY_U3P_GPIO_INTR_BOTH_EDGE ; / 允许中断apiRetStatus = CyU3PGpioSetSimpleConfig (45, &gpioConfig); 如此这般配置了 45 脚。接下来，要配置21脚，因为21脚比较特殊本来是用于 GPIF的CTRL4的。现在要使用它就要重载一下: 这样的 IO 脚是不可以象在主程序中哪样，将它直接设为输出的，而是要先重载。同样，看输出脚是如何定义的gpioConfig.outValue= CyFalse; /低电平gpioConfig.driveLowEn= CyTrue; /允

30、许低输出gpioConfig.driveHighEn= CyTrue; /允许高输出gpioConfig.inputEn =CyFalse; /方向设为输出，(假的输入就是输出)gpioConfig.intrMode= CY_U3P_GPIO_NO_INTR ; / 不用中断再看一下回调函数，如何实现它的: 当引脚有跳变时，这个函数被调用。首先，它得到引脚的值。这个回调函数是带参数的。当它发生时，会 带过来一个参数。表明是哪一个引脚触发了这个事件。这在库函数中可能已经处理了，提供给用户程序就 不用麻烦再去看原因了。我想可能有一个机制，即有一个中断状态寄存器，表示是哪一个引脚变化了。 在这里调用

31、了一个函数: CyU3PGpioGetValue(gpioId,&gpioValue); 注意到这个值是一个 BOOL 型的。然后根据情况来设置事件:CyU3PEventSet(&glFxGpioAppEvent,CY_FX_GPIOAPP_GPIO_HIGH_EVENT,CYU3P_EVENT_OR); 我们看，其中有要设置的事件指针，有什么事件，以什么方式设置，它是以 OR 的方式设置的。这个 OR表示的是将这个第 2 个参数与当前的事件标志进行或。显然，如果相或的话，则事件标志将被置 1，而如果与则完全不同，它没效果。(在得到事件中，有一个 AND 表示全部标志都符合才生成事件，所以也是用 OR 的，不然，不可能全部符 合的，永远不会发生事件了，因为不可能既变高又变低的) 至此整个程序解读完