vxWorks 函数库

1. usbdTransfer()------初始化一个USB管道上的数据传输

STATUS usbdTransfer( USBD_CLIENT_HANDLE clientHandle, USBD_PIPE_HANDLE pipeHandle, pUSB_IRP pIrp //指向I/O请求包的指针)

一个client使用这个函数来初始化一个pipeHandle指定的管道的数据传输,这个传输由IRP或者说是I/O请求包来描述。必须要在调用usbdTransfer()之前初始化这个请求包。USB_IRP结构在vxWorks中的定义如下:

typedef struct usb_bfr_list{ UINT16 pid; pUINT8 pBfr; UINT16 bfrLen; UINT16 actLen; }USB_BFR_LIST;
typedef struct usb_irp{ LINK usbdLink; //used by USBD pVOID usbdPtr; //used by USBD LINK hcdLink; //used by HCD pVOID hcdPtr; //used by HCD pVOID userPtr; UINT16 irpLen; int result; // returned by USBD/HCD IRP_CALLBACK usbdCallback; // used by USBD IRP_CALLBACK userCallback; UINT16 dataToggle; // filled in by USBD UINT16 flags; UINT32 timeout; // defaults to 5 seconds if zero UINT16 startFrame; UINT16 transferLen; UINT16 dataBlockSize; UINT16 bfrCount; USB_BFR_LIST bfrList [1]; }USB_IRP, *pUSB_IRP;

  • USB_IRP结构体的长度必须要存储在irpLen这个变量当中,并且这个长度不是固定的,长度的值依赖于这个结构体底部的bfrList元素的个数。默认的这个结构体包含的bftList的元素个数是一个。但是client可以配置一个结构来适应更多的bfrList元素。

  • flags定义一个附加的传输选项,目前flags的定义如下:

  1. USB_FLAG_SHORT_OK:将正在接收(IN)的数据视为正常(Treats receive(IN) data underrun as OK)
  2. USB_FLAG_SHORT_FAIL: 将正在接收(IN)的数据视为错误(Treats receive(IN) data underrun as error)
  3. USB_FLAG_ISO_ASAP: 立即开始同步传输(Start an ioschronous transfer immediately.)

当USB正在从一个设备传输数据到主机时这个数据可能是出于”underrun“的状态。也就是说,这个设备可能传输比主机预期的更少的数据,这种情况可以算是或者不算是一个错误,这依赖于device的设计。对于大多数的device来说,underrun是完全正常的并且预示着从device过来的数据流的结束。而对于其他的设备而言,underrrun预示着传输的失败。默认的情况下USBD和下层的USB HCD将underrun视为数据传输的结束,并不将其宣告为一个错误。如果设立USB_FLAG_SHORT_FAIL标识,那么USBD/USB HCD将underrun视为一个错误发生的情况。

  • 对于ioschronous传输,USB_FLAG_ISO_ASAP指明应该立即开始一个同步传输,若没有指明USB_FLAG_ISO_ASAP,那么在startFrame参数中必须要指明传输开始的帧号(the starting frame number for the transfer)。在usbdCurrentFrameGet()函数中允许一个client为底层的USB host controller获取当前的帧号和一个被称作是帧调度窗口(frame scheduling window)的数值。这个帧窗口的数值表明了最大帧数。只有是isochronous传输时才需要指定startFrame。

  • dataBlockSize也可以用来指定isochronous传输,若该值非零,这个参数定义了isochronous数据传输的粒度(granularity)。当底层的Host Controller Driver(HCD)将传输分解为单个帧时,这个参数用来保证每一帧中传输的数据量是这个值的倍数。

  • timeout 以毫秒为单位指明IRP超时。若调用者传递这个值为0,那么USBD会自动的将其设置为USB_TIMEOUT_DEFAULT。若不希望有超时选项,那么超时应该被设置为USB_TIMEOUT_NONE。超时设置只适用于control和bulk传输。isochronous和interrupt传输没有超时,应将其设为USB_TIMEOUT_NONE。

  • bfrList 是一组缓冲描述符,用于描述与此IRP关联的数据缓冲区。如果需要超过一个bfrList元素,则调用者必须通过计算大小来分配IRP。
    irpLen = sizeof (USB_IRP) + (sizeof (USB_BFR_DESCR) * (bfrCount - 1))

  • transferLen必须是所传输的数据的的总的长度。换句话说,tranferLen是bfrList中所有bfrLen条目的和。

  • pid指明缓冲区中数据包的类型,并被定义为USB_PID_xxxx格式。

  • IRP usrCallback例程必须指向一个client提供的IRP_CALLBACK类型的函数。usbdTransfer()函数在IRP成功加入队列之后就立即返回,若在IRP被传递给HCD的时候失败,那么usbdTransfer()就会返回一个错误。在调用userCallback()例程之后应该检查IRP真正的返回结果。

若能够进行传输usbdTransfer()会返回OK,若不能进行传输,则返回ERROR。

2.

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 210,978评论 6 490
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 89,954评论 2 384
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 156,623评论 0 345
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,324评论 1 282
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,390评论 5 384
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,741评论 1 289
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,892评论 3 405
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,655评论 0 266
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,104评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,451评论 2 325
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,569评论 1 340
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,254评论 4 328
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,834评论 3 312
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,725评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,950评论 1 264
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,260评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,446评论 2 348

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,628评论 18 139
  • 国家电网公司企业标准(Q/GDW)- 面向对象的用电信息数据交换协议 - 报批稿:20170802 前言: 排版 ...
    庭说阅读 10,913评论 6 13
  • 串口操作 串口操作需要的头文件 #include /*标准输入输出定义*/ #include /*标准函数库定...
    旅行家John阅读 1,297评论 0 3
  • 1.1 资料 ,最好的入门小册子,可以先于一切文档之前看,免费。 作者Antirez的博客,Antirez维护的R...
    JefferyLcm阅读 17,034评论 1 51
  • 阿虎一直以来都是一个温顺乖巧的小孩,当他还是小BB的时候,别人拿走他正在玩的玩具,正在看的书,他也从来不发...
    我是大明阅读 278评论 0 0