CYPEESS USB3.0程序解读之---同步FIFO(slaveFifoSync)

上一篇文章解读了CYPRESS FX3的GPIO的操作过程，下面解读同步FIFO的一个例子(slaveFifoSync)。

*生产者，消费者。

1、首先看DMA的回调函数(cyu3dma.h)：

typedef void (*CyU3PDmaCallback_t) (

 CyU3PDmaChannel *handle,     /* Handle to the DMA channel. */

 CyU3PDmaCbType_t type, /* The type ofcallback notification being generated. */

 CyU3PDmaCBInput_t *input /* Union that contains data related to the notification.

                      The input parameter willbe a pointer to a CyU3PDmaBuffer_t

variable in the cases where the callback type is CY_U3P_DMA_CB_RECV_CPLTor CY_U3P_DMA_CB_PROD_EVENT. */

       );

根据其说明，解读如下：

1． 对每一个DMA通道，回调函数必须被注册。如果没有注册或者相应的通知事件没有被注册，则回调函数不会被执行。

2． 回调函数不能被阻塞。即不能用SLEEP（）之类的函数。如果数据需要处理，必须在回调函数之外。

3． 在生产者事件中，应用希望尽可能快地处理输入的数据。如果缓冲的处理不能在规定的时间内完成，则输入的可能是陈旧的数据。在自动信号通道中，输入参量指向最新的数据。如果处理延时，生产者socket可能覆盖部分数据。

4． 在手动或手动IN通道模式时，输入参量指向第一个缓冲(用于去消费者socket).如果在第二次调用时，这个缓冲仍没有被处理，输入参量中将是被陈旧的数据。如果数据处理必须在通道中做， CyU3PDmaChannelGetBuffer函数必须被应用，而回调函数必须作为一个通知。

2、而输入指针input的定义如下：

typedef struct CyU3PDmaBuffer_t

