赛普拉斯 cypress Cyapi使用心得

Cyapi使用心得(1)--USB连接2009-11-07 19:23             

 用Cyapi也有一阵了,这个确实比EZusb的api好用,简单说下Cyapi的使用心得,在编程中应该注意的一些问题,毕竟,说起来,那个CYapi的说明文档讲的实在太简单了点,好多东西都讲得不明白,只能

在使用中自己慢慢积累了。

            首先说下前提,固件架构是EZ-USB FX2/FX2LP(CY7C68013),编译环境VC++ 6.0,驱动是Cyusb.sys。

            上位机简单说下,建立一个MFC 单文档/对话框 应用程序;在路径项目中包含头文件cyapi.h和cyapi.lib所在的路径,最好移到最上面。然后手动导入cyapi.lib,注意是CV6_7的lib,不要导入BCB的。

             下面讲得是按照USB一般工作流程来讲得。

(1)USB连接

         1.首先要建立一个USB设备对象

文档里有说的了,copy一下

       CCyUSBDevice *USBDevice = new   CCyUSBDev(Handle);

括号中的Handle是USB所关联对象的句柄,一般在MFC中直接就是m_hwnd。

        2.然后就该是打开USB设备了

可以用到两个函数open();isopen()

     这两个都可以用来打开USB设备,isopen()还可以判断能否获得USB设备句柄

      一般来说,如果只有一个USB设备连接,可以这样打开:

               USBDevice->open(0)    //打开0号USB设备

如果要判断,可以:

                     if(! USBDevice->open(0)) //打开失败

                      {messagebox("USB未连接");}

或者        if(!USBDevice->Isopen())

                     ..........

      如果连接有多个USB设备,那么可以枚举所有的USB,用到DeviceCount()函数;具体的可以参考cybulk的例子,执行USBDevice->DeviceCount()后,返回所连接的USB设备个数:

       if (USBDevice->DeviceCount())   //保证至少有一个USB设备连接
    {
        for (i = 0; i < USBDevice->DeviceCount(); i++)    //枚举所有USB设备
        {
            USBDevice->Open(i);                                     //打开第i号USB设备

            m_DeviceListComBox.AddString(USBDevice->DeviceName);   //所选择的当前设备名
        }

    }

                    好了,今天说到这里,有空接着写~
 

Cyapi使用心得(2)--端点使用及其他USB属性获取2009-11-13 22:52    ◆     在cybulk的例子中介绍了如何枚举固件中使用的所有端点,也就是使用多个端点的情况:

       CCyUSBDevice *USBDevice =new CCyUSBDevice(m_hWnd); //USB设备

     USBDevice->Open(0);    //打开0号USB设备

       【1】首先获取所用的端点数目

       int epts = USBDevice->EndPointCount();

EndPointCount();函数返回当前所用的端点数+1,也就是包含了控制端点。例如在固件接口描述符Interface Descriptor中设置Number of end points项(第5项)的值为4,则epts的值为4+1=5

      【2】定义端点指针

      CCyUSBEndPoint *endpt;  

CCyUSBEndPoint 建立一个端点对象,可建立所有的端点类型,控制端点,bulk端点,ISO端点等;

      【3】开始枚举端点,并获得其属性:端点号,传输方向

       for (i=1; i<epts; i++)
    {   
        endpt = USBDevice->EndPoints[i];    //EndPoints-端点列表,最大16.EndPoints[0]指向控制端点( CCyControlEndPoint)
            //未使用的端点设置为NULL

        if (endpt->Attributes == 2)    // Bulk Attributes--判断传输类型bulk,control,等
        {
            sprintf(s, "0x%02X", endpt->Address);

            if (endpt->Address & 0x80)   //Address--判断传输方向in or out 0x8_-in;0x0_-out
            {
                m_InEndptComBox.AddString(s); //最高位为8,in端点,添加到in组合框
                m_InEndptComBox.SetItemData(m_InEndptComBox.GetCount()-1,i);
            }
            else
            {
                m_OutEndptComBox.AddString(s); //否则,最高位为0,out端点,添加到out组合框
                m_OutEndptComBox.SetItemData(m_OutEndptComBox.GetCount()-1,i);
            }
        }
    }

