上一篇文章解读了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机。
手机扫一扫
移动阅读更方便
你可能感兴趣的文章