{

    uint8_t *buffer;   /* Pointer to the buffer                */

    uint16_t count;     /* Byte count of valid data in buffer   */

    uint16_t size;      /* Buffer size                          */

    uint16_t status;    /* Buffer status. This is a four bit data field…

} CyU3PDmaBuffer_t;

 

CyU3PDmaChannel这个结构中包含20个左右的参数，其中含回调函数。

 

1> .定义了一个全局变量：CyBool_t glIsApplnActive=CyFalse; 这个变量是一个BOOL型先设为FALSE.

 

2> .程序然后定义了一个错误处理，CyFxAppErrorHandler()我们不处理错误，故是一个死循环语句。

 

 

3>. 然后，定义一个CyFxSlFifoApplnDebugInit()用串口来显示一些信息。初始化串口，设波特率—只允许发不允许收，另外，采用DMA模式来处理UART。

*注意到这个函数：CyU3PDebugInit(CY_U3P_LPP_SOCKET_UART_CONS,8)表示只处理8以下的显示，大于8将不显示。

3、 接下来就是两个回调处理函数

1>. DMA回调函数 ，生产者----->消费者

CyFxSlFifoUtoPDmaCallback(

CyU3PDmaChannel *chHandle,

CyU3PDmaCbType_t type,

CyU3PDmaCBInput_t *input)

{

CyU3PReturnStatus_t status =CYU3P_SUCESS;

    If(type== CY_U3P_DMA_CB_PROD_EVENT){

    Status=  

CyU3PDmaChannelCommitBuffer(chHandler,input->buff_p.count,0);

glDMARxCount++;}

}

其中，CommitBuffer这个函数通常在手动DMA方式下被调用，它3个参数的含义分别为：DMA的句柄号，处理的字节数及当前的状态。其中地址由通道描述符隐含着。这个函数发送一个buffer向消费者socket.

 2>.DMA 回调函数 ，消费者----->生产者

CyFxSlFifoPtoUDmaCallback (

       CyU3PDmaChannel   *chHandle,

       CyU3PDmaCbType_t  type,

       CyU3PDmaCBInput_t *input

       )

{

   CyU3PReturnStatus_t status = CY_U3P_SUCCESS;

    if(type == CY_U3P_DMA_CB_PROD_EVENT)

    {

       status = CyU3PDmaChannelCommitBuffer (chHandle, input->buffer_p.count,0);

       if (status != CY_U3P_SUCCESS)

       {

           CyU3PDebugPrint (4, "CyU3PDmaChannelCommitBuffer failed, Error code= %d\n", status);

       }

       glDMATxCount++;

    }

}

    1>.这个回调跟上一个功能类似，只是这个是 PtoU（ 消费者----->生产者）。

4、 接下来，是一个比较复杂的程序

VoidCyFxSlFifoApplnStart(void)

这个函数启动一个slave fifo应用。当从USB接口收到一个SET_CONF事件时，即设置配置事件时，它被调用。在这个函数中，端点被配置，DMA管道被建立。我们稍后将看到它就是在USB配置时被调用的。

首先，根据USB的接口速度，决定这个DMA缓冲区的大小为多少字节。对于3.0是1024 Byte。

然后，端点配置。而得到速度是一个库函数，如何得到速度不得而知。

不过，由于配置是在设备描述符得到后，并且是设置地址后调用的。故此时估计PC机已经与下位机协商好速度了。例如PC为2.0则速度只能设为2.0

端口设为BULK方式，且被允许。突发长度为1。尺寸也被设为1024。

 

先配置生产者：

允许端点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通道中，修改了这些：

产生者socketID被定义为0x100

消费者socketID被定义为0x301

回调函数改变了。

然后是生成DMA通道。

再就是刷新生产者端点 EP。

再就是刷新消费者端点 EP

设置DMA传输尺寸。设为0表示无限。

最后将glIsApplnActive = CyTrue;  将这个全局变量设为TRUE。

 

下面是一个停止FIFO循环的程序。断开时或复位时会被调用。此处暂不管它。

再下面是一个当USB在SETUP时的回调处理

由于SETUP时交由DRIVER缺省处理，故直接返回一个FALSE.

 

USB事件处理回调函数

当设置配置时，调用AppStart() 但是如果已激活又来这么一下，则直接调用ApplnStop()

复位和断开时，调用ApplnStop()

 

5、下面又定义一个比较重要的函数：用于初始化GPIF和USB接口。

CyFxSlFifoApplnInit(void)   ///下面将这个函数写于此

{

CyU3PPibClock_tpitClock;

CyU3PReturnStatus_tapiRetStatus =CY_U3P_SUCCESS;

//以下初始化p-port块

pibClock.clkDiv =2;

pibClock.clkSrc =CY_U3P_SYS_CLK;

pibClock.isHanfDiv= CyFalse;

pibClock.isDllEnable= CyFalse;

apiRetStatus =CyU3PPibInit(CyTrue,&pibClock);   //这里是设置好时钟

///以下装载GPIF   Slave_Fifo----未明白它是如何配置的。

apiRetStatus =CyU3PGpifLoad(&Sync_Slave_Fifo_2Bit_CyFxGpifConfig);

///接下来是启动状态机（略），启动USB函数：

apiRetStatus =CyU3PUsbStart(0;---开始USB功能

接下来

注册回调函数用于USB的SETUP过程。但它是一个返回FALSE的函数。

CyU3PUsbRegisterSetupCallback(CyFxSlFifoApplnUSBSetupCB,CyTrue);

CyU3PUsbRegisterEventCallback(CyFxSlFifoApplnUSBEventCB);事务处理不是缺省的，而是我们上面定义过的。例如ApplnStart()就是在配置过程中启动的。

 

接下来，要开始配置设备描述符了，因为描述符中含有PID和VID的值。所以必须配置。

apiRetStatus=CyU3PUsbSetDesc(CY_U3P_USB_SET_SS_DEVICE_DESCR,NULL,(uint8*)CyFxUSB30DeviceDscr);

接下来是二进对象存储描述符的设置。

接下来是设备量化描述符。

接下来是超速配置描述符，高速设备配置描述符，

重点看一下超速配置描述符，它含配置描述符 主要指明了接口数，配置数，配置字符串（无）

特性-自供电，远端唤醒功能

电流消耗400mA

接口描述符有：

端口数量，2个。

接口类 FF，子类00 接口协议0 接口协议字符串0

生产者端点描述符如下：

端点地址 0x01 生产者。最大包的长度1024，数据间隔传输类型 0表示BULK。

超速端点公司描述符，基本上全是0。

消费者端点，与生产者基本类似。只是端口地址不一样，其它一样的。

接下来是高速，全速描述符。

接下来是语言描述符。

接下来是制造厂名描述符。 为CYPRESS

接下来是产品描述符  FX3

最后连接USB物理层。至此枚举将开始。

}

然后定义了一个线程进入点，如下：

SlFifoAppThread_Entry(uint32input)

{

         CyFxSlFifoApplnDegugInit();  ///这里是UART串口初始化

         CyFxSlFifoApplnInit();     ///初始化FIFO 应用在这中间是GPIF和USB的初始化程序。

          for(;;)

{ CyU3PThreadSleep(1000);   //sleep

  If(glIsApplnActive)       ///如果还是激活状态

         CyU3PDebugPring(6,”Datatracker:…%d,buffer send:%d\n”,glDMARxCount,glDMATxCount);

}

}

}

/

下面是应用定义函数，估计这个函数名是不能改的。在这个函数中，我们先分配一个堆栈空间

 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_PRIOITY,

CY_FX_SLFIFO_THREAD_PRIORITY,

CYU3P_NO_THIME_SLICE,

CYU3P_AUTO_START

);

 

 

6、最后是主程序main()

首先初始化设备，设备指的是CPU，主要是时钟和堆栈等。

然后cachecontrol 不用DATA CACHE。

在开发板上，由于53：56脚被连接到UART，这意味着我们要么选择DQ32模式，要么选择LppMode.

不然UART就没办法用了。Lpp模式好象是GPIO+UART模式，见datasheet33页。

几个参数 用UART，不用IIC ，不用IIS，不用SPI。没有GPIO使用到（简单复杂都没有）。

然后就是设置配置了。

最后进入到内核。不返回。结束主程序。

内核于是调用某一个函数（具体实现内核已经封装好了），也就是CyFxApplicationDefine(void)。程序就从此开始了。

*问：

1程序是如何下载到USB中去的。要怎么做。例如将这个编译好的代码放到什么目录里还是怎么办，还是启动时，安装driver时，自动下载，这个下载的东西是个什么文件格式？该放在哪里？不明白

2．难道GPIF口上没接任何东西， 如何将PC机发下来的数据发回到PC机上去？

生产者：USB的OUT接口1，向GPIF发送一批数据

消费者：GPIF向IN接口81，由它消费掉一批数据。然后通过IN发回PC机。