◆ 这样,就完成了某个具体端点的选择。从上面的代码来看,非常烦琐,如果只需要使用一个端点的画,那上面的代码无疑就显得冗长不够简洁了。仅使用一个端点,可以使用EndPointOf()函数,该函数直接使用指定的端点,返回其指针;例如,要使用端点2,in传输,那么,可以这样:

            CCyUSBDevice *USBDevice =new CCyUSBDevice(m_hWnd); //USB设备 

            USBDevice->Open(0); //打开0号设备,

           CCyUSBEndPoint *endpt = USBDevice->EndPointOf(0X82); //使用端点2,in传输

       可以看到,上面的只需要3行代码,比枚举简洁方便多了。

◆ 至于获取USB其他属性,这里列出经常使用的几个,具体的可参考cyapi的文档,在CCyUSBDevice和CCyUSBEndPoint这两个类里可查询到。

       USBDevice->DeviceCount()     //返回连接到电脑的USB设备个数,从0,1,2.。开始命名

        USBDevice->DeviceName()     //返回USB设备名称,也就是固件中 StringDscr2: 字段字符串  

       USBDevice->VendorID           //返回USB设备VID

       USBDevice->ProductID           //返回USB设备PID


Cyapi使用心得(3)--控制传输2009-11-17 21:04         刚喝酒回来,头很晕!今天写写控制传输吧--

        可以说,写USB上位机,控制传输肯定第一个要做的例子和试验了;因为固件不用很多代码,VC也不用很多代码就测试你写的USB上位机的正确与否,这里简单介绍下cyapi写控制传输的一些方法。

      基本上,要对固件进行自定义命令(vendor)传输,通常都是用控制传输进行的。使用控制传输in或者out方式都可以实现对固件的自定义命令。

      【1】out控制传输发送vendor命令

                我想采用out方式应该比较符合大家的思维,因为是从上位机发命令到下位机,怎么看都应该是out而不是in。

       例如你在固件里设置了out的接收buf:

      BOOL DR_VendorCmnd(void)
{
   switch (SETUPDAT[1])
{
   case 0xDD:
   { temp=EP0BUF[0];
    EP0BCH=0;
    EP0BCL=1;
    EP0CS |=bmHSNAK;
    break;
   }
   default:
    return(TRUE);
   }
   return(FALSE);
}

      VC中:

           CCyControlEndPoint* CtlEndpoint;   //定义一个控制端点  

          CtlEndpoint->Target    = TGT_DEVICE;       //不必关注,固定
          CtlEndpoint->ReqType   = REQ_VENDOR;             //请求类型:自定义请求(标准请求等)
          CtlEndpoint->Direction = DIR_TO_DEVICE;    //传输方向:主机->usb设备(out)
          CtlEndpoint->ReqCode   = 0XDD;      //自定义请求码  
          CtlEndpoint->Value     = 0;     //这里的设定值将传给setupdat的【2:3】位
           CtlEndpoint->Index     = 0;    //这里的设定值将传给setupdat的【4:5】位
 
          PUCHAR buf=new UCHAR[1];
         ZeroMemory(buf,1);                             //用0填充buf区,填充大小(1字节)
          long buflen=1;                                    //传输的其他字节数:cy控制台console中length的值
           CtlEndpoint->XferData(buf,buflen);

当然,没有规定说一定必须传给下位机至少一个字节的数据;你也可以不传;不过最好下位机同样设置接收字节为0,否则小心有莫名奇妙的错误(XX内存不能为只读等等)。

        将temp=EP0BUF[0];去掉,上位机:

          PUCHAR buf=new UCHAR;                         //用0填充buf区,填充大小(1字节)
          long buflen=0;
           CtlEndpoint->XferData(buf,buflen);

也是可以的,友情提示:控制传输请尽量用同步的xferdata()而不是异步的begindataxfer()。

【2】in控制传输发送vendor命令

          基本上,跟out区别不大。固件中:

       BOOL DR_VendorCmnd(void)
{
   switch (SETUPDAT[1])
{
   case 0xDD:
   {
    *EP0BUF=0XDD;
    EP0BCH=0;
    EP0BCL=1;
    EP0CS |=bmHSNAK;
    break;
   }
   default:
    return(TRUE);
   }
   return(FALSE);
}

      VC中:

          CCyControlEndPoint* CtlEndpoint;   //定义一个控制端点  

          CtlEndpoint->Target    = TGT_DEVICE;       //不必关注,固定
          CtlEndpoint->ReqType   = REQ_VENDOR;             //请求类型:自定义请求(标准请求等)
          CtlEndpoint->Direction = DIR_FROM_DEVICE;    //传输方向:usb设备->主机(in)
          CtlEndpoint->ReqCode   = 0XDD;      //自定义请求码  
          CtlEndpoint->Value     = 0;     //这里的设定值将传给setupdat的【2:3】位
           CtlEndpoint->Index     = 0;    //这里的设定值将传给setupdat的【4:5】位
 
          PUCHAR buf=new UCHAR[1];
         ZeroMemory(buf,1);                             //用0填充buf区,填充大小(1字节)
          long buflen=1;                                    //传输的其他字节数:cy控制台console中length的值
           CtlEndpoint->XferData(buf,buflen);

这里的话,推荐尽量设置接收缓冲,不要将buflen设置为0.同样,友情提示:控制传输请尽量用同步的xferdata()而不是异步的begindataxfer()。

     【3】另外,还有两个简化版本的函数Write(out传输)和Read(in传输)也可以进行控制传输,作用同XferData()是一样的,因为已经明确表示了是in还是out,所以Direction 项的值就省略了。只是看起来代码更加简洁,输入效率更高而已。基本上,大多数时候,我都是使用Write和Read。

          CCyControlEndPoint* CtlEndpoint;   //定义一个控制端点  

          CtlEndpoint->Target    = TGT_DEVICE;       //不必关注,固定
          CtlEndpoint->ReqType   = REQ_VENDOR;             //请求类型:自定义请求(标准请求等)
          CtlEndpoint->ReqCode   = 0XDD;      //自定义请求码  
          CtlEndpoint->Value     = 0;     //这里的设定值将传给setupdat的【2:3】位
           CtlEndpoint->Index     = 0;    //这里的设定值将传给setupdat的【4:5】位
 
          PUCHAR buf=new UCHAR[1];
         ZeroMemory(buf,1);                             //用0填充buf区,填充大小(1字节)
          long buflen=1;                                    //传输的其他字节数:cy控制台console中length的值
           CtlEndpoint->Write(buf,buflen);  

      Read的话同理。
 
Cyapi使用心得(4)--bulk传输2009-12-01 19:50           今天有空写以下bulk传输。bulk的话,cy开发包里有个例子cybulk写的很好,不过说实话,那个太烦琐了,基本上我们自己只用到其中的一部分,另外,就是局限性很大,例如它只是512字节的倍数,对于任意数目的字节貌似是不支持的,数据会不同步。

           为了提高传输速度与效率,一般要把数据采集放在另外一个线程,单独开启一个bulk线程。恩,前面的还是稍微提一下,在打开USB,设定端点后,紧接着开启线程,进行bulk采集:

         if (USBDevice->IsOpen()) {   //如果USB设备已经打开
           bLooping = true;      //线程循环标志为真
          XferThread = AfxBeginThread(XferLoop, this); //启动线程
           }

        然后是线程中的处理,在这里上位机用异步接收,创建异步事件:

      OVERLAPPED inOvLap;
     CVC_SimpleCyapiDlg *dlg = (CVC_SimpleCyapiDlg *) params;   //使该线程可访问CBulkLoopDlg类的所 有公有成员

     inOvLap.hEvent   = CreateEvent(NULL, false, false, "CYUSB_IN");

     线程循环:

    bool success;

dlg->InEndpt->TimeOut = 120;


for (;dlg->bLooping;) {       //线程循环,直到循环标志blooping为假
   LONG inlen ;
   inlen = 512;
   UCHAR *inContext = dlg->InEndpt->BeginDataXfer(inData,inlen,&inOvLap);
 
        dlg->InEndpt->WaitForXfer(&inOvLap,TimeOut);
        success = dlg->InEndpt->FinishDataXfer(inData,inlen, &inOvLap,inContext);
     if (!success) dlg->bLooping = false;
}

      主要是三步,调用三个函数BeginDataXfer,WaitForXfer,FinishDataXfer。按照手册上说的,BeginDataXfer发起异步传输,并且立即返回。也就是说,发起此次的inlen后,并不会等inlen传输完,而是立即开始下一次inlen字节传输;WaitForXfer,异步传输最大等待时间;FinishDataXfer,到这里才开始真正的写内存,将读到的数写到缓冲区indata中。

      最后,完了别忘记释放对象:

     CloseHandle(inOvLap.hEvent);

     delete [] inData;

     另外,如果要传输非512字节整数倍的数据,而且不是一次传输完的话,最好在线程中用SetXferSize()重新设置传输大小,否则会导致数据不同步。

 

    USBDevice->BulkInEndPt->SetXferSize(len);→接收数据速度提升。

 

 

 

相关推荐
©️2020 CSDN 皮肤主题: 大白 设计师:CSDN官方博客 返回